Get Tasks
REST API - Tasks
List Tasks
Get paginated list of tasks with optional filtering by status, agent, or date range
GET
Get Tasks
Retrieve a paginated list of tasks with optional filtering by status, agent ID, or creation date. Useful for monitoring task execution across your organization or for specific agents.
Query Parameters
integer
default:1
Page number (starting from 1)
integer
default:20
Items per page (maximum 50)
string
Filter by user ID who created the task
string
Filter by specific agent UUID
string
Filter by parent task ID (for sub-tasks)
string
Filter by triggering agent ID (parent calling agent in multi-agent workflows)
string
Filter by task status:
pending, executing, paused, error, failed, completed, stoppedstring
Filter by internal task processing status
string
Filter tasks created on or after this date (ISO 8601, e.g.,
2026-02-01T00:00:00Z)string
Filter tasks created on or before this date (ISO 8601)
Response
array
Array of task objects
integer
Total number of tasks matching the filter across all pages
integer
Current page number
integer
Number of items returned per page
integer
Total number of pages available
Example Requests
Example Response
Use Cases
- Monitor task volume - Track total tasks and completion rates
- Filter by agent - See tasks for a specific agent
- Find completed work - Retrieve only successful task executions
- Track recent activity - Filter by creation date range
See Also
- Get Task - Get detailed information about a specific task
- Stop Task - Cancel a running task
- Delete Task - Permanently remove a task and its data
- Get Task Thread - Get the conversation history of a task
Authorizations
API Key for authentication
Query Parameters
Page number (starting from 1)
Required range:
x >= 1Items per page (max 50)
Required range:
1 <= x <= 50filter by user id (optional)
filter by parent task id (optional)
filter by agent id (optional)
filter by triggering agent id (parent calling agent) (optional)
filter by task status (optional)
Available options:
pending, executing, paused, error, failed, completed, stopped filter by internal status (optional)
filter tasks created on or after this date (ISO 8601, optional)
filter tasks created on or before this date (ISO 8601, optional)

