# Pp Elevenlabs

> Printing Press CLI for Elevenlabs. This is the documentation for the ElevenLabs API. You can use this API to use our service programmatically, this is...

- Skill: `mvanhorn-printing-press-libra/pp-elevenlabs` (Agent Skill, multi-file: 410 files)
- Install (CLI): `npx skillmds add mvanhorn-printing-press-libra/pp-elevenlabs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mvanhorn-printing-press-libra/pp-elevenlabs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: Apache-2.0
- Author: mvanhorn (https://skillmd.com/u/mvanhorn-printing-press-libra)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/mvanhorn-printing-press-libra/pp-elevenlabs

---


# Elevenlabs — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `elevenlabs-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install elevenlabs --cli-only
   ```
2. Verify: `elevenlabs-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/ai/elevenlabs/cmd/elevenlabs-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Agent audio planning
- **`voice discover`** — Search owned and shared ElevenLabs voices through one compact, JSON-first command.

  _Agents can pick a voice before generation without paging through incompatible raw endpoints._

  ```bash
  elevenlabs-pp-cli voice discover --source all --limit 5 --agent
  ```
- **`tts resolve`** — Resolve a voice, model, output format, default settings, and subscription context before rendering.

  _Agents can validate generation choices cheaply before spending quota on audio._

  ```bash
  elevenlabs-pp-cli tts resolve --voice JBFqnCBsd6RMkjVDRZzb --model auto --agent
  ```

### Audio artifact workflows
- **`tts render`** — Render text to an audio file and print a structured manifest with file path, byte count, model, and voice.

  _Agents get a durable audio artifact plus machine-readable metadata in one step._

  ```bash
  elevenlabs-pp-cli tts render --voice JBFqnCBsd6RMkjVDRZzb --text 'Hello from ElevenLabs.' --out hello.mp3 --agent
  ```
- **`dialogue cast`** — Render speaker-labelled dialogue lines by resolving speaker-to-voice assignments and saving audio.

  _Agents can generate multi-speaker dialogue from scripts without manually constructing JSON voice-id payloads._

  ```bash
  elevenlabs-pp-cli dialogue cast --line narrator='Welcome.' --cast narrator=JBFqnCBsd6RMkjVDRZzb --out dialogue.mp3 --agent
  ```

## Command Reference

**audio-isolation** — Manage audio isolation

- `elevenlabs-pp-cli audio-isolation audio_isolation` — Removes background noise from audio
- `elevenlabs-pp-cli audio-isolation delete-history-item` — Deletes a specific audio isolation history item and the associated media files.
- `elevenlabs-pp-cli audio-isolation get-history` — Returns a list of all your audio isolation generations.
- `elevenlabs-pp-cli audio-isolation stream` — Removes background noise from audio and streams the result

**audio-native** — Manage audio native

- `elevenlabs-pp-cli audio-native create-project` — Creates Audio Native enabled project, optionally starts conversion and returns project ID and embeddable HTML snippet.
- `elevenlabs-pp-cli audio-native update-content-from-url` — Finds an AudioNative project matching the provided URL, extracts content from the URL, updates the project content,...

**convai** — Manage convai

