---
type: api
title: Send A2A task
description: > warn
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v0/operation/operation-post-agent-builder-a2a-agentid
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v0/operation/operation-post-agent-builder-a2a-agentid
products:
  - Kibana
---

# Send A2A task

Authentication: required

Availability: Experimental since 9.2

- Server: `https://{kibana_url}`

## Paths

- `POST` `/api/agent_builder/a2a/{agentId}`

#### Path parameters

- `agentId` (string) — required
  The unique identifier of the agent to send the A2A task to.

## Description

> warn
> 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](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/a2a-server).

## Required authorization

- Privileges: `agentBuilder:read`

## Request body

`application/json`

Type: `object`


## Response

Indicates a successful response

`application/json`

## Code examples

#### Console

```console
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"
      }
    ]
  }
}
```

#### curl

```curl
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"
        }
      ]
    }
  }'
```

## Response examples

#### A2a task response

`application/json`

Example response from A2A Task Endpoint with results of task execution

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