Skip to main content
POST
Deprecate Flow

Authorizations

x-api-key
string
header
required

Your ps_ API key

Path Parameters

id
string
required

The local id of the Flow — the id field GET /v1/flows returns, never metaFlowId.

Body

application/json
supersededByFlowId
string

The LOCAL id of the successor Flow — the same id GET /v1/flows returns, not the metaFlowId. Optional: deprecating with no successor is legitimate. But present-and-unusable is a different request from absent — an empty or whitespace-only string is refused with 400 FLOW_DEPRECATE_INVALID_SUCCESSOR rather than dropped, because a version chain that ends silently is invisible afterwards. The successor is verified to belong to your tenant; one that does not is 404.

Minimum string length: 1
Example:

"cmf2b3c4d5e6f7g8h9i0j1k2"

Response

Flow deprecated