---
title: Language Translations
description: Explains the PingOne translations endpoint for viewing and updating localized UI string translations for a specified language
component: pingone-api
page_id: pingone-api:platform:language-management/language-translations/index
canonical_url: https://developer.pingidentity.com/pingone-api/platform/language-management/language-translations/index.html
llms_txt: https://developer.pingidentity.com/pingone-api/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2026-08-11
section_ids:
  languages-translation-request-data-model: Languages translation request data model
  languages-translation-response-data-model: Languages translation response data model
  response-codes: Response codes
---

# Language Translations

The translations endpoint supplies operations to view the custom string translations for a specified language, and to update localized strings for UI elements in the specified language.

|   |                                                                                                                                    |
| - | ---------------------------------------------------------------------------------------------------------------------------------- |
|   | After you change a language locale or translation configuration, it might take up to 30 seconds for DaVinci to reflect the update. |

The response for a `GET` request returns the embedded resources that supply UI strings in English, and the associated localized string content in the specified language. Here's a sample of a localized string (in French) for the Cancel button in the `flow-ui` module used in a UI page:

```json
    "_embedded": {
        "translations": [
            {
                "id": "3e90224d-9036-4d78-badb-65e98f4fc944",
                "key": "flow-ui.button.cancel",
                "shortKey": "button.cancel",
                "referenceText": "Cancel",
                "translatedText": "Annuler"
            },
```

PingOne support UI string translations for the following languages:

| Locale  | Language          |
| ------- | ----------------- |
| `de`    | German            |
| `en`    | English           |
| `es`    | Spanish           |
| `fr`    | French            |
| `fr-CA` | French (Canadian) |
| `it`    | Italian           |
| `ja`    | Japanese          |
| `ko`    | Korean            |
| `nl`    | Dutch             |
| `pt`    | Portuguese        |
| `ru`    | Russian           |
| `th`    | Thai              |
| `tr`    | Turkish           |
| `zh`    | Chinese           |
| `cs`    | Czech             |

## Languages translation request data model

For `PUT` requests, the following properties are required in the request body.

| Property         | Type   | Required | Mutable | Description                                                                                                                |
| ---------------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `key`            | String | Required | Mutable | A string that specifies the page and name of the interface element to be localized (for example, `flow-ui.button.cancel`). |
| `translatedText` | String | Required | Mutable | A string that specifies the translated string text associated with the interface element.                                  |

|   |                                                                                                             |
| - | ----------------------------------------------------------------------------------------------------------- |
|   | `PUT` operations do not return data in the response. A successful update request returns a `200 OK` status. |

## Languages translation response data model

For `GET` requests, the data model returns the following information about the specified language's localized strings.

| Property                      | Type   | Description                                                                                        |
| ----------------------------- | ------ | -------------------------------------------------------------------------------------------------- |
| `translations.id`             | String | The translation ID for a specific string.                                                          |
| `translations.key`            | String | The page and name of the interface element to be localized (for example, `flow-ui.button.cancel`). |
| `translations.shortKey`       | String | The interace element only (for example, `button.cancel`).                                          |
| `translations.referenceText`  | String | The English string text associated with the interface element.                                     |
| `translations.translatedText` | String | The translated string text associated with the interface element.                                  |

## Response codes

| Code | Message                                                               |
| ---- | --------------------------------------------------------------------- |
| 200  | Successful operation.                                                 |
| 400  | The request could not be completed.                                   |
| 401  | You do not have access to this resource.                              |
| 403  | You do not have permissions or are not licensed to make this request. |
| 404  | The requested resource was not found.                                 |