> ## 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. # Espaços de trabalho atribuídos > Recupera uma lista paginada de Workspaces que pertencem ao grupo de workspaces especificado. Suporta paginação, ordenação e filtragem mediante uma cadeia de filtros JSON. A resposta inclui um conjunto reduzido de campos de Workspace. ## OpenAPI ````yaml /pt-BR/api-reference/openapi.pt-v1.json get /v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/workspaces openapi: 3.0.3 info: title: API Publica Portal version: 1.0.0 description: API pública REST para portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/workspaces: get: tags: - Grupos de workspaces summary: Espaços de trabalho atribuídos description: >- Recupera uma lista paginada de Workspaces que pertencem ao grupo de workspaces especificado. Suporta paginação, ordenação e filtragem mediante uma cadeia de filtros JSON. A resposta inclui um conjunto reduzido de campos de Workspace. operationId: listWorkspaceGroupsWorkspaces parameters: - name: organization_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: O identificador único da organização example: 507f1f77bcf86cd799439011 - name: workspace_group_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: O identificador único do grupo de workspaces example: 507f1f77bcf86cd799439020 - name: page in: query required: false schema: type: integer default: 1 description: 'Número da página (padrão: 1)' - name: per_page in: query required: false schema: type: integer default: 100 maximum: 100 minimum: 1 description: 'Itens por página (padrão: 100, máx.: 100)' - name: sort in: query required: false schema: type: string description: >- Campo de ordenação com sufixo de ordem opcional (:asc ou :desc). Usa nomes de propriedades da resposta: id, organization_id, name, related_environment, operative_system, ip_address, type, last_user, total_ram. - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Lista separada por vírgulas de campos para incluir em cada elemento Workspace. Campos selecionáveis: id, organization_id, name, related_environment, operative_system, ip_address, type, last_user, total_ram. O campo id sempre é incluído. example: name,operative_system,total_ram - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Cadeia JSON com condições de filtro. Usa nomes de propriedades da resposta para os campos. Operadores: eq, ne, in, nin, gt, gte, lt, lte, contains, startsWith, endsWith, between. Combina com and/or. examples: simple: summary: Filtrar por nome de Workspace description: Retorne Workspaces cujo nome contém o texto fornecido. value: '{"field": "name", "op": "contains", "value": "desktop"}' complex-and: summary: Filtrar por sistema operacional e RAM description: Retorne Workspaces com Windows e pelo menos 8 GB de RAM. value: >- {"and": [{"field": "operative_system", "op": "contains", "value": "Windows"}, {"field": "total_ram", "op": "gte", "value": 8192}]} complex-or-and: summary: Combinar condições OU e E description: >- Corresponde a dois prefixos de sub-rede e aplica um limite de memória. value: >- {"and": [{"or": [{"field": "ip_address", "op": "startsWith", "value": "172."}, {"field": "ip_address", "op": "startsWith", "value": "10."}]}, {"field": "total_ram", "op": "gt", "value": 4096}]} responses: '200': description: >- Lista paginada de Workspaces do grupo de workspaces recuperada corretamente. content: application/json: schema: $ref: '#/components/schemas/WorkspaceGroupWorkspaceListResponseV1' '400': $ref: '#/components/responses/BadRequest' description: Solicitação incorreta. Paginação, ordenação ou filtros inválidos. '401': $ref: '#/components/responses/Unauthorized' description: 'Não autorizado: é necessária autenticação' '404': $ref: '#/components/responses/NotFound' description: Grupo de workspaces não encontrado ou não pertence à organização '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: WorkspaceGroupWorkspaceListResponseV1: type: object properties: has_next: type: boolean data: type: array items: $ref: '#/components/schemas/WorkspaceGroupWorkspaceItemV1' required: - has_next - data WorkspaceGroupWorkspaceItemV1: type: object description: >- Elemento Workspace na lista de Workspaces do grupo de workspaces (projeção reduzida). properties: id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ organization_id: type: string nullable: true maxLength: 24 pattern: ^[0-9a-f]{24}$ name: type: string nullable: true related_environment: type: string nullable: true operative_system: type: string nullable: true ip_address: type: string nullable: true type: type: string nullable: true last_user: type: string nullable: true total_ram: type: number nullable: true required: - id ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error responses: BadRequest: description: Solicitação incorreta content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Não autorizado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: Não encontrado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: Solicitações em excesso content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Erro interno do servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````