---
title: "Eliminar un rol"
method: DELETE
path: "/roles/{id}"
tags: ["Roles"]
---

# Eliminar un rol

`DELETE /roles/{id}`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/roles/{id}`
- Auth: HTTP bearer

Realiza una eliminación lógica (soft delete) del rol especificado.
El rol no se borra físicamente de la base de datos; se marca con `deleted: true`
y se actualiza `modifiedOn` a la fecha actual.

Solo se puede eliminar un rol que pertenezca al negocio del usuario autenticado.
Tras la eliminación se notifica por WebSocket a los usuarios conectados del negocio
y se registra el historial del cambio.

**Permiso requerido:** `RO_DELETE`

## Path parameters

- `id` string, required

## Response `200`

Rol eliminado exitosamente

- object
  - `message` string

## Other responses

- `401`: Token no proporcionado o inválido
- `403`: Sin permiso para eliminar roles (requiere RO_DELETE)
- `500`: Error interno del servidor o rol no encontrado en el negocio

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)