> ## 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 para um aplicativo instalado > Devolve uma lista paginada de observações a nível de Workspace para o app instalado selecionado no alcance da organização. ## OpenAPI ````yaml /pt-BR/api-reference/openapi.pt-v1.json get /v1/organizations/{organization_id}/installed-apps/{installed_app_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}/installed-apps/{installed_app_id}/workspaces: get: tags: - Aplicações instaladas summary: Listar workspaces para um aplicativo instalado description: >- Devolve uma lista paginada de observações a nível de Workspace para o app instalado selecionado no alcance da organização. operationId: get_installed_app_workspaces parameters: - name: organization_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de organização. example: 507f1f77bcf86cd799439011 - name: installed_app_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de app instalado. example: 64f0c2a1b2d3e4f5060709aa - 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 maximum: 100 minimum: 1 description: Número de elementos por página. - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Nomes de campos de elementos de resposta separados por vírgulas para incluir. - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Expressão de filtro JSON sobre rotas de campos de resposta filtráveis. examples: simple: summary: Filtrar por workspace_id value: >- {"field":"workspace_id","op":"eq","value":"64f0c2a1b2d3e4f5060708f1"} complex-and: summary: Filtrar por local de instalação e versão value: >- {"and":[{"field":"install_location","op":"contains","value":"Program Files"},{"field":"version","op":"contains","value":"124"}]} complex-or-and: summary: >- Combinar alternativas de installed_at com uma condição de organização value: >- {"and":[{"or":[{"field":"installed_at","op":"eq","value":"2025-12-01T08:00:00.000Z"},{"field":"installed_at","op":"eq","value":"2025-11-15T09:30:00.000Z"}]},{"field":"organization_id","op":"eq","value":"507f1f77bcf86cd799439011"}]} - name: sort in: query required: false schema: type: string pattern: >- ^(workspace_id|organization_id|version|reported_at|install_location|installed_at):(asc|desc)$ description: Expressão de ordenação com o formato :asc|desc. responses: '200': description: Observações de Workspace de app instalado obtidas corretamente. content: application/json: schema: $ref: '#/components/schemas/GetInstalledAppWorkspacesResponseV1' examples: paginated_result: summary: Observações de Workspace paginadas value: has_next: true data: - workspace_id: 64f0c2a1b2d3e4f5060708f1 organization_id: 507f1f77bcf86cd799439011 version: 124.0.2478.97 reported_at: '2026-01-15T10:20:30.000Z' install_location: C:\Program Files\ExampleApp installed_at: '2025-12-01T08:00:00.000Z' empty_result: summary: Não se encontraram observações de Workspace value: has_next: false data: [] '400': description: Parâmetros de solicitação inválidos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_filters: summary: Formato de filtros inválido value: error: message: Formato de filters invalido code: bad_request details: filters debe ser una expresion de filtro JSON valida '401': description: Não autorizado ou a organização não é acessível. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Falha de acesso à organização value: error: message: No autorizado code: unauthorized '404': description: >- Não se encontrou o app instalado dentro do alcance de organização autorizado. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: installed_app_not_found: summary: Não se encontrou o app instalado solicitado value: error: message: No se encontro la app instalada code: not_found '500': description: Erro interno do servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Falha não controlada value: error: message: Error interno del servidor code: internal_error components: schemas: GetInstalledAppWorkspacesResponseV1: type: object properties: has_next: type: boolean description: Indica se há outra página disponível. data: type: array items: $ref: '#/components/schemas/GetInstalledAppWorkspacesItemV1' 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 GetInstalledAppWorkspacesItemV1: type: object properties: workspace_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador do Workspace. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de organização. version: type: string nullable: true description: Versão do aplicativo instalado reportado para o Workspace. reported_at: type: string format: date-time nullable: true description: Data e hora do último relatório de instalação para o Workspace. install_location: type: string nullable: true description: Caminho de instalação reportado para o aplicativo no Workspace. installed_at: type: string format: date-time nullable: true description: Data e hora de instalação reportada para o Workspace. required: - workspace_id - organization_id securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````