How to Delete an Organization

Deleting an organization removes it from your Vultr account. This action disassociates all users, groups, roles, and policies linked to the organization. Existing user accounts are not deleted from the platform, but they lose access to the organization and its resources.

This guide explains how to delete an organization using the Vultr API.

1. Send a GET request to the List Organizations endpoint to retrieve all organizations associated with your account.

   console Copy

   $ curl "https://api.vultr.com/v2/organizations" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"
   

   Explain Code

   Note the id of the organization you want to delete.

2. Send a GET request to the Read Organization endpoint to retrieve the organization details. Replace {organization-id} with the id you retrieved in the previous step. Verify that the name and type match the organization you intend to delete.

   console Copy

   $ curl "https://api.vultr.com/v2/organizations/{organization-id}" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"
   

   Explain Code

3. Send a DELETE request to the Delete Organization endpoint to delete the organization.

   console Copy

   $ curl "https://api.vultr.com/v2/organizations/{organization-id}" \
       -X DELETE \
       -H "Authorization: Bearer ${VULTR_API_KEY}"
   

   Explain Code

   A successful deletion returns an HTTP 204 No Content response with no response body.

4. Send a GET request to the List Organizations endpoint to retrieve all organizations.

   console Copy

   $ curl "https://api.vultr.com/v2/organizations" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"
   

   Explain Code

   Verify that the deleted organization no longer appears in the list. Save the organization id if you may need to restore it later.