When to use this article

This article may be used any time there is a need to delete teams in bulk from Atlassian Cloud. For example, after testingmigration to Atlassian Cloud, it may be necessary to delete many teams from the organization to retest.

Set up Postman

Prepare data

1. Follow the steps in the GET Rest API  "Get a list of teams" to retrieve the teamId.

2. Locate the "teamId": "<string>" from the HTTP response for each team.

3. Copy the teamId values for the teams you want to delete.

4. Use these team IDs in the DELETE Rest API calls mentioned in the section “Set up REST API call”, replacing {{teamId}} with each value.

Set up REST API call

1. Click New, or type Ctrl + N  (Windows/Linux) or Cmd  + N (MacOS).

2. Select "HTTP".

3. Name the request "Delete Team from Atlassian Cloud".

4. Change the method from GET  to DELETE .

5. In the URL, paste:

   https://api.atlassian.com/public/teams/v1/org/{{organizationId}}/teams/{{teamId}}

6. Replace {{organizationId}} with your organization id if it has not been set elsewhere (for example, at the environment level).
   1. Please follow the steps at Retrieve my Atlassian Cloud Organization's ID to retrieve your organization id.
7. Click the "Authorization" tab.

8. Ensure Type is "Inherit auth from parent".

9. Click Save , saving into the "Atlassian Cloud User Management" collection.

Execute runner 

1. Change the environment using the environment selector at the top right of Postman, selecting "Atlassian Cloud".

2. Select Collections in the sidebar.

3. Select the "Atlassian Cloud User Management" collection.

4. On the Overview tab, select ▶️ Run towards the top right corner.

5. Under Run order, ensure there is one and only REST API call - "Delete Team from Atlassian Cloud".

6. On the Functional tab, select Run manually.

7. Click Data.

8. Navigate to and select the previously prepared csv file.

9. Reduce the number of "Iterations" under Run configuration to 1.
   
   

   Deleting a team is a destructive and irreversible action. We strongly recommend testing with a single team and verifying results before systematically deleting all teams.

10. Leave Advanced settings as is.

11. Click Run Atlassian Cloud User Management.

12. Check Postman to ensure the runner collection has passed all tests. The run results should show:

    1. "Iterations" and "All tests" to be equivalent in count

    2. Passed (n) where n is the number of iterations

    3. Failed (0)

    4. Skipped (0)

13. Check admin.atlassian.com to ensure the team count has been reduced by one.

14. Rerun Postman Runner following the previous steps, with the number of "Iterations" set to the number of rows in the csv file. One error may be expected as it is not possible to delete a team that has already been deleted.

References

• developer.atlassian.com - Delete a Team
• Postman - Using the Collection Runner