Skip to main content
Version: 2.0

Send A2A v1 message

POST 

/v2/agents/:agent_key/message:send

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.

A message that opens a new session is subject to the agent's run_condition. When it evaluates to false no session is created and the call returns an InvalidRequestError.

Request

Responses

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