---
title: "Delete Role"
method: DELETE
path: "/api/v1/roles/{role_id}"
tags: ["roles"]
---

# Delete Role

`DELETE /api/v1/roles/{role_id}`

Delete a role. Optionally, reassign existing users with that role to a new role.

## Path parameters

- `role_id` integer, required — The ID of the role to delete

## Query parameters

- `reason` string, required — The reason for deleting the role
- `new_role_id` integer, nullable — Users with the deleted role will be reassigned to the new role, if a new role ID is provided

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/asksyllable/apis/syllablesdk.md) · [All operations](https://skmtc.net/asksyllable/apis/syllablesdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/asksyllable/syllablesdk/versions/ac3228f980bb/schema)