Method: organizations.delete

Delete an Apigee organization. For organizations with BillingType EVALUATION, an immediate deletion is performed. For paid organizations (Subscription or Pay-as-you-go), a soft-deletion is performed. The organization can be restored within the soft-deletion period, which is specified using theretention field in the request or by filing a support ticket with Apigee. During the data retention period specified in the request, the Apigee organization cannot be recreated in the same Google Cloud project.

IMPORTANT: The default data retention setting for this operation is 7 days. To permanently delete the organization in 24 hours, set the retention parameter toMINIMUM.

HTTP request

DELETE https://apigee.googleapis.com/v1/{name=organizations/*}

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Name of the organization. Use the following structure in your request:organizations/{org}

Authorization requires the followingIAM permission on the specified resourcename:

  • apigee.organizations.delete

Query parameters

Parameters
retention

enum (DeletionRetention)

Optional. This setting is applicable only for organizations that are soft-deleted (i.e., BillingType is not EVALUATION). It controls how long Organization data will be retained after the initial delete operation completes. During this period, the Organization may be restored to its last known state. After this period, the Organization will no longer be able to be restored.

Note: During the data retention period specified using this field, the Apigee organization cannot be recreated in the same Google Cloud project.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance ofOperation.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

DeletionRetention

Data retention settings for deleting Organizations.

Enums
DELETION_RETENTION_UNSPECIFIEDDefault data retention setting of seven days will be applied.
MINIMUMOrganization data will be retained for the minimum period of 24 hours.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-17 UTC.