> ## Documentation Index > Fetch the complete documentation index at: https://docsnewgen.flexxible.com/llms.txt > Use this file to discover all available pages before exploring further. # Llistar rols > Retorna una llista paginada de rols disponibles dins de l'àmbit de l'organització. ## OpenAPI ````yaml /ca/api-reference/openapi.ca-v2.json get /v2/organizations/{organization_id}/roles openapi: 3.0.3 info: title: API Publica Portal version: 2.0.0 description: API pública REST per al portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: - name: Activitat digital description: Creació de grups de processos core per organització - name: Roles description: Endpoint de creacion de roles de organizacion - name: Usuarios description: Endpoint de creacion de usuarios de organizacion - name: Grupos de workspaces description: Endpoints de gestión de grupos de workspaces - name: Workspaces description: Endpoint de eliminacion de workspaces de la organizacion - name: Aplicaciones instaladas description: Endpoint de detalle de aplicación instalada de la organización - name: Autenticación description: Endpoints de autenticación y contexto de sesión - name: Microservicios description: Detalle de microservicios por organizacion - name: Operaciones description: Consulta de detalle de operaciones por organización - name: Organización description: Operaciones de organización - name: Objetivos de política de parches description: Endpoints de gestión de objetivos de política de parches - name: Configuraciones de producto description: Endpoints de gestión de configuraciones de producto - name: Grupos de reporte description: Operaciones sobre grupos de reporte - name: Sesiones description: Endpoint de detalle de sesion de la organizacion - name: Tenants description: Endpoints de gestión de tenants paths: /v2/organizations/{organization_id}/roles: get: tags: - Rols summary: Llistar rols description: >- Retorna una llista paginada de rols disponibles dins de l'àmbit de l'organització. operationId: get_roles parameters: - name: organization_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de l'organització. example: 507f1f77bcf86cd799439011 - name: page in: query required: false schema: type: integer default: 1 minimum: 1 description: Número de pàgina. - name: per_page in: query required: false schema: type: integer default: 100 minimum: 1 maximum: 100 description: Número d'elements per pàgina. - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Noms de camps de l'element de resposta, separats per comes, que s'han d'incloure. - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Expressió de filtres JSON sobre rutes de camps filtrables de la resposta. examples: simple: summary: Filtrar per nom de rol value: '{"field":"name","op":"contains","value":"administrador"}' complex-and: summary: Filtrar per tokens combinats del nom del rol value: >- {"and":[{"field":"name","op":"contains","value":"organización"},{"field":"name","op":"contains","value":"administrador"}]} complex-or-and: summary: Combina condicions OR i AND value: >- {"and":[{"or":[{"field":"name","op":"contains","value":"administrador"},{"field":"name","op":"contains","value":"operador"}]},{"field":"name","op":"contains","value":"rol"}]} - name: sort in: query required: false schema: type: string pattern: ^(id|organization_id|name|created_at|created_by):(asc|desc)$ description: Expressió d'ordre en el format :asc|desc. responses: '200': description: Rols recuperats correctament. content: application/json: schema: $ref: '#/components/schemas/GetRolesResponseV2' examples: paginated_result: summary: Llista paginada amb rols value: has_next: true data: - id: 64f0c2a1b2d3e4f5060708aa organization_id: 507f1f77bcf86cd799439011 name: Administrador de la organización created_at: '2026-03-12T10:30:00Z' created_by: 64f0c2a1b2d3e4f5060708bb permissions: - portal_permission: organization_admin workspaces_permission: admin analyzer_permission: access target_organization: all target_reporting_groups: - 64f0c2a1b2d3e4f5060708c1 empty_result: summary: No es van trobar rols value: has_next: false data: [] '400': description: Paràmetres de sol·licitud invàlids. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_filters: summary: Format de filtres invàlid value: error: message: Formato de filtros inválido code: bad_request details: filters debe ser una cadena JSON válida '401': description: No autoritzat o l'organització no és accessible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Fallada d'accés a l'organització value: error: message: No autorizado code: unauthorized '404': description: >- El recurs sol·licitat no es va trobar dins de l'àmbit de l'organització autoritzada. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: resource_not_found: summary: No s'ha trobat el recurs sol·licitat value: error: message: No encontrado code: not_found '500': description: Error intern del servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Fallada inesperada value: error: message: Error interno del servidor code: internal_error components: schemas: GetRolesResponseV2: type: object properties: has_next: type: boolean description: Indica si hi ha una altra pàgina disponible. data: type: array items: $ref: '#/components/schemas/RoleV2' required: - has_next - data ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error RoleV2: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del rol. name: type: string description: Nom del rol. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de l'organització associada a aquest rol. created_at: type: string format: date-time description: Marca de temps de creació del rol en format ISO 8601. created_by: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de l'usuari que va crear el rol. permissions: type: array nullable: true description: Entrades de permisos configurades per a aquest rol. items: $ref: '#/components/schemas/GetRolePermissionItemV2' required: - id - name - organization_id - created_at - created_by GetRolePermissionItemV2: type: object properties: portal_permission: type: string nullable: true enum: - admin - organization_admin - organization_admin_read_only - user - platform - l1_support_team - l1_support_team_read_only - l2_support_team - l2_support_team_read_only - l3_engineering_team - l3_engineering_team_read_only - billing description: Nivell de permís de Portal. workspaces_permission: type: string nullable: true enum: - no_access - l1_support_team_read_only - l1_support_team - l2_support_team_read_only - l2_support_team - l3_engineering_team_read_only - l3_engineering_team - admin_read_only - admin description: Nivell de permís de Workspace. analyzer_permission: type: string nullable: true enum: - no_access - access - admin description: Nivell de permís d'Analyzer. target_organization: oneOf: - type: string enum: - all - type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: >- Àmbit d'organització del permís: 'all' per a totes les organitzacions o un 'organization_id' específic. target_reporting_groups: oneOf: - type: string enum: - all - type: array minItems: 1 items: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: >- Àmbit de grups de report del permís: 'all' per a tots els grups o llista de 'reporting_group_id' específics. required: - target_organization - target_reporting_groups securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````