Rols
Crear un rol
Crea un rol i les seves entrades de permisos en una sola sol·licitud.
POST
/
v1
/
organizations
/
{organization_id}
/
roles
curl --request POST \
--url https://api.flexxible.net/v1/organizations/{organization_id}/roles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Operador de organizacion",
"permissions": [
{
"portal_permission": "organization_admin",
"workspaces_permission": "admin_read_only",
"analyzer_permission": "access",
"target_organization": "507f1f77bcf86cd799439011",
"target_reporting_groups": [
"64f0c2a1b2d3e4f5060708c1",
"64f0c2a1b2d3e4f5060708c2"
]
}
]
}
'{
"id": "64f0c2a1b2d3e4f5060708aa",
"name": "Operador de organizacion",
"organization_id": "507f1f77bcf86cd799439011",
"created_at": "2026-03-12T10:30:00Z",
"created_by": "64f0c2a1b2d3e4f5060708bb",
"permissions": [
{
"portal_permission": "organization_admin",
"workspaces_permission": "admin_read_only",
"analyzer_permission": "access",
"target_organization": "507f1f77bcf86cd799439011",
"target_reporting_groups": [
"64f0c2a1b2d3e4f5060708c1",
"64f0c2a1b2d3e4f5060708c2"
]
}
]
}{
"error": {
"message": "Cuerpo de solicitud no valido",
"code": "bad_request",
"details": "permissions[0].target_organization debe ser `all` o una cadena hexadecimal en minusculas de 24 caracteres"
}
}{
"error": {
"message": "No autorizado",
"code": "unauthorized"
}
}{
"error": {
"message": "Grupo de reporte no encontrado",
"code": "not_found"
}
}{
"error": {
"message": "El nombre del rol ya existe",
"code": "conflict",
"details": "name ya esta en uso dentro de esta organizacion"
}
}{
"error": {
"message": "Entity ownership limit exceeded.",
"code": "unprocessable_entity"
}
}{
"error": {
"message": "Error interno del servidor",
"code": "internal_error"
}
}Autoritzacions
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Paràmetres de ruta
Identificador de la organització.
Required string length:
24Pattern:
^[0-9a-f]{24}$Cos
application/json
Resposta
Rol d'usuari creat correctament.
Identificador del rol.
Required string length:
24Pattern:
^[0-9a-f]{24}$Nom del rol.
Identificador de l'organització associada a aquest rol.
Required string length:
24Pattern:
^[0-9a-f]{24}$Marca de temps de creació del rol en format ISO 8601.
Identificador de l'usuari que va crear el rol.
Required string length:
24Pattern:
^[0-9a-f]{24}$Entrades de permisos configurades per a aquest rol.
Show child attributes
Show child attributes
⌘I
curl --request POST \
--url https://api.flexxible.net/v1/organizations/{organization_id}/roles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Operador de organizacion",
"permissions": [
{
"portal_permission": "organization_admin",
"workspaces_permission": "admin_read_only",
"analyzer_permission": "access",
"target_organization": "507f1f77bcf86cd799439011",
"target_reporting_groups": [
"64f0c2a1b2d3e4f5060708c1",
"64f0c2a1b2d3e4f5060708c2"
]
}
]
}
'{
"id": "64f0c2a1b2d3e4f5060708aa",
"name": "Operador de organizacion",
"organization_id": "507f1f77bcf86cd799439011",
"created_at": "2026-03-12T10:30:00Z",
"created_by": "64f0c2a1b2d3e4f5060708bb",
"permissions": [
{
"portal_permission": "organization_admin",
"workspaces_permission": "admin_read_only",
"analyzer_permission": "access",
"target_organization": "507f1f77bcf86cd799439011",
"target_reporting_groups": [
"64f0c2a1b2d3e4f5060708c1",
"64f0c2a1b2d3e4f5060708c2"
]
}
]
}{
"error": {
"message": "Cuerpo de solicitud no valido",
"code": "bad_request",
"details": "permissions[0].target_organization debe ser `all` o una cadena hexadecimal en minusculas de 24 caracteres"
}
}{
"error": {
"message": "No autorizado",
"code": "unauthorized"
}
}{
"error": {
"message": "Grupo de reporte no encontrado",
"code": "not_found"
}
}{
"error": {
"message": "El nombre del rol ya existe",
"code": "conflict",
"details": "name ya esta en uso dentro de esta organizacion"
}
}{
"error": {
"message": "Entity ownership limit exceeded.",
"code": "unprocessable_entity"
}
}{
"error": {
"message": "Error interno del servidor",
"code": "internal_error"
}
}