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_definition.delete
AuthorizationBearer <token>

In: header

Scope: flow_definition.delete

Path Parameters

id*string

The id returned by the POST /flow_definitions endpoint.

Response Body

application/json

application/json

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

{  "code": "auth.unauthorized",  "message": "The request lacks valid authentication credentials."}