Funções
Criar um papel
Crie um papel e suas entradas de permissões em uma única solicitação.
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 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"
}
}Autorizações
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parâmetros de caminho
Identificador de organização.
Required string length:
24Pattern:
^[0-9a-f]{24}$Corpo
application/json
Resposta
Papel de usuário criado com sucesso.
Identificador do papel.
Required string length:
24Pattern:
^[0-9a-f]{24}$Nome do papel.
Identificador da organização associada a este papel.
Required string length:
24Pattern:
^[0-9a-f]{24}$Carimbo de tempo de criação do papel em formato ISO 8601.
Identificador do usuário que criou o papel.
Required string length:
24Pattern:
^[0-9a-f]{24}$Entradas de permissões configuradas para este papel.
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 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"
}
}