Cloud Data Retention Policy

CircleCI implements a data retention policy to maintain optimal performance and reliability across our platform. This policy determines how long we store your build data and other pipeline-related information.

What is Build Data?

Build data includes:

All pipeline runs
Workflows within those pipelines (including reruns)
Jobs within those workflows
Information viewable in the CircleCI UI or retrievable via API

Note: Workspaces, caches, and artifacts have separate retention policies that can be customized.

Retention Periods by Plan

Our data retention periods vary based on your subscription plan:

Plan Type	Retention Period
Free Plan	90 days
Performance Plan	180 days
Custom Performance Plan	180 days
Scale Plan	2 years

Attempting to access pipeline data that precedes your plan's retention period you will receive a 404 error in the UI or in the API response.

Customizing Storage Retention

You can set custom retention periods for artifacts, workspaces, and caches to optimize storage usage and costs.

To access the usage controls:

Log in to your CircleCI account
Navigate to Organization Settings (click on your organization name in the top left)
Select Plan from the left sidebar
Click on Usage Controls