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 theretentionfield 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.
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_UNSPECIFIED
Default data retention setting of seven days will be applied.
MINIMUM
Organization data will be retained for the minimum period of 24 hours.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThis operation deletes an Apigee organization, with immediate deletion for EVALUATION billing types and soft-deletion with a retention period for paid subscriptions.\u003c/p\u003e\n"],["\u003cp\u003eThe default data retention period for soft-deleted organizations is 7 days, during which the organization can be restored.\u003c/p\u003e\n"],["\u003cp\u003eSetting the \u003ccode\u003eretention\u003c/code\u003e parameter to \u003ccode\u003eMINIMUM\u003c/code\u003e in the query parameters will permanently delete the organization after a 24-hour retention period.\u003c/p\u003e\n"],["\u003cp\u003eDuring the retention period, the deleted organization cannot be recreated within the same Google Cloud project.\u003c/p\u003e\n"],["\u003cp\u003eThe URL uses \u003ccode\u003eDELETE https://apigee.googleapis.com/v1/{name=organizations/*}\u003c/code\u003e and requires \u003ccode\u003eapigee.organizations.delete\u003c/code\u003e IAM permissions and \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: organizations.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [DeletionRetention](#DeletionRetention)\n- [Try it!](#try-it)\n\nDelete 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 the `retention` 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.\n\n**IMPORTANT: The default data retention setting for this operation is 7 days. To permanently delete the organization in 24 hours, set the retention parameter to `MINIMUM`.**\n\n### HTTP request\n\n`DELETE https://apigee.googleapis.com/v1/{name=organizations/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/apigee/docs/reference/apis/apigee/rest/v1/organizations.operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nDeletionRetention\n-----------------\n\nData retention settings for deleting Organizations."]]
