Skip to main content
GET
Get a task (A2A REST)

Authorizations

Authorization
string
header
required

OAuth 2.0 / OIDC bearer token.

Tenant-Name
string
header
required

The tenant the request operates within.

Headers

A2A-Version
string
default:1.0

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.

Pattern: ^\d+\.\d+$

Path Parameters

agentId
string<agent-id>
required

Agent identifier (prefixed UUIDv7). Agent identifier. Accepts agt.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(agt\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"

taskId
string<task-id>
required

Task identifier (prefixed UUIDv7). Task identifier. Accepts task.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(task\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62"

Query Parameters

historyLength
integer

Cap the number of history messages returned.

Required range: x >= 0

Response

The task.

An A2A task — a unit of agent work with status, history, and artifacts.

id
string<task-id>
required

Task identifier. Accepts task.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(task\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62"

contextId
string<context-id>
required

Context identifier. Accepts ctx.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(ctx\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51"

status
object
required

A task's current state, with an optional status message and timestamp.

Example:
history
object[]

Messages exchanged during the task, oldest first.

Example:
artifacts
object[]

Artifacts produced by the task.

Example:
metadata
object

Task metadata, including $usage token/credit accounting. Not yet exposed through the REST binding (deferred); only the JSON-RPC binding populates this field.

Example: