Tools

Delete a tool

Deletes a tool by ID. A tool that is a decider's backend is refused with 409 TOOL_HAS_DEPENDENTS, and so is one another project has accepted a share of, or one of its own project's ingestion rules converts with, until force=true. Every share of the tool is revoked when it is deleted; an ingestion rule keeps its tool_id and fails the documents it matches with CONVERTER_FAILED until repointed.

delete/v1/projects/{project_id}/tools/{tool_id}

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/tools/{tool_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

tool_idstring required

Query parameters

forceboolean

Delete the tool even when another project has accepted a share of it, revoking those shares, or an ingestion rule converts with it. A decider backend still refuses.

Response

Deleted

Changes

No recorded changes to this operation across all 1 revision of this API.