# Elastic Stack (ELK Stack) agent builder API **Canonical:** https://apis.io/apis/elk-stack/elk-stack-agent-builder-api/ **Provider:** Elastic Stack (ELK Stack) — https://apis.io/providers/elk-stack/ **Base URL:** https://{elasticsearch_endpoint} **Documentation:** https://www.elastic.co/docs/api/doc/elasticsearch/ Elastic Stack (ELK Stack) agent builder API is one of 132 APIs that [Elastic Stack (ELK Stack)](https://apis.io/providers/elk-stack/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agent Builder. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference. Agent Builder is a set of AI-powered capabilities for developing and interacting with agents that work with your Elasticsearch data. Most users will probably want to integrate with Agent Builder using MCP or A2A, but you can also work programmatically with tools, agents, and conversations using these Kibana APIs. Follow the [Agent Builder API tutorial](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/agent-builder-api-tutorial) for a guided example. **Elastic Agent Builder requires an Enterprise subscription.** ## Operations (41) | Method | Path | Summary | |---|---|---| | POST | `/api/agent_builder/a2a/{agentId}` | Send A2A task | | GET | `/api/agent_builder/a2a/{agentId}.json` | Get A2A agent card | | GET | `/api/agent_builder/agents` | List agents | | POST | `/api/agent_builder/agents` | Create an agent | | POST | `/api/agent_builder/agents/{agent_id}/consumption` | Get agent consumption data | | DELETE | `/api/agent_builder/agents/{id}` | Delete an agent | | GET | `/api/agent_builder/agents/{id}` | Get an agent by ID | | PUT | `/api/agent_builder/agents/{id}` | Update an agent | | GET | `/api/agent_builder/agents/{id}/access_control` | Get an agent's access control list | | PUT | `/api/agent_builder/agents/{id}/access_control` | Update an agent's access control list | | GET | `/api/agent_builder/conversations` | List conversations | | POST | `/api/agent_builder/conversations` | Create conversation | | DELETE | `/api/agent_builder/conversations/{conversation_id}` | Delete conversation by ID | | GET | `/api/agent_builder/conversations/{conversation_id}` | Get conversation by ID | | PUT | `/api/agent_builder/conversations/{conversation_id}/access_control` | Update a conversation's access control | | GET | `/api/agent_builder/conversations/{conversation_id}/attachments` | List conversation attachments | | POST | `/api/agent_builder/conversations/{conversation_id}/attachments` | Create conversation attachment | | DELETE | `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}` | Delete conversation attachment | | PATCH | `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}` | Rename attachment | | PUT | `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}` | Update conversation attachment | | POST | `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}/_restore` | Restore deleted attachment | | PUT | `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}/origin` | Update attachment origin | | GET | `/api/agent_builder/conversations/{conversation_id}/attachments/stale` | Check attachment staleness | | POST | `/api/agent_builder/converse` | Send chat message | | POST | `/api/agent_builder/converse/async` | Send chat message (streaming) | | POST | `/api/agent_builder/mcp` | MCP server | | GET | `/api/agent_builder/plugins` | List plugins | | DELETE | `/api/agent_builder/plugins/{pluginId}` | Delete a plugin | | GET | `/api/agent_builder/plugins/{pluginId}` | Get a plugin by id | | POST | `/api/agent_builder/plugins/install` | Install a plugin | | GET | `/api/agent_builder/skills` | List skills | | POST | `/api/agent_builder/skills` | Create a skill | | DELETE | `/api/agent_builder/skills/{skillId}` | Delete a skill | | GET | `/api/agent_builder/skills/{skillId}` | Get a skill by id | | PUT | `/api/agent_builder/skills/{skillId}` | Update a skill | | GET | `/api/agent_builder/tools` | List tools | | POST | `/api/agent_builder/tools` | Create a tool | | POST | `/api/agent_builder/tools/_execute` | Run a tool | | DELETE | `/api/agent_builder/tools/{toolId}` | Delete a tool | | GET | `/api/agent_builder/tools/{toolId}` | Get a tool by id | | PUT | `/api/agent_builder/tools/{toolId}` | Update a tool | ## Machine-readable artifacts (8) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/elk-stack/refs/heads/main/openapi/elk-stack-agent-builder-api-openapi.yml - **Documentation** — https://www.elastic.co/docs/reference/elasticsearch - **APIReference** — https://www.elastic.co/docs/api/doc/elasticsearch/ - **SourceCode** — https://github.com/elastic/elasticsearch-specification - **Documentation** — https://www.elastic.co/docs/reference/kibana - **APIReference** — https://www.elastic.co/docs/api/doc/kibana/ - **SourceCode** — https://github.com/elastic/kibana - **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/elk-stack/refs/heads/main/mcp/elk-stack-tool-crosswalk.yml ## Other Elastic Stack (ELK Stack) APIs (12) - [Elastic Cloud API](https://apis.io/apis/elk-stack/elastic-cloud-api/) - [Elastic Stack (ELK Stack) Accounts API](https://apis.io/apis/elk-stack/elk-stack-accounts-api/) - [Elastic Stack (ELK Stack) Actions API](https://apis.io/apis/elk-stack/elk-stack-actions-api/) - [Elastic Stack (ELK Stack) Alerting API](https://apis.io/apis/elk-stack/elk-stack-alerting-api/) - [Elastic Stack (ELK Stack) Alerting V2 API](https://apis.io/apis/elk-stack/elk-stack-alerting-v2-api/) - [Elastic Stack (ELK Stack) Analytics API](https://apis.io/apis/elk-stack/elk-stack-analytics-api/) - [Elastic Stack (ELK Stack) APM agent configuration API](https://apis.io/apis/elk-stack/elk-stack-apm-agent-configuration-api/) - [Elastic Stack (ELK Stack) APM agent keys API](https://apis.io/apis/elk-stack/elk-stack-apm-agent-keys-api/) - [Elastic Stack (ELK Stack) APM annotations API](https://apis.io/apis/elk-stack/elk-stack-apm-annotations-api/) - [Elastic Stack (ELK Stack) APM server schema API](https://apis.io/apis/elk-stack/elk-stack-apm-server-schema-api/) - [Elastic Stack (ELK Stack) APM sourcemaps API](https://apis.io/apis/elk-stack/elk-stack-apm-sourcemaps-api/) - [Elastic Stack (ELK Stack) Authentication API](https://apis.io/apis/elk-stack/elk-stack-authentication-api/) ## Tags Agent Builder --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/elk-stack/elk-stack-agent-builder-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/elk-stack/.