Get secrets | ElevenLabs Documentation

curl https://api.elevenlabs.io/v1/convai/secrets \
     -H "Content-Type: application/json"

{
  "secrets": [
    {
      "type": "stored",
      "secret_id": "sec_9f8b7c6d5e4a3b2c1d0e",
      "name": "Production Database Password",
      "used_by": {
        "tools": [
          {
            "type": "available",
            "access_level": "admin",
            "created_at_unix_secs": 1672531200,
            "id": "tool_123abc456def",
            "name": "Data Sync Tool"
          }
        ],
        "agents": [
          {
            "type": "available",
            "access_level": "editor",
            "created_at_unix_secs": 1675209600,
            "id": "agent_789xyz012uvw",
            "name": "User Onboarding Agent",
            "referenced_resource_ids": [
              "tool_123abc456def"
            ]
          }
        ],
        "others": [
          "conversation_initiation_webhook"
        ],
        "tools_has_more": false,
        "agents_has_more": false,
        "phone_numbers": [
          {
            "phone_number_id": "pn_5551234567",
            "phone_number": "+15551234567",
            "label": "Support Line",
            "provider": "twilio"
          }
        ],
        "phone_numbers_has_more": false,
        "mcp_servers": [
          {
            "type": "available",
            "access_level": "viewer",
            "created_at_unix_secs": 1669852800,
            "id": "mcp_0011223344",
            "name": "EU MCP Server"
          }
        ]
      }
    }
  ],
  "next_cursor": "cursor_eyJwYWdlIjoxfQ=="
}

Get all workspace secrets for the user

Query parameters

page_sizeinteger or nullOptional1-100

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

dependency_limitinteger or nullOptional1-100

Maximum number of dependent resources (tools, agents, phone numbers) to return per secret. Can not exceed 100.

cursorstring or nullOptional

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

Response

Successful Response

secretslist of objects

next_cursorstring or null

Cursor for fetching the next page of secrets

Errors

422

Unprocessable Entity Error

Headers

Query parameters

Response

Errors