Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

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

Path Parameters

fromAgentId
string
required

ID of the sending agent (must belong to the caller's org)

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

Body

application/json

Dispatch an A2A task from one of your agents to another agent by DID

toDid
string
required

Recipient agent DID

Minimum string length: 1
type
string
required

Task type

Required string length: 1 - 200
input
object
required

Task input payload

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