Delete Workflow Tool

DELETE /workflows/:id/tools/:toolId Remove a custom tool. By default this soft-disables it (is_active: false) so past calls stay in history; pass ?hard=true to permanently delete the row.

Path Parameters

Parameter	Type	Required	Description
`id`	string (uuid)	Yes	Agent ID
`toolId`	string (uuid)	Yes	Tool ID

Query Parameters

Parameter	Type	Required	Description
`hard`	boolean	No	`true` permanently deletes the tool instead of disabling it

Responses

`200` — Disabled (default)

{
  "success": true,
  "tool_id": "9a1b2c3d-0000-4000-8000-000000000001",
  "status": "disabled"
}

`200` — Deleted (`?hard=true`)

{
  "success": true,
  "tool_id": "9a1b2c3d-0000-4000-8000-000000000001",
  "status": "deleted"
}

`401` — Authentication error

See Authentication.

`404` — Not found

{
  "error": "Not found",
  "message": "Workflow not found"
}

`500` — Internal server error

Last modified on July 10, 2026

Update Workflow Tool

Set Stage Gate

​Path Parameters

​Query Parameters

​Responses

​200 — Disabled (default)

​200 — Deleted (?hard=true)

​401 — Authentication error

​404 — Not found

​500 — Internal server error