- `elevenlabs-pp-cli convai add-documentation-to-knowledge-base` — Uploads a file or reference a webpage to use as part of the shared knowledge base
- `elevenlabs-pp-cli convai add-mcp-server-tool-approval-route` — Add approval for a specific MCP tool when using per-tool approval mode.
- `elevenlabs-pp-cli convai add-mcp-tool-config-override-route` — Create configuration overrides for a specific MCP tool.
- `elevenlabs-pp-cli convai add-tool-route` — Add a new tool to the available tools in the workspace.
- `elevenlabs-pp-cli convai agent-testing-bulk-move-route` — Moves multiple tests or folders from one folder to another.
- `elevenlabs-pp-cli convai assign-conversation-tags-route` — Assign one or more conversation tags to a conversation. Tags that are already assigned are ignored. Tags must belong...
- `elevenlabs-pp-cli convai cancel-batch-call` — Cancel a running batch call and set all recipients to cancelled status.
- `elevenlabs-pp-cli convai cancel-file-upload-route` — Remove a file upload from a conversation. Only possible if the file hasn't already been used in the conversation.
- `elevenlabs-pp-cli convai create-agent-deployment-route` — Create a new deployment for an agent
- `elevenlabs-pp-cli convai create-agent-draft-route` — Create a new draft for an agent
- `elevenlabs-pp-cli convai create-agent-response-test-route` — Creates a new agent response test.
- `elevenlabs-pp-cli convai create-agent-route` — Create an agent from a config object
- `elevenlabs-pp-cli convai create-agent-test-folder-route` — Creates a folder for organizing agent tests.
- `elevenlabs-pp-cli convai create-batch-call` — Submit a batch call request to schedule calls for multiple recipients.
- `elevenlabs-pp-cli convai create-branch-route` — Create a new branch from a given version of any branch
- `elevenlabs-pp-cli convai create-conversation-tag-route` — Create a new conversation tag for the workspace.
- `elevenlabs-pp-cli convai create-environment-variable` — Create a new environment variable for the workspace
- `elevenlabs-pp-cli convai create-file-document-route` — Create a knowledge base document generated form the uploaded file.
- `elevenlabs-pp-cli convai create-folder-route` — Create a folder used for grouping documents together.
- `elevenlabs-pp-cli convai create-mcp-server-route` — Create a new MCP server configuration in the workspace.
- `elevenlabs-pp-cli convai create-phone-number-route` — Import Phone Number from provider configuration (Twilio or SIP trunk)
- `elevenlabs-pp-cli convai create-secret-route` — Create a new secret for the workspace
- `elevenlabs-pp-cli convai create-text-document-route` — Create a knowledge base document containing the provided text.
- `elevenlabs-pp-cli convai create-url-document-route` — Create a knowledge base document generated by scraping the given webpage.
- `elevenlabs-pp-cli convai delete-agent-draft-route` — Delete a draft for an agent
- `elevenlabs-pp-cli convai delete-agent-route` — Delete an agent
- `elevenlabs-pp-cli convai delete-agent-test-folder-route` — Deletes an agent test folder by ID. Use force=true to delete a non-empty folder and all its contents.
- `elevenlabs-pp-cli convai delete-batch-call` — Permanently delete a batch call and all recipient records. Conversations remain in history.
- `elevenlabs-pp-cli convai delete-chat-response-test-route` — Deletes an agent response test by ID.
- `elevenlabs-pp-cli convai delete-conversation-route` — Delete a particular conversation
- `elevenlabs-pp-cli convai delete-conversation-tag-route` — Delete a conversation tag. Restricted to the tag owner or a workspace admin.
- `elevenlabs-pp-cli convai delete-knowledge-base-document` — Delete a document or folder from the knowledge base.
- `elevenlabs-pp-cli convai delete-mcp-server-route` — Delete a specific MCP server configuration from the workspace.
- `elevenlabs-pp-cli convai delete-phone-number-route` — Delete Phone Number by ID
- `elevenlabs-pp-cli convai delete-rag-index` — Delete RAG index for the knowledgebase document.
- `elevenlabs-pp-cli convai delete-secret-route` — Delete a workspace secret if it's not in use
- `elevenlabs-pp-cli convai delete-tool-route` — Delete tool from the workspace.
- `elevenlabs-pp-cli convai delete-whatsapp-account` — Delete a WhatsApp account
- `elevenlabs-pp-cli convai duplicate-agent-route` — Create a new agent by duplicating an existing one
- `elevenlabs-pp-cli convai get-agent-knowledge-base-size` — Returns the number of pages in the agent's knowledge base.
- `elevenlabs-pp-cli convai get-agent-knowledge-base-summaries-route` — Gets multiple knowledge base document summaries by their IDs.
- `elevenlabs-pp-cli convai get-agent-link-route` — Get the current link used to share the agent with others
- `elevenlabs-pp-cli convai get-agent-llm-expected-cost-calculation` — Calculates expected number of LLM tokens needed for the specified agent.
- `elevenlabs-pp-cli convai get-agent-response-test-route` — Gets an agent response test by ID.
- `elevenlabs-pp-cli convai get-agent-response-tests-summaries-route` — Gets multiple agent response tests by their IDs. Returns a dictionary mapping test IDs to test summaries.
- `elevenlabs-pp-cli convai get-agent-route` — Retrieve config for an agent
- `elevenlabs-pp-cli convai get-agent-summaries-route` — Returns summaries for the specified agents.
- `elevenlabs-pp-cli convai get-agent-test-folder-route` — Gets an agent test folder by ID, including its folder path.
- `elevenlabs-pp-cli convai get-agent-topics-route` — Returns the latest topic discovery run results for a given agent.
- `elevenlabs-pp-cli convai get-agent-widget-route` — Retrieve the widget configuration for an agent
- `elevenlabs-pp-cli convai get-agents-route` — Returns a list of your agents and their metadata.
- `elevenlabs-pp-cli convai get-api-integration-docs` — Get MDX documentation for all integrations that have it. Returns docs for publicly available integrations when...
- `elevenlabs-pp-cli convai get-batch-call` — Get detailed information about a batch call including all recipients.
- `elevenlabs-pp-cli convai get-branch-route` — Get information about a single agent branch
- `elevenlabs-pp-cli convai get-branches-route` — Returns a list of branches an agent has
- `elevenlabs-pp-cli convai get-conversation-audio-route` — Get the audio recording of a particular conversation
- `elevenlabs-pp-cli convai get-conversation-histories-route` — Get all conversations of agents that user owns. With option to restrict to a specific agent.
- `elevenlabs-pp-cli convai get-conversation-history-route` — Get the details of a particular conversation
- `elevenlabs-pp-cli convai get-conversation-signed-link` — Get a signed url to start a conversation with an agent with an agent that requires authorization
- `elevenlabs-pp-cli convai get-conversation-sip-messages` — Get SIP messages associated with a conversation's phone call
- `elevenlabs-pp-cli convai get-conversation-tag-route` — Get a conversation tag by ID.
- `elevenlabs-pp-cli convai get-conversation-users-route` — Get distinct users from conversations with pagination.
- `elevenlabs-pp-cli convai get-dashboard-settings-route` — Retrieve Convai dashboard settings for the workspace
- `elevenlabs-pp-cli convai get-documentation-chunk-from-knowledge-base` — Get details about a specific documentation part used by RAG.
- `elevenlabs-pp-cli convai get-documentation-chunks-from-knowledge-base` — Get all RAG chunks for a specific knowledge base document.
- `elevenlabs-pp-cli convai get-documentation-from-knowledge-base` — Get details about a specific documentation making up the agent's knowledge base
- `elevenlabs-pp-cli convai get-environment-variable` — Get a specific environment variable by ID
- `elevenlabs-pp-cli convai get-knowledge-base-content` — Get the entire content of a document from the knowledge base
- `elevenlabs-pp-cli convai get-knowledge-base-dependent-agents` — Get a list of agents depending on this knowledge base document
- `elevenlabs-pp-cli convai get-knowledge-base-list-route` — Get a list of available knowledge base documents
- `elevenlabs-pp-cli convai get-knowledge-base-source-file-url` — Get a signed URL to download the original source file of a file-type document from the knowledge base
- `elevenlabs-pp-cli convai get-live-count` — Get the live count of the ongoing conversations.
- `elevenlabs-pp-cli convai get-livekit-token` — Get a WebRTC session token for real-time communication.
- `elevenlabs-pp-cli convai get-mcp-route` — Retrieve a specific MCP server configuration from the workspace.
- `elevenlabs-pp-cli convai get-mcp-tool-config-override-route` — Retrieve configuration overrides for a specific MCP tool.
- `elevenlabs-pp-cli convai get-or-create-rag-indexes` — Retrieves and/or creates RAG indexes for multiple knowledge base documents in a single request. Maximum 100 items...
- `elevenlabs-pp-cli convai get-phone-number-route` — Retrieve Phone Number details by ID
- `elevenlabs-pp-cli convai get-public-llm-expected-cost-calculation` — Returns a list of LLM models and the expected cost for using them based on the provided values.
- `elevenlabs-pp-cli convai get-rag-index-overview` — Provides total size and other information of RAG indexes used by knowledgebase documents
- `elevenlabs-pp-cli convai get-rag-indexes` — Provides information about all RAG indexes of the specified knowledgebase document.
- `elevenlabs-pp-cli convai get-secret-dependencies-route` — Get paginated list of resources that depend on a specific secret, filtered by resource type.
- `elevenlabs-pp-cli convai get-secret-route` — Get a workspace secret by ID
- `elevenlabs-pp-cli convai get-secrets-route` — Get all workspace secrets for the user
- `elevenlabs-pp-cli convai get-settings-route` — Retrieve Convai settings for the workspace
- `elevenlabs-pp-cli convai get-signed-url-deprecated` — Get a signed url to start a conversation with an agent with an agent that requires authorization
- `elevenlabs-pp-cli convai get-test-invocation-route` — Gets a test invocation by ID.
- `elevenlabs-pp-cli convai get-tool-dependent-agents-route` — Get a list of agents depending on this tool
- `elevenlabs-pp-cli convai get-tool-executions-route` — Get paginated list of tool executions for a specific tool.
- `elevenlabs-pp-cli convai get-tool-route` — Get tool that is available in the workspace.
- `elevenlabs-pp-cli convai get-tools-route` — Get all available tools in the workspace.
- `elevenlabs-pp-cli convai get-version-metadata-route` — Get metadata for a specific agent version
- `elevenlabs-pp-cli convai get-whatsapp-account` — Get a WhatsApp account
- `elevenlabs-pp-cli convai get-workspace-batch-calls` — Get all batch calls for the current workspace.
- `elevenlabs-pp-cli convai handle-sip-trunk-outbound-call` — Handle an outbound call via SIP trunk
- `elevenlabs-pp-cli convai handle-twilio-outbound-call` — Handle an outbound call via Twilio
- `elevenlabs-pp-cli convai list-available-llms` — Returns a list of available LLM models that can be used with agents, including their capabilities and any...
- `elevenlabs-pp-cli convai list-chat-response-tests-route` — Lists all agent response tests with pagination support and optional search filtering.
- `elevenlabs-pp-cli convai list-conversation-tags-route` — List conversation tags for the workspace, ordered by most recently created first.
- `elevenlabs-pp-cli convai list-environment-variables` — List all environment variables for the workspace with optional filtering
- `elevenlabs-pp-cli convai list-mcp-server-tools-route` — Retrieve all tools available for a specific MCP server configuration.
- `elevenlabs-pp-cli convai list-mcp-servers-route` — Retrieve all MCP server configurations available in the workspace.
- `elevenlabs-pp-cli convai list-phone-numbers-route` — Retrieve all Phone Numbers
- `elevenlabs-pp-cli convai list-sip-messages` — Get SIP messages for a phone number
- `elevenlabs-pp-cli convai list-test-invocations-route` — Lists all test invocations with pagination support and optional search filtering.
- `elevenlabs-pp-cli convai list-whatsapp-accounts` — List all WhatsApp accounts
- `elevenlabs-pp-cli convai merge-branch-into-target` — Merge a branch into a target branch
- `elevenlabs-pp-cli convai patch-agent-settings-route` — Patches an Agent settings
- `elevenlabs-pp-cli convai post-agent-avatar-route` — Sets the avatar for an agent displayed in the widget
- `elevenlabs-pp-cli convai post-conversation-feedback-route` — Send the feedback for the given conversation
- `elevenlabs-pp-cli convai post-knowledge-base-bulk-move-route` — Moves multiple entities from one folder to another.
- `elevenlabs-pp-cli convai post-knowledge-base-move-route` — Moves the entity from one folder to another.
- `elevenlabs-pp-cli convai rag-index-status` — In case the document is not RAG indexed, it triggers rag indexing task, otherwise it just returns the current status.
- `elevenlabs-pp-cli convai refresh-url-document-route` — Manually refresh a URL document by re-fetching its content from the source URL.
- `elevenlabs-pp-cli convai register-twilio-call` — Register a Twilio call and return TwiML to connect the call
- `elevenlabs-pp-cli convai remove-mcp-server-tool-approval-route` — Remove approval for a specific MCP tool when using per-tool approval mode.
- `elevenlabs-pp-cli convai remove-mcp-tool-config-override-route` — Remove configuration overrides for a specific MCP tool.
- `elevenlabs-pp-cli convai resubmit-tests-route` — Resubmits specific test runs from a test invocation.
- `elevenlabs-pp-cli convai retry-batch-call` — Retry a batch call, calling failed and no-response recipients again.
- `elevenlabs-pp-cli convai run-agent-test-suite-route` — Run selected tests on the agent with provided configuration. If the agent configuration is provided, it will be used...
- `elevenlabs-pp-cli convai run-conversation-analysis` — Run the analysis for a conversation using the agent's current evaluation criteria and data collection settings.
- `elevenlabs-pp-cli convai run-conversation-simulation-route` — Run a conversation between the agent and a simulated user.
- `elevenlabs-pp-cli convai run-conversation-simulation-route-stream` — Run a conversation between the agent and a simulated user and stream back the response. Response is streamed back as...
- `elevenlabs-pp-cli convai search-knowledge-base-content-route` — Fuzzy text search over knowledge base document content
- `elevenlabs-pp-cli convai smart-search-conversation-messages-route` — Search conversation transcripts by semantic similarity to surface relevant messages based on meaning and intent,...
- `elevenlabs-pp-cli convai text-search-conversation-messages-route` — Search through conversation transcript messages by full-text and fuzzy search
- `elevenlabs-pp-cli convai unassign-conversation-tag-route` — Remove a single conversation tag from a conversation.
- `elevenlabs-pp-cli convai update-agent-response-test-route` — Updates an agent response test by ID.
- `elevenlabs-pp-cli convai update-agent-test-folder-route` — Updates an agent test folder. Currently only supports updating the folder name.
- `elevenlabs-pp-cli convai update-branch-route` — Update agent branch properties such as archiving status and protection level
- `elevenlabs-pp-cli convai update-conversation-tag-route` — Update a conversation tag's title and/or description. Restricted to the tag owner or a workspace admin.
- `elevenlabs-pp-cli convai update-dashboard-settings-route` — Update Convai dashboard settings for the workspace
- `elevenlabs-pp-cli convai update-document-route` — Update the name and/or content of a document.
- `elevenlabs-pp-cli convai update-environment-variable` — Replace an environment variable's values. Use null to remove an environment (except production).
- `elevenlabs-pp-cli convai update-file-document-route` — Update the source file of a file document. The document name, content, and metadata are updated to reflect the new...
- `elevenlabs-pp-cli convai update-mcp-server-approval-policy-route` — Update the approval policy configuration for an MCP server. DEPRECATED: Use PATCH /mcp-servers/{id} endpoint instead.
- `elevenlabs-pp-cli convai update-mcp-server-config-route` — Update the configuration settings for an MCP server.
- `elevenlabs-pp-cli convai update-mcp-tool-config-override-route` — Update configuration overrides for a specific MCP tool.
- `elevenlabs-pp-cli convai update-phone-number-route` — Update assigned agent of a phone number
- `elevenlabs-pp-cli convai update-secret-route` — Update an existing secret for the workspace
- `elevenlabs-pp-cli convai update-settings-route` — Update Convai settings for the workspace
- `elevenlabs-pp-cli convai update-tool-route` — Update tool that is available in the workspace.
- `elevenlabs-pp-cli convai update-whatsapp-account` — Update a WhatsApp account
- `elevenlabs-pp-cli convai upload-file-route` — Upload an image or PDF file for a conversation. Returns a unique file ID that can be used to reference the file in...
- `elevenlabs-pp-cli convai whatsapp-outbound-call` — Make an outbound call via WhatsApp
- `elevenlabs-pp-cli convai whatsapp-outbound-message` — Send an outbound message via WhatsApp

