Get all task executions for a specific agent with support for filtering by user, status, and parent task relationships. This endpoint is useful for monitoring agent activity and debugging task flows.
Path Parameters Unique identifier of the agent (UUID format)
Query Parameters Page number (starting from 1)
Items per page (maximum 50)
Filter by user ID who created the task
Filter by parent task ID (for sub-tasks)
Filter by triggering agent ID (parent calling agent in multi-agent workflows)
Filter by task execution status: pending, running, completed, failed, cancelled
Filter by internal task status (for debugging)
Response Array of task objects Unique identifier for the task (UUID format)
ID of the agent that executed this task
ID of the user who created the task (nullable)
ID of parent task if this is a subtask (nullable)
ID of agent that triggered this task (nullable)
Organization UUID this task belongs to
Current task status: pending, completed, error
ISO timestamp of task creation
ISO timestamp of last update
Task execution result (nullable, present when completed)
Task title or description (nullable)
Total number of tasks for this agent
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/38551c1d-a16b-454f-84d4-68f431ba608b/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/38551c1d-a16b-454f-84d4-68f431ba608b/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/38551c1d-a16b-454f-84d4-68f431ba608b/tasks?user_id=user-123&page=1&per_page=10" Example Response { "items" : [ { "id" : "b7e398b2-cddc-4c1e-b714-8200953b8558" , "agent_id" : "38551c1d-a16b-454f-84d4-68f431ba608b" , "user_id" : null , "parent_task_id" : null , "triggering_agent_id" : null , "organization_id" : "91fbe9bc-35b3-41e8-b59d-922fb5a0f031" , "status" : "completed" , "created_at" : "2025-11-06T06:05:43.071572Z" , "updated_at" : "2025-11-06T06:05:48.492501Z" , "source_node_type" : "sdk" , "result" : "Your request to \" Test async invoke \" is noted..." , "title" : "Test async invoke" }, { "id" : "4921b718-7f97-4bc3-8910-1baab59839d9" , "agent_id" : "38551c1d-a16b-454f-84d4-68f431ba608b" , "user_id" : null , "parent_task_id" : null , "triggering_agent_id" : null , "organization_id" : "91fbe9bc-35b3-41e8-b59d-922fb5a0f031" , "status" : "completed" , "created_at" : "2025-11-06T06:05:28.666491Z" , "updated_at" : "2025-11-06T06:05:34.055349Z" , "source_node_type" : "sdk" , "result" : "Your request to \" Test sync invoke \" has been received..." , "title" : "Test sync invoke" } ], "total" : 8 , "page" : 1 , "per_page" : 2 , "total_pages" : 4 } Use Cases
Monitor agent activity - Track all tasks executed by a specific agentDebug workflows - Filter by parent_task_id to see sub-task hierarchiesUser analytics - Filter by user_id to see tasks from specific usersMulti-agent debugging - Use triggering_agent_id to trace agent-to-agent delegations
See Also
[List Tasks](/API reference/v1/tasks/list-tasks) - List all tasks across all agents
[Get Task](/API reference/v1/tasks/get-task) - Get detailed information about a specific task
[Invoke Agent](/API reference/v1/agents/invoke-async) - Create new tasks
Required range: 1 <= x <= 50
Available options:
pending,
executing,
paused,
error,
failed,
completed,
stopped
items
TasksListItem · object[]
required
