Criar um papel

POST

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"
  }
}

Autorizações

Authorization

string

header

obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

organization_id

string

obrigatório

Identificador de organização.

Required string length: 24

Pattern: ^[0-9a-f]{24}$

Corpo

application/json

name

string

obrigatório

Nome do papel do usuário.

Required string length: 1 - 120

permissions

object[]

obrigatório

Entradas de permissões atribuídas ao papel.

Minimum array length: 1

Show child attributes

Resposta

Papel de usuário criado com sucesso.

string

obrigatório

Identificador do papel.

Required string length: 24

Pattern: ^[0-9a-f]{24}$

name

string

obrigatório

Nome do papel.

organization_id

string

obrigatório

Identificador da organização associada a este papel.

Required string length: 24

Pattern: ^[0-9a-f]{24}$

created_at

string<date-time>

obrigatório

Carimbo de tempo de criação do papel em formato ISO 8601.

created_by

string | null

obrigatório

Identificador do usuário que criou o papel.

Required string length: 24

Pattern: ^[0-9a-f]{24}$

permissions

object[] | null

Entradas de permissões configuradas para este papel.

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"
  }
}

API Gen 2

Recursos API Gen 2 - v2

Recursos API Gen 2 - v1

Autorizações

Parâmetros de caminho

Corpo

Resposta