v3

latestOpenAPI 3.0.02026-08-081996601.2 MB
A2A Protocol

Send A2A v1 message

Sends a message to the agent using the A2A v1 wire format. Blocks until the agent reaches a terminal or interrupted state. Returns the resulting task, or a direct message reply for stateless interactions.

To continue an existing conversation, set message.contextId to the prior task's id.

post/v2/agents/{agent_key}/message:send

Path parameters

agent_keystring required

A unique key that identifies an agent.

Example:customer_support

The unique key of the agent.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Request body

tenantstring nullable

Tenant identifier the message is sent to.

metadataobject nullable

Arbitrary client-supplied metadata for the request.

Response

Send-message response — exactly one of task or message.