Skip to main content
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

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

​
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:

​
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