Zitadel Preview Docs

Delete a flow definition by id

Delete a flow definition by id. If the flow definition is currently being used by a flow, the deletion will fail. If the flow definition is the last active flow definition for a given purpose, the deletion will fail to prevent disruption of new flows being started for that purpose.

DELETE
/flow_definitions/{id}

Delete a flow definition by id. If the flow definition is currently being used by a flow, the deletion will fail. If the flow definition is the last active flow definition for a given purpose, the deletion will fail to prevent disruption of new flows being started for that purpose.

Authorization

oauth2 flow_definitions.delete
AuthorizationBearer <token>

In: header

Scope: flow_definitions.delete

Path Parameters

id*string

The id returned by the POST /flow_definitions endpoint.

Query Parameters

project_id*string

The project id to filter by.

Response Body

application/json

application/json

curl -X DELETE "https://example.com/flow_definitions/fd_123abc456def?project_id=river-8421"
Empty
{  "code": "string",  "message": "string",  "details": {}}
{  "code": "string",  "message": "string",  "details": {}}