Archive or delete a workflow

posthttps://api.expiryedge.com/v1/deleteWorkflow
bearer token (Firebase ID token or session JWT); role editor or admin60/minAny method
Request
curl -X POST 'https://api.expiryedge.com/v1/deleteWorkflow?id=wf_3Kd9Tx&permanent=false' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "permanent": true
}'
Response
{
  "message": "Workflow archived successfully"
}

Archives the workflow (status: archived) by default. With permanent=true (query or body) it deletes the workflow, its sections and steps. Either way, expiry workflow attachments that use it are cancelled. Existing runs are kept. The web app sends DELETE; any HTTP method is accepted.

Query parameters

  • idstringrequired
    Workflow id.
  • permanentboolean
    Delete permanently instead of archiving (may also be sent in the body).
    Default false

Body parameters

application/json
  • permanentboolean

Returns

200
Archived or deleted.
  • messagestringrequired

Errors

400
The request is missing required fields or contains invalid values.
401
Missing, expired or invalid bearer token.
403
Authenticated, but your role or organization does not allow this action.
404
The record does not exist or is not in your organization.
429
Too many requests for this endpoint from your IP. Wait Retry-After seconds.
500
Unexpected server error. Retry later; quote requestId to support.