CircleCI Logo
Navigation Menu Icon

Delete organizations and projects

Language Icon 17 hours ago · 5 min read
Cloud
Contribute Go to Code

This page details everything you need to know about deleting organizations and projects connected to CircleCI.

If you only want to stop builds for a project and keep the complete build history, see the Stop building a project on CircleCI page.

VCS integration Delete organization Delete project Notes

GitHub App

Yes

Yes

The organization will remain visible for several hours before disappearing.

GitLab

Yes

Yes

The organization will remain visible for several hours before disappearing.

Bitbucket Data Center

Yes

Yes

The organization will remain visible for several hours before disappearing.

GitHub OAuth app

Yes

Yes

Deleting the organization removes all content from the organization. The organization will remain visible but without data underneath.

Bitbucket Cloud

Yes

Yes

Deleting the organization removes all content from the organization. The organization will remain visible but without data underneath.

Delete an organization

You can only delete an organization when both the below conditions are met:

  • The organization is on a Free Plan.

  • The user performing the action has an admin role in the organization.

You can delete your organization from the CircleCI web app or via the CircleCI API:

This action will permanently delete the organization for you and all organization members.

  • CircleCI web app

  • API

  1. In the CircleCI web app, select your org from the org cards on your user homepage.

  2. Select Organization Settings in the sidebar.

  3. Scroll to the bottom of the Overview page and select Delete Organization.

  4. Confirm your choice by typing the organization name and selecting Permanently Delete Organization in the popup.

  1. Set up your API authentication. Steps are available in the API developers guide.

  2. You can use the Delete an organization endpoint with either your organization ID or your organization slug. You can retrieve both from the CircleCI web app under Organization Settings  Overview.

    curl --request DELETE \
  --url https://circleci.com/api/v2/organization/<org-slug-or-id> \
  --header "Circle-Token: ${CIRCLE_TOKEN}"

Delete a project

Only organization admins and project admins can delete projects.

If you want to remove a project from your CircleCI account, follow the steps below.

Deleting a project will remove the complete build history.

  • CircleCI web app

  • API

  1. In the CircleCI web app, select your org from the org cards on your user homepage.

  2. Select Projects from the sidebar and locate your project from the list. You can use the search to help.

  3. Select the ellipsis more icon next to your project and select Project Settings.

  1. Scroll to the bottom of the Overview page, select Delete Project.

  2. Confirm your choice by typing the project name and selecting Permanently Delete Project in the popup.

  1. Set up your API authentication. Steps are available in the API developers guide.

  2. You need the project slug to use the Delete a project endpoint. You can retrieve the project slug from the CircleCI web app under Project Settings  Overview.

    curl --request DELETE \
  --url https://circleci.com/api/v2/project/<project-slug> \
  --header "Circle-Token: ${CIRCLE_TOKEN}"

If you encounter an error, open a new support request with details of the project that you wish to remove. Choose the "Build Failure/Configuration Help/Service Issue" option when opening the request.

For more information on submitting support requests, see How to submit a support ticket .