Data Retention

Configure organization-wide data retention policies that apply across all projects.

Organization-level data retention policies set default retention periods that apply across all projects in your organization. Individual projects can override these defaults by toggling off Inherit from organization in their own retention settings.

Organization Data Retention

Retention Categories

You can set a separate retention period for each of the following data types:

Data TypeWhat Gets Deleted
Traces & SpansTraces and spans older than the retention period are permanently deleted. Shorter retention reduces storage costs.
Test RunsTest runs past the retention period are removed along with their test cases and metrics.
DatasetsInactive datasets with no activity beyond the retention period are permanently deleted.
PromptsInactive prompts with no activity beyond the retention period are permanently deleted.

Setting a Retention Period

For each data type, choose one of:

  • Forever — Data is never automatically deleted.
  • Days — Enter a number of days (e.g., 30).
  • Months — Enter a number of months (e.g., 6).
  • Years — Enter a number of years (e.g., 2).

You select one unit per data type — these are not combined. For example, you set traces & spans to “2 Years”, not “2 Years and 30 Days”.

To configure retention:

  1. Navigate to Organization SettingsData Retention
  2. For each data type, select the unit (Forever, Days, Months, or Years) and enter a duration
  3. Click Save

Retention cleanup happens daily at midnight UTC. Changing retention settings will not trigger an immediate deletion — stale data will be removed during the next cleanup cycle.

How Deletion Works

When data is deleted, any child data associated with it gets deleted too. Here’s how the hierarchy works:

  • Test Runs — Deleting a test run also removes its associated metrics, test cases, traces, spans, and threads.
  • Threads — Deleting a thread removes all traces, spans, and metrics within it.
  • Traces — Deleting a trace removes its spans and metrics, but leaves the parent thread intact.

For example, if you set your trace & span retention to 14 days, any traces older than 14 days will be deleted along with all their associated spans and metrics.

Projects inherit these organization retention policies by default. To configure project-specific retention periods, go to the project’s Data UsageRetention tab and toggle off Inherit from organization.