Skip to main content
GET
Get a task within a context

Authorizations

Authorization
string
header
required

OAuth 2.0 / OIDC bearer token.

Tenant-Name
string
header
required

The tenant the request operates within.

Path Parameters

contextId
string<context-id>
required

Context identifier (prefixed UUIDv7). 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"

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"

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: