# Cartesia Docs ## Docs - [Delete Agent](https://docs.cartesia.ai/api-reference/agents/agents/delete.md) - [Get Agent](https://docs.cartesia.ai/api-reference/agents/agents/get.md): Returns the details of a specific agent - [List Agents](https://docs.cartesia.ai/api-reference/agents/agents/list.md): Lists all agents associated with your account - [Agent Phone Numbers](https://docs.cartesia.ai/api-reference/agents/agents/phone-numbers.md) - [List Templates](https://docs.cartesia.ai/api-reference/agents/agents/templates.md): List of public, Cartesia-provided agent templates to help you get started - [Update Agent](https://docs.cartesia.ai/api-reference/agents/agents/update.md) - [Cancel Call Batch](https://docs.cartesia.ai/api-reference/agents/call-batches/cancel-call-batch.md): Stops dialing the batch's queued calls. Calls already in flight are left to finish. Idempotent. - [Create Call Batch](https://docs.cartesia.ai/api-reference/agents/call-batches/create-call-batch.md): Queues a batch of outbound calls. Calls are issued gradually, subject to the organization's and the batch's concurrency limits. - [Get Call Batch](https://docs.cartesia.ai/api-reference/agents/call-batches/get-call-batch.md): Retrieves a batch and the current status of each of its recipients. - [List Call Batches](https://docs.cartesia.ai/api-reference/agents/call-batches/list-call-batches.md) - [Retry Call Batch](https://docs.cartesia.ai/api-reference/agents/call-batches/retry-call-batch.md): Re-queues the batch's recipients whose latest call attempt failed or went unanswered, so the dispatcher dials them again. Recipients that successfully completed their call are left untouched. A cancelled batch cannot be retried. - [Cancel Call](https://docs.cartesia.ai/api-reference/agents/calls/cancel-call.md): Terminates an active call. Only calls in the `started` status can be cancelled; the call ends with end reason `api_cancelled`. - [Create Outbound Call](https://docs.cartesia.ai/api-reference/agents/calls/create-outbound-call.md) - [Delete Call](https://docs.cartesia.ai/api-reference/agents/calls/delete-call.md): Deletes the sensitive data for a call, including the transcript, audio recordings, and logs. The call record is retained with non-sensitive operational metadata; deleted fields are omitted from subsequent API responses, and `redacted_at` marks when deletion occurred. Deletion cannot be undone. - [Download Call Audio](https://docs.cartesia.ai/api-reference/agents/calls/download-call-audio.md) - [Get Call](https://docs.cartesia.ai/api-reference/agents/calls/get-call.md) - [Get Call Runtime Logs](https://docs.cartesia.ai/api-reference/agents/calls/get-call-logs.md) - [List Calls](https://docs.cartesia.ai/api-reference/agents/calls/list-calls.md) - [Get Deployment](https://docs.cartesia.ai/api-reference/agents/deployments/get-deployment.md): Get a deployment by its ID. - [List Deployments](https://docs.cartesia.ai/api-reference/agents/deployments/list-deployments.md): List of all deployments associated with an agent. - [Create Document](https://docs.cartesia.ai/api-reference/agents/documents/create.md): Upload a document into a [knowledge base](/line/knowledge-base) folder - [Bulk Create Documents](https://docs.cartesia.ai/api-reference/agents/documents/create-bulk.md): Upload up to 100 [knowledge base](/line/knowledge-base) documents in a single request - [Delete Document](https://docs.cartesia.ai/api-reference/agents/documents/delete.md): Delete a [knowledge base](/line/knowledge-base) document. - [Get Document](https://docs.cartesia.ai/api-reference/agents/documents/get.md): Returns the details of a single [knowledge base](/line/knowledge-base) document, including its full content. - [List Documents](https://docs.cartesia.ai/api-reference/agents/documents/list.md): List all [knowledge base](/line/knowledge-base) documents in your organization - [Update Document](https://docs.cartesia.ai/api-reference/agents/documents/update.md): Update a [knowledge base](/line/knowledge-base) document's name, content, metadata, or folder - [Create Folder](https://docs.cartesia.ai/api-reference/agents/folders/create.md): Create a [knowledge base](/line/knowledge-base) folder - [Delete Folder](https://docs.cartesia.ai/api-reference/agents/folders/delete.md): Delete a [knowledge base](/line/knowledge-base) folder - [Get Folder](https://docs.cartesia.ai/api-reference/agents/folders/get.md): Returns the details of a single [knowledge base](/line/knowledge-base) folder, including its documents and agents that have access to it - [List Folders](https://docs.cartesia.ai/api-reference/agents/folders/list.md): List [knowledge base](/line/knowledge-base) folders - [Update Folder](https://docs.cartesia.ai/api-reference/agents/folders/update.md): Update a [knowledge base](/line/knowledge-base) folder's name, parent, documents, or agents - [Add Metric to Agent](https://docs.cartesia.ai/api-reference/agents/metrics/add-metric-to-agent.md) - [Create Metric](https://docs.cartesia.ai/api-reference/agents/metrics/create-metric.md): Create a new metric. - [Delete Metric](https://docs.cartesia.ai/api-reference/agents/metrics/delete-metric.md): Delete a metric by its ID. The metric is removed from all agents it is attached to. Existing metric results are retained. - [Export Metric Results as CSV](https://docs.cartesia.ai/api-reference/agents/metrics/export-metric-results.md): Exports metric results as a CSV file. - [Get Metric](https://docs.cartesia.ai/api-reference/agents/metrics/get-metric.md): Get a metric by its ID. - [List Metric Results](https://docs.cartesia.ai/api-reference/agents/metrics/list-metric-results.md) - [List Metrics](https://docs.cartesia.ai/api-reference/agents/metrics/list-metrics.md): List of all LLM-as-a-Judge metrics owned by your account. - [Remove Metric from Agent](https://docs.cartesia.ai/api-reference/agents/metrics/remove-metric-from-agent.md) - [Delete Phone Number](https://docs.cartesia.ai/api-reference/agents/phone-numbers/delete.md) - [Get Phone Number](https://docs.cartesia.ai/api-reference/agents/phone-numbers/get.md): Returns the details of a specific phone number - [Import Phone Number](https://docs.cartesia.ai/api-reference/agents/phone-numbers/import.md) - [List Phone Numbers](https://docs.cartesia.ai/api-reference/agents/phone-numbers/list.md) - [Provision Cartesia Number](https://docs.cartesia.ai/api-reference/agents/phone-numbers/provision.md): Provision a new Cartesia-managed US phone number - [Update Phone Number](https://docs.cartesia.ai/api-reference/agents/phone-numbers/update.md): Update a phone number's label, agent assignment, or provider - [Create Provider](https://docs.cartesia.ai/api-reference/agents/providers/create.md): Link a telephony provider account - [Delete Provider](https://docs.cartesia.ai/api-reference/agents/providers/delete.md): Delete a provider account - [Get Provider](https://docs.cartesia.ai/api-reference/agents/providers/get.md): Returns the details of a specific provider account. - [List Providers](https://docs.cartesia.ai/api-reference/agents/providers/list.md): List telephony provider accounts linked to your account - [Update Provider](https://docs.cartesia.ai/api-reference/agents/providers/update.md): Update a provider's credentials - [Create Webhook](https://docs.cartesia.ai/api-reference/agents/webhooks/create.md): Register a webhook endpoint. Cartesia POSTs [call events](/line/infrastructure/observability#webhooks) to its `url` for every agent the webhook is attached to. Attach a webhook to an agent by setting the agent's `webhook_id` with [Update Agent](/api-reference/agents/agents/update). - [Delete Webhook](https://docs.cartesia.ai/api-reference/agents/webhooks/delete.md): Delete a webhook. Detach it from any agents first by clearing their `webhook_id`. - [Get Webhook](https://docs.cartesia.ai/api-reference/agents/webhooks/get.md): Returns the details of a single webhook. The `secret` is omitted. - [List Webhooks](https://docs.cartesia.ai/api-reference/agents/webhooks/list.md): List the webhooks in your organization. The `secret` is omitted. - [Update Webhook](https://docs.cartesia.ai/api-reference/agents/webhooks/update.md): Update a webhook's `url`, `secret`, or `display_name`. Omit `secret` to leave the existing secret unchanged. - [Get API Key](https://docs.cartesia.ai/api-reference/api-keys/get.md): Returns metadata for a single API key. - [List API Keys](https://docs.cartesia.ai/api-reference/api-keys/list.md): Returns a paginated list of standard API keys owned by the authenticating organization. Only metadata is returned, not the keys themselves. Admin API keys are not included. - [API Status and Version](https://docs.cartesia.ai/api-reference/api-status/get.md) - [Generate a New Access Token](https://docs.cartesia.ai/api-reference/auth/access-token.md): Generates a short-lived access token to make API requests from authenticated clients. - [Create](https://docs.cartesia.ai/api-reference/datasets/create.md): Create a new dataset - [Delete](https://docs.cartesia.ai/api-reference/datasets/delete.md): Delete a dataset - [Delete file](https://docs.cartesia.ai/api-reference/datasets/delete-file.md): Remove a file from a dataset - [Get](https://docs.cartesia.ai/api-reference/datasets/get.md): Retrieve a specific dataset by ID - [List](https://docs.cartesia.ai/api-reference/datasets/list.md): Paginated list of datasets - [List files](https://docs.cartesia.ai/api-reference/datasets/list-files.md): Paginated list of files in a dataset - [Update](https://docs.cartesia.ai/api-reference/datasets/update.md): Update an existing dataset - [Upload file](https://docs.cartesia.ai/api-reference/datasets/upload-file.md): Upload a new file to a dataset - [Create](https://docs.cartesia.ai/api-reference/fine-tunes/create.md): Create a new fine-tune - [Delete](https://docs.cartesia.ai/api-reference/fine-tunes/delete.md): Delete a fine-tune - [Get](https://docs.cartesia.ai/api-reference/fine-tunes/get.md): Retrieve a specific fine-tune by ID - [List](https://docs.cartesia.ai/api-reference/fine-tunes/list.md): Paginated list of all fine-tunes for the authenticated user - [List Voices](https://docs.cartesia.ai/api-reference/fine-tunes/list-voices.md): List all voices created from a fine-tune - [Infill (Bytes)](https://docs.cartesia.ai/api-reference/infill/bytes.md): Generate audio that smoothly connects two existing audio segments - [Create](https://docs.cartesia.ai/api-reference/pronunciation-dicts/create.md): Create a new pronunciation dictionary - [Delete](https://docs.cartesia.ai/api-reference/pronunciation-dicts/delete.md): Delete a pronunciation dictionary - [Get](https://docs.cartesia.ai/api-reference/pronunciation-dicts/get.md): Retrieve a specific pronunciation dictionary by ID - [List](https://docs.cartesia.ai/api-reference/pronunciation-dicts/list.md): List all pronunciation dictionaries for the authenticated user - [Update](https://docs.cartesia.ai/api-reference/pronunciation-dicts/update.md): Update a pronunciation dictionary - [Batch Speech-to-Text](https://docs.cartesia.ai/api-reference/stt/transcribe.md): Transcribes an audio file of any length - [Realtime Speech-to-Text (Auto)](https://docs.cartesia.ai/api-reference/stt/turns/websocket.md): Realtime speech transcription with built-in turn detection - [Realtime Speech-to-Text (Manual)](https://docs.cartesia.ai/api-reference/stt/websocket.md): Realtime speech transcription without turn detection - [Text-to-Speech (Bytes)](https://docs.cartesia.ai/api-reference/tts/bytes.md): Stream audio from a complete transcript - [Text-to-Speech (SSE)](https://docs.cartesia.ai/api-reference/tts/sse.md): Stream audio with extra metadata from a complete transcript - [Text-to-Speech (WebSocket)](https://docs.cartesia.ai/api-reference/tts/websocket.md): Generate audio in realtime with contexts - [Get Agent Usage](https://docs.cartesia.ai/api-reference/usage/agents.md): Returns your agent usage over time, bucketed by the requested interval. - [Get Credit Usage](https://docs.cartesia.ai/api-reference/usage/credits.md): Returns your credit usage over time, bucketed by the requested interval. - [Voice Changer (Bytes)](https://docs.cartesia.ai/api-reference/voice-changer/bytes.md): Takes an audio file of speech, and returns an audio file of speech spoken with the same intonation, but with a different voice. - [Voice Changer (SSE)](https://docs.cartesia.ai/api-reference/voice-changer/sse.md): Takes an audio file of speech, and returns an audio file of speech spoken with the same intonation, but with a different voice. - [Clone Voice](https://docs.cartesia.ai/api-reference/voices/clone.md) - [Delete Voice](https://docs.cartesia.ai/api-reference/voices/delete.md) - [Get Voice](https://docs.cartesia.ai/api-reference/voices/get.md) - [List Voices](https://docs.cartesia.ai/api-reference/voices/list.md) - [Localize Voice](https://docs.cartesia.ai/api-reference/voices/localize.md): Create a new voice from an existing voice localized to a new language and dialect. - [Update Voice](https://docs.cartesia.ai/api-reference/voices/update.md): Update the name, description, and gender of a voice. To set the gender back to the default, set the gender to `null`. If gender is not specified, the gender will not be updated. - [Choosing a Voice](https://docs.cartesia.ai/build-with-cartesia/capability-guides/choosing-a-voice.md): How to pick the best voice for your Voice Agents - [Instant Voice Clone](https://docs.cartesia.ai/build-with-cartesia/capability-guides/clone-voices.md): Learn how to get the best voice clones from your audio clips - [Pro Voice Clone](https://docs.cartesia.ai/build-with-cartesia/capability-guides/clone-voices-pro.md): Create near replica voices by leveraging more of your data - [Custom Pronunciations](https://docs.cartesia.ai/build-with-cartesia/capability-guides/custom-pronunciations.md): Specify custom pronunciations for words that are hard to get right, like proper nouns or domain-specific terms. - [Multilingual Voices](https://docs.cartesia.ai/build-with-cartesia/capability-guides/multilingual-voices.md): Make a voice sound native in new languages and accents. - [Prompting tips](https://docs.cartesia.ai/build-with-cartesia/capability-guides/prompting-tips.md): Get natural-sounding output from Sonic with minimal prompt engineering. - [SSML Tags](https://docs.cartesia.ai/build-with-cartesia/capability-guides/ssml-tags.md): Laughter, pauses, and mid-transcript controls - [Stream Inputs using Continuations](https://docs.cartesia.ai/build-with-cartesia/capability-guides/stream-inputs-using-continuations.md): Learn how to stream input text to Sonic TTS - [Build with Sonic](https://docs.cartesia.ai/build-with-cartesia/capability-guides/tts.md) - [Output Format](https://docs.cartesia.ai/build-with-cartesia/capability-guides/tts-output-audio-format.md): How to find the right parameters for output audio - [Volume, Speed, and Emotion](https://docs.cartesia.ai/build-with-cartesia/capability-guides/volume-speed-emotion.md): Control the speed, volume, and emotion of generated speech. - [Audio Input](https://docs.cartesia.ai/build-with-cartesia/stt/audio-input.md): How to find the right encoding and sample rate for realtime audio - [Build with Ink](https://docs.cartesia.ai/build-with-cartesia/stt/guides.md) - [Ink 2](https://docs.cartesia.ai/build-with-cartesia/stt/latest.md) - [Older Models](https://docs.cartesia.ai/build-with-cartesia/stt/older-models.md) - [Deprecated Models](https://docs.cartesia.ai/build-with-cartesia/tts-models/api-changes.md) - [Sonic 3.5](https://docs.cartesia.ai/build-with-cartesia/tts-models/latest.md) - [Older Models](https://docs.cartesia.ai/build-with-cartesia/tts-models/older-models.md) - [Migrating from Sonic 3 to Sonic 3.5](https://docs.cartesia.ai/build-with-cartesia/tts-models/sonic-3-to-sonic-3-5.md): What's new in Sonic 3.5 and what to know before you switch. - [Changelog 2024](https://docs.cartesia.ai/changelog/2024.md): Product, API, and platform changes for 2024 - [Changelog 2025](https://docs.cartesia.ai/changelog/2025.md): Product, API, and platform changes for 2025 - [Changelog 2026](https://docs.cartesia.ai/changelog/2026.md): Product, API, and platform changes for 2026 - [Set up an organization](https://docs.cartesia.ai/enterprise/set-up-an-organization.md) - [Set up SSO](https://docs.cartesia.ai/enterprise/set-up-sso.md) - [Zero Data Retention](https://docs.cartesia.ai/enterprise/zero-data-retention.md): Zero Data Retention (ZDR) is available to Cartesia Enterprise customers for our Text-to-Speech (TTS) and Speech-to-Text (STT) APIs. - [Error Handling](https://docs.cartesia.ai/examples/error-handling.md): Example of error handling with SDK exceptions. - [Create Infill Audio](https://docs.cartesia.ai/examples/infill-create.md): Create infill audio between two clips. - [Next.js Full Example](https://docs.cartesia.ai/examples/nextjs.md): A complete Next.js application with batch TTS, HTTP streaming, and STT transcription. - [Realtime STT (Auto)](https://docs.cartesia.ai/examples/stt-auto-finalize-websocket.md): Realtime transcription with native turn detection — recommended for voice agents. - [Realtime STT (Manual)](https://docs.cartesia.ai/examples/stt-manual-finalize-websocket.md): Realtime transcription where you control the user turn. Recommended for push-to-talk apps. - [Batch STT](https://docs.cartesia.ai/examples/stt-transcribe.md): Transcribe pre-recorded audio files. - [Download Audio File](https://docs.cartesia.ai/examples/tts-download-file.md): Generate audio and trigger a file download in the browser. - [Generate to File](https://docs.cartesia.ai/examples/tts-generate-to-file.md): Use generate() and write_to_file() to write a wav file. - [Play Audio in Browser](https://docs.cartesia.ai/examples/tts-play-audio.md): Generate a wav and play it using an