Get Agent Tasks

curl --request GET \
  --url https://api.xpander.ai/v1/agents/{agent_id}/tasks \
  --header 'x-api-key: <api-key>'

{
  "items": [
    {
      "id": "<string>",
      "agent_id": "<string>",
      "organization_id": "<string>",
      "user_id": "<string>",
      "parent_task_id": "<string>",
      "triggering_agent_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "source_node_type": "<string>",
      "result": "<string>",
      "title": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "per_page": 123,
  "total_pages": 123
}

GET

agents

{agent_id}

tasks

Get Agent Tasks

curl --request GET \
  --url https://api.xpander.ai/v1/agents/{agent_id}/tasks \
  --header 'x-api-key: <api-key>'

{
  "items": [
    {
      "id": "<string>",
      "agent_id": "<string>",
      "organization_id": "<string>",
      "user_id": "<string>",
      "parent_task_id": "<string>",
      "triggering_agent_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "source_node_type": "<string>",
      "result": "<string>",
      "title": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "per_page": 123,
  "total_pages": 123
}

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

agent_id

string

required

Unique identifier of the agent (UUID format)

Query Parameters

page

integer

default:1

Page number (starting from 1)

per_page

integer

default:20

Items per page (maximum 50)

user_id

string

Filter by user ID who created the task

parent_task_id

string

Filter by parent task ID (for sub-tasks)

triggering_agent_id

string

Filter by triggering agent ID (parent calling agent in multi-agent workflows)

status

string

Filter by task execution status: pending, executing, paused, error, failed, completed, stopped

internal_status

string

Filter by internal task processing status

Response

items

array

Array of task objects

Show Task Object

string

Unique identifier for the task (UUID format)

agent_id

string

ID of the agent that executed this task

user_id

string

ID of the user who created the task (nullable)

parent_task_id

string

ID of parent task if this is a subtask (nullable)

triggering_agent_id

string

ID of agent that triggered this task (nullable)

organization_id

string

Organization UUID this task belongs to

status

string

Current task status: pending, executing, paused, error, failed, completed, or stopped

source_node_type

string

Source of task invocation: sdk, webhook, assistant, etc.

created_at

string

ISO timestamp of task creation

updated_at

string

ISO timestamp of last update

title

string

Task title or the latest input text for that task/thread

result

string

Latest result for that task/thread (nullable, present when completed)

total

integer

Total number of tasks for this agent

page

integer

Current page number

per_page

integer

Number of items per page

total_pages

integer

Total number of pages available

Example Requests

List all tasks for an agent

curl -X GET -H "x-api-key: <your-api-key>" \
  "https://api.xpander.ai/v1/agents/<agent-id>/tasks?page=1&per_page=2"

Filter by status

curl -X GET -H "x-api-key: <your-api-key>" \
  "https://api.xpander.ai/v1/agents/<agent-id>/tasks?status=completed&page=1&per_page=10"

Filter by user

curl -X GET -H "x-api-key: <your-api-key>" \
  "https://api.xpander.ai/v1/agents/<agent-id>/tasks?user_id=<user-id>&page=1&per_page=10"

Example Response

{
  "items": [
    {
      "id": "fbd08e4d-cfa7-4838-b6e6-e51855ac2ba3",
      "agent_id": "<agent-id>",
      "user_id": null,
      "parent_task_id": null,
      "triggering_agent_id": null,
      "organization_id": "<org-id>",
      "status": "completed",
      "source_node_type": "sdk",
      "created_at": "2026-03-23T00:45:24.296117Z",
      "updated_at": "2026-03-23T00:45:31.040146Z",
      "title": "Reply with exactly SECOND",
      "result": "SECOND"
    }
  ],
  "total": 6,
  "page": 1,
  "per_page": 5,
  "total_pages": 2
}

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

Get Agent Tasks

Path Parameters

Query Parameters

Response

Example Requests

List all tasks for an agent

Filter by status

Filter by user

Example Response

Use Cases

Notes

See Also

Authorizations

Path Parameters

Query Parameters

Response

Documentation Index

​Path Parameters

​Query Parameters

​Response

​Example Requests

​List all tasks for an agent

​Filter by status

​Filter by user

​Example Response

​Use Cases

​Notes

​See Also

Authorizations

Path Parameters

Query Parameters

Response

Path Parameters

Query Parameters

Response

Example Requests

List all tasks for an agent

Filter by status

Filter by user

Example Response

Use Cases

Notes

See Also