> ## 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 destinatários de uma notificação de workspace

> Retorna uma lista paginada de workspaces destinatários da notificação indicada, dentro da organização autorizada. Se a notificação não existe no escopo autorizado, responde 404. Se existe com destino workspaces mas não tem destinatários, responde 200 com dados vazios. Se existe com um destino diferente de workspaces, responde 400. A agregação não está disponível neste endpoint.



## OpenAPI

````yaml /pt-BR/api-reference/openapi.pt-v2.json get /v2/organizations/{organization_id}/workspace-notifications/{workspace_notification_id}/acknowledgements
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
security:
  - bearerAuth: []
tags:
  - name: Solve
    description: Visibilidade e gestão de tickets Flexxible Solve
  - name: Atividade digital
    description: Criação de grupos de processos core por organização
  - name: Locais
    description: Gestão de localizações (FWS)
  - name: Funções
    description: Endpoint de criação de funções de organização
  - name: Usuários
    description: Endpoint de criação de usuários da organização
  - name: Grupos de workspaces
    description: Endpoints de gerenciamento de grupos de workspaces
  - name: Redes
    description: Gestão de redes (FWS)
  - name: Redes Wifi
    description: Gestão de redes wifi (FWS)
  - name: Workspaces
    description: Endpoint de eliminação de workspaces da organização
  - name: Logs de Eventos
    description: Consulta de logs de eventos de workspaces
  - name: Aplicações instaladas
    description: Endpoint de detalhes do aplicativo instalado da organização
  - name: Autenticação
    description: Endpoints de autenticação e contexto de sessão
  - name: Microserviços
    description: Detalhe dos microsserviços por organização
  - name: Operações
    description: Consulta de detalhes de operações por organização
  - name: Organização
    description: Operações de organização
  - name: Alvos de política de patches
    description: Endpoints de gerenciamento de objetivos de política de patches
  - name: Configurações de produto
    description: Endpoints de gerenciamento de configurações de produto
  - name: Grupos de relatório
    description: Operações sobre grupos de relatório
  - name: Sessões
    description: Endpoint de detalhes de sessão da organização
  - name: Locatários
    description: Endpoints de gerenciamento de tenants
  - name: Logs de Conexão do Workspace
    description: Consulta de registros de conexão de workspace
  - name: Workspace GPO
    description: Consulta de GPOs aplicadas a uma sessão
  - name: Notificações de Workspace
    description: Consulta de notificações de workspace
paths:
  /v2/organizations/{organization_id}/workspace-notifications/{workspace_notification_id}/acknowledgements:
    get:
      tags:
        - Notificações de Workspace
      summary: Listar workspaces destinatários de uma notificação de workspace
      description: >-
        Retorna uma lista paginada de workspaces destinatários da notificação
        indicada, dentro da organização autorizada. Se a notificação não existe
        no escopo autorizado, responde 404. Se existe com destino workspaces mas
        não tem destinatários, responde 200 com dados vazios. Se existe com um
        destino diferente de workspaces, responde 400. A agregação não está
        disponível neste endpoint.
      operationId: listWorkspaceNotificationAcknowledgements
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identificador da organização.
          example: 507f1f77bcf86cd799439011
        - name: workspace_notification_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            pattern: >-
              ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
            minLength: 36
            maxLength: 36
          description: Identificador da notificação do workspace.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Número da 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 resposta separados por vírgulas para cada elemento.
          example: id,user_name,acknowledged_on,session_id,workspace_id
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
          description: Expressão JSON de filtros sobre campos filtráveis do recurso.
          examples:
            simple:
              summary: Filtrar por nome
              value: '{"field":"name","op":"contains","value":"laptop"}'
            complex-and:
              summary: Filtrar por estado e usuários aceitos
              value: >-
                {"and":[{"field":"status","op":"eq","value":"updated"},{"field":"total_users_accepted","op":"gte","value":1}]}
            complex-or-and:
              summary: Filtrar por estado e nome
              value: >-
                {"and":[{"or":[{"field":"status","op":"eq","value":"pending"},{"field":"status","op":"eq","value":"updated"}]},{"field":"name","op":"contains","value":"laptop"}]}
        - name: sort
          in: query
          required: false
          schema:
            type: string
            pattern: ^([a-z_]+):(asc|desc)$
          description: >-
            Expressão de ordenação no formato `<field>:asc|desc`. Por padrão
            name:asc.
          example: name:asc
      responses:
        '200':
          description: Workspaces destinatários recuperados com sucesso.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/ListWorkspaceNotificationAcknowledgementsResponseV2
              examples:
                paginated_result:
                  summary: Lista paginada com resultados
                  value:
                    has_next: false
                    data:
                      - id: 507f1f77bcf86cd799439012
                        name: LAPTOP-001
                        status: updated
                        total_users_accepted: 3
                        session_id: 42
                        workspace_id: 507f1f77bcf86cd799439099
                empty_result:
                  summary: Notificação existente sem destinatários
                  value:
                    has_next: false
                    data: []
        '400':
          description: >-
            Parâmetros de solicitação inválidos ou destino da notificação
            incompatível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalid_parameters:
                  summary: Parâmetros inválidos
                  value:
                    error:
                      message: Parámetros de solicitud no válidos.
                      code: BAD_REQUEST
                      details: per_page must be less than or equal to 100
        '401':
          description: Não autorizado ou sem acesso à organização.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unauthorized:
                  summary: Não autorizado
                  value:
                    error:
                      message: No autorizado.
                      code: UNAUTHORIZED
        '404':
          description: >-
            Notificação de workspace não encontrada dentro da organização
            autorizada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                not_found:
                  summary: Recurso não encontrado
                  value:
                    error:
                      message: Recurso no encontrado.
                      code: NOT_FOUND
        '429':
          description: Limite de solicitações excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                rate_limited:
                  summary: Limite de solicitações excedido
                  value:
                    error:
                      message: Límite de solicitudes excedido.
                      code: TOO_MANY_REQUESTS
        '500':
          description: Erro interno do servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                server_error:
                  summary: Erro interno
                  value:
                    error:
                      message: Error interno del servidor.
                      code: INTERNAL_SERVER_ERROR
        '503':
          description: Serviço indisponível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                service_unavailable:
                  summary: Serviço indisponível
                  value:
                    error:
                      message: Database unavailable
                      code: SERVICE_UNAVAILABLE
components:
  schemas:
    ListWorkspaceNotificationAcknowledgementsResponseV2:
      type: object
      properties:
        has_next:
          type: boolean
          description: Indica se existe uma próxima página.
        data:
          type: array
          items:
            $ref: '#/components/schemas/WorkspaceNotificationAcknowledgementItemV2'
      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
    WorkspaceNotificationAcknowledgementItemV2:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: >-
            Identificador do acuse de recebimento (FWS
            NotificationAcknowledgement.Oid).
        user_name:
          type: string
          nullable: true
          description: Usuário que confirmou.
        acknowledged_on:
          type: string
          nullable: true
          format: date-time
          description: Data/hora UTC do acuse.
        session_id:
          type: number
          nullable: true
          description: Identificador numérico de sessão em FWS.
        workspace_id:
          type: string
          nullable: true
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Identificador do workspace no Portal.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````