API v1
Agents
Tasks CRUD

Get Agent Tasks

Retrieve paginated list of task executions for a specific agent with optional filters

get/v1/agents/{agent_id}/tasks

Request

  • Base URL
    https://api.xpander.ai (the document declares no server; this is the origin it was published from)
  • Auth
    API key in header x-api-key

Path parameters

agent_idstring required

Query parameters

pageinteger

Page number (starting from 1)

per_pageinteger

Items per page (max 50)

user_idstring

Filter by user ID

parent_task_idstring

Filter by parent task ID

triggering_agent_idstring

Filter by triggering agent ID (parent calling agent)

status'pending' | 'executing' | 'paused' | 'error' | 'failed' | 'completed' | 'stopped'

Filter by task execution status

internal_statusstring

Filter by internal task status

archived'true' | 'false' | 'any' nullable

Archived rows: false (default) hides them, true lists only them, any lists both

Response

Successful Response

totalinteger required
pageinteger required
per_pageinteger required
total_pagesinteger required

Changes

No recorded changes to this operation across all 4 revisions of this API.