# Cartesia Docs: English API ## API ### 2026-08-14 #### Use the API - [API Conventions](https://docs.cartesia.ai/use-the-api/api-conventions.md) - [API Errors](https://docs.cartesia.ai/use-the-api/api-errors.md) - [Concurrency and WebSocket Limits](https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts.md): Learn about concurrency limits and timeouts with the Cartesia API. #### API Status - [API Status and Version](https://docs.cartesia.ai/api-reference/api-status/get.md) #### TTS - [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 #### STT - [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 - [Batch Speech-to-Text](https://docs.cartesia.ai/api-reference/stt/transcribe.md): Transcribes an audio file of any length #### Managed Agents - [WebSocket](https://docs.cartesia.ai/api-reference/agents/agent-websocket.md): Stream audio and events between an application and a Managed Agent. Server applications authenticate with `X-API-Key`; browser and mobile applications pass an `access_token` query parameter. See the [WebSocket guide](/line/integrations/websocket-api) for setup, limits, and audio handling. ##### Agents - [Create Agent](https://docs.cartesia.ai/api-reference/agents/create.md): Creates an agent and its initial configuration version - [List Agents](https://docs.cartesia.ai/api-reference/agents/list.md): Returns agent summaries for your account. Full configurations are omitted. - [Get Agent](https://docs.cartesia.ai/api-reference/agents/get.md): Returns the published agent with its complete normalized configuration - [Update Agent](https://docs.cartesia.ai/api-reference/agents/update.md): Sparsely updates agent metadata or configuration. Configuration changes create a new immutable version. - [Delete Agent](https://docs.cartesia.ai/api-reference/agents/delete.md): Deletes the agent. Future reads and new calls fail. ##### Versions - [List Agent Versions](https://docs.cartesia.ai/api-reference/agents/versions/list.md): Returns the agent's configuration history, ordered from newest to oldest. Each version is an immutable snapshot of the complete configuration. - [Get Agent Version](https://docs.cartesia.ai/api-reference/agents/versions/get.md): Returns one immutable configuration snapshot. To restore it, pass its `config` to `PATCH /v1/agents/{agent_id}`. Restoring creates a new version and does not change existing history. ##### Models - [List Models](https://docs.cartesia.ai/api-reference/agents/models/list.md): Returns the LLMs available for Managed Agents, including latency and pricing metadata ##### Tools - [Create Tool](https://docs.cartesia.ai/api-reference/agents/tools/create.md): Creates a shared webhook or client tool that can be attached to agents - [List Tools](https://docs.cartesia.ai/api-reference/agents/tools/list.md): Returns shared webhook and client tools for your account - [Get Tool](https://docs.cartesia.ai/api-reference/agents/tools/get.md): Returns one shared tool. Expand `agents` to include agents that currently reference it. - [Update Tool](https://docs.cartesia.ai/api-reference/agents/tools/update.md): Sparsely updates a tool. - [Delete Tool](https://docs.cartesia.ai/api-reference/agents/tools/delete.md): Deletes an unused tool. Detach the tool from current agent configurations first. ##### Calls - [List Calls](https://docs.cartesia.ai/api-reference/agents/calls/list-calls.md): Lists an agent's calls, or the calls placed for one outbound call batch. One of `agent_id` or `batch_id` is required. - [Create Outbound Call](https://docs.cartesia.ai/api-reference/agents/calls/create-outbound-call.md) - [Get Call](https://docs.cartesia.ai/api-reference/agents/calls/get-call.md) - [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`. - [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) ##### Batch Calling - [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. - [List Call Batches](https://docs.cartesia.ai/api-reference/agents/call-batches/list-call-batches.md) - [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. - [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. - [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. ##### Phone Numbers - [List Phone Numbers](https://docs.cartesia.ai/api-reference/agents/phone-numbers/list.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) - [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 - [Delete Phone Number](https://docs.cartesia.ai/api-reference/agents/phone-numbers/delete.md) ##### Providers - [List Providers](https://docs.cartesia.ai/api-reference/agents/providers/list.md): List telephony provider accounts linked to your account. Supports Twilio and SIP Trunk providers. - [Get Provider](https://docs.cartesia.ai/api-reference/agents/providers/get.md): Returns the details of a specific provider account. - [Create Provider](https://docs.cartesia.ai/api-reference/agents/providers/create.md): Link a telephony provider account. For Twilio, credentials are validated before the provider is created. Each account SID + region combination can only be linked once. For SIP trunks, configure a trunk with an inbound and/or outbound configuration. - [Update Provider](https://docs.cartesia.ai/api-reference/agents/providers/update.md): Update a provider. For Twilio, credentials are validated before applying. If phone numbers using this provider cannot be verified with the new credentials, the update is rejected with a list of unreachable numbers. For SIP trunks, omitted fields remain unchanged. Set `credentials` or `destination_co… - [Delete Provider](https://docs.cartesia.ai/api-reference/agents/providers/delete.md): Delete a provider account ##### Metrics - [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. - [Get Metric](https://docs.cartesia.ai/api-reference/agents/metrics/get-metric.md): Get a metric by its ID. - [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. - [List Metric Results](https://docs.cartesia.ai/api-reference/agents/metrics/list-metric-results.md) - [Export Metric Results as CSV](https://docs.cartesia.ai/api-reference/agents/metrics/export-metric-results.md): Exports metric results as a CSV file. - [Add Metric to Agent](https://docs.cartesia.ai/api-reference/agents/metrics/add-metric-to-agent.md) - [Remove Metric from Agent](https://docs.cartesia.ai/api-reference/agents/metrics/remove-metric-from-agent.md) #### Auth - [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. #### Voices - [List Voices](https://docs.cartesia.ai/api-reference/voices/list.md) - [List Accents](https://docs.cartesia.ai/api-reference/accents/list.md): Retrieve all supported accents, including which ones you can localize a voice into. Filter with `is_localizable`, `language`, and `locale`. If you pass more than one, every filter has to match. - [Clone Voice](https://docs.cartesia.ai/api-reference/voices/clone.md) - [Delete Voice](https://docs.cartesia.ai/api-reference/voices/delete.md) - [Update Voice](https://docs.cartesia.ai/api-reference/voices/update.md): Update the name, description, gender, and accent 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. - [Get Voice](https://docs.cartesia.ai/api-reference/voices/get.md) - [Localize Voice](https://docs.cartesia.ai/api-reference/voices/localize.md): Localize a voice to sound native in another accent. This creates a new voice with its own voice ID. - [Add Voice Accents](https://docs.cartesia.ai/api-reference/voices/add-accents.md): Add accents to an instant voice clone you own so a single `voice_id` can speak multiple accents natively. - [Delete Voice Accent](https://docs.cartesia.ai/api-reference/voices/delete-accent.md): Remove an accent your instant voice clone supports. #### Pronunciation Dicts - [List](https://docs.cartesia.ai/api-reference/pronunciation-dicts/list.md): List all pronunciation dictionaries for the authenticated user - [Create](https://docs.cartesia.ai/api-reference/pronunciation-dicts/create.md): Create a new pronunciation dictionary - [Get](https://docs.cartesia.ai/api-reference/pronunciation-dicts/get.md): Retrieve a specific pronunciation dictionary by ID - [Update](https://docs.cartesia.ai/api-reference/pronunciation-dicts/update.md): Update a pronunciation dictionary - [Delete](https://docs.cartesia.ai/api-reference/pronunciation-dicts/delete.md): Delete a pronunciation dictionary #### Datasets - [List](https://docs.cartesia.ai/api-reference/datasets/list.md): Paginated list of datasets - [Create](https://docs.cartesia.ai/api-reference/datasets/create.md): Create a new dataset - [Get](https://docs.cartesia.ai/api-reference/datasets/get.md): Retrieve a specific dataset by ID - [Update](https://docs.cartesia.ai/api-reference/datasets/update.md): Update an existing dataset - [Delete](https://docs.cartesia.ai/api-reference/datasets/delete.md): Delete a dataset - [List files](https://docs.cartesia.ai/api-reference/datasets/list-files.md): Paginated list of files in a dataset - [Upload file](https://docs.cartesia.ai/api-reference/datasets/upload-file.md): Upload a new file to a dataset - [Delete file](https://docs.cartesia.ai/api-reference/datasets/delete-file.md): Remove a file from a dataset #### Files - [Upload](https://docs.cartesia.ai/api-reference/files/upload.md): Upload a file, tagged with what it will be used for. - [List](https://docs.cartesia.ai/api-reference/files/list.md): Paginated list of your uploaded files. - [Get](https://docs.cartesia.ai/api-reference/files/get.md): Retrieve a file's metadata. - [Download](https://docs.cartesia.ai/api-reference/files/download.md): Download a file's contents. - [Delete](https://docs.cartesia.ai/api-reference/files/delete.md): Delete an uploaded file. #### Fine Tunes - [List](https://docs.cartesia.ai/api-reference/fine-tunes/list.md): Paginated list of all fine-tunes for the authenticated user - [Create](https://docs.cartesia.ai/api-reference/fine-tunes/create.md): Create a new fine-tune - [Get](https://docs.cartesia.ai/api-reference/fine-tunes/get.md): Retrieve a specific fine-tune by ID - [Delete](https://docs.cartesia.ai/api-reference/fine-tunes/delete.md): Delete a fine-tune - [List Voices](https://docs.cartesia.ai/api-reference/fine-tunes/list-voices.md): List all voices created from a fine-tune #### Infill - [Infill (Bytes)](https://docs.cartesia.ai/api-reference/infill/bytes.md): Generate audio that smoothly connects two existing audio segments #### Admin ##### Usage - [Get Credit Usage](https://docs.cartesia.ai/api-reference/usage/credits.md): Returns your credit usage over time, bucketed by the requested interval. - [Get Agent Usage](https://docs.cartesia.ai/api-reference/usage/agents.md): Returns your agent usage over time, bucketed by the requested interval. ##### API Keys - [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. - [Get API Key](https://docs.cartesia.ai/api-reference/api-keys/get.md): Returns metadata for a single API key. ##### Organizations - [List Users](https://docs.cartesia.ai/api-reference/organizations/list-users.md): Lists users in the organization, ordered by when they joined (newest first) - [Get User](https://docs.cartesia.ai/api-reference/organizations/get-user.md) - [Remove User](https://docs.cartesia.ai/api-reference/organizations/remove-user.md): Removes a non-admin user from the organization without deleting their account - [List Invites](https://docs.cartesia.ai/api-reference/organizations/list-invites.md): Lists organization invites, filtered by status - [Create Invites](https://docs.cartesia.ai/api-reference/organizations/create-invites.md): Invites email addresses to the organization as members. If any email is rejected, the whole request fails and no invites are created. Rate limited to 10 requests per hour. - [Get Invite](https://docs.cartesia.ai/api-reference/organizations/get-invite.md) - [Cancel Invite](https://docs.cartesia.ai/api-reference/organizations/cancel-invite.md): Cancels a pending invite. If it has already been accepted, [remove the user](/api-reference/organizations/remove-user) instead. ### 2026-03-01 #### Use the API - [API Conventions](https://docs.cartesia.ai/use-the-api/api-conventions.md) - [API Errors](https://docs.cartesia.ai/use-the-api/api-errors.md) - [Concurrency and WebSocket Limits](https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts.md): Learn about concurrency limits and timeouts with the Cartesia API. #### API Status - [API Status and Version](https://docs.cartesia.ai/2026-03-01/api-reference/api-status/get.md) #### TTS - [Text-to-Speech (Bytes)](https://docs.cartesia.ai/2026-03-01/api-reference/tts/bytes.md): Stream audio from a complete transcript - [Text-to-Speech (SSE)](https://docs.cartesia.ai/2026-03-01/api-reference/tts/sse.md): Stream audio with extra metadata from a complete transcript - [Text-to-Speech (WebSocket)](https://docs.cartesia.ai/2026-03-01/api-reference/tts/websocket.md): Generate audio in realtime with contexts #### STT - [Realtime Speech-to-Text (Auto)](https://docs.cartesia.ai/2026-03-01/api-reference/stt/turns/websocket.md): Realtime speech transcription with built-in turn detection - [Realtime Speech-to-Text (Manual)](https://docs.cartesia.ai/2026-03-01/api-reference/stt/websocket.md): Realtime speech transcription without turn detection - [Batch Speech-to-Text](https://docs.cartesia.ai/2026-03-01/api-reference/stt/transcribe.md): Transcribes an audio file of any length #### Agents ##### Calls - [List Calls](https://docs.cartesia.ai/2026-03-01/api-reference/agents/calls/list-calls.md): Lists an agent's calls, or the calls placed for one outbound call batch. One of `agent_id` or `batch_id` is required. - [Create Outbound Call](https://docs.cartesia.ai/2026-03-01/api-reference/agents/calls/create-outbound-call.md) - [Get Call](https://docs.cartesia.ai/2026-03-01/api-reference/agents/calls/get-call.md) - [Cancel Call](https://docs.cartesia.ai/2026-03-01/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`. - [Delete Call](https://docs.cartesia.ai/2026-03-01/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/2026-03-01/api-reference/agents/calls/download-call-audio.md) ##### Batch Calling - [Create Call Batch](https://docs.cartesia.ai/2026-03-01/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. - [List Call Batches](https://docs.cartesia.ai/2026-03-01/api-reference/agents/call-batches/list-call-batches.md) - [Get Call Batch](https://docs.cartesia.ai/2026-03-01/api-reference/agents/call-batches/get-call-batch.md): Retrieves a batch and the current status of each of its recipients. - [Cancel Call Batch](https://docs.cartesia.ai/2026-03-01/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. - [Retry Call Batch](https://docs.cartesia.ai/2026-03-01/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. ##### Phone Numbers - [List Phone Numbers](https://docs.cartesia.ai/2026-03-01/api-reference/agents/phone-numbers/list.md) - [Get Phone Number](https://docs.cartesia.ai/2026-03-01/api-reference/agents/phone-numbers/get.md): Returns the details of a specific phone number - [Import Phone Number](https://docs.cartesia.ai/2026-03-01/api-reference/agents/phone-numbers/import.md) - [Provision Cartesia Number](https://docs.cartesia.ai/2026-03-01/api-reference/agents/phone-numbers/provision.md): Provision a new Cartesia-managed US phone number - [Update Phone Number](https://docs.cartesia.ai/2026-03-01/api-reference/agents/phone-numbers/update.md): Update a phone number's label, agent assignment, or provider - [Delete Phone Number](https://docs.cartesia.ai/2026-03-01/api-reference/agents/phone-numbers/delete.md) - [Agent Phone Numbers](https://docs.cartesia.ai/2026-03-01/api-reference/agents/agents/phone-numbers.md) ##### Providers - [List Providers](https://docs.cartesia.ai/2026-03-01/api-reference/agents/providers/list.md): List telephony provider accounts linked to your account. Supports Twilio and SIP Trunk providers. - [Get Provider](https://docs.cartesia.ai/2026-03-01/api-reference/agents/providers/get.md): Returns the details of a specific provider account. - [Create Provider](https://docs.cartesia.ai/2026-03-01/api-reference/agents/providers/create.md): Link a telephony provider account. For Twilio, credentials are validated before the provider is created. Each account SID + region combination can only be linked once. For SIP trunks, configure a trunk with an inbound and/or outbound configuration. - [Update Provider](https://docs.cartesia.ai/2026-03-01/api-reference/agents/providers/update.md): Update a provider. For Twilio, credentials are validated before applying. If phone numbers using this provider cannot be verified with the new credentials, the update is rejected with a list of unreachable numbers. For SIP trunks, omitted fields remain unchanged. Set `credentials` or `destination_co… - [Delete Provider](https://docs.cartesia.ai/2026-03-01/api-reference/agents/providers/delete.md): Delete a provider account ##### Metrics - [List Metrics](https://docs.cartesia.ai/2026-03-01/api-reference/agents/metrics/list-metrics.md): List of all LLM-as-a-Judge metrics owned by your account. - [Get Metric](https://docs.cartesia.ai/2026-03-01/api-reference/agents/metrics/get-metric.md): Get a metric by its ID. - [Create Metric](https://docs.cartesia.ai/2026-03-01/api-reference/agents/metrics/create-metric.md): Create a new metric. - [Delete Metric](https://docs.cartesia.ai/2026-03-01/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. - [List Metric Results](https://docs.cartesia.ai/2026-03-01/api-reference/agents/metrics/list-metric-results.md) - [Export Metric Results as CSV](https://docs.cartesia.ai/2026-03-01/api-reference/agents/metrics/export-metric-results.md): Exports metric results as a CSV file. - [Add Metric to Agent](https://docs.cartesia.ai/2026-03-01/api-reference/agents/metrics/add-metric-to-agent.md) - [Remove Metric from Agent](https://docs.cartesia.ai/2026-03-01/api-reference/agents/metrics/remove-metric-from-agent.md) #### Auth - [Generate a New Access Token](https://docs.cartesia.ai/2026-03-01/api-reference/auth/access-token.md): Generates a short-lived access token to make API requests from authenticated clients. #### Voices - [List Voices](https://docs.cartesia.ai/2026-03-01/api-reference/voices/list.md) - [List Accents](https://docs.cartesia.ai/2026-03-01/api-reference/accents/list.md): Returns all supported accents. Use this to build accent pickers and filter voices by accent. Accent `name` values match `Voice.accent`; `id` is the stable machine-readable slug; `locale` is the canonical BCP-47 locale for the accent; `is_locale_default` is true for exactly one accent per locale. - [Clone Voice](https://docs.cartesia.ai/2026-03-01/api-reference/voices/clone.md) - [Delete Voice](https://docs.cartesia.ai/2026-03-01/api-reference/voices/delete.md) - [Update Voice](https://docs.cartesia.ai/2026-03-01/api-reference/voices/update.md): Update the name, description, gender, and accent 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. - [Get Voice](https://docs.cartesia.ai/2026-03-01/api-reference/voices/get.md) - [Localize Voice](https://docs.cartesia.ai/2026-03-01/api-reference/voices/localize.md): Create a new voice from an existing voice localized to a new language and dialect. - [Add Voice Accents](https://docs.cartesia.ai/2026-03-01/api-reference/voices/add-accents.md): Add accents to an instant voice clone you own so a single `voice_id` can speak multiple accents natively. - [Delete Voice Accent](https://docs.cartesia.ai/2026-03-01/api-reference/voices/delete-accent.md): Remove an accent your instant voice clone supports. #### Pronunciation Dicts - [List](https://docs.cartesia.ai/2026-03-01/api-reference/pronunciation-dicts/list.md): List all pronunciation dictionaries for the authenticated user - [Create](https://docs.cartesia.ai/2026-03-01/api-reference/pronunciation-dicts/create.md): Create a new pronunciation dictionary - [Get](https://docs.cartesia.ai/2026-03-01/api-reference/pronunciation-dicts/get.md): Retrieve a specific pronunciation dictionary by ID - [Update](https://docs.cartesia.ai/2026-03-01/api-reference/pronunciation-dicts/update.md): Update a pronunciation dictionary - [Delete](https://docs.cartesia.ai/2026-03-01/api-reference/pronunciation-dicts/delete.md): Delete a pronunciation dictionary #### Datasets - [List](https://docs.cartesia.ai/2026-03-01/api-reference/datasets/list.md): Paginated list of datasets - [Create](https://docs.cartesia.ai/2026-03-01/api-reference/datasets/create.md): Create a new dataset - [Get](https://docs.cartesia.ai/2026-03-01/api-reference/datasets/get.md): Retrieve a specific dataset by ID - [Update](https://docs.cartesia.ai/2026-03-01/api-reference/datasets/update.md): Update an existing dataset - [Delete](https://docs.cartesia.ai/2026-03-01/api-reference/datasets/delete.md): Delete a dataset - [List files](https://docs.cartesia.ai/2026-03-01/api-reference/datasets/list-files.md): Paginated list of files in a dataset - [Upload file](https://docs.cartesia.ai/2026-03-01/api-reference/datasets/upload-file.md): Upload a new file to a dataset - [Delete file](https://docs.cartesia.ai/2026-03-01/api-reference/datasets/delete-file.md): Remove a file from a dataset #### Files - [Upload](https://docs.cartesia.ai/2026-03-01/api-reference/files/upload.md): Upload a file, tagged with what it will be used for. - [List](https://docs.cartesia.ai/2026-03-01/api-reference/files/list.md): Paginated list of your uploaded files. - [Get](https://docs.cartesia.ai/2026-03-01/api-reference/files/get.md): Retrieve a file's metadata. - [Download](https://docs.cartesia.ai/2026-03-01/api-reference/files/download.md): Download a file's contents. - [Delete](https://docs.cartesia.ai/2026-03-01/api-reference/files/delete.md): Delete an uploaded file. #### Fine Tunes - [List](https://docs.cartesia.ai/2026-03-01/api-reference/fine-tunes/list.md): Paginated list of all fine-tunes for the authenticated user - [Create](https://docs.cartesia.ai/2026-03-01/api-reference/fine-tunes/create.md): Create a new fine-tune - [Get](https://docs.cartesia.ai/2026-03-01/api-reference/fine-tunes/get.md): Retrieve a specific fine-tune by ID - [Delete](https://docs.cartesia.ai/2026-03-01/api-reference/fine-tunes/delete.md): Delete a fine-tune - [List Voices](https://docs.cartesia.ai/2026-03-01/api-reference/fine-tunes/list-voices.md): List all voices created from a fine-tune #### Infill - [Infill (Bytes)](https://docs.cartesia.ai/2026-03-01/api-reference/infill/bytes.md): Generate audio that smoothly connects two existing audio segments #### Admin ##### Usage - [Get Credit Usage](https://docs.cartesia.ai/2026-03-01/api-reference/usage/credits.md): Returns your credit usage over time, bucketed by the requested interval. - [Get Agent Usage](https://docs.cartesia.ai/2026-03-01/api-reference/usage/agents.md): Returns your agent usage over time, bucketed by the requested interval. ##### API Keys - [List API Keys](https://docs.cartesia.ai/2026-03-01/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. - [Get API Key](https://docs.cartesia.ai/2026-03-01/api-reference/api-keys/get.md): Returns metadata for a single API key. ##### Organizations - [List Users](https://docs.cartesia.ai/2026-03-01/api-reference/organizations/list-users.md): Lists users in the organization, ordered by when they joined (newest first) - [Get User](https://docs.cartesia.ai/2026-03-01/api-reference/organizations/get-user.md) - [Remove User](https://docs.cartesia.ai/2026-03-01/api-reference/organizations/remove-user.md): Removes a non-admin user from the organization without deleting their account - [List Invites](https://docs.cartesia.ai/2026-03-01/api-reference/organizations/list-invites.md): Lists organization invites, filtered by status - [Create Invites](https://docs.cartesia.ai/2026-03-01/api-reference/organizations/create-invites.md): Invites email addresses to the organization as members. If any email is rejected, the whole request fails and no invites are created. Rate limited to 10 requests per hour. - [Get Invite](https://docs.cartesia.ai/2026-03-01/api-reference/organizations/get-invite.md) - [Cancel Invite](https://docs.cartesia.ai/2026-03-01/api-reference/organizations/cancel-invite.md): Cancels a pending invite. If it has already been accepted, [remove the user](/api-reference/organizations/remove-user) instead. ### 2024-11-13 #### Use the API - [API Conventions](https://docs.cartesia.ai/use-the-api/api-conventions.md) - [Concurrency and WebSocket Limits](https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts.md): Learn about concurrency limits and timeouts with the Cartesia API. #### API Status - [API Status and Version](https://docs.cartesia.ai/2024-11-13/api-reference/api-status/get.md) #### TTS - [Text-to-Speech (Bytes)](https://docs.cartesia.ai/2024-11-13/api-reference/tts/bytes.md): Stream audio from a complete transcript - [Text-to-Speech (SSE)](https://docs.cartesia.ai/2024-11-13/api-reference/tts/sse.md): Stream audio with extra metadata from a complete transcript - [Text-to-Speech (WebSocket)](https://docs.cartesia.ai/2024-11-13/api-reference/tts/websocket.md): Generate audio in realtime with contexts #### STT - [Realtime Speech-to-Text (Auto)](https://docs.cartesia.ai/api-reference/stt/turns/websocket.md): Realtime speech transcription with built-in turn detection - [Speech-to-Text (Streaming)](https://docs.cartesia.ai/2024-11-13/api-reference/stt/websocket.md): Realtime speech transcription without turn detection - [Batch Speech-to-Text](https://docs.cartesia.ai/2024-11-13/api-reference/stt/transcribe.md): Transcribes an audio file of any length #### Auth - [Generate a New Access Token](https://docs.cartesia.ai/2024-11-13/api-reference/auth/access-token.md): Generates a short-lived access token to make API requests from authenticated clients. #### Voices - [List Voices](https://docs.cartesia.ai/2024-11-13/api-reference/voices/list.md) - [Clone Voice](https://docs.cartesia.ai/2024-11-13/api-reference/voices/clone.md) - [Delete Voice](https://docs.cartesia.ai/2024-11-13/api-reference/voices/delete.md) - [Update Voice](https://docs.cartesia.ai/2024-11-13/api-reference/voices/update.md) - [Get Voice](https://docs.cartesia.ai/2024-11-13/api-reference/voices/get.md) - [Localize Voice](https://docs.cartesia.ai/2024-11-13/api-reference/voices/localize.md): Create a new voice from an existing voice localized to a new language and dialect. - [Mix Voices](https://docs.cartesia.ai/2024-11-13/api-reference/voices/mix.md) - [Create Voice](https://docs.cartesia.ai/2024-11-13/api-reference/voices/create.md): Create voice from an embedding #### Infill - [Infill (Bytes)](https://docs.cartesia.ai/2024-11-13/api-reference/infill/bytes.md): Generate audio that smoothly connects two existing audio segments ### 2024-06-10 #### Use the API - [API Conventions](https://docs.cartesia.ai/use-the-api/api-conventions.md) - [Concurrency and WebSocket Limits](https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts.md): Learn about concurrency limits and timeouts with the Cartesia API. #### API Status - [API Status and Version](https://docs.cartesia.ai/2024-06-10/api-reference/api-status/get.md) #### TTS - [Text-to-Speech (Bytes)](https://docs.cartesia.ai/2024-06-10/api-reference/tts/bytes.md): Stream audio from a complete transcript - [Text-to-Speech (SSE)](https://docs.cartesia.ai/2024-06-10/api-reference/tts/sse.md): Stream audio with extra metadata from a complete transcript - [Text-to-Speech (WebSocket)](https://docs.cartesia.ai/2024-06-10/api-reference/tts/websocket.md): Generate audio in realtime with contexts #### STT - [Realtime Speech-to-Text (Auto)](https://docs.cartesia.ai/api-reference/stt/turns/websocket.md): Realtime speech transcription with built-in turn detection - [Speech-to-Text (Streaming)](https://docs.cartesia.ai/2024-06-10/api-reference/stt/websocket.md): Realtime speech transcription without turn detection - [Batch Speech-to-Text](https://docs.cartesia.ai/2024-06-10/api-reference/stt/transcribe.md): Transcribes an audio file of any length #### Auth - [Generate a New Access Token](https://docs.cartesia.ai/2024-06-10/api-reference/auth/access-token.md): Generates a short-lived access token to make API requests from authenticated clients. #### Voices - [List Voices](https://docs.cartesia.ai/2024-06-10/api-reference/voices/list.md) - [Clone Voice](https://docs.cartesia.ai/2024-06-10/api-reference/voices/clone.md) - [Delete Voice](https://docs.cartesia.ai/2024-06-10/api-reference/voices/delete.md) - [Update Voice](https://docs.cartesia.ai/2024-06-10/api-reference/voices/update.md) - [Get Voice](https://docs.cartesia.ai/2024-06-10/api-reference/voices/get.md) - [Localize Voice](https://docs.cartesia.ai/2024-06-10/api-reference/voices/localize.md): Create a new voice from an existing voice localized to a new language and dialect. - [Mix Voices](https://docs.cartesia.ai/2024-06-10/api-reference/voices/mix.md) - [Create Voice](https://docs.cartesia.ai/2024-06-10/api-reference/voices/create.md): Create voice from an embedding #### Infill - [Infill (Bytes)](https://docs.cartesia.ai/2024-06-10/api-reference/infill/bytes.md): Generate audio that smoothly connects two existing audio segments ## OpenAPI Specs - [latest](/latest.yml) - [api](/2026-03-01/api.yml) - [api](/2024-11-13/api.yml) - [api](/2024-06-10/api.yml) ## AsyncAPI Specs - [asyncapi](/2024-06-10/asyncapi.yml) - [asyncapi](/2024-11-13/asyncapi.yml) - [asyncapi](/2026-03-01/asyncapi.yml) - [asyncapi](/2026-08-14/asyncapi.yml) - [asyncapi](/asyncapi.yml)