Delete a workflow permanently
workflow:deleteDeletes the workflow and everything hanging off it: its versions, its runs, their step rows, and the offloaded step payloads in object storage. There is no soft delete, no undo and no confirmation step. A published workflow is deleted without being unpublished first — its webhook URL simply stops resolving.
Deleting a workflow that another workflow references (as a Sub-flow target or an error workflow) is NOT refused; the referencing flow fails at run time instead. This route requires workflow:delete, a separate permission from workflow:write.
Authorization
bearerAuth An API token: Authorization: Bearer grt_…. Mint one in the app under Settings → Workspace → API tokens; the raw value is shown once. Scopes confine the token — see x-permission on each operation.
In: header
Path Parameters
Workflow id. A value that is not a UUID is a 400, not a 404.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api/workflows/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "message": "string" }}