Flows

Update a draft

Save the full designer document with its current revision. Stale writes return 409.

POST/v1/flows/{flowId}/draft

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

How it works

Authenticate, set X-Organization-Id, then send the request shown alongside. The response example shows relevant fields; open OpenAPI for the complete schema.

Request body

revisionintegerrequiredmin 0 · max 9007199254740991

documentobjectrequired

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.

curl -X POST "https://api.flow2act.com/v1/flows/10000000-0000-4000-8000-000000000002/draft" \ -H "authorization: Bearer $FLOW2ACT_API_KEY" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-save-draft-001" \ -H "content-type: application/json" \ --data-raw '{ "revision": 1, "document": { "name": "Deployment approval", "definition": { "schemaVersion": 2, "fields": [ { "key": "environment", "label": "Environment", "type": "select", "required": true, "options": [ "staging", "production" ], "min": null, "max": null } ], "nodes": [ { "id": "start", "type": "start", "label": "Request received", "next": "approval" }, { "id": "approval", "type": "approval", "label": "Operations approval", "groupId": "10000000-0000-4000-8000-000000000009", "next": "end" }, { "id": "end", "type": "end", "label": "Approved", "outcome": "approved" } ] }, "presentation": { "names": { "api": "Request", "amount": "Condition", "end": "Complete" }, "description": "Operations approves a deployment.", "positions": {} } } }'

Flows

Update a draft

Save the full designer document with its current revision. Stale writes return 409.

POST/v1/flows/{flowId}/draft

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

How it works

Authenticate, set X-Organization-Id, then send the request shown alongside. The response example shows relevant fields; open OpenAPI for the complete schema.

Request body

revisionintegerrequiredmin 0 · max 9007199254740991

documentobjectrequired

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.

Update a draft

How it works

Request body

Request essentials

Ask the docs

Update a draft

How it works

Request body

Request essentials

Ask the docs