> ## 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 for an installed app > Returns a paginated list of Workspace-level observations for the selected installed app within the scope of the organization. ## OpenAPI ````yaml /en/api-reference/openapi.en-v1.json get /v1/organizations/{organization_id}/installed-apps/{installed_app_id}/workspaces openapi: 3.0.3 info: title: Public Portal API version: 1.0.0 description: Public REST API for portal servers: - url: https://api.staging.flxwvdexternal.com description: Staging API server. security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/installed-apps/{installed_app_id}/workspaces: get: tags: - Installed apps summary: List workspaces for an installed app description: >- Returns a paginated list of Workspace-level observations for the selected installed app within the scope of the organization. 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: Organization identifier. example: 507f1f77bcf86cd799439011 - name: installed_app_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Installed app identifier. example: 64f0c2a1b2d3e4f5060709aa - 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 maximum: 100 minimum: 1 description: Number of items per page. - name: fields in: query required: false schema: type: string maxLength: 2048 description: Comma-separated names of response item fields to include. - name: filters in: query required: false schema: type: string maxLength: 5120 description: JSON filter expression on response filterable field paths. examples: simple: summary: Filter by workspace_id value: >- {"field":"workspace_id","op":"eq","value":"64f0c2a1b2d3e4f5060708f1"} complex-and: summary: Filter by install_location and version value: >- {"and":[{"field":"install_location","op":"contains","value":"Program Files"},{"field":"version","op":"contains","value":"124"}]} complex-or-and: summary: Combine installed_at alternatives with an organization condition 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: Sorting expression with the format :asc|desc. responses: '200': description: Installed app Workspace observations obtained successfully. content: application/json: schema: $ref: '#/components/schemas/GetInstalledAppWorkspacesResponseV1' examples: paginated_result: summary: Paginated Workspace observations 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: No Workspace observations found value: has_next: false data: [] '400': description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_filters: summary: Invalid filter format value: error: message: Invalid filter format code: bad_request details: filters must be a valid JSON filter expression '401': description: Not authorized or organization not accessible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Organization access failure value: error: message: Unauthorized code: unauthorized '404': description: >- Installed app not found within the scope of the authorized organization. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: installed_app_not_found: summary: Requested installed app not found value: error: message: Installed app not found code: not_found '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Unhandled failure value: error: message: Internal Server Error code: internal_error components: schemas: GetInstalledAppWorkspacesResponseV1: type: object properties: has_next: type: boolean description: Indicates if another page is available. 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: Workspace identifier. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Organization identifier. version: type: string nullable: true description: Version of the installed application reported for the Workspace. reported_at: type: string format: date-time nullable: true description: Date and time of the last installation report for the Workspace. install_location: type: string nullable: true description: Reported installation path for the application in the Workspace. installed_at: type: string format: date-time nullable: true description: Reported installation date and time for the Workspace. required: - workspace_id - organization id securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````