API ReferenceAgents

List Task Agent Runs

List execution runs for a Task Agent. Returns run history with: - Input message - Token usage - Status and duration - Trigger type (`manual`, `api`, `slack`, or a trigger type such as `schedule`, `webhook`, or `gmail_inbox`) - Task tools invoked - MCP tools invoked - Phase timings for LLM, tool execution, and memory compaction when applicable

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

OR
AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"
The organization ID
project_idstringRequiredformat: "uuid"
The project ID
task_agent_idstringRequiredformat: "uuid"
The task agent ID

Query parameters

session_idstring or nullOptional
Filter by session ID
is_errorboolean or nullOptional

Filter by run-level error status.

had_task_tool_failboolean or nullOptional
Filter by whether any invoked task tool failed.
had_mcp_tool_failboolean or nullOptional
Filter by whether any invoked MCP tool failed.
had_integration_tool_failboolean or nullOptional
Filter by whether any invoked integration tool failed.
statusenum or nullOptional
Filter by run status.
Allowed values:
created_afterdatetime or nullOptional

Filter runs created at/after this timestamp.

created_beforedatetime or nullOptional

Filter runs created at/before this timestamp.

min_duration_msinteger or nullOptional>=0
Filter runs with duration greater than or equal to this value.
task_agent_revision_idstring or nullOptionalformat: "uuid"
Filter by TaskAgent revision ID.
trigger_typestring or nullOptional

Filter by how the run was triggered. Non-trigger sources include manual, api, and slack; trigger executions use their trigger type value such as schedule, webhook, or gmail_inbox.

chaos_enabledboolean or nullOptional
Filter by whether the run has a chaos policy.
page_limitintegerOptional1-100Defaults to 100

The maximum number of items to return per page. Defaults to 100 if not specified.

cursorstring or nullOptional

A cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

Response

Run history
resultslist of objects
The list of items returned for the current page.
paginationobject or nullOptional
Contains pagination information for the result set.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error