Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer

Path Parameters

agentId
string
required

ID of the receiving agent that owns the task

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
taskId
string
required

ID of the task to update

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$

Body

application/json

Owner-driven A2A task status transition (the receiving agent reports working/completed/failed)

status
enum<string>
required

New task status. Terminal states (completed/failed/canceled) are immutable once reached.

Available options:
working,
input_required,
completed,
failed
output
object

Task output payload (typically set when completing)

error
object

Error details — only allowed when status is 'failed'

message
string

Human-readable annotation recorded in the task history

Maximum string length: 2000

Response

200 - application/json

OK

Full A2A task representation

id
string
required

Unique task identifier

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
agentId
string
required

ID of the receiving agent

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
orgId
string
required

Organization that owns the receiving agent

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
fromDid
string
required

Sender DID

toDid
string
required

Receiver DID

type
string
required

Task type

status
enum<string>
required

Current status of the A2A task

Available options:
submitted,
working,
input_required,
completed,
failed,
canceled
input
object
required

Task input payload

output
object | null
required

Task output payload

error
object | null
required

Error details if task failed

history
object[]
required

Status change history

createdAt
string<date-time>
required

Task creation timestamp

updatedAt
string<date-time>
required

Last update timestamp