---
title: "DELETE /{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}"
method: DELETE
path: "/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}"
tags: ["RoleAssignments"]
---

# DELETE /{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}

`DELETE /{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}`

Deletes a role assignment.

## Path parameters

- `scope` string, required
- `roleAssignmentName` string, required

## Parameters

- `../../../../../common-types/resource-management/v2/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref

## Response `200`

OK - Returns information about the role assignment.

- RoleAssignment — Role Assignments
  - `id` string — The role assignment ID.
  - `name` string — The role assignment name.
  - `type` string — The role assignment type.
  - `properties` RoleAssignmentPropertiesWithScope — Role assignment properties with scope.
    - `scope` string — The role assignment scope.
    - `roleDefinitionId` string — The role definition ID.
    - `principalId` string — The principal ID.
    - `principalType` 'User' | 'Group' | 'ServicePrincipal' | 'ForeignGroup' — The principal type of the assigned principal ID.
    - `canDelegate` boolean — The Delegation flag for the role assignment

## Other responses

- `204` — Role assignment already deleted or does not exist.
- `default` — Error response describing why the operation failed.

## Changes

- **2021-02-21** (2018-09-01-preview) `e30a31d275fb` — 1 warning, 1 info
  - deleted the `query` request parameter `api-version`
  - added the success response with the status `204`

[Change history](https://skmtc.dev/azure/apis/authorizationmanagementclient-5/changes/:scope/providers/Microsoft.Authorization/roleAssignments/:roleAssignmentName/delete.md)

---

[API](https://skmtc.dev/azure/apis/authorizationmanagementclient-5.md) · [All operations](https://skmtc.dev/azure/apis/authorizationmanagementclient-5/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/authorizationmanagementclient-5/revisions/209daa6419a3/schema)