Delete a flow
Soft delete a flow.
Marks a flow as deleted without permanently removing it from the database. Deleted flows are hidden from listings but can be recovered if needed.
Behavior
- Flow is marked with
deleted=trueflag - Flow no longer appears in list/get operations
- All versions of the flow are marked as deleted
- Can be recovered by support team if needed
Important Notes
- This is a soft delete, not a permanent deletion
- Associated executions and files are NOT deleted
- Deleted flows cannot be undeleted via API (contact support)
Header Parameters
Authorizationstring
Path Parameters
flow_idstring Required
Response
204
Object
Flow successfully deleted (soft delete)
401
Object
Unauthorized - Missing or invalid authentication credentials
Response Attributes
errorobject Required
Standard error detail structure.
This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.
Show child attributes
request_idnull
403
Object
Forbidden - User doesn't have permission to delete this flow
Response Attributes
errorobject Required
Standard error detail structure.
This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.
Show child attributes
request_idnull
404
Object
Not Found - The requested resource does not exist
Response Attributes
errorobject Required
Standard error detail structure.
This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.
Show child attributes
request_idnull
422
Object
Validation Error
Response Attributes
detailarray
Show child attributes
Was this section helpful?
What made this section unhelpful for you?
Response
Was this section helpful?