> ## 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.

# Actualizar rol

> Actualiza el nombre o los permisos de un rol. Requiere `roles:manage`.

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

> [!NOTE]
>
> La misma protección contra escalada que en [Crear rol](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/roles/create.md), pero
> comprobada contra la **unión de los conjuntos de permisos antiguo y nuevo** del rol: quitar de un rol ajeno un permiso
> que no tienes también es editar algo que no es tuyo. Nadie —el propietario incluido en espíritu, aunque el propietario
> queda exento de la comprobación— puede editar el rol que tiene asignado, y nadie puede cambiar su propia asignación de
> rol a través de este endpoint.

### Ruta

**id** `string` *required*

ID del workspace.

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

ID del rol.

### Body

Reemplazo completo: mismos campos que [Crear rol](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/roles/create.md), todos obligatorios salvo los opcionales.

**name** `string` *required*

**permissions** `WorkspacePermission[]` *required*

**position** `number`

### Respuesta

Misma forma que [Crear rol](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/roles/create.md).

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quien llama no tiene `roles:manage`. |
| 403 | `WORKSPACE_PERMISSION_ESCALATION` | El conjunto de permisos antiguo o el nuevo incluye algo que quien llama no tiene (si no es el propietario). |
| 404 | `WORKSPACE_NOT_FOUND` | El workspace no existe o no eres miembro. |
| 404 | `WORKSPACE_ROLE_NOT_FOUND` | `role_id` no pertenece a este workspace. |


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