{ "opencollection": "1.0.0", "info": { "name": "Kibana APIs Actions agent builder API", "version": "1.0" }, "request": { "auth": { "type": "apikey", "key": "Authorization", "value": "{{Authorization}}", "placement": "header" } }, "items": [ { "info": { "name": "agent builder", "type": "folder" }, "items": [ { "info": { "name": "Send A2A task", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/a2a/:agentId", "params": [ { "name": "agentId", "value": "", "type": "path", "description": "The unique identifier of the agent to send the A2A task to." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/a2a/{agentId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\n> warn\n> 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.

[Required authorization] Route required privileges: " }, { "info": { "name": "Get A2A agent card", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/a2a/:agentId.json", "params": [ { "name": "agentId", "value": "", "type": "path", "description": "The unique identifier of the agent to get A2A metadata for." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/a2a/{agentId}.json
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet agent discovery metadata in JSON format. Use this endpoint to provide agent information for A2A protocol integration and discovery.

[Required authorization] Route required privileges: agentBuil" }, { "info": { "name": "List agents", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/agents" }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/agents
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nList all available agents. Use this endpoint to retrieve complete agent information including their current configuration and assigned tools. To learn more, refer to the [agents documentation](https://www.elastic.co/do" }, { "info": { "name": "Create an agent", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/agents", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/agents
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nCreate a new agent. Use this endpoint to define the agent's behavior, appearance, and capabilities through comprehensive configuration options. To learn more, refer to the [agents documentation](https://www.elastic.c" }, { "info": { "name": "Get agent consumption data", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/agents/:agent_id/consumption", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "agent_id", "value": "", "type": "path", "description": "The unique identifier of the agent." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/agents/{agent_id}/consumption
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nReturns paginated, per-conversation token consumption data for a given agent. Includes input/output token counts, round counts, LLM call counts, and warnings for conversations with high token u" }, { "info": { "name": "Get an agent by ID", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/agents/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The unique identifier of the agent to retrieve." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/agents/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet a specific agent by ID. Use this endpoint to retrieve the complete agent definition including all configuration details and tool assignments. To learn more, refer to the [agents documentation](https://www.elas" }, { "info": { "name": "Update an agent", "type": "http" }, "http": { "method": "PUT", "url": "https://{kibana_url}/api/agent_builder/agents/:id", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The unique identifier of the agent to update." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
put /s/{space_id}/api/agent_builder/agents/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nUpdate an existing agent configuration. Use this endpoint to modify any aspect of the agent's behavior, appearance, or capabilities. To learn more, refer to the [agents documentation](https://www.elastic.co/docs/e" }, { "info": { "name": "Delete an agent", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kibana_url}/api/agent_builder/agents/:id", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The unique identifier of the agent to delete." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
delete /s/{space_id}/api/agent_builder/agents/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete an agent by ID. This action cannot be undone. To learn more, refer to the [agents documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/agent-builder-agents).

[" }, { "info": { "name": "List conversations", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/conversations", "params": [ { "name": "agent_id", "value": "", "type": "query", "description": "Optional agent ID to filter conversations by a specific agent." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/conversations
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nList all conversations for a user. Use the optional agent ID to filter conversations by a specific agent.

[Required authorization] Route required privileges: agentBuilder:read." }, { "info": { "name": "Get conversation by ID", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id", "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation to retrieve." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/conversations/{conversation_id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet a specific conversation by ID. Use this endpoint to retrieve the complete conversation history including all messages and metadata.

[Required authorization] Route required privileg" }, { "info": { "name": "Delete conversation by ID", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation to delete." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
delete /s/{space_id}/api/agent_builder/conversations/{conversation_id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete a conversation by ID. This action cannot be undone.

[Required authorization] Route required privileges: agentBuilder:read." }, { "info": { "name": "List conversation attachments", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id/attachments", "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation." }, { "name": "include_deleted", "value": "", "type": "query", "description": "Whether to include deleted attachments in the list." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nList all attachments for a conversation. Use the optional include_deleted query parameter to include soft-deleted attachments.

[Required authorization] Route required privi" }, { "info": { "name": "Create conversation attachment", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id/attachments", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nCreate a new attachment for a conversation with version tracking.

[Required authorization] Route required privileges: agentBuilder:read." }, { "info": { "name": "Update conversation attachment", "type": "http" }, "http": { "method": "PUT", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id/attachments/:attachment_id", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation." }, { "name": "attachment_id", "value": "", "type": "path", "description": "The unique identifier of the attachment to update." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
put /s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nUpdate an attachment content. Creates a new version if content changed.

[Required authorization] Route required privileges: agentBuilder:read." }, { "info": { "name": "Rename attachment", "type": "http" }, "http": { "method": "PATCH", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id/attachments/:attachment_id", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation." }, { "name": "attachment_id", "value": "", "type": "path", "description": "The unique identifier of the attachment to rename." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
patch /s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nRename an attachment without creating a new version.

[Required authorization] Route required privileges: agentBuilder:read." }, { "info": { "name": "Delete conversation attachment", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id/attachments/:attachment_id", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation." }, { "name": "attachment_id", "value": "", "type": "path", "description": "The unique identifier of the attachment to delete." }, { "name": "permanent", "value": "", "type": "query", "description": "If true, permanently removes the attachment (only for unreferenced attachments)." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
delete /s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete an attachment. By default performs a soft delete (can be restored). Use permanent=true to permanently remove unreferenced attachments.

[Require" }, { "info": { "name": "Restore deleted attachment", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id/attachments/:attachment_id/_restore", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation." }, { "name": "attachment_id", "value": "", "type": "path", "description": "The unique identifier of the attachment to restore." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}/_restore
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nRestore a soft-deleted attachment.

[Required authorization] Route required privileges: agentBuilder:read." }, { "info": { "name": "Update attachment origin", "type": "http" }, "http": { "method": "PUT", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id/attachments/:attachment_id/origin", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation." }, { "name": "attachment_id", "value": "", "type": "path", "description": "The unique identifier of the attachment to update." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
put /s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}/origin
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nUpdate the origin reference for an attachment. Use this after saving a by-value attachment to link it to its persistent store.

[Required authorizatio" }, { "info": { "name": "Check attachment staleness", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/conversations/:conversation_id/attachments/stale", "params": [ { "name": "conversation_id", "value": "", "type": "path", "description": "The unique identifier of the conversation." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments/stale
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nChecks staleness for the latest version of all conversation attachments against their origin snapshot.

[Required authorization] Route required privileges: agentBuilde" }, { "info": { "name": "Send chat message", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/converse", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/converse
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nSend a message to an agent and receive a complete response. This synchronous endpoint waits for the agent to fully process your request before returning the final result. Use this for simple chat interactions where" }, { "info": { "name": "Send chat message (streaming)", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/converse/async", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/converse/async
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nSend a message to an agent and receive real-time streaming events. This asynchronous endpoint provides live updates as the agent processes your request, allowing you to see intermediate steps and progress. Us" }, { "info": { "name": "MCP server", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/mcp", "params": [ { "name": "namespace", "value": "", "type": "query", "description": "Comma-separated list of namespaces to filter tools. Only tools matching the specified namespaces will be returned." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/mcp
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\n> warn\n> This endpoint is designed for MCP clients (Claude Desktop, Cursor, VS Code, etc.) and should not be used directly via REST APIs. Use MCP Inspector or native MCP clients instead.\nTo learn more, refer to the [MCP" }, { "info": { "name": "List plugins", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/plugins" }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/plugins
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nList all installed plugins and their managed assets. Plugins are installable packages that bundle agent capabilities such as skills, following the [Claude agent plugin specification](https://code.claude.com/docs/en/pl" }, { "info": { "name": "Get a plugin by id", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/plugins/:pluginId", "params": [ { "name": "pluginId", "value": "", "type": "path", "description": "The unique identifier of the plugin." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/plugins/{pluginId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet a specific plugin by ID.

[Required authorization] Route required privileges: agentBuilder:read." }, { "info": { "name": "Delete a plugin", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kibana_url}/api/agent_builder/plugins/:pluginId", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "pluginId", "value": "", "type": "path", "description": "The unique identifier of the plugin." }, { "name": "force", "value": "", "type": "query", "description": "If true, removes the plugin skills from agents that use them and then deletes the plugin. If false and any agent uses the plugin skills, the request returns 409 Conflict with the list of agents." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
delete /s/{space_id}/api/agent_builder/plugins/{pluginId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete an installed plugin by ID. This action cannot be undone.

[Required authorization] Route required privileges: agentBuilder:write." }, { "info": { "name": "Install a plugin", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/plugins/install", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/plugins/install
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nInstall a plugin from a [GitHub Claude plugin URL](https://code.claude.com/docs/en/plugins) or a direct ZIP URL. Plugins bundle agent capabilities such as skills.

[Required authorization] Route requ" }, { "info": { "name": "List skills", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/skills", "params": [ { "name": "include_plugins", "value": "", "type": "query", "description": "Set to true to include skills from plugins." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/skills
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nList all available skills (built-in and user-created).

[Required authorization] Route required privileges: agentBuilder:read." }, { "info": { "name": "Create a skill", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/skills", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/skills
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nCreate a new user-defined skill.

[Required authorization] Route required privileges: agentBuilder:manageSkills." }, { "info": { "name": "Get a skill by id", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/skills/:skillId", "params": [ { "name": "skillId", "value": "", "type": "path", "description": "The unique identifier of the skill." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/skills/{skillId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet a specific skill by ID.

[Required authorization] Route required privileges: agentBuilder:read." }, { "info": { "name": "Update a skill", "type": "http" }, "http": { "method": "PUT", "url": "https://{kibana_url}/api/agent_builder/skills/:skillId", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "skillId", "value": "", "type": "path", "description": "The unique identifier of the skill." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
put /s/{space_id}/api/agent_builder/skills/{skillId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nUpdate an existing user-created skill.

[Required authorization] Route required privileges: agentBuilder:manageSkills." }, { "info": { "name": "Delete a skill", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kibana_url}/api/agent_builder/skills/:skillId", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "skillId", "value": "", "type": "path", "description": "The unique identifier of the skill." }, { "name": "force", "value": "", "type": "query", "description": "If true, removes the skill from agents that use it and then deletes it. If false and any agent uses the skill, the request returns 409 Conflict with the list of agents." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
delete /s/{space_id}/api/agent_builder/skills/{skillId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete a user-created skill by ID. If agents still reference the skill, the request returns 409 unless force=true, which removes the skill from agents first. Built-in skills cannot be deleted.

" }, { "info": { "name": "List tools", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/tools" }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/tools
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nList all available tools. Use this endpoint to retrieve complete tool definitions including their schemas and configuration requirements. To learn more, refer to the [tools documentation](https://www.elastic.co/docs/exp" }, { "info": { "name": "Create a tool", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/tools", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/tools
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nCreate a new tool. Use this endpoint to define a custom tool with specific functionality and configuration for use by agents. To learn more, refer to the [tools documentation](https://www.elastic.co/docs/explore-analy" }, { "info": { "name": "Run a tool", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/agent_builder/tools/_execute", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/agent_builder/tools/_execute
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nRun a tool with parameters. Use this endpoint to run a tool directly with specified inputs and optional external connector integration. To learn more, refer to the [tools documentation](https://www.elastic.co" }, { "info": { "name": "Get a tool by id", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/agent_builder/tools/:toolId", "params": [ { "name": "toolId", "value": "", "type": "path", "description": "The unique identifier of the tool to retrieve." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/agent_builder/tools/{toolId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet a specific tool by ID. Use this endpoint to retrieve the complete tool definition including its schema and configuration requirements. To learn more, refer to the [tools documentation](https://www.elastic.c" }, { "info": { "name": "Update a tool", "type": "http" }, "http": { "method": "PUT", "url": "https://{kibana_url}/api/agent_builder/tools/:toolId", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "toolId", "value": "", "type": "path", "description": "The unique identifier of the tool to update." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
put /s/{space_id}/api/agent_builder/tools/{toolId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nUpdate an existing tool. Use this endpoint to modify any aspect of the tool's configuration or metadata. To learn more, refer to the [tools documentation](https://www.elastic.co/docs/explore-analyze/ai-features" }, { "info": { "name": "Delete a tool", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kibana_url}/api/agent_builder/tools/:toolId", "headers": [ { "name": "kbn-xsrf", "value": "" } ], "params": [ { "name": "toolId", "value": "", "type": "path", "description": "The unique identifier of the tool to delete." }, { "name": "force", "value": "", "type": "query", "description": "If true, removes the tool from agents that use it and then deletes it. If false and any agent uses the tool, the request returns 409 Conflict with the list of agents." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
delete /s/{space_id}/api/agent_builder/tools/{toolId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete a tool by ID. This action cannot be undone. To learn more, refer to the [tools documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/tools).

[Required author" } ] } ], "bundled": true }