Saltar al contenido principal
POST
Crear rol
Requiere roles:manage. Una clave de API necesita el scope workspaces:write.
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

string
requerido
ID del workspace.

Body

string
requerido
De 1 a 50 caracteres.
WorkspacePermission[]
requerido
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.
number
De 0 a 999, orden de visualización.

Respuesta

Misma forma que una fila de Listar roles.

Errores

Última modificación el 28 de octubre de 2026