The retention settings object

⚠️

Preview — this feature is being built; the design below is the spec.

The retention_settings object as the API returns it. Every field below appears in every response that returns this object; fields with no value are null rather than missing.

Example

{
  "type": "retention_settings",
  "zero_data_retention": false,
  "request_logs_days": 30,
  "files_days": null,
  "batch_results_days": 29,
  "session_events_days": 90,
  "memory_enabled": true,
  "updated_at": "2026-11-05T10:00:00Z"
}

Fields

Field	Type	Description
`type`	string	The object type, always `retention_settings`.
`zero_data_retention`	boolean	Read-only here; set by contract. When `true`, prompts and outputs are not stored and the day settings below are ignored for content.
`request_logs_days`	integer	How long request and response bodies are kept for your Console logs, 0 to 30.
`files_days`	integer or null	Delete uploaded files automatically after this many days; `null` keeps them until you delete them.
`batch_results_days`	integer	Results files are deleted after this many days, 1 to 29.
`session_events_days`	integer	Agent session event logs, 7 to 365.
`memory_enabled`	boolean	Whether memory stores may persist data.
`updated_at`	string	When it last changed.

Returned by

prompt_template runner

Was this page helpful?