Skip to main content
POST
Send 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

The resulting task or agent message.

Exactly one of task or message is present.

task
object
required

An A2A task — a unit of agent work with status, history, and artifacts.

message
object

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