DELETE /api/workflows/:workflowId — Delete a Workflow

DELETE /api/workflows/:workflowId — Permanently delete a workflow by ID, removing its full definition and all associated run history from your account.

If you no longer need a workflow, you can permanently remove it from your account using the delete endpoint. Submitting a DELETE request with the target workflow’s ID instructs Flowmatic to remove the workflow definition and every run record associated with it. This helps you keep your account tidy and ensures that stale workflows are not accidentally triggered.

Endpoint

DELETE https://api.flowmatic.io/api/workflows/:workflowId

Authentication: Authorization: Bearer <accessToken> header required.
Request body: None.

Deletion is permanent and cannot be undone. When you delete a workflow, Flowmatic removes not only the workflow definition but also the complete run history for that workflow. All logs, output records, and execution details associated with past runs are destroyed. Make sure you no longer need any of this data before proceeding.

Path Parameters

workflowId · string · required

The unique ID of the workflow you want to permanently delete. You can retrieve this value from the List Workflows or Get Workflow endpoints.

Example Request

Replace :workflowId with the ID of the workflow you want to delete:

curl -X DELETE https://api.flowmatic.io/api/workflows/wf_7kQmR9pL2x \
  -H "Authorization: Bearer <accessToken>"

Response

A successful deletion returns HTTP 204 No Content. The response body is empty. If the workflow ID does not exist or does not belong to your account, the API returns 404 Not Found.

Example Response

HTTP/1.1 204 No Content