> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs

> Connect ElevenLabs to your Atako agents — 23 read and 14 write actions.

Let your agents manage your ElevenLabs account — voices, generation history, dubbing projects, pronunciation dictionaries and Conversational AI agents.

## Connection

* **Authentication**: API key.

<Note>
  elevenlabs.io → sign in → click your profile (bottom left) → API Keys → Create API Key. Enable the permissions your agent needs (Voices, History, Dubbing, Agents Platform — read and/or write) or leave the key unrestricted, then copy the key (starts with sk\_).

  See [ElevenLabs's documentation](https://elevenlabs.io/app/settings/api-keys).
</Note>

## Read actions (23)

| Action                            | Description                                                            |
| --------------------------------- | ---------------------------------------------------------------------- |
| `get_agent`                       | Fetch the full configuration of a Conversational AI agent.             |
| `get_agent_link`                  | Fetch the shareable link token of a Conversational AI agent.           |
| `get_character_usage`             | Fetch character usage metrics between two dates.                       |
| `get_conversation`                | Fetch a conversation with its transcript and analysis.                 |
| `get_default_voice_settings`      | Fetch the default voice settings applied when a voice has none.        |
| `get_dubbing_project`             | Fetch metadata and status of a dubbing project.                        |
| `get_dubbing_transcript`          | Fetch the transcript of a dubbing project for a target language.       |
| `get_history_item`                | Fetch metadata about a single history item.                            |
| `get_knowledge_base_document`     | Fetch metadata about a knowledge base document.                        |
| `get_pronunciation_dictionary`    | Fetch metadata about a pronunciation dictionary.                       |
| `get_user`                        | Fetch information about the authenticated ElevenLabs user.             |
| `get_user_subscription`           | Fetch the current subscription plan, character quota and usage.        |
| `get_voice`                       | Fetch metadata about a single voice.                                   |
| `get_voice_settings`              | Fetch the stored generation settings of a voice.                       |
| `list_agents`                     | List Conversational AI agents in the workspace.                        |
| `list_conversations`              | List Conversational AI conversations, filterable by agent and outcome. |
| `list_dubbing_projects`           | List dubbing projects with pagination and status filters.              |
| `list_history`                    | List generated audio history items, most recent first.                 |
| `list_knowledge_base`             | List knowledge base documents available to agents.                     |
| `list_models`                     | List all available speech models and their capabilities.               |
| `list_pronunciation_dictionaries` | List pronunciation dictionaries in the account.                        |
| `list_shared_voices`              | Search the community voice library of shared voices.                   |
| `list_voices`                     | List voices in the account, with optional search and sorting.          |

## Write actions (14)

| Action                                     | Description                                                           |
| ------------------------------------------ | --------------------------------------------------------------------- |
| `add_pronunciation_dictionary_rules`       | Add alias or phoneme rules to a pronunciation dictionary.             |
| `create_agent`                             | Create a Conversational AI agent from a conversation configuration.   |
| `create_knowledge_base_document_from_text` | Create a knowledge base document from raw text.                       |
| `create_knowledge_base_document_from_url`  | Create a knowledge base document by scraping a web page URL.          |
| `create_pronunciation_dictionary`          | Create a new pronunciation dictionary from a list of rules.           |
| `delete_agent`                             | Delete a Conversational AI agent.                                     |
| `delete_conversation`                      | Delete a conversation and its transcript.                             |
| `delete_dubbing_project`                   | Delete a dubbing project.                                             |
| `delete_history_item`                      | Delete a history item and its audio.                                  |
| `delete_knowledge_base_document`           | Delete a knowledge base document.                                     |
| `delete_voice`                             | Delete a voice from the account.                                      |
| `edit_voice_settings`                      | Update the generation settings of a voice.                            |
| `remove_pronunciation_dictionary_rules`    | Remove rules from a pronunciation dictionary by their source strings. |
| `update_agent`                             | Update the configuration, name or tags of a Conversational AI agent.  |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.