Delete a tool

DELETE 
/api/v1/tools/:tool_id

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.

Request

Responses

204

Deleted

400

Invalid request — a query parameter or body field the operation does not declare, or a value that fails validation

401

Unauthorized

403

Forbidden

404

Not found

409

The tool is a decider's backend, or has accepted shares and force is not set

429

QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens

Response Headers

Retry-After

Seconds until the quota window admits a request again

500

Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded