> ## 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 versiones de agente del workspace > Devuelve el historial paginado de versiones del agente para un workspace dentro de una organización, exponiendo solo discovered_at y version. ## OpenAPI ````yaml /api-reference/openapi-v2.json get /v2/organizations/{organization_id}/workspaces/{workspace_id}/agent-versions 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}/workspaces/{workspace_id}/agent-versions: get: tags: - Workspaces summary: Listar versiones de agente del workspace description: >- Devuelve el historial paginado de versiones del agente para un workspace dentro de una organización, exponiendo solo discovered_at y version. operationId: workspaces_agent_versions parameters: - name: organization_id in: path required: true description: Identificador de la organización. schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 example: 64b7f1a2c3d4e5f60718293a - name: workspace_id in: path required: true description: Identificador del workspace. schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 example: 64b7f1a2c3d4e5f60718293b - name: page in: query required: false description: Número de página a consultar. schema: type: integer default: 1 minimum: 1 - name: per_page in: query required: false description: Cantidad de elementos por página. schema: type: integer default: 100 minimum: 1 maximum: 100 - name: fields in: query required: false description: Campos de respuesta a incluir, separados por comas. schema: type: string - name: sort in: query required: false description: Expresión de ordenación con el formato :asc|desc. schema: type: string pattern: ^([a-z_]+):(asc|desc)$ - name: filters in: query required: false description: Expresión JSON de filtros sobre campos filtrables de la respuesta. schema: type: string examples: simple: summary: Filtro simple por versión value: '{"field":"version","op":"contains","value":"5.2"}' complex_and: summary: Filtro compuesto con and value: >- {"and":[{"field":"version","op":"contains","value":"5."},{"field":"discovered_at","op":"contains","value":"2026-06"}]} complex_or_and: summary: Filtro compuesto con or y and value: >- {"and":[{"or":[{"field":"version","op":"eq","value":"5.2.0"},{"field":"version","op":"eq","value":"5.2.1"}]},{"field":"discovered_at","op":"contains","value":"2026-06"}]} responses: '200': description: Listado paginado de versiones del agente del workspace. content: application/json: schema: $ref: '#/components/schemas/GetWorkspaceAgentVersionsResponseV2' examples: success: summary: Respuesta paginada correcta value: data: - discovered_at: '2026-06-18T10:20:30.000Z' version: 5.2.1 - discovered_at: '2026-05-10T08:00:00.000Z' version: 5.1.9 has_next: true '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: Could not process filters code: BAD_REQUEST details: >- Operator "contains" is not allowed for field "discovered_at". '401': description: No autorizado para acceder a la organización. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unauthorized: summary: Credenciales invalidas o sin acceso value: error: code: unauthorized message: No autorizado para acceder a este recurso. '404': description: Recurso no encontrado dentro del alcance autorizado. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: not_found: summary: Workspace sin historial disponible value: error: code: not_found message: No se encontró el recurso solicitado. '500': description: Error interno del servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: internal_error: summary: Fallo inesperado value: error: code: internal_error message: Se ha producido un error interno. components: schemas: GetWorkspaceAgentVersionsResponseV2: type: object additionalProperties: false required: - data - has_next properties: data: type: array items: $ref: '#/components/schemas/WorkspaceAgentVersionItemV2' has_next: type: boolean description: Indica si existen mas resultados en la siguiente página. ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error WorkspaceAgentVersionItemV2: type: object additionalProperties: false required: - discovered_at - version properties: discovered_at: type: string format: date-time description: Fecha en la que se detectó la versión del agente. version: type: string description: Versión del agente detectada en el workspace. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````