Skip to main content
GET
Get Agent Tasks
Get paginated task records for a specific agent with support for filtering by user, status, and parent task relationships. In multi-turn conversations, reusing an invocation id updates the same task/thread record instead of creating a brand-new top-level item for every turn.

Path Parameters

string
required
Unique identifier of the agent (UUID format)

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 parent task ID (for sub-tasks)
string
Filter by triggering agent ID (parent calling agent in multi-agent workflows)
string
Filter by task execution status: pending, executing, paused, error, failed, completed, stopped
string
Filter by internal task processing status

Response

array
Array of task objects
integer
Total number of tasks for this agent
integer
Current page number
integer
Number of items per page
integer
Total number of pages available

Example Requests

List all tasks for an agent

Filter by status

Filter by user

Example Response

Use Cases

  • Monitor Agent Activity: Track all tasks executed by a specific agent
  • Debug Workflows: Filter by parent_task_id to see sub-task hierarchies
  • User Analytics: Filter by user_id to see tasks from specific users
  • Multi-Agent Debugging: Use triggering_agent_id to trace agent-to-agent delegations
  • Performance Analysis: Track task completion times and status distribution

Notes

  • Tasks are returned in reverse chronological order (newest first)
  • Continuing a conversation by sending the same invocation id updates the same task/thread record instead of creating a new top-level task item
  • The title, result, and updated_at fields reflect the latest turn for that task/thread
  • The source_node_type indicates how the task was invoked (SDK, webhook, web UI, etc.)
  • Sub-tasks (when parent_task_id is set) represent work delegated to other agents
  • Use Get Task for the latest full task object and Get Task Thread or Get Task Thread (Full) for message history

See Also

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

agent_id
string
required

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

parent_task_id
string

Filter by parent task ID

triggering_agent_id
string

Filter by triggering agent ID (parent calling agent)

status
enum<string>

Filter by task execution status

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

Filter by internal task status

Response

Successful Response

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