Flows

Publish a flow

Publish the saved draft revision. Existing executions keep their original version.

POST/v1/flows/{flowId}/publish

Administrator or Sandbox developer requiredIntegration key: flows:write; or a user token with the required role.

How it works

Use draft.publishedVersionId for new runs. Live publication requires a complete business profile and explicit activation; otherwise 409 ORGANIZATION_NOT_LIVE. Both publication APIs enforce this rule. Sandbox publication stays available. Publishing consumes no process quota and starts no execution.

Request body

revisionintegerrequiredmin 1 · max 9007199254740991

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOW2ACT_API_KEY
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Flows

Publish a flow

Publish the saved draft revision. Existing executions keep their original version.

POST/v1/flows/{flowId}/publish

Administrator or Sandbox developer requiredIntegration key: flows:write; or a user token with the required role.

How it works

Request body

revisionintegerrequiredmin 1 · max 9007199254740991

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOW2ACT_API_KEY
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Publish a flow

How it works

Request body

Request essentials

Ask the docs

Publish a flow

How it works

Request body

Request essentials

Ask the docs