Skip to main content
POST
Subscribe to task events (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"

Response

An SSE stream of task events. Each event's data is a JSON-encoded StreamResponse. The server writes event ids but does not yet read the Last-Event-ID request header, so resumption without gaps is not implemented.

An SSE event carrying an A2A HTTP+JSON streaming response.

data
string
required

SSE payload: an A2A HTTP+JSON streaming response.

event
string

Event type. Absent for the default message event.

id
string

Opaque event id. Clients echo the most recent value in the Last-Event-ID header to resume a dropped stream.

retry
integer

Reconnection time in milliseconds the client should use.

Required range: x >= 0