curl -X GET 'https://api.elevenlabs.io/v1/flows/templates?cursor=example-cursor&page_size=10&versions_per_template=3&search=example-search' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

# GET /v1/flows/templates (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-22

> List Templates

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X GET 'https://api.elevenlabs.io/v1/flows/templates?cursor=example-cursor&page_size=10&versions_per_template=3&search=example-search' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| cursor | query | string | No | Pagination cursor: the `next_cursor`... |
| page_size | query | integer | No | How many templates to return per page... |
| versions_per_template | query | integer | No | How many of each template's published... |
Other params: search

## Response (200 OK)
{"has_more":true,"next_cursor":"cGFnZXwx"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

GET

GET /v1/flows/templates — ElevenLabs API

ElevenLabs API

List Templates

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-22 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 203 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X GET 'https://api.elevenlabs.io/v1/flows/templates?cursor=example-cursor&page_size=10&versions_per_template=3&search=example-search' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Parameters

Name	In	Type	Required	Description
cursor	query	string	No	Pagination cursor: the `next_cursor` value of the previous page's response. Omit it for the first page.
page_size	query	integer	No	How many templates to return per page. Lower than the run list's ceiling because each row expands its versions' input and output schemas.
versions_per_template	query	integer	No	How many of each template's published versions to return, newest first. `has_more_versions` tells you when a template has more.
search	query	string	No	Only return templates whose name or description contains this text.

Response 200 OK

{
  "has_more": true,
  "next_cursor": "cGFnZXwx",
  "templates": [
    {
      "description": "Drop in a product photo, get a studio shot.",
      "has_more_versions": false,
      "id": "tmpl_abc123",
      "name": "Product shot",
      "versions": [
        {
          "inputs": [
            {
              "content_schema": {
                "title": "Prompt",
                "type": "string"
              },
              "id": "prompt"
            },
            {
              "content_schema": {
                "description": "A clean product photo on any background.",
                "title": "Product photo",
                "type": "image"
              },
              "id": "reference"
            }
          ],
          "is_latest": true,
          "outputs": [
            {
              "content_schema": {
                "title": "Final image",
                "type": "image"
              },
              "id": "product_still"
            }
          ],
          "published_at_unix": 1739721600,
          "version_id": "ver_01hxyz"
        }
      ]
    }
  ]
}

Get a free ElevenLabs API key → sponsored