v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
agent builder

Create a tool

Spaces method and path for this operation:

<div><span class="operation-verb post">post</span>&nbsp;<span class="operation-path">/s/{space_id}/api/agent_builder/tools</span></div>

Refer to Spaces for more information.

Create a new tool. Use this endpoint to define a custom tool with specific functionality and configuration for use by agents. To learn more about Agent Builder tools, refer to the tools documentation.<br/><br/>[Required authorization] Route required privileges: agentBuilder:manageTools.

post/api/agent_builder/tools

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

configurationobject required

Tool-specific configuration parameters. See examples for details.

descriptionstring

Description of what the tool does.

idstring required

Unique identifier for the tool.

tagsstring[]

Optional tags for categorizing and organizing tools.

type'esql' | 'index_search' | 'workflow' | 'mcp' required

The type of tool to create (e.g., esql, index_search).

Response

Indicates a successful response