List account templates

GET

https://api.talkif.ai/api/v1/flow-templates/custom

GET

/api/v1/flow-templates/custom

curl https://api.talkif.ai/api/v1/flow-templates/custom \
     -H "Authorization: Bearer <token>"

{
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 142
  },
  "templates": [
    {
      "category": "appointment",
      "createdAt": "2026-01-15T10:30:00Z",
      "displayOrder": 1,
      "edges": {},
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "initialNode": "main_agent_1",
      "isActive": true,
      "name": "Appointment Reminder",
      "nodes": {},
      "slug": "appointment-reminder",
      "updatedAt": "2026-02-20T14:45:00Z",
      "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "createdBy": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "definition": {},
      "description": "Automated appointment confirmation and rescheduling flow",
      "icon": "calendar",
      "previewImageUrl": "https://cdn.talkif.com/templates/appointment-reminder.png",
      "tags": [
        "healthcare",
        "scheduling"
      ]
    }
  ]
}

Returns the templates saved in this account (system templates are listed by GET /api/v1/flow-templates).

Authentication

AuthorizationBearer

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

Query parameters

categorystringOptional

Filter by category

limitlongOptional

Page size

offsetlongOptionalDefaults to 0

Page offset

Response

Paginated list of account-specific flow templates

metaobject

Pagination metadata

templateslist of objects

Items on this page

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error