GoRunner

Delete a workflow permanently

Requires scope workflow:delete
DELETE
/api/workflows/{id}

Deletes 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
AuthorizationBearer <token>

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

id*string

Workflow id. A value that is not a UUID is a 400, not a 404.

Formatuuid

Response 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"  }}