apicheats.dev elevenlabs/llms.txt Raw .md
GET

GET /v1/convai/secrets — ElevenLabs API

ElevenLabs API

Get Convai Workspace Secrets

Base URL
https://api.elevenlabs.io
Auth
xi-api-key: <ELEVENLABS_API_KEY>
Last verified
2026-10-20 · upstream hash matched
Actions Try in browser→
Agents: curl -H "Accept: text/markdown" this URL
→ 207 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/convai/secrets?page_size=10&dependency_limit=10&search=example-search&cursor=example-cursor' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Parameters

Name In Type Required Description
page_size query integer No How many documents to return at maximum. Can not exceed 100. If not provided, returns all secrets.
dependency_limit query integer No Maximum number of dependent resources (tools, agents, phone numbers) to return per secret. Can not exceed 100.
search query string No If specified, returns only secrets whose names start with this string.
cursor query string No Used for fetching next page. Cursor is returned in the response.

Response 200 OK

{
  "secrets": [
    {
      "type": "string",
      "secret_id": "string",
      "name": "string",
      "used_by": {
        "tools": [
          {
            "id": "[recursive or deeply nested schema]",
            "name": "[recursive or deeply nested schema]",
            "type": "[recursive or deeply nested schema]",
            "created_at_unix_secs": "[recursive or deeply nested schema]",
            "access_level": "[recursive or deeply nested schema]"
          }
        ],
        "tools_has_more": false,
        "agents": [
          {
            "referenced_resource_ids": "[recursive or deeply nested schema]",
            "id": "[recursive or deeply nested schema]",
            "name": "[recursive or deeply nested schema]",
            "type": "[recursive or deeply nested schema]",
            "created_at_unix_secs": "[recursive or deeply nested schema]",
            "access_level": "[recursive or deeply nested schema]"
          }
        ],
        "agents_has_more": false,
        "phone_numbers": [
          {
            "phone_number_id": "[recursive or deeply nested schema]",
            "phone_number": "[recursive or deeply nested schema]",
            "label": "[recursive or deeply nested schema]",
            "provider": "[recursive or deeply nested schema]"
          }
        ],
        "phone_numbers_has_more": false,
        "mcp_servers": [
          {
            "id": "[recursive or deeply nested schema]",
            "name": "[recursive or deeply nested schema]",
            "type": "[recursive or deeply nested schema]",
            "created_at_unix_secs": "[recursive or deeply nested schema]",
            "access_level": "[recursive or deeply nested schema]"
          }
        ],
        "others": [
          "conversation_initiation_webhook"
        ]
      }
    }
  ],
  "next_cursor": "string"
}
Get a free ElevenLabs API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.