---
search:
  tags:
    - Roles and permissions
    - DELETE
seo:
  description: >-
    Requires ac:delete, and organization:delete for a Role that… Reference for
    the DELETE /organizations/{organizationId}/roles/{roleId} endpoint in the
    Auth API.
sidebar:
  label: Delete a custom Role
  badge: DELETE
title: Delete a custom Role
type: openapi-operation
---
Requires ac:delete, and organization:delete for a Role that grants it. Deletes the Role's Grants, Memberships and pending invitations; members holding no other Role leave the organization. Built-in Roles cannot be deleted (409).

`DELETE /organizations/{organizationId}/roles/{roleId}`

**Responses**

- `204` — The Role is deleted.
- `default` — The request failed.
