---
title: "Delete Role"
method: DELETE
path: "/v2/schema/{proj_id}/{env_id}/roles/{role_id}"
tags: ["Roles"]
---

# Delete Role

`DELETE /v2/schema/{proj_id}/{env_id}/roles/{role_id}`

Deletes a tenant role and all its related data.
This includes any permissions granted to said role.

## Path parameters

- `role_id` string, required — Either the unique id of the role, or the URL-friendly key of the role (i.e: the "slug").
- `proj_id` string, required — Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").
- `env_id` string, required — Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/permit/apis/permit-io-api.md) · [All operations](https://skmtc.dev/permit/apis/permit-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/permit/permit-io-api/revisions/13faa12b4692/schema)