---
title: "Delete a role"
method: DELETE
path: "/roles/{id}"
tags: ["Roles"]
---

# Delete a role

`DELETE /roles/{id}`

## Response `200`

Role deleted

- RolesDto
  - `id` string, required — Role ID
  - `permissions` PermissionDto[], required — Permissions
    - `id` string, required — Permission ID
    - `name` string, required — Permission name
    - `description` string, required — Permission description
    - `subject` SubjectDto, required
      - `id` string — Subject ID
      - `fields` string[] — Fields
      - `entity` string — Entity identified by this subject
    - `actions` string[], required — The actions that this permission allows to be performed on the subject
  - `name` string, required — Role name
  - `description` string, required — Role description
  - `public` boolean, required — If **True**, this role is available to all user, including those that are not logged it.
  - `default` boolean, required — If **True**, this role is assigned to any newly created organization.

---

[API](https://skmtc.net/fanhero/apis/tenant-endpoints.md) · [All operations](https://skmtc.net/fanhero/apis/tenant-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanhero/tenant-endpoints/versions/8e7584c449dc/schema)