Skip to main content
DELETE
Delete a tool
  • A Business Owner or Admin, or a Personal account’s owner, can delete any tool their team created. Anyone else can delete only tools they created; others answer forbidden.
  • The tool leaves every list and stops running, including runs already started.
  • The rest of its integration stays. An integration left with no tools is removed too, with its MCP and everything bound to it.
  • This can’t be undone.
  • Callers: an API key, an MCP OAuth token or a Dashboard session.
  • Permission: tools:build.
  • Effect: Removes or replaces something, and can’t be undone.
  • Errors: not_found, and the errors any request can get.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

a tool ID: tool_ and 32 lowercase hex digits

Example:

"tool_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"

Response

Deleted