v3

latestOpenAPI 3.0.02026-08-081996601.2 MB
A2A Protocol

Get A2A v0.3 task

Returns the current state of an A2A task, including its status, conversation history, and any produced artifacts.

get/v2/agents/{agent_key}/v1/tasks/{task_id}

Path parameters

agent_keystring required

A unique key that identifies an agent.

Example:customer_support

The unique key of the agent.

task_idstring required

The A2A task id, as returned in task.id. Opaque — do not construct or parse.

Query parameters

historyLengthinteger

Maximum number of historical messages to include. 0 means unlimited.

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

The current state of the task.

idstring required

Unique identifier of the task.

contextIdstring

Identifier of the conversation context the task belongs to.

metadataobject nullable

Arbitrary agent-supplied metadata for the task.