Roles
Crear un rol
Crea un rol y sus entradas de permisos en una sola solicitud.
POST
/
v2
/
organizations
/
{organization_id}
/
roles
curl --request POST \
--url https://api.flexxible.net/v2/organizations/{organization_id}/roles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Operador de organización",
"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 organización",
"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 válido",
"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 está en uso dentro de esta organización"
}
}{
"error": {
"message": "Entity ownership limit exceeded.",
"code": "unprocessable_entity"
}
}{
"error": {
"message": "Error interno del servidor",
"code": "internal_error"
}
}Autorizaciones
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parámetros de ruta
Identificador de organización.
Required string length:
24Pattern:
^[0-9a-f]{24}$Cuerpo
application/json
Respuesta
Rol de usuario creado correctamente.
Identificador del rol.
Required string length:
24Pattern:
^[0-9a-f]{24}$Nombre del rol.
Identificador de la organización asociada a este rol.
Required string length:
24Pattern:
^[0-9a-f]{24}$Marca de tiempo de creación del rol en formato ISO 8601.
Identificador del usuario que creó el rol.
Required string length:
24Pattern:
^[0-9a-f]{24}$Entradas de permisos configuradas para este rol.
Show child attributes
Show child attributes
⌘I
curl --request POST \
--url https://api.flexxible.net/v2/organizations/{organization_id}/roles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Operador de organización",
"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 organización",
"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 válido",
"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 está en uso dentro de esta organización"
}
}{
"error": {
"message": "Entity ownership limit exceeded.",
"code": "unprocessable_entity"
}
}{
"error": {
"message": "Error interno del servidor",
"code": "internal_error"
}
}