Crear un rol
Crear un rol
POST/roles
Permisos requeridos
Dashboard: necesitas al menos uno de estos permisos.
users.dashboard.manage
API Keys: necesitas al menos uno de estos permisos.
roles.api.writeroles.api.manage
Crear un rol
Prueba este endpoint
Responses
- 201
- 202
- 401
- 403
- 409
- 422
Rol creado exitosamente
Response Headers
Estado de la proyección local cuando la mutación ya está visible en sandbox.
La mutación ya fue aplicada por la autoridad de configuración, pero su proyección local en sandbox sigue pendiente. No se debe repetir la mutación: reintentarla crearía o modificaría el recurso una segunda vez.
El cuerpo es el mismo que devuelve la respuesta exitosa de este endpoint, con el recurso ya mutado, así que
puedes usarlo sin esperar la proyección. Consulta el Location firmado solo si necesitas leer el recurso
desde sandbox inmediatamente después.
Cuando la proyección alcanza a la autoridad dentro de la misma request, el endpoint responde con su estado
exitoso habitual y X-Soyio-Projection-State: applied en lugar de este 202.
Response Headers
Estado de la proyección local. En este 202 siempre es pending.
Identificador de la empresa cuya configuración fue modificada.
Versión global que la proyección local debe alcanzar.
Segundos sugeridos antes de consultar nuevamente el estado.
Ruta firmada para consultar el estado de la proyección sin credenciales adicionales.
Error de autenticación
Acceso prohibido por permisos, módulo o entorno no habilitado
Otra mutación sobre la misma configuración compartida se aplicó al mismo tiempo y esta request no se aplicó. No se guardó ningún cambio, así que puedes reintentar la misma request de forma segura.
A diferencia del 202 de proyección pendiente, este 409 indica que la mutación no tuvo efecto.
Error de validación