**docs** — Manage docs

- `elevenlabs-pp-cli docs` — Redirect To Mintlify

**dubbing** — Manage dubbing

- `elevenlabs-pp-cli dubbing add-language` — Adds the given ElevenLab Turbo V2/V2.5 language code to the resource. Does not automatically generate...
- `elevenlabs-pp-cli dubbing create` — Dubs a provided audio or video file into given language.
- `elevenlabs-pp-cli dubbing create-clip` — Creates a new segment in dubbing resource with a start and end time for the speaker in every available language....
- `elevenlabs-pp-cli dubbing create-speaker` — Create A New Speaker
- `elevenlabs-pp-cli dubbing delete` — Deletes a dubbing project.
- `elevenlabs-pp-cli dubbing delete-segment` — Deletes a single segment from the dubbing.
- `elevenlabs-pp-cli dubbing dub` — Regenerate the dubs for either the entire resource or the specified segments/languages. Will automatically...
- `elevenlabs-pp-cli dubbing get-dubbed-metadata` — Returns metadata about a dubbing project, including whether it's still in progress or not
- `elevenlabs-pp-cli dubbing get-resource` — Given a dubbing ID generated from the '/v1/dubbing' endpoint with studio enabled, returns the dubbing resource.
- `elevenlabs-pp-cli dubbing get-similar-voices-for-speaker` — Fetch the top 10 similar voices to a speaker, including the voice IDs, names, descriptions, and, where possible, a...
- `elevenlabs-pp-cli dubbing list-dubs` — List the dubs you have access to.
- `elevenlabs-pp-cli dubbing migrate-segments` — Change the attribution of one or more segments to a different speaker.
- `elevenlabs-pp-cli dubbing render` — Regenerate the output media for a language using the latest Studio state. Please ensure all segments have been...
- `elevenlabs-pp-cli dubbing transcribe` — Regenerate the transcriptions for the specified segments. Does not automatically regenerate translations or dubs.
- `elevenlabs-pp-cli dubbing translate` — Regenerate the translations for either the entire resource or the specified segments/languages. Will automatically...
- `elevenlabs-pp-cli dubbing update-segment-language` — Modifies a single segment with new text and/or start/end times. Will update the values for only a specific language...
- `elevenlabs-pp-cli dubbing update-speaker` — Amend the metadata associated with a speaker, such as their voice. Both voice cloning and using voices from the...

