> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar workspaces conectados a una ubicación

> Devuelve una lista paginada de workspaces (dispositivos FWS) conectados a la ubicación indicada a través de su red, dentro del alcance de la organización autorizada (incluye tenants delegados accesibles). Si la ubicación no existe en el alcance autorizado, responde 404. Si existe pero no tiene dispositivos, responde 200 con data vacía. La agregación no está disponible en este endpoint.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /v2/organizations/{organization_id}/locations/{location_id}/connected-workspaces
openapi: 3.0.3
info:
  title: API Publica Portal
  version: 1.0.0
  description: Api publica REST para portal
servers:
  - url: https://api.flexxible.net/
    description: Portal API
security:
  - bearerAuth: []
tags:
  - name: Solve
    description: Visibilidad y gestión de tickets Flexxible Solve
  - name: Actividad digital
    description: Creación de grupos de procesos core por organización
  - name: Locations
    description: Gestión de ubicaciones (FWS)
  - 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: Networks
    description: Gestión de redes (FWS)
  - name: Wifi Networks
    description: Gestión de redes wifi (FWS)
  - name: Workspaces
    description: Endpoint de eliminacion de workspaces de la organizacion
  - name: Event logs
    description: Consulta de event logs de workspaces
  - 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
  - name: Workspace Connection Logs
    description: Consulta de registros de conexión de workspace
  - name: Workspace GPO
    description: Consulta de GPOs aplicadas a una sesión
  - name: Workspace Notifications
    description: Consulta de notificaciones de workspace
paths:
  /v2/organizations/{organization_id}/locations/{location_id}/connected-workspaces:
    get:
      tags:
        - Locations
      summary: Listar workspaces conectados a una ubicación
      description: >-
        Devuelve una lista paginada de workspaces (dispositivos FWS) conectados
        a la ubicación indicada a través de su red, dentro del alcance de la
        organización autorizada (incluye tenants delegados accesibles). Si la
        ubicación no existe en el alcance autorizado, responde 404. Si existe
        pero no tiene dispositivos, responde 200 con data vacía. La agregación
        no está disponible en este endpoint.
      operationId: listLocationConnectedWorkspaces
      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: location_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Identificador de la ubicación (FWS Location.Oid).
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        - 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 separados por comas para cada elemento.
          example: id,location_id,network_id,organization_id
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
          description: >-
            Expresión JSON de filtros sobre campos filtrables del recurso
            (location_id, network_id, organization_id).
          examples:
            simple:
              summary: Filtrar por organización del dispositivo
              value: >-
                {"field":"organization_id","op":"eq","value":"507f1f77bcf86cd799439011"}
            complex-and:
              summary: Filtrar por red y organización
              value: >-
                {"and":[{"field":"network_id","op":"eq","value":"c3d4e5f6-a7b8-9012-cdef-123456789012"},{"field":"organization_id","op":"eq","value":"507f1f77bcf86cd799439011"}]}
        - name: sort
          in: query
          required: false
          schema:
            type: string
            pattern: ^([a-z_]+):(asc|desc)$
          description: >-
            Expresión de ordenación con el formato <field>:asc|desc. Campos
            ordenables: location_id, network_id, organization_id. Por defecto
            organization_id:asc.
          example: organization_id:asc
      responses:
        '200':
          description: Workspaces conectados recuperados correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListLocationConnectedWorkspacesResponseV2'
              examples:
                paginated_result:
                  summary: Lista paginada con resultados
                  value:
                    has_next: false
                    data:
                      - id: 507f1f77bcf86cd799439012
                        location_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                        network_id: c3d4e5f6-a7b8-9012-cdef-123456789012
                        organization_id: 507f1f77bcf86cd799439011
                empty_result:
                  summary: Ubicación existente sin dispositivos
                  value:
                    has_next: false
                    data: []
        '400':
          description: Parámetros de solicitud no válidos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: No autorizado o sin acceso a la organización.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Ubicación no encontrada dentro de la organización autorizada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Límite de solicitudes excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Error interno del servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ListLocationConnectedWorkspacesResponseV2:
      type: object
      properties:
        has_next:
          type: boolean
          description: Indica si existe una página siguiente.
        data:
          type: array
          items:
            $ref: '#/components/schemas/LocationConnectedWorkspaceItemV2'
      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
    LocationConnectedWorkspaceItemV2:
      type: object
      properties:
        id:
          type: string
          nullable: true
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: >-
            Identificador del workspace Portal (Mongo _id). Null si el
            dispositivo FWS no tiene coincidencia en Portal.
        location_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            Identificador de la ubicación FWS (Network.RelatedLocation /
            Location.Oid).
        network_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            Identificador de la red FWS a través de la cual el dispositivo está
            conectado a la ubicación.
        organization_id:
          type: string
          nullable: true
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: >-
            Identificador de la organización Portal del dispositivo
            (SWSTenant.PortalOrganizationId vía ReportingGroup).
      required:
        - location_id
        - network_id
        - organization_id
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````