Sign in

v3

latestOpenAPI 3.0.02026-08-081996601.2 MB
A2A Protocol

List A2A v1 tasks

Lists the agent's tasks. Results are paginated. Optional query parameters filter by conversation context and lifecycle state.

get/v2/agents/{agent_key}/tasks

Path parameters

agent_keystring required

A unique key that identifies an agent.

Example:customer_support

The unique key of the agent.

Query parameters

contextIdstring

Only return tasks belonging to this conversation context.

status'TASK_STATE_UNSPECIFIED' | 'TASK_STATE_SUBMITTED' | 'TASK_STATE_WORKING' | 'TASK_STATE_COMPLETED' | 'TASK_STATE_FAILED' | 'TASK_STATE_CANCELED' | 'TASK_STATE_INPUT_REQUIRED' | 'TASK_STATE_REJECTED' | 'TASK_STATE_AUTH_REQUIRED'

The A2A v1 task lifecycle state. TASK_STATE_CANCELED uses the US spelling (one L), as defined in the A2A v1 specification.

Only return tasks currently in this lifecycle state.

pageSizeinteger

Maximum number of tasks to return per page.

pageTokenstring

Token from a previous response's nextPageToken used to fetch the next page.

historyLengthinteger

Maximum number of recent events to include per task. 0 (the default) returns tasks without history. Values above 100 are capped to 100.

statusTimestampAfterstring date-time

ISO-8601 timestamp; only tasks whose status last changed at or after this value are returned.

includeArtifactsboolean

When true, include each task's produced artifacts in the response.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Response

A page of tasks.

nextPageTokenstring required

Token to retrieve the next page of results. Empty when there are no further pages.

pageSizeinteger required

Number of tasks requested per page.

totalSizeinteger required

Total number of tasks matching the query across all pages.