Skip to content

Delete Workflow DELETE

Overview

Permanently deletes a workflow and all associated data.

Endpoint URL

DELETE /api/workflows/:workflowId

Endpoint Data

Parameter Description Type Required
workflowId The workflow's unique identifier (UUID) String Yes 
This endpoint has no query parameters.

This endpoint has no request body.

Example Request

curl -X DELETE "http://localhost:3026/api/workflows/550e8400-e29b-41d4-a716-446655440000" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -b cookies.txt

Example Response

HTTP/1.1 204 No Content

Error Responses

Status Code Error Description
400 Bad Request Invalid workflow ID format
401 Unauthorized Invalid or missing session
403 Forbidden Cannot delete another user's workflow
404 Not Found Workflow does not exist