---
type: api
title: Agent Builder
description: Agent Builder is a set of AI-powered capabilities for developing and interacting with agents that work with your Elasticsearch data.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/group/endpoint-agent-builder
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/group/endpoint-agent-builder
products:
  - Kibana
---

# Agent Builder

`agent builder`

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.**

[Agent Builder docs](https://www.elastic.co/docs/solutions/search/agent-builder/programmatic-access)

- [Send A2A task](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-a2a-agentid): `POST` `/api/agent_builder/a2a/{agentId}`
- [Get A2A agent card](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-a2a-agentid-json): `GET` `/api/agent_builder/a2a/{agentId}.json`
- [List agents](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-agents): `GET` `/api/agent_builder/agents`
- [Create an agent](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-agents): `POST` `/api/agent_builder/agents`
- [Get agent consumption data](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-agents-agent-id-consumption): `POST` `/api/agent_builder/agents/{agent_id}/consumption`
- [Delete an agent](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-delete-agent-builder-agents-id): `DELETE` `/api/agent_builder/agents/{id}`
- [Get an agent by ID](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-agents-id): `GET` `/api/agent_builder/agents/{id}`
- [Update an agent](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-put-agent-builder-agents-id): `PUT` `/api/agent_builder/agents/{id}`
- [Get an agent's access control list](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-agents-id-access-control): `GET` `/api/agent_builder/agents/{id}/access_control`
- [Update an agent's access control list](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-put-agent-builder-agents-id-access-control): `PUT` `/api/agent_builder/agents/{id}/access_control`
- [List conversations](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-conversations): `GET` `/api/agent_builder/conversations`
- [Create conversation](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-conversations): `POST` `/api/agent_builder/conversations`
- [Delete conversation by ID](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-delete-agent-builder-conversations-conversation-id): `DELETE` `/api/agent_builder/conversations/{conversation_id}`
- [Get conversation by ID](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-conversations-conversation-id): `GET` `/api/agent_builder/conversations/{conversation_id}`
- [Add events to a conversation](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-conversations-conversation-id-add-events): `POST` `/api/agent_builder/conversations/{conversation_id}/_add_events`
- [Update a conversation's access control](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-put-agent-builder-conversations-conversation-id-access-control): `PUT` `/api/agent_builder/conversations/{conversation_id}/access_control`
- [List conversation attachments](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-conversations-conversation-id-attachments): `GET` `/api/agent_builder/conversations/{conversation_id}/attachments`
- [Create conversation attachment](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-conversations-conversation-id-attachments): `POST` `/api/agent_builder/conversations/{conversation_id}/attachments`
- [Delete conversation attachment](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-delete-agent-builder-conversations-conversation-id-attachments-attachment-id): `DELETE` `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}`
- [Get conversation attachment](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-conversations-conversation-id-attachments-attachment-id): `GET` `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}`
- [Rename attachment](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-patch-agent-builder-conversations-conversation-id-attachments-attachment-id): `PATCH` `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}`
- [Update conversation attachment](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-put-agent-builder-conversations-conversation-id-attachments-attachment-id): `PUT` `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}`
- [Restore deleted attachment](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-conversations-conversation-id-attachments-attachment-id-restore): `POST` `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}/_restore`
- [Update attachment origin](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-put-agent-builder-conversations-conversation-id-attachments-attachment-id-origin): `PUT` `/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}/origin`
- [Check attachment staleness](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-conversations-conversation-id-attachments-stale): `GET` `/api/agent_builder/conversations/{conversation_id}/attachments/stale`
- [Send chat message](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-converse): `POST` `/api/agent_builder/converse`
- [Send chat message (streaming)](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-converse-async): `POST` `/api/agent_builder/converse/async`
- [MCP server](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-mcp): `POST` `/api/agent_builder/mcp`
- [List plugins](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-plugins): `GET` `/api/agent_builder/plugins`
- [Delete a plugin](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-delete-agent-builder-plugins-pluginid): `DELETE` `/api/agent_builder/plugins/{pluginId}`
- [Get a plugin by id](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-plugins-pluginid): `GET` `/api/agent_builder/plugins/{pluginId}`
- [Install a plugin](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-plugins-install): `POST` `/api/agent_builder/plugins/install`
- [List skills](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-skills): `GET` `/api/agent_builder/skills`
- [Create a skill](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-skills): `POST` `/api/agent_builder/skills`
- [Delete a skill](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-delete-agent-builder-skills-skillid): `DELETE` `/api/agent_builder/skills/{skillId}`
- [Get a skill by id](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-skills-skillid): `GET` `/api/agent_builder/skills/{skillId}`
- [Update a skill](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-put-agent-builder-skills-skillid): `PUT` `/api/agent_builder/skills/{skillId}`
- [List tools](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-tools): `GET` `/api/agent_builder/tools`
- [Create a tool](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-tools): `POST` `/api/agent_builder/tools`
- [Run a tool](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-post-agent-builder-tools-execute): `POST` `/api/agent_builder/tools/_execute`
- [Delete a tool](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-delete-agent-builder-tools-toolid): `DELETE` `/api/agent_builder/tools/{toolId}`
- [Get a tool by id](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-get-agent-builder-tools-toolid): `GET` `/api/agent_builder/tools/{toolId}`
- [Update a tool](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v0/operation/operation-put-agent-builder-tools-toolid): `PUT` `/api/agent_builder/tools/{toolId}`