Delete Workflow

Delete a private workflow and its drafts, versions, and triggers.

DELETE /api/v2/public/workflow/:workflow_id

cURL

curl -X DELETE "https://app.refold.ai/api/v2/public/workflow/{workflow_id}" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

200

{
  "success": true,
  "triggers_deregistered": true
}

Delete a workflow along with all its drafts and versions, and deregister its triggers. The response indicates whether trigger deregistration fully succeeded.

A version-snapshot workflow cannot be deleted directly — delete the parent (published) workflow instead.

Authentication

This endpoint requires a session token; it deletes the linked account’s private workflow.

Authorization · string · required

Session token for the linked account.

Format: Bearer YOUR_SESSION_TOKEN

Path Parameters

workflow_id · string · required

The published workflow ID to delete (from List Workflows or the publish response). Deleting a draft/version snapshot directly is rejected.

Response

200 OK

success · boolean

Whether the workflow was deleted.

triggers_deregistered · boolean

Whether all triggers were fully deregistered.

400 Bad Request

Returned, for example, when targeting a version-snapshot workflow.

200

{
  "success": true,
  "triggers_deregistered": true
}

cURL

curl -X DELETE "https://app.refold.ai/api/v2/public/workflow/{workflow_id}" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"