**forced-alignment** — Force align an audio file to a text transcript to get precise word-level and character level timing information. Response is a list of characters with their start and end times as milliseconds elapsed from the start of the recording.

- `elevenlabs-pp-cli forced-alignment` — Force align an audio file to text. Use this endpoint to get the timing information for each character and word in an...

**history** — Manage history

- `elevenlabs-pp-cli history delete-speech-item` — Delete a history item by its ID
- `elevenlabs-pp-cli history download-speech-items` — Download one or more history items. If one history item ID is provided, we will return a single audio file. If more...
- `elevenlabs-pp-cli history get-speech` — Returns a list of your generated audio.
- `elevenlabs-pp-cli history get-speech-item-by-id` — Retrieves a history item.

**models** — Access the different models of the platform.

- `elevenlabs-pp-cli models` — Gets a list of available models.

**music** — Manage music

- `elevenlabs-pp-cli music compose-detailed` — Compose a song from a prompt or a composition plan.
- `elevenlabs-pp-cli music compose-plan` — Generate a composition plan from a prompt.
- `elevenlabs-pp-cli music generate` — Compose a song from a prompt or a composition plan.
- `elevenlabs-pp-cli music separate-song-stems` — Separate an audio file into individual stems. This endpoint might have high latency, depending on the length of the...
- `elevenlabs-pp-cli music stream-compose` — Stream a composed song from a prompt or a composition plan.
- `elevenlabs-pp-cli music upload-song` — Upload a music file to be later used for inpainting. Only available to enterprise clients with access to the...
- `elevenlabs-pp-cli music video-to` — Generate background music from one or more video files. Videos are combined in order. Optional description and style...

