---
title: "(BETA) Workspaces that use a language."
method: GET
path: "/api/v1/actions/organization/localization/usage/workspaces"
tags: ["Localization"]
---

# (BETA) Workspaces that use a language.

`GET /api/v1/actions/organization/localization/usage/workspaces`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/actions/organization/localization/usage/workspaces`
- Auth: none declared

(BETA) Lists the workspaces behind the counts of the organization localization usage, sorted by name. Without the setting filter, a workspace matches when any of the display, metadata and data language settings matches, and its source is the strongest one. Without the value filter, a setting without a language matches too. An empty `value=` means no filter. No value selects the usage entry without a language.

## Query parameters

- `value` string
- `name` string
- `setting` 'LOCALE' | 'METADATA_LOCALE' | 'DATA_LOCALE'
- `source` 'USER' | 'WORKSPACE' | 'PARENT' | 'ORGANIZATION' | 'ENVIRONMENT' | 'DEFAULT': Where the value comes from, from the strongest source to the weakest: USER - the user set it. WORKSPACE - the workspace sets it. PARENT - the workspace inherits it from a parent workspace. ORGANIZATION - the organization default. ENVIRONMENT - the default set for the whole deployment. DEFAULT - the built-in default.
- `page` integer
- `size` integer

## Response `200`

OK

- LocalizationUsageWorkspaces
  - `totalCount` integer, required: The total number of workspaces that match the filters.
  - `workspaces` LocalizationUsageWorkspace[], required
    - `bySetting` LocalizationResolvedValues, required: The value for each of the display, metadata and data language settings, with its source.
      - `DATA_LOCALE` LocalizationResolvedValue, required: The value a workspace gets for one setting, and where it comes from. Never null. `content.value` is null when the workspace gets no language.
        - `content` LocalizationContent, required
          - `value` string, nullable: Language tag, or null when no language is set.
        - `originId` string, nullable: The ancestor workspace that sets the value. Null unless the source is PARENT.
        - `source` 'USER' | 'WORKSPACE' | 'PARENT' | 'ORGANIZATION' | 'ENVIRONMENT' | 'DEFAULT', required: Where the value comes from, from the strongest source to the weakest: USER - the user set it. WORKSPACE - the workspace sets it. PARENT - the workspace inherits it from a parent workspace. ORGANIZATION - the organization default. ENVIRONMENT - the default set for the whole deployment. DEFAULT - the built-in default.
      - `LOCALE` LocalizationResolvedValue, required: The value a workspace gets for one setting, and where it comes from. Never null. `content.value` is null when the workspace gets no language.
        - `content` LocalizationContent, required
          - `value` string, nullable: Language tag, or null when no language is set.
        - `originId` string, nullable: The ancestor workspace that sets the value. Null unless the source is PARENT.
        - `source` 'USER' | 'WORKSPACE' | 'PARENT' | 'ORGANIZATION' | 'ENVIRONMENT' | 'DEFAULT', required: Where the value comes from, from the strongest source to the weakest: USER - the user set it. WORKSPACE - the workspace sets it. PARENT - the workspace inherits it from a parent workspace. ORGANIZATION - the organization default. ENVIRONMENT - the default set for the whole deployment. DEFAULT - the built-in default.
      - `METADATA_LOCALE` LocalizationResolvedValue, required: The value a workspace gets for one setting, and where it comes from. Never null. `content.value` is null when the workspace gets no language.
        - `content` LocalizationContent, required
          - `value` string, nullable: Language tag, or null when no language is set.
        - `originId` string, nullable: The ancestor workspace that sets the value. Null unless the source is PARENT.
        - `source` 'USER' | 'WORKSPACE' | 'PARENT' | 'ORGANIZATION' | 'ENVIRONMENT' | 'DEFAULT', required: Where the value comes from, from the strongest source to the weakest: USER - the user set it. WORKSPACE - the workspace sets it. PARENT - the workspace inherits it from a parent workspace. ORGANIZATION - the organization default. ENVIRONMENT - the default set for the whole deployment. DEFAULT - the built-in default.
    - `childrenCount` integer, required: Number of direct child workspaces.
    - `id` string, required
    - `name` string, required
    - `parentId` string, nullable: The parent workspace, or null for a root workspace.
    - `source` 'USER' | 'WORKSPACE' | 'PARENT' | 'ORGANIZATION' | 'ENVIRONMENT' | 'DEFAULT', required: Where the value comes from, from the strongest source to the weakest: USER - the user set it. WORKSPACE - the workspace sets it. PARENT - the workspace inherits it from a parent workspace. ORGANIZATION - the organization default. ENVIRONMENT - the default set for the whole deployment. DEFAULT - the built-in default.

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)