Delete an organization

This is for:

System Administrator
In this article

You’ll rarely (if ever) need to delete a Coveo organization, unless you originally created this organization for a specific purpose such as testing, and this purpose is now finished. In such a case, you may delete the obsolete organization.

Deleting a Coveo organization is permanent. Make sure you know what you’re doing before you perform this call.

Use the Delete an organization operation to permanently remove a specific organization from the Coveo Platform.

You can also perform this action from the Coveo Administration Console Settings page. See Organization details.

  • It’s impossible to delete an organization that’s in read-only mode (see Organization status). Often, this means that your organization is inactive, and you need to resume it first.

  • Upon deletion, Coveo keeps your organization backup until the end of the retention period. If an organization is restored within the retention period, the data will still be available.

Request template

DELETE https://platform.cloud.coveo.com/rest/organizations/<MyOrganizationId> HTTP/1.1
 
Accept: application/json
Authorization: Bearer <MyAccessToken>

In the request path:

In the Authorization HTTP header:

A successful response (204 No Content) signifies that the target organization no longer exists in Coveo.

Sample Request

Request - Deleting the mycoveocloudv2organizationg8tp8wu3 organization

DELETE https://platform.cloud.coveo.com/rest/organizations/mycoveocloudv2organizationg8tp8wu3 HTTP/1.1
 
Accept: application/json
Authorization: Bearer **********-****-****-****-************

Successful response - 204 No Content

{}