**pronunciation-dictionaries** — Manage pronunciation dictionaries

- `elevenlabs-pp-cli pronunciation-dictionaries add-from-file` — Creates a new pronunciation dictionary from a lexicon .PLS file
- `elevenlabs-pp-cli pronunciation-dictionaries add-from-rules` — Creates a new pronunciation dictionary from provided rules.
- `elevenlabs-pp-cli pronunciation-dictionaries get-metadata` — Get a list of the pronunciation dictionaries you have access to and their metadata
- `elevenlabs-pp-cli pronunciation-dictionaries get-pronunciation-dictionary-metadata` — Get metadata for a pronunciation dictionary
- `elevenlabs-pp-cli pronunciation-dictionaries patch-pronunciation-dictionary` — Partially update the pronunciation dictionary without changing the version

**service-accounts** — Manage service accounts

- `elevenlabs-pp-cli service-accounts` — List all service accounts in the workspace

**shared-voices** — Manage shared voices

- `elevenlabs-pp-cli shared-voices` — Retrieves a list of shared voices.

**similar-voices** — Manage similar voices

- `elevenlabs-pp-cli similar-voices` — Returns a list of shared voices similar to the provided audio sample. If neither similarity_threshold nor top_k is...

**single-use-token** — Manage single use token

- `elevenlabs-pp-cli single-use-token` — Generate a time limited single-use token with embedded authentication for frontend clients.

