Can I delete a project?

Project Deletion

Per our data retention policy, depending on your plan, we retain build data for the following periods :

  • Free Plans: 90 days
  • Performance and Custom Plans: 180 days
  • Scale Plans: 2 years

You can also set custom data retention periods for artifacts, workspaces and cache items by navigating to the Usage Controls in the Plan portal:

https://app.circleci.com/settings/plan/vcs/organisation/usage-controls

If you need a project deleted sooner than our policy outlines, please follow this guide. Deleting a project will remove the complete build history. 

Project Deletion via the UI

You can delete your project in Project Settings by scrolling to the bottom of the page and clicking "Delete Project"

Screenshot 2025-04-29 at 9.09.42 AM.png

Project Deletion via the v2 API

Use the following endpoint to delete your project via the v2 API:

curl --request DELETE \
--url https://circleci.com/api/v2/project/gh/CircleCI-Public/api-preview-docs \
--header 'Authorization: Basic REPLACE_BASIC_AUTH'

Additional Resources

 

Was this article helpful?
1 out of 19 found this helpful

Comments

0 comments

Article is closed for comments.