Run Message Agent

Send a message to an Agno Agent (non-streaming). The Agent is identified via the path parameter ''. Optional: Pass user ID via X-User-ID header (recommended) or ‘userId’ in params.message.metadata.

POST /a2a/agents/{id}/v1/message:send

Run Message Agent

cURL

curl --request POST \
  --url https://api.example.com/a2a/agents/{id}/v1/message:send

200

{
  "jsonrpc": "2.0",
  "id": "request-123",
  "result": {
    "task": {
      "id": "task-456",
      "context_id": "context-789",
      "status": "completed",
      "history": [
        {
          "message_id": "msg-1",
          "role": "agent",
          "parts": [
            {
              "kind": "text",
              "text": "Response from agent"
            }
          ]
        }
      ]
    }
  }
}

Path Parameters

id · string · required

Response

200

application/json

Message sent successfully

Represents a successful JSON-RPC response for the message/send method.

result · Task · object · required

Represents a single, stateful operation or conversation between a client and an agent.

Task

Message

Show child attributes

id · string integer

jsonrpc · string · default: 2.0

Allowed value: "2.0"