Get a task (A2A REST)
Authorizations
OAuth 2.0 / OIDC bearer token.
The tenant the request operates within.
Headers
A2A protocol version in Major.Minor form (A2A §3.6). Optional; defaults to 1.0 when absent. This surface implements 1.0 only. Patch versions MUST NOT be sent and are not considered during negotiation.
^\d+\.\d+$Path Parameters
Agent identifier (prefixed UUIDv7).
Agent identifier. Accepts agt.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.
^(agt\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"
Task identifier (prefixed UUIDv7).
Task identifier. Accepts task.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.
^(task\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62"
Query Parameters
Cap the number of history messages returned.
x >= 0Response
The task.
An A2A task — a unit of agent work with status, history, and artifacts.
Task identifier. Accepts task.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.
^(task\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62"
Context identifier. Accepts ctx.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.
^(ctx\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51"
A task's current state, with an optional status message and timestamp.
Messages exchanged during the task, oldest first.
Artifacts produced by the task.
Task metadata, including $usage token/credit accounting. Not yet exposed through the REST binding (deferred); only the JSON-RPC binding populates this field.