> ## 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.

# List workspaces connected to a WiFi network

> Returns a paginated list of workspaces (FWS devices) connected to the specified WiFi network based on its SSID within the authorized organization scope (includes accessible delegated tenants). If the WiFi network does not exist within the authorized scope, respond with 404. If it exists but has no devices, respond with 200 and empty data. Aggregation not available on this endpoint. Public contract only contains identifiers.



## OpenAPI

````yaml /en/api-reference/openapi.en-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: Public REST API for portal
servers:
  - url: https://api.flexxible.net/
    description: Portal API
security:
  - bearerAuth: []
tags:
  - name: Solve
    description: Flexxible Solve ticket visibility and management
  - name: Digital activity
    description: Core process group creation by organization
  - name: Locations
    description: Location management (FWS)
  - name: Roles
    description: Role creation endpoint for organization
  - name: Users
    description: User creation endpoint for organization
  - name: Workspace groups
    description: Management endpoints for workspace groups
  - name: Networks
    description: Network management (FWS)
  - name: WiFi Networks
    description: Wi-Fi network management (FWS)
  - name: Workspaces
    description: Workspace deletion endpoint for the organization
  - name: Event logs
    description: Workspace event logs query
  - name: Installed apps
    description: Installed application detail endpoint for the organization
  - name: Authentication
    description: Session context and authentication endpoints
  - name: Microservices
    description: Details of microservices by organization
  - name: Operations
    description: Detail queries for operations by organization
  - name: Organization
    description: Organization operations
  - name: Patch policy targets
    description: Patch policy objective management endpoints
  - name: Product configurations
    description: Product configuration management endpoints
  - name: Reporting Groups
    description: Operations on reporting groups
  - name: Sessions
    description: Session detail endpoint for the organization
  - name: Tenants
    description: Tenant management endpoints
  - name: Workspace Connection Logs
    description: Workspace connection logs query
  - name: Workspace GPO
    description: Query GPOs applied to a session
  - name: Workspace Notifications
    description: Workspace notifications query
paths:
  /v2/organizations/{organization_id}/wifi-networks/{wifi_network_id}/connected-workspaces:
    get:
      tags:
        - WiFi Networks
      summary: List workspaces connected to a WiFi network
      description: >-
        Returns a paginated list of workspaces (FWS devices) connected to the
        specified WiFi network based on its SSID within the authorized
        organization scope (includes accessible delegated tenants). If the WiFi
        network does not exist within the authorized scope, respond with 404. If
        it exists but has no devices, respond with 200 and empty data.
        Aggregation not available on this endpoint. Public contract only
        contains identifiers.
      operationId: listWifiNetworkConnectedWorkspaces
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Organization identifier.
          example: 507f1f77bcf86cd799439011
        - name: wifi_network_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: WiFi network identifier (FWS WifiNetwork.Oid).
          example: d4e5f6a7-b8c9-0123-def0-234567890123
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number.
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 100
          description: Number of items per page.
        - name: fields
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
          description: Response fields separated by commas for each element.
          example: id,wifi_network_id,organization_id
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
          description: >-
            JSON filter expression. This endpoint does not publish filterable
            fields.
          examples:
            unsupported:
              summary: No public filterable fields
              value: '{}'
        - name: sort
          in: query
          required: false
          schema:
            type: string
            pattern: ^([a-z_]+):(asc|desc)$
          description: >-
            Sorting expression with format <field>:asc|desc. This endpoint does
            not publish sortable fields; omit to use default internal order.
      responses:
        '200':
          description: Connected workspaces retrieved successfully.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/ListWifiNetworkConnectedWorkspacesResponseV2
              examples:
                paginated_result:
                  summary: Paginated list with results
                  value:
                    has_next: false
                    data:
                      - id: 507f1f77bcf86cd799439012
                        wifi_network_id: d4e5f6a7-b8c9-0123-def0-234567890123
                        organization_id: 507f1f77bcf86cd799439011
                empty_result:
                  summary: Existing WiFi network without devices
                  value:
                    has_next: false
                    data: []
                null_portal_id:
                  summary: FWS device without match Portal
                  value:
                    has_next: false
                    data:
                      - id: null
                        wifi_network_id: d4e5f6a7-b8c9-0123-def0-234567890123
                        organization_id: 507f1f77bcf86cd799439011
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Not authorized or without access to the organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: WiFi network not found within authorized organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ListWifiNetworkConnectedWorkspacesResponseV2:
      type: object
      properties:
        has_next:
          type: boolean
          description: Indicates if there's a next page.
        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: >-
            Workspace Portal Id (Mongo _id). Null if FWS device has no match in
            Portal.
        wifi_network_id:
          type: string
          format: uuid
          description: Identifier of the parent WiFi network (FWS WifiNetwork.Oid).
        organization_id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Organization identifier of the request (path).
      required:
        - wifi_network_id
        - organization_id
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````