v3
latestOpenAPI 3.0.02026-08-081996601.2 MBA2A 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
Response
The send-message response — exactly one of task or message.