---
type: api
title: List agents
description: List all available agents. Use this endpoint to retrieve complete agent information including their current configuration and assigned tools. To learn more about agents, refer to the [agents documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/agent-builder-agents).<br/><br/>[Required authorization] Route required privileges: agentBuilder:read.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-agents
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-agents
products:
  - Kibana
---

# List agents

Availability: 9.2+

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

## Paths

- `GET` `/api/agent_builder/agents`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/kibana/v0/authentication#apikeyauth)
- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/kibana/v0/authentication#basicauth)

## Description

List all available agents. Use this endpoint to retrieve complete agent information including their current configuration and assigned tools. To learn more about agents, refer to the [agents documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/agent-builder-agents).<br/><br/>[Required authorization] Route required privileges: agentBuilder:read.

## Response

Indicates a successful response

## Code Examples

#### Console

```console
GET kbn://api/agent_builder/agents
```

#### curl

```curl
curl \
 -X GET "${KIBANA_URL}/api/agent_builder/agents" \
 -H "Authorization: ApiKey ${API_KEY}"
```

## Response Examples

#### List agents response

Example response that returns one built-in Elastic agent and one created by the user

```json
{
  "results": [
    {
      "access_control": "null",
      "configuration": {
        "tools": [
          {
            "tool_ids": [
              "platform.core.search",
              "platform.core.list_indices",
              "platform.core.get_index_mapping",
              "platform.core.get_document_by_id"
            ]
          }
        ]
      },
      "description": "Elastic AI Agent",
      "id": "elastic-ai-agent",
      "name": "Elastic AI Agent",
      "permissions": {
        "update_access_control": false,
        "update_agent": false
      },
      "type": "chat"
    },
    {
      "access_control": {
        "access_mode": "private",
        "entries": [
          {
            "name": "alice",
            "role": "manager",
            "type": "user"
          }
        ]
      },
      "avatar_color": "#BFDBFF",
      "avatar_symbol": "SI",
      "configuration": {
        "instructions": "You are a custom agent that wants to help searching data using all indices starting with prefix \u0022content-\u0022.",
        "tools": [
          {
            "tool_ids": [
              "platform.core.search",
              "platform.core.list_indices",
              "platform.core.get_index_mapping",
              "platform.core.get_document_by_id"
            ]
          }
        ]
      },
      "description": "Hi! I can help you search the data within the indices starting with \u0022content-\u0022 prefix.",
      "id": "created-agent-id",
      "labels": [
        "custom-indices",
        "department-search"
      ],
      "name": "Search Index Helper",
      "permissions": {
        "update_access_control": true,
        "update_agent": true
      },
      "type": "chat"
    }
  ]
}
```