Skip to main content
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, stopped
string
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

Authorizations

x-api-key
string
header
required

API Key for authentication

Query Parameters

page
integer
default:1

Page number (starting from 1)

Required range: x >= 1
per_page
integer
default:20

Items per page (max 50)

Required range: 1 <= x <= 50
user_id
string

filter by user id (optional)

parent_task_id
string

filter by parent task id (optional)

agent_id
string

filter by agent id (optional)

triggering_agent_id
string

filter by triggering agent id (parent calling agent) (optional)

status
enum<string>

filter by task status (optional)

Available options:
pending,
executing,
paused,
error,
failed,
completed,
stopped
internal_status
string

filter by internal status (optional)

from_date
string<date-time>

filter tasks created on or after this date (ISO 8601, optional)

to_date
string<date-time>

filter tasks created on or before this date (ISO 8601, optional)

Response

Successful Response

items
TasksListItem · object[]
required
total
integer
required
page
integer
required
per_page
integer
required
total_pages
integer
required