> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Eliminar rol

> Elimina un rol. Requiere `roles:manage`; se rechaza mientras esté asignado a un miembro o a una invitación pendiente.

Requiere `roles:manage`. Una clave de API necesita el scope `workspaces:write`.

### Ruta

**id** `string` *required*

ID del workspace.

**role\_id** `string` *required*

ID del rol.

### Respuesta

Respuesta vacía si todo sale bien.

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quien llama no tiene `roles:manage`. |
| 404 | `WORKSPACE_NOT_FOUND` | El workspace no existe o no eres miembro. |
| 404 | `WORKSPACE_ROLE_NOT_FOUND` | `role_id` no pertenece a este workspace. |
| 409 | `WORKSPACE_ROLE_IN_USE` | Un miembro tiene este rol, o existe una invitación pendiente con él. Reasigna o revoca primero. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.