Stay organized with collections
Save and categorize content based on your preferences.
NAME
gdcloud iam roles delete - Delete a custom role.
SYNOPSIS
gdcloud iam roles delete ROLE_NAME [--project=PROJECT] [flags]
DESCRIPTION
This command deletes a custom role at project scope, If the --project flag is provided, otherwise, it deletes a custom role at an organization-scope.
EXAMPLES
To delete a custom role at organization scope, run:
gdcloud iam roles delete org-role
To delete a custom role at project scope, run:
gdcloud iam roles delete project-role --project my-project
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration, --format, --help, --project, --quiet.
[[["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-08-25 UTC."],[[["\u003cp\u003eThis command \u003ccode\u003egdcloud iam roles delete\u003c/code\u003e is used to delete a custom role within either a project or organization.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eROLE_NAME\u003c/code\u003e argument specifies the custom role to be deleted.\u003c/p\u003e\n"],["\u003cp\u003eAdding the \u003ccode\u003e--project\u003c/code\u003e flag allows for the deletion of a custom role at the project level.\u003c/p\u003e\n"],["\u003cp\u003eOmitting the \u003ccode\u003e--project\u003c/code\u003e flag results in the command deleting a custom role at the organization level.\u003c/p\u003e\n"]]],[],null,["# gdcloud iam roles delete\n\nNAME\n----\n\ngdcloud iam roles delete - Delete a custom role.\n\nSYNOPSIS\n--------\n\n gdcloud iam roles delete ROLE_NAME [--project=PROJECT] [flags]\n\nDESCRIPTION\n-----------\n\nThis command deletes a custom role at project scope, If the --project flag is provided, otherwise, it deletes a custom role at an organization-scope.\n\n### EXAMPLES\n\n\n To delete a custom role at organization scope, run:\n\n gdcloud iam roles delete org-role\n\n To delete a custom role at project scope, run:\n\n gdcloud iam roles delete project-role --project my-project\n\n### GDCLOUD WIDE FLAGS\n\nThese flags are available to all commands: `--configuration`, `--format`, `--help`, `--project`, `--quiet`.\n\nFor more information, see the [gdcloud CLI reference overview](/distributed-cloud/hosted/docs/latest/gdch/resources/gdcloud-reference/gdcloud) page."]]
