Docs
API ReferenceReferenceFlows

Set a flow's questions

PUT
/flows/{flowId}/questions

Replaces the Flow's questions, which are its run parameters: each becomes a {{workflow.<key>}} variable and an entry in the draft's inputs. Requires the flows:write scope; a personal key also needs the member role or above. Edits change the DRAFT only: nothing reaches end users until POST …/publish.

AuthorizationBearer <token>

An organization API key, created from a Portal's Webhooks page (Provisioning API card). The secret is shown once at creation and stored only as a hash. Keys are organization-wide and carry scopes (end_users:read, end_users:write). Rate limit: 120 requests per minute per key (sliding 60-second window).

In: header

Path Parameters

flowId*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/flows/497f6eca-6276-4993-bfeb-53cbbbba6f08/questions" \  -H "Content-Type: application/json" \  -d '{    "questions": [      {        "label": "string"      }    ]  }'
{  "flow": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "slug": "string",    "description": "string",    "kind": "form",    "questions": [      {        "id": "string",        "label": "string"      }    ],    "inputs": [      {        "key": "string",        "label": "string",        "description": "string",        "type": "string",        "required": true,        "options": [          "string"        ]      }    ],    "nodes": [      {        "id": "string",        "type": "trigger_start",        "data": {},        "blocks": [          {}        ]      }    ],    "published": true,    "productionVersionId": "a45124a6-f1ae-495a-9d4c-946315091da1",    "versionCount": 0,    "lastChange": {      "at": "2019-08-24T14:15:22Z",      "by": "string",      "source": "ui",      "action": "string",      "summary": "string"    },    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  }}