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

/v1/convai/secrets

ElevenLabs API

Get Convai Workspace Secrets

Base URL
https://api.elevenlabs.io
Auth
xi-api-key: <ELEVENLABS_API_KEY>
Last verified
2026-09-03 · upstream hash matched
Actions
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/convai/secrets?page_size=10&dependency_limit=10&search=example-search&cursor=example-cursor' \  -H "xi-api-key: $ELEVENLABS_API_KEY"
Get a free ElevenLabs API key → sponsored

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"
}