Get secrets | ElevenLabs Documentation

from elevenlabs import ElevenLabs
client = ElevenLabs()
client.conversational_ai.secrets.list(
    page_size=1,
    cursor="cursor",
)

{
  "secrets": [
    {
      "type": "stored",
      "secret_id": "sec_9f8b7c6d5e4a3b2c1d0e",
      "name": "Database Credentials",
      "used_by": {
        "tools": [
          {
            "type": "available",
            "access_level": "admin",
            "created_at_unix_secs": 1685600000,
            "id": "tool_12345abcde",
            "name": "Data Sync Tool"
          }
        ],
        "agents": [
          {
            "type": "available",
            "access_level": "editor",
            "created_at_unix_secs": 1685700000,
            "id": "agent_67890fghij",
            "name": "Customer Support Bot"
          }
        ],
        "others": [
          "conversation_initiation_webhook"
        ],
        "phone_numbers": []
      }
    }
  ],
  "next_cursor": "cursor_abcdef1234567890",
  "has_more": true
}

Get all workspace secrets for the user

Query parameters

page_sizeintegerOptional1-100

How many documents to return at maximum. Can not exceed 100. If not provided, returns all secrets.

cursorstringOptional

Used for fetching next page. Cursor is returned in the response.

Response

Successful Response

secretslist of objects

next_cursorstring

Cursor for fetching the next page of secrets

has_morebooleanDefaults to false

Whether there are more secrets to fetch

Errors

422

Secrets List Request Unprocessable Entity Error

Headers

Query parameters

Response

Errors