**sound-generation** — Manage sound generation

- `elevenlabs-pp-cli sound-generation` — Turn text into sound effects for your videos, voice-overs or video games using the most advanced sound effects...

**speech-engine** — Manage speech engine

- `elevenlabs-pp-cli speech-engine create` — Create a new Speech Engine resource
- `elevenlabs-pp-cli speech-engine delete` — Delete a Speech Engine resource
- `elevenlabs-pp-cli speech-engine get` — Retrieve a Speech Engine resource
- `elevenlabs-pp-cli speech-engine list` — Returns a paginated list of Speech Engine resources.
- `elevenlabs-pp-cli speech-engine update` — Update a Speech Engine resource (partial update)

**speech-to-speech** — Create speech by combining the style and content of an audio file you upload with a voice of your choice.

- `elevenlabs-pp-cli speech-to-speech <voice_id>` — Transform audio from one voice to another. Maintain full control over emotion, timing and delivery.

**speech-to-text** — Transcribe your audio files with detailed speaker annotations and precise timestamps using our cutting-edge model.

- `elevenlabs-pp-cli speech-to-text delete-transcript-by-id` — Delete a previously generated transcript by its ID.
- `elevenlabs-pp-cli speech-to-text get-transcript-by-id` — Retrieve a previously generated transcript by its ID.
- `elevenlabs-pp-cli speech-to-text speech_to_text` — Transcribe an audio or video file. If webhook is set to true, the request will be processed asynchronously and...

**studio** — Access, create and convert Studio Projects programmatically, only specifically whitelisted accounts can access the Studio API. If you need access please contact our sales team.

- `elevenlabs-pp-cli studio add-chapter` — Creates a new chapter either as blank or from a URL.
- `elevenlabs-pp-cli studio add-project` — Creates a new Studio project, it can be either initialized as blank, from a document or from a URL.
- `elevenlabs-pp-cli studio convert-chapter-endpoint` — Starts conversion of a specific chapter.
- `elevenlabs-pp-cli studio convert-project-endpoint` — Starts conversion of a Studio project and all of its chapters.
- `elevenlabs-pp-cli studio create-podcast` — Create and auto-convert a podcast project. Currently, the LLM cost is covered by us but you will still be charged...
- `elevenlabs-pp-cli studio delete-chapter-endpoint` — Deletes a chapter.
- `elevenlabs-pp-cli studio delete-project` — Deletes a Studio project.
- `elevenlabs-pp-cli studio edit-chapter` — Updates a chapter.
- `elevenlabs-pp-cli studio edit-project` — Updates the specified Studio project by setting the values of the parameters passed.
- `elevenlabs-pp-cli studio edit-project-content` — Updates Studio project content.
- `elevenlabs-pp-cli studio get-chapter-by-id-endpoint` — Returns information about a specific chapter.
- `elevenlabs-pp-cli studio get-chapter-snapshot-endpoint` — Returns the chapter snapshot.
- `elevenlabs-pp-cli studio get-chapter-snapshots` — Gets information about all the snapshots of a chapter. Each snapshot can be downloaded as audio. Whenever a chapter...
- `elevenlabs-pp-cli studio get-chapters` — Returns a list of a Studio project's chapters.
- `elevenlabs-pp-cli studio get-project-by-id` — Returns information about a specific Studio project. This endpoint returns more detailed information about a project...
- `elevenlabs-pp-cli studio get-project-muted-tracks-endpoint` — Returns a list of chapter IDs that have muted tracks in a project.
- `elevenlabs-pp-cli studio get-project-snapshot-endpoint` — Returns the project snapshot.
- `elevenlabs-pp-cli studio get-project-snapshots` — Retrieves a list of snapshots for a Studio project.
- `elevenlabs-pp-cli studio get-projects` — Returns a list of your Studio projects with metadata.
- `elevenlabs-pp-cli studio stream-chapter-snapshot-audio` — Stream the audio from a chapter snapshot. Use `GET /v1/studio/projects/{project_id}/chapters/{chapter_id}/snapshots`...
- `elevenlabs-pp-cli studio stream-project-snapshot-archive-endpoint` — Returns a compressed archive of the Studio project's audio.
- `elevenlabs-pp-cli studio stream-project-snapshot-audio-endpoint` — Stream the audio from a Studio project snapshot.
- `elevenlabs-pp-cli studio update-pronunciation-dictionaries` — Create a set of pronunciation dictionaries acting on a project. This will automatically mark text within this...

