Docs
API ReferenceReferenceFlows

List flows

GET
/flows

Every published Flow in your organization with its inputs. Requires the flows:read scope. Paged: every answer carries nextCursor (FWA-2815); ?fields= keeps the payload small.

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

Query Parameters

include?"drafts"

drafts lists unpublished Flows too, with published and updatedAt per row. Needs the flows:write scope.

Value in

  • "drafts"
limit?integer

Items per page (default 50, max 200).

Range1 <= value <= 200
cursor?string

The nextCursor from the previous page. Omit for the first page. A cursor names the last item handed out, so a walk is gapless; a stale one is refused with invalid_request.

fields?string

Comma-separated field names to keep on each item. Published listing: id, name, description, inputs, inputSchema. With include=drafts: id, name, description, kind, published, updatedAt. An unknown name is invalid_request naming the valid ones.

updatedSince?string

Only items changed at or after this time (inclusive).

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/flows"
{  "flows": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "description": "string",      "inputs": [        {          "key": "string",          "label": "string",          "description": "string",          "type": "string",          "required": true,          "options": [            "string"          ]        }      ],      "inputSchema": {}    }  ],  "nextCursor": "string"}