Method: orgunits.delete
Removes an organizational unit.
HTTP request
DELETE https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
customerId |
string
The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the my_customer alias to represent your account's customerId. The customerId is also returned as part of the Users resource.
|
orgUnitPath |
string
The full path of the organizational unit (minus the leading /) or its unique ID.
|
Request body
The request body must be empty.
Response body
If successful, the response is a generic HTTP response whose format is defined by the method.
Authorization scopes
Requires one of the following OAuth scopes:
https://apps-apis.google.com/a/feeds/policies/
https://www.googleapis.com/auth/admin.directory.orgunit
For more information, see the Authorization guide.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-22 UTC.
[null,null,["Last updated 2024-08-22 UTC."],[[["Permanently deletes an organizational unit (OU) within a Google Workspace account."],["Requires providing the customer ID and the full path or unique ID of the target OU."],["Uses an HTTP DELETE request with an empty body, and authorization with specific OAuth scopes is necessary."],["Successful deletion results in a generic HTTP response, indicating the OU has been removed."]]],["This document outlines the process for deleting an organizational unit within a Google Workspace account. The action is performed via a `DELETE` HTTP request to a specified URL, including `customerId` and `orgUnitPath` as parameters. The request body must be empty. A successful deletion results in a generic HTTP response. Authorization requires either `https://apps-apis.google.com/a/feeds/policies/` or `https://www.googleapis.com/auth/admin.directory.orgunit` OAuth scopes.\n"]]
