Delete a custom tool

Hard-delete a custom tool. Removed from every agent that referenced it.

DELETE /api/v1/custom_tools/:id

Hard delete. Custom tools have no trash UI. The tool is removed and pulled from every agent.tools[] array in the org in the same transaction.

Scope: custom_tools:delete

Path parameters

Param	Type
`:id`	string

curl -X DELETE https://dashboard.getmacha.com/api/v1/custom_tools/tool_64f1c0... \
  -H "Authorization: Bearer $MACHA_API_KEY"

{
  "data": { "id": "tool_64f1c0...", "deleted": true },
  "meta": { "request_id": "req_..." }
}

Status	Code	When
`404`	`custom_tool_not_found`	Unknown ID or already deleted.

⚠

Cascade is automatic

Every agent that referenced this tool has it pulled from its tools[] array. Affected agents keep working, just without this tool.