Skip to content
17 changes: 11 additions & 6 deletions chapters/limits-and-specifications/data-retention.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
---
title: Data retention
description: "Data retention policies and zero data behavior"
title: Data retention and zero data retention
description: "Understand Gladia retention windows for audio, transcripts and metadata, Enterprise zero data retention, callback delivery and retrieval limitations."

Check warning on line 3 in chapters/limits-and-specifications/data-retention.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/data-retention.mdx#L3

Did you really mean 'Gladia'?
sidebarTitle: Data retention
---

To provide transcription services, Gladia processes several types of data:
Gladia's data retention depends on the plan and the type of data. Audio and transcript retention are separate from API metadata and operational logs. Enterprise customers can request custom retention or zero data retention. Under the documented zero-retention workflow, results are delivered through callbacks and are not available for later retrieval through the API or playground. The data types are:

Check warning on line 7 in chapters/limits-and-specifications/data-retention.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/data-retention.mdx#L7

Did you really mean 'Gladia's'?

- **Audio input**: Audio files or audio streams provided for transcription
- **Transcription output**: Text, timestamps, words, utterances
Expand All @@ -12,8 +13,9 @@

The duration for which your data is stored depends on your plan type. You have two main options for data retention:

- **Standard data retention:** Data is stored according to the default windows below (by plan and data type). Audio files and transcripts remain retrievable through the API and the [Gladia playground](https://app.gladia.io/?utm_campaign=197609689-Website&utm_source=documentation&utm_content=sign-up) for that window. Enterprise customers can request a custom retention period. The minimum custom value is 0, which means data is deleted within 24 hours.
- **Zero data retention:** Data storage is minimized at all stages, avoiding temporary storage whenever possible. All data is deleted immediately after processing.
- **Standard retention:** Audio and transcripts remain retrievable during the default retention window for your plan and data type.
- **Custom retention (Enterprise):** Enterprise customers can request a custom period. A custom value of zero means deletion within 24 hours; it does not mean immediate deletion.
- **Zero data retention (Enterprise):** This separate option uses ephemeral processing and immediate deletion after processing, as described below. It is not the same as a custom retention value of zero.

<Info>
Only Enterprise users are eligible for custom data retention and the zero data retention option.
Expand Down Expand Up @@ -43,9 +45,9 @@
| API Metadata | 1 year | Request IDs, timestamps, and processing status only |
| Logs | Limited period | Operational logs for service quality and reliability |

## Zero Data Retention behavior
## Zero data retention behavior

When Zero Data Retention is enabled, Gladia processes data ephemerally; no data is stored at rest.

Check warning on line 50 in chapters/limits-and-specifications/data-retention.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/data-retention.mdx#L50

Did you really mean 'Gladia'?

<Warning>
Enabling Zero Data Retention is a **breaking change** if your integration relies on file upload ([`/v2/upload`](/api-reference/v2/upload/audio-file)) or result retrieval via polling ([`GET /v2/pre-recorded/:id`](/api-reference/v2/pre-recorded/get)). Review the restrictions below and update your integration **before** enabling ZDR.
Expand All @@ -53,7 +55,7 @@

### Disabled endpoints

- **File upload is disabled**: The [`/v2/upload`](/api-reference/v2/upload/audio-file) endpoint is fully disabled. Any request to this endpoint will fail. The asynchronous API must use an external audio file URL (e.g. an S3 presigned URL or any publicly accessible URL) passed directly as `audio_url` to [`POST /v2/pre-recorded`](/api-reference/v2/pre-recorded/init).

Check warning on line 58 in chapters/limits-and-specifications/data-retention.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/data-retention.mdx#L58

Did you really mean 'presigned'?
- **Result polling is disabled**: Transcription results cannot be retrieved via [`GET /v2/pre-recorded/:id`](/api-reference/v2/pre-recorded/get). The only way to receive results is through [callbacks](/api-reference/v2/pre-recorded/callback/success).

### No data stored
Expand All @@ -70,13 +72,16 @@

<Steps>
<Step title="Host audio files externally">
Replace any usage of `/v2/upload` with an external storage provider. Pass a publicly accessible or signed URL (e.g. AWS S3 presigned URL, GCS signed URL) as `audio_url` when creating a transcription job.

Check warning on line 75 in chapters/limits-and-specifications/data-retention.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/data-retention.mdx#L75

Did you really mean 'presigned'?
</Step>
<Step title="Set up a callback endpoint">
Configure a callback URL in your transcription requests to receive results, since polling and the playground will not be available. See [callback configuration](/api-reference/v2/pre-recorded/init) for setup details.
</Step>
<Step title="Remove polling and GET calls">
Remove any code that retrieves transcription results via `GET /v2/pre-recorded/:id` or relies on the Gladia playground for debugging. Results are delivered exclusively through callbacks.

Check warning on line 81 in chapters/limits-and-specifications/data-retention.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/data-retention.mdx#L81

Did you really mean 'Gladia'?
</Step>
</Steps>

For pre-recorded transcription with zero data retention, use an external audio URL and deliver results through a callback. File upload is unavailable under zero data retention, and results cannot be retrieved later through the API or playground. See the [pre-recorded request reference](/api-reference/v2/pre-recorded/init).

For current security attestations, data residency information, and agreements, see the [compliance hub](https://www.gladia.io/compliance-hub). Plan eligibility for custom retention and zero data retention is listed on [Pricing](https://www.gladia.io/pricing). Choosing a retention setting does not by itself establish your application's overall legal compliance.
Loading