---
title: "Delete a custom AI tool"
method: DELETE
path: "/tools/{toolId}"
tags: ["Custom tools"]
deprecated: true
---

# Delete a custom AI tool

`DELETE /tools/{toolId}`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/tools/{toolId}`
- Auth: HTTP bearer

> **Deprecated.**

Requires `tools:write`. Deprecated compatibility API; unchanged behavior and legacy scope. Migrate to delete_action, actions:write. Use actionId=http:<toolId>; diagnosticId=logId. New grants must be explicitly approved. No retirement date is assigned. See /api-docs/actions-api#tools-migration.

## Path parameters

- `toolId` string, required

## Response `200`

Delete result

- ToolDeleteResponse
  - `ok` boolean, required
  - `toolId` string, required
  - `changed` boolean, required

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)