> ## 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. # Listar roles > Devuelve una lista paginada de roles disponibles dentro del ámbito de la organización. ## OpenAPI ````yaml /api-reference/openapi-v2.json get /v2/organizations/{organization_id}/roles openapi: 3.0.3 info: title: API Pública Portal version: 2.0.0 description: API pública REST para Portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: - name: Actividad digital description: Creación de grupos de procesos core por organización - name: Roles description: Endpoint de creaciÓn de roles de organización - name: Usuarios description: Endpoint de creación de usuarios de organización - name: Grupos de workspaces description: Endpoints de gestión de grupos de workspaces - name: Workspaces description: Endpoint de eliminacion de workspaces de la organización - 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 organización - 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 sesión de la organización - name: Tenants description: Endpoints de gestión de tenants paths: /v2/organizations/{organization_id}/roles: get: tags: - Roles summary: Listar roles description: >- Devuelve una lista paginada de roles disponibles dentro del ámbito de la organización. 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 la organización. 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 de elementos por página. - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Nombres de campos del elemento de respuesta, separados por comas, que se deben incluir. - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Expresión de filtros JSON sobre rutas de campos filtrables de la respuesta. examples: simple: summary: Filtrar por nombre de rol value: '{"field":"name","op":"contains","value":"administrador"}' complex-and: summary: Filtrar por tokens combinados del nombre del rol value: >- {"and":[{"field":"name","op":"contains","value":"organización"},{"field":"name","op":"contains","value":"administrador"}]} complex-or-and: summary: Combinar condiciones OR y 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: Expresión de orden en el formato :asc|desc. responses: '200': description: Roles recuperados correctamente. content: application/json: schema: $ref: '#/components/schemas/GetRolesResponseV2' examples: paginated_result: summary: Lista paginada con roles 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 se encontraron roles value: has_next: false data: [] '400': description: Parámetros de solicitud inválidos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_filters: summary: Formato de filtros inválido value: error: message: Formato de filtros inválido code: bad_request details: filters debe ser una cadena JSON válida '401': description: No autorizado o la organización no es accesible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Fallo de acceso a la organización value: error: message: No autorizado code: unauthorized '404': description: >- El recurso solicitado no se encontró dentro del ámbito de la organización autorizada. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: resource_not_found: summary: No se encontró el recurso solicitado value: error: message: No encontrado code: not_found '500': description: Error interno del servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Fallo no controlado value: error: message: Error interno del servidor code: internal_error components: schemas: GetRolesResponseV2: type: object properties: has_next: type: boolean description: Indica si hay otra 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: Nombre del rol. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la organización asociada a este rol. created_at: type: string format: date-time description: Marca de tiempo de creación del rol en formato ISO 8601. created_by: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del usuario que creó el rol. permissions: type: array nullable: true description: Entradas de permisos configuradas para este 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: Nivel de permiso 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: Nivel de permiso de Workspace. analyzer_permission: type: string nullable: true enum: - no_access - access - admin description: Nivel de permiso de Analyzer. target_organization: oneOf: - type: string enum: - all - type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: >- Ámbito de organización del permiso: `all` para todas las organizaciones o un `organization_id` específico. 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: >- Ámbito de grupos de reporte del permiso: `all` para todos los grupos o lista de `reporting_group_id` específicos. required: - target_organization - target_reporting_groups securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````