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

# Delete role

`DELETE /api/roles/{roleId}`

Deletes a role and removes all associated group assignments.

## Path parameters

- `roleId` string, uuid, required

## Response `200`

Confirmation that the role was deleted

- object — Confirmation that the role was deleted
  - `status` 'ok', required — Operation status

---

[API](https://skmtc.dev/gorules/apis/gorules-agent-api.md) · [All operations](https://skmtc.dev/gorules/apis/gorules-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gorules/gorules-agent-api/revisions/52c0773fcd80/schema)