---
title: "DELETE /{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionName}"
method: DELETE
path: "/{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionName}"
---

# DELETE /{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionName}

`DELETE /{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionName}`

Deletes a custom role definition.

## Path parameters

- `scope` string, required
- `roleDefinitionName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- RoleDefinition — Role definition.
  - `id` string — The role definition ID.
  - `name` string — The role definition name.
  - `type` 'Microsoft.Authorization/roleDefinitions' — The role definition type.
  - `properties` RoleDefinitionProperties — Role definition properties.
    - `roleName` string — The role name.
    - `description` string — The role definition description.
    - `type` 'AKVBuiltInRole' | 'CustomRole' — The role type.
    - `permissions` Permission[] — Role definition permissions.
      - `actions` string[] — Action permissions that are granted.
      - `notActions` string[] — Action permissions that are excluded but not denied. They may be granted by other role definitions assigned to a principal.
      - `dataActions` DataAction[] — Data action permissions that are granted.
      - `notDataActions` DataAction[] — Data action permissions that are excluded but not denied. They may be granted by other role definitions assigned to a principal.
    - `assignableScopes` RoleScope[] — Role definition assignable scopes.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.dev/azure/apis/keyvault-administration.md) · [All operations](https://skmtc.dev/azure/apis/keyvault-administration/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/keyvault-administration/revisions/207d840b9335/schema)