Skip to main content
DELETE
/
v1
/
workflows
/
{workflow_id}
Delete Workflow
curl --request DELETE \
  --url https://api.example.com/v1/workflows/{workflow_id} \
  --header 'x-api-key: <api-key>'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}
Permanently delete a workflow, its node graph, and all associated resources. This operation cannot be undone.

​
Path Parameters

​
workflow_id
string
required
Unique identifier of the workflow to delete (UUID)

​
Response

Returns HTTP 202 Accepted on successful deletion.

​
Example Request

curl -X DELETE -H "x-api-key: <your-api-key>" \
  "https://api.xpander.ai/v1/workflows/<workflow-id>"

​
Notes

  • This operation is permanent and cannot be undone
  • Active tasks may be terminated

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Path Parameters

​
workflow_id
string
required

Response

Successful Response