List published flows

GET

https://api.talkif.ai/api/v1/flows/published

GET

/api/v1/flows/published

curl https://api.talkif.ai/api/v1/flows/published \
     -H "Authorization: Bearer <token>"

{
  "flows": [
    {
      "accountId": "550e8400-e29b-41d4-a716-446655440000",
      "analysisOverride": "use_account_default",
      "connectedPhones": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "phoneNumber": "+15551234567",
          "friendlyName": "Main Office Line"
        }
      ],
      "createdAt": "2026-01-15T10:30:00Z",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Appointment Reminder",
      "nodeCount": 5,
      "recordingOverride": "use_account_default",
      "status": "DRAFT",
      "tags": [
        "healthcare",
        "scheduling"
      ],
      "updatedAt": "2026-01-20T14:00:00Z",
      "version": "1.2.0",
      "versions": [
        {
          "publishedAt": "2026-01-15T10:30:00Z",
          "version": "1.2.0",
          "notes": "string"
        }
      ],
      "voicemailEnabled": true,
      "description": "Automated appointment reminder calls",
      "publishedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 142
  }
}

Returns only the account’s published flows (the ones a phone number or call can use), with their connected phone numbers.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Query parameters

limitintegerOptional>=0

Max items to return (1-100, default 20)

offsetintegerOptional>=0Defaults to 0

Items to skip (default 0)

Response

Paginated list of published flows

flowslist of objects

Items on this page

metaobject

Pagination metadata

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error