When you delete a custom role, the following changes occur immediately:
You cannot bind a principal to the custom role in an IAM Policy.
Existing bindings to the custom role are not changed, but they have no effect.
By default, the response from roles.list does not include the custom role.
A deleted custom role still counts toward the custom role limit until it is permanently deleted. You have 7 days to undelete the custom role. After 7 days, the following changes occur:
The custom role is permanently deleted and cannot be recovered.
If an IAM policy contains a binding to the custom role, the binding is permanently removed.
The custom role no longer counts toward your custom role limit.
The name parameter's value depends on the target resource for the request, namely projects or organizations. Each resource type's name value format is described below:
projects.roles.delete: projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}. This method deletes only custom roles that have been created at the project level. Example request URL: https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}
organizations.roles.delete: organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}. This method deletes only custom roles that have been created at the organization level. Example request URL: https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}
Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.
Authorization requires the following IAM permission on the specified resource name:
[[["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-01-16 UTC."],[[["This endpoint is used to delete a custom Role within either a project or an organization."],["Immediately upon deletion, the custom role can no longer be used in new IAM policy bindings, and existing bindings become ineffective, though the role is not removed from the list by default."],["Deleted custom roles are recoverable for 7 days and still count against the custom role limit, after which they are permanently deleted."],["The HTTP request for deletion uses the `DELETE` method and requires the role's name, specified in the format `organizations/*/roles/*` or `projects/*/roles/*`, to be placed in the path parameters of the URL."],["Authorization to delete a role requires the `iam.roles.delete` permission on the specified resource name and one of the provided OAuth scopes."]]],[]]