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

# Crear rol

> Crea un rol personalizado. Requiere `roles:manage`.

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

> [!NOTE]
>
> **Protección contra escalada de privilegios:** quien no es propietario solo puede conceder un conjunto de permisos que
> ya tiene. No hay una comprobación aparte para «crear» frente a «editar»: sin esto, `roles:manage` por sí solo permitiría
> a un miembro crear un rol con todos los permisos, incluidos los que no tiene.

El número de roles que puede tener un workspace está limitado por el nivel del plan del propietario — **los 4 roles
iniciales cuentan para ese límite.**

### Ruta

**id** `string` *required*

ID del workspace.

### Body

**name** `string` *required*

De 1 a 50 caracteres.

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

Subconjunto del catálogo de 20 entradas. Debe ser un subconjunto de los permisos propios de quien llama, salvo que quien llama sea el propietario.

**position** `number`

De 0 a 999, orden de visualización.

### Respuesta

Misma forma que una fila de [Listar roles](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/roles/list.md).

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quien llama no tiene `roles:manage`. |
| 403 | `WORKSPACE_PERMISSION_ESCALATION` | Quien llama no es el propietario y pidió un permiso que no tiene. |
| 404 | `WORKSPACE_NOT_FOUND` | El workspace no existe o no eres miembro. |
| 409 | `WORKSPACE_ROLE_LIMIT_REACHED` | Se alcanzó el límite de roles del nivel del plan del propietario (incluidos los roles iniciales). |


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