Send A2A task

Base URL: https://{kibana_url}

POST /api/agent_builder/a2a/{agentId}
POST /s/{space_id}/api/agent_builder/a2a/{agentId}

Auth

Warning

This endpoint is designed for A2A protocol clients and should not be used directly via REST APIs. Use an A2A SDK or A2A Inspector instead.

To learn more about the Agent Builder A2A server, refer to the A2A server documentation.

Required authorization

Privileges agentBuilder:read

Path parameters

space_id string optional: An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.
agentId string required: The unique identifier of the agent to send the A2A task to.

Request body

Type: object

Response

200

Indicates a successful response

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Warning

DO NOT USE THIS ENDPOINT VIA REST API. These examples are auto-generated and should not be run. Integrate with A2A using an A2A SDK or A2A Inspector instead.

Console Kibana Dev Tools

POST kbn:/api/agent_builder/a2a/AGENT_ID
{
  "id": "task-123",
  "jsonrpc": "2.0",
  "method": "complete",
  "params": {
    "messages": [
      {
        "content": "Hello from A2A protocol",
        "role": "user"
      }
    ]
  }
}

Generated from the API spec

curl Shell

curl -X POST "${KIBANA_URL}/api/agent_builder/a2a/${AGENT_ID}" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "task-123",
    "jsonrpc": "2.0",
    "method": "complete",
    "params": {
      "messages": [
        {
          "content": "Hello from A2A protocol",
          "role": "user"
        }
      ]
    }
  }'

Generated from the API spec

Response

Example response from A2A Task Endpoint with results of task execution

{
  "id": "task-123",
  "jsonrpc": "2.0",
  "result": {
    "conversation_id": "conv-456",
    "response": {
      "message": "Hello! How can I help you today?"
    },
    "type": "response"
  }
}