A2A Post

Communicate with an assistant using the Agent-to-Agent Protocol. Sends a JSON-RPC 2.0 message to the assistant.

• Request: Provide an object with jsonrpc, id, method, and optional params.
• Response: Returns a JSON-RPC response with task information or error.

Supported Methods:

• message/send: Send a message to the assistant
• tasks/get: Get the status and result of a task

Notes:

• Supports threaded conversations via thread context
• Messages can contain text and data parts
• Tasks run asynchronously and return completion status

POST /a2a/{assistant_id}

A2A Post

cURL

curl --request POST \
  --url https://api.example.com/a2a/{assistant_id} \
  --header 'Accept: <accept>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "params": {
    "message": {
      "parts": [
        {
          "text": "<string>"
        }
      ],
      "messageId": "<string>"
    },
    "thread": {
      "threadId": "<string>"
    }
  }
}
'

200

{
  "id": "<string>",
  "result": {},
  "error": {
    "code": 123,
    "message": "<string>"
  }
}

Headers

Accept · enum<string> · required

Must be application/json

Available options: application/json

Path Parameters

assistant_id · string<uuid> · required

The ID of the assistant to communicate with

Body

application/json

jsonrpc · enum<string> · required

JSON-RPC version

Available options: 2.0

id · string · required

Request identifier

method · enum<string> · required

The method to invoke

Available options: message/send, tasks/get

params · Message Send Parameters · object

Method parameters

Message Send Parameters

Task Get Parameters

Show child attributes

Response

200

application/json

JSON-RPC response

jsonrpc · enum<string> · required

Available options: 2.0

id · string · required

result · object

Success result containing task information or task details

error · object

Error information if request failed

Show child attributes