Delete Workflow
Workflows
Delete Workflow
Remove a workflow. Historical trigger logs are retained for audit.
DELETE
Delete Workflow
Request
Deleting a workflow removes it from the evaluation path immediately. Historical trigger logs are retained and can still be fetched viaGET /v1/workflows/{id}/logs. To pause without deleting, prefer PATCH /v1/workflows/{id} with enabled: false.
Path Parameters
Workflow UUID.
Headers
Optional UUID. Repeated DELETEs with the same key return the same result without erroring.
Response
On success returns HTTP204 No Content. The response carries standard rate-limit headers and X-Request-ID.
Example Response
Errors
| Status | Code | Description |
|---|---|---|
| 401 | invalid_key | Invalid or expired API key |
| 403 | insufficient_permissions | Missing write:workflows permission |
| 404 | not_found | Workflow not found |
| 429 | rate_limited | Rate limit exceeded |