> ## 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 parches de un Workspace > Devuelve una lista paginada de parches para el workspace seleccionado. Solo aplica a workspaces con platform_type `windows`. ## OpenAPI ````yaml /api-reference/openapi-v2.json get /v2/organizations/{organization_id}/workspaces/{workspace_id}/patches 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}/patches: get: tags: - Workspaces summary: Listar parches de un Workspace description: >- Devuelve una lista paginada de parches para el workspace seleccionado. Solo aplica a workspaces con platform_type `windows`. operationId: workspaces_patches 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: workspace_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del Workspace. example: 507f1f77bcf86cd799439099 - 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: Campos de respuesta a incluir, separados por comas. - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Expresión de filtro JSON sobre campos del item de respuesta (incluye `id`). examples: simple: summary: Filtrar por título value: '{"field":"title","op":"contains","value":"security update"}' complex-and: summary: Filtrar por estado y severidad value: >- {"and":[{"field":"status","op":"eq","value":"pending"},{"field":"severity","op":"contains","value":"critical"}]} complex-or-and: summary: Combinar OR y AND value: >- {"and":[{"or":[{"field":"product","op":"contains","value":"windows 10"},{"field":"product","op":"contains","value":"windows 11"}]},{"field":"kb","op":"contains","value":"kb503"}]} - name: sort in: query required: false schema: type: string pattern: ^([a-z_]+):(asc|desc)$ description: >- Expresión de ordenación con el formato :asc|desc sobre campos escalares del item (incluye `id`). En modo agregado, solo acepta campos de `group_by` o aliases agregados (`count`, `_`). - name: aggregate in: query required: false schema: type: string maxLength: 4096 description: >- Expresión JSON de agregacion con `group_by` y `aggregates` sobre campos escalares de primer nivel. examples: group_status_count: summary: Agrupar por estado y contar value: >- {"group_by":["status"],"aggregates":[{"field":"*","function":"count"}]} group_product_avg: summary: Agrupar por producto y calcular promedio value: >- {"group_by":["product"],"aggregates":[{"field":"*","function":"count"},{"field":"installed_at","function":"max"}]} responses: '200': description: Parches de Workspace recuperados correctamente. content: application/json: schema: $ref: '#/components/schemas/GetWorkspacePatchesResponseV2' examples: paginated_result: summary: Resultado paginado con registros de parches value: has_next: true data: - id: 64f0c2a1b2d3e4f506070812 kb: KB5034123 title: Actualización acumulativa de seguridad status: pending product: windows 11 severity: critical arrived_at: '2026-03-15' category: security_updates installed_at: null additional_information_url: https://support.microsoft.com/help/kb5034123 empty_result: summary: No se encontraron parches value: has_next: false data: [] '400': description: Parámetros de solicitud no válidos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_filters: summary: Formato de filtros no válido value: error: message: Formato de filtros no válido code: bad_request details: filters debe ser una cadena JSON válida invalid_platform_type: summary: Workspace con plataforma no compatible value: error: message: Workspace no compatible para consulta de parches code: bad_request details: >- Este endpoint solo admite workspaces con platform_type windows '401': description: No autorizado u organización no 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: >- Workspace no encontrado dentro del alcance de la organización autorizada. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: workspace_not_found: summary: Workspace no existe en el alcance value: error: message: Workspace 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: GetWorkspacePatchesResponseV2: type: object properties: has_next: type: boolean description: Indica si hay otra página disponible. data: type: array items: $ref: '#/components/schemas/GetWorkspacePatchItemV2' 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 GetWorkspacePatchItemV2: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del registro de parche. kb: type: string description: Codigo KB del parche. title: type: string description: Título del parche. status: type: string enum: - pending - installed description: Estado del parche. product: type: string description: Producto asociado al parche. severity: type: string description: Severidad del parche. arrived_at: type: string description: Fecha de llegada o publicacion del parche. category: type: string description: Categoria del parche. installed_at: type: string nullable: true description: Fecha de instalación del parche. additional_information_url: type: string description: URL con información adicional del parche. required: - id - kb - title - status - product - severity - arrived_at - category - additional_information_url securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````