v53

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

Delete a tool

Spaces method and path for this operation:

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

Refer to Spaces for more information.

Delete a tool by ID. This action cannot be undone. To learn more about Agent Builder tools, refer to the tools documentation.<br/><br/>[Required authorization] Route required privileges: agentBuilder:manageTools.

delete/api/agent_builder/tools/{toolId}

Path parameters

toolIdstring required

The unique identifier of the tool to delete.

Query parameters

forceboolean

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.

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Response

Indicates a successful response