**text-to-dialogue** — Manage text to dialogue

- `elevenlabs-pp-cli text-to-dialogue full-with-timestamps` — Generate dialogue from text with precise character-level timing information for audio-text synchronization.
- `elevenlabs-pp-cli text-to-dialogue stream` — Converts a list of text and voice ID pairs into speech (dialogue) and returns an audio stream.
- `elevenlabs-pp-cli text-to-dialogue stream-with-timestamps` — Converts a list of text and voice ID pairs into speech (dialogue) and returns a stream of JSON blobs containing...
- `elevenlabs-pp-cli text-to-dialogue text_to_dialogue` — Converts a list of text and voice ID pairs into speech (dialogue) and returns audio.

**text-to-speech** — Convert text into lifelike speech using a voice of your choice.

- `elevenlabs-pp-cli text-to-speech <voice_id>` — Converts text into speech using a voice of your choice and returns audio.

**text-to-voice** — Manage text to voice

- `elevenlabs-pp-cli text-to-voice create-voice` — Create a voice from previously generated voice preview. This endpoint should be called after you fetched a...
- `elevenlabs-pp-cli text-to-voice design` — Design a voice via a prompt. This method returns a list of voice previews. Each preview has a generated_voice_id and...
- `elevenlabs-pp-cli text-to-voice text_to_voice` — **Deprecated.** Use `POST /v1/text-to-voice/design` instead. Generate a custom voice based on voice description....

**usage** — Manage usage

- `elevenlabs-pp-cli usage` — (Deprecated) This endpoint is deprecated. Use /v1/workspace/analytics/query/usage-by-product-over-time instead....

**user** — Manage user

- `elevenlabs-pp-cli user get-info` — Gets information about the user
- `elevenlabs-pp-cli user get-subscription-info` — Gets extended information about the users subscription

**voices** — Access to voices created either by you or ElevenLabs.

- `elevenlabs-pp-cli voices add` — Add a new voice to your collection of voices in VoiceLab.
- `elevenlabs-pp-cli voices add-pvc-samples` — Add audio samples to a PVC voice
- `elevenlabs-pp-cli voices add-sharing` — Add a shared voice to your collection of voices.
- `elevenlabs-pp-cli voices create-pvc` — Creates a new PVC voice with metadata but no samples
- `elevenlabs-pp-cli voices delete` — Deletes a voice by its ID.
- `elevenlabs-pp-cli voices delete-pvc-sample` — Delete a sample from a PVC voice.
- `elevenlabs-pp-cli voices edit-pvc` — Edit PVC voice metadata
- `elevenlabs-pp-cli voices edit-pvc-sample` — Update a PVC voice sample - apply noise removal, select speaker, change trim times or file name.
- `elevenlabs-pp-cli voices get` — Returns a list of all available voices for a user. Stops working once the user's workspace exceeds 500 voices.
- `elevenlabs-pp-cli voices get-by-id` — Returns metadata about a specific voice.
- `elevenlabs-pp-cli voices get-pvc-captcha` — Get captcha for PVC voice verification.
- `elevenlabs-pp-cli voices get-pvc-sample-audio` — Retrieve the first 30 seconds of voice sample audio with or without noise removal.
- `elevenlabs-pp-cli voices get-pvc-sample-speakers` — Retrieve the status of the speaker separation process and the list of detected speakers if complete.
- `elevenlabs-pp-cli voices get-pvc-sample-visual-waveform` — Retrieve the visual waveform of a voice sample.
- `elevenlabs-pp-cli voices get-settings-default` — Gets the default settings for voices. 'similarity_boost' corresponds to'Clarity + Similarity Enhancement' in the web...
- `elevenlabs-pp-cli voices get-speaker-audio` — Retrieve the separated audio for a specific speaker.
- `elevenlabs-pp-cli voices get-user-v2` — Gets a list of all available voices for a user with search, filtering and pagination.
- `elevenlabs-pp-cli voices request-pvc-manual-verification` — Request manual verification for a PVC voice.
- `elevenlabs-pp-cli voices run-pvc-training` — Start PVC training process for a voice.
- `elevenlabs-pp-cli voices start-speaker-separation` — Start speaker separation process for a sample
- `elevenlabs-pp-cli voices verify-pvc-captcha` — Submit captcha verification for PVC voice.

