Skip to main content
GET
Get Data Retention

Authorizations

Authorization
string
header
required

Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.

Path Parameters

workspace_id
integer
required

Workspace ID. Find this in Workspace > General Settings.

Response

Successful Response

Response schema for the data-retention settings endpoints.

retention_period_days
integer | null
required

Days a call is kept before it is erased. Null means never delete.

erasure_scope
enum<string> | null
required

What is destroyed when a call expires. Null when nothing is ever deleted.

Available options:
transcript_recording,
caller_data,
full,
null
allowed_retention_periods
(integer | null)[]
required

Retention windows the workspace's plan allows, in days, ascending. Contains null when the plan permits never deleting. The update endpoint accepts only these values.

allowed_erasure_scopes
enum<string>[]
required

Erasure scopes the workspace's plan allows, shallowest to deepest. The update endpoint accepts only these values.

Available options:
transcript_recording,
caller_data,
full
default_erasure_scope
enum<string> | null
required

The plan's default scope, useful to preselect when the workspace has none set yet. Null when the plan offers no scopes.

Available options:
transcript_recording,
caller_data,
full,
null