v2

latestOpenAPI 3.0.02026-08-051996591.2 MB
A2A Protocol

Send A2A v0.3 message

Sends a message to the agent. 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}/v1/message:send

Path parameters

agent_keystring required

A unique key that identifies an agent.

Example:customer_support

The unique key of the agent to interact with.

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

metadataobject nullable

Arbitrary client-supplied metadata for the request.

Response

The send-message response — exactly one of task or message.