**workspace** — Access to workspace related endpoints.

- `elevenlabs-pp-cli workspace add-member` — Adds a member of your workspace to the specified group. Requires `group_members_manage` permission.
- `elevenlabs-pp-cli workspace create-auth-connection` — Create a new OAuth2 auth connection for the workspace
- `elevenlabs-pp-cli workspace create-webhook-route` — Create a new webhook for the workspace with the specified authentication type.
- `elevenlabs-pp-cli workspace delete-auth-connection` — Delete Workspace Auth Connection
- `elevenlabs-pp-cli workspace delete-invite` — Invalidates an existing email invitation. The invitation will still show up in the inbox it has been delivered to,...
- `elevenlabs-pp-cli workspace delete-webhook-route` — Delete the specified workspace webhook
- `elevenlabs-pp-cli workspace edit-webhook-route` — Update the specified workspace webhook
- `elevenlabs-pp-cli workspace get-audit-logs` — Returns the audit log for the workspace. Requires enterprise tier and the audit_log_read permission.
- `elevenlabs-pp-cli workspace get-groups-endpoint` — Get all groups in the workspace
- `elevenlabs-pp-cli workspace get-resource-metadata` — Gets the metadata of a resource by ID.
- `elevenlabs-pp-cli workspace get-webhooks-route` — List all webhooks for a workspace
- `elevenlabs-pp-cli workspace invite-user` — Sends an email invitation to join your workspace to the provided email. If the user doesn't have an account they...
- `elevenlabs-pp-cli workspace invite-users-bulk` — Sends email invitations to join your workspace to the provided emails. Requires all email addresses to be part of a...
- `elevenlabs-pp-cli workspace list-auth-connections` — Get all auth connections for the workspace
- `elevenlabs-pp-cli workspace remove-member` — Removes a member from the specified group. Requires `group_members_manage` permission.
- `elevenlabs-pp-cli workspace requests-list` — Returns a list of API requests. Supports filtering by time range, column filters, and search terms. At least one of...
- `elevenlabs-pp-cli workspace search-groups` — Searches for user groups in the workspace. Multiple or no groups may be returned.
- `elevenlabs-pp-cli workspace share-resource-endpoint` — Grants a role on a workspace resource to a user or a group. It overrides any existing role this user/service...
- `elevenlabs-pp-cli workspace unshare-resource-endpoint` — Removes any existing role on a workspace resource from a user, service account, group or workspace api key. To...
- `elevenlabs-pp-cli workspace update-member` — Updates attributes of a workspace member. Apart from the email identifier, all parameters will remain unchanged...
- `elevenlabs-pp-cli workspace usage-by-product-over-time` — Returns credit usage broken down by product type over time. The response is a tabular structure with columns,...


### Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

```bash
elevenlabs-pp-cli which "<capability in your own words>"
```

`which` resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code `0` means at least one match; exit code `2` means no confident match — fall back to `--help` or use a narrower query.

## Auth Setup
Run `elevenlabs-pp-cli auth setup` to print the URL and steps for getting a key (add `--launch` to open the URL). Then set:

```bash
export ELEVENLABS_API_KEY="<your-key>"
```

Or persist it in `~/.config/elevenlabs-documentation-pp-cli/config.toml`.

Run `elevenlabs-pp-cli doctor` to verify setup.

## Agent Mode

Add `--agent` to any command. Expands to: `--json --compact --no-input --no-color --yes`.

- **Pipeable** — JSON on stdout, errors on stderr
- **Filterable** — `--select` keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  ```bash
  elevenlabs-pp-cli models --agent --select id,name,status
  ```
- **Previewable** — `--dry-run` shows the request without sending
- **Offline-friendly** — sync/search commands can use the local SQLite store when available
- **Non-interactive** — never prompts, every input is a flag
- **Explicit retries** — use `--idempotent` only when an already-existing create should count as success, and `--ignore-missing` only when a missing delete target should count as success

### Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

```json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
```

Parse `.results` for data and `.meta.source` to know whether it's live or local. A human-readable `N results (live)` summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

## Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

```
elevenlabs-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
elevenlabs-pp-cli feedback --stdin < notes.txt
elevenlabs-pp-cli feedback list --json 

…(truncated)