Skip to main content
POST
Stream a message (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"

Body

application/json

The message to send to the agent.

Request body for sending a message to an agent.

message
object
required

An A2A message — an ordered list of content parts with a role.

configuration
object

Per-request options controlling how a message is processed.

metadata
object

Free-form request metadata.

Example:
tenant
string

Optional. Opaque routing identifier. Must match the tenant value from the selected AgentInterface in the Agent Card when that field is set.

Response

An SSE stream of streaming responses. Each event's data is a JSON-encoded StreamResponse (Task, statusUpdate, or artifactUpdate).

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