How to Delete an Organization

Submitting a Request

To submit a deletion request, please open a ticket with our support team via the Support Center.

In the ticket,
please provide the following details:

  1. Organization Name (case-sensitive)
  2. VCS provider (if it is GitHub, Bitbucket, Gitlab, etc)

Once a request is received, you can expect our agents to ask for confirmation of your request. 

CircleCI will only approve deletion requests made by organization admins.
Please ensure you have not disconnected your org from CircleCI before submitting a request, otherwise our Support agents will not be able to verify your admin status directly.

 

Please understand that the deletion of your organization can take up to several hours.
This depends on the total number of builds made under the organization.

 

Organization Data Deletion

Organization deletion effectively deletes all build history, contexts, and project environment variables for a given organization.

To delete an organization account, please file a Support ticket. 

To make a user data deletion request please visit the CIrcleCI privacy page and click "Make a Request"

GitHub App

If your VCS provider is GitHub App, please uninstall CircleCI App from GitHub following the steps below.

  1. Visit the following link: GitHub Installed Apps Settings.
    • If necessary, switch the organization by clicking on Switch to another account found at the top left of the page.
  2. Look for the CircleCI App under the Installed GitHub Apps section. Once found, click on Configure.

  3. After opening the CircleCI Apps Configuration page, scroll down to the section labeled Danger Zone.

  4. Click on Uninstall. This will remove the triggers that are sent to CircleCI.

After successful completion of these steps, the CircleCI App will be uninstalled from your GitHub account, and prepared for submission of organization to be deleted from CircleCI.

GitLab

If your VCS provider is GitLab, please delete Circle triggers and configuration by following the steps below for each project within the organization prior to submitting a support ticket. 

  1. Delete triggers from CircleCI: Navigate to project settings > triggers
     
    Screenshot 2023-10-11 at 4.18.58 PM.png 
  2. Delete Configuration: Navigate to project settings > Configuration

    Screenshot 2023-10-11 at 4.21.07 PM.png

 

Important: After Deletion is Complete

Our agents will inform you once the organization account is deleted.
Please be aware that, this organization account can still show up on the left navigation bar on our UI.

This is because when a user logs in to CircleCI, CircleCI looks up all their linked organizations in the user's connected VCS account (e.g., GitHub), and recreates them if not found.

Please note that the original organization account was deleted, and all build histories are removed.
This newly-created organization account does not have any build history, and has a different organization ID.

Please update your organization's repositories to prevent them from further building on CircleCI.
You would want to:

  1. Remove any CircleCI webhooks in your repository settings
  2. (Optional) Remove the .circleci/config.yml file from your repository source code

Was this article helpful?
0 out of 3 found this helpful

Comments

0 comments

Article is closed for comments.