> ## 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 red WiFi

> Devuelve una lista paginada de workspaces (dispositivos FWS) conectados a la red WiFi indicada según su SSID, dentro del alcance de la organización autorizada (incluye tenants delegados accesibles). Si la red WiFi 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. El contrato público es solo identificadores.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /v2/organizations/{organization_id}/wifi-networks/{wifi_network_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}/wifi-networks/{wifi_network_id}/connected-workspaces:
    get:
      tags:
        - Wifi Networks
      summary: Listar workspaces conectados a una red WiFi
      description: >-
        Devuelve una lista paginada de workspaces (dispositivos FWS) conectados
        a la red WiFi indicada según su SSID, dentro del alcance de la
        organización autorizada (incluye tenants delegados accesibles). Si la
        red WiFi 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. El contrato público es solo
        identificadores.
      operationId: listWifiNetworkConnectedWorkspaces
      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: wifi_network_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Identificador de la red WiFi (FWS WifiNetwork.Oid).
          example: d4e5f6a7-b8c9-0123-def0-234567890123
        - 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,wifi_network_id,organization_id
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
          description: >-
            Expresión JSON de filtros. Este endpoint no publica campos
            filtrables.
          examples:
            unsupported:
              summary: No hay campos filtrables públicos
              value: '{}'
        - 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. Este
            endpoint no publica campos ordenables; omitir para usar el orden
            interno por defecto.
      responses:
        '200':
          description: Workspaces conectados recuperados correctamente.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/ListWifiNetworkConnectedWorkspacesResponseV2
              examples:
                paginated_result:
                  summary: Lista paginada con resultados
                  value:
                    has_next: false
                    data:
                      - id: 507f1f77bcf86cd799439012
                        wifi_network_id: d4e5f6a7-b8c9-0123-def0-234567890123
                        organization_id: 507f1f77bcf86cd799439011
                empty_result:
                  summary: Red WiFi existente sin dispositivos
                  value:
                    has_next: false
                    data: []
                null_portal_id:
                  summary: Dispositivo FWS sin coincidencia Portal
                  value:
                    has_next: false
                    data:
                      - id: null
                        wifi_network_id: d4e5f6a7-b8c9-0123-def0-234567890123
                        organization_id: 507f1f77bcf86cd799439011
        '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: Red WiFi 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:
    ListWifiNetworkConnectedWorkspacesResponseV2:
      type: object
      properties:
        has_next:
          type: boolean
          description: Indica si existe una página siguiente.
        data:
          type: array
          items:
            $ref: '#/components/schemas/WifiNetworkConnectedWorkspaceItemV2'
      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
    WifiNetworkConnectedWorkspaceItemV2:
      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.
        wifi_network_id:
          type: string
          format: uuid
          description: Identificador de la red WiFi padre (FWS WifiNetwork.Oid).
        organization_id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Identificador de la organización de la solicitud (path).
      required:
        - wifi_network_id
        - organization_id
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````