Get Data Retention
Get a workspace’s data-retention policy.
Returns the retention window currently in force and the erasure scope applied when a call expires, alongside the windows and scopes the workspace’s plan allows — use those lists to build the options you offer before calling the update endpoint.
Authorizations
Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.
Path Parameters
Workspace ID. Find this in Workspace > General Settings.
Response
Successful Response
Response schema for the data-retention settings endpoints.
Days a call is kept before it is erased. Null means never delete.
What is destroyed when a call expires. Null when nothing is ever deleted.
transcript_recording, caller_data, full, null 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.
Erasure scopes the workspace's plan allows, shallowest to deepest. The update endpoint accepts only these values.
transcript_recording, caller_data, full The plan's default scope, useful to preselect when the workspace has none set yet. Null when the plan offers no scopes.
transcript_recording, caller_data, full, null