> This page is for API Reference & Tools.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Language Settings (MLS)

> Read and update Language Settings (MLS) through the Moveworks Configuration API: endpoints, fields and examples.

`assistant.mls`

Language/translation settings.

* **Endpoint:** `/assistant/mls`  |  **Methods:** GET, PATCH
* **Request shape:** one per organization, so there is no `id`. It already exists: read it with `GET`, then `PATCH` the fields you want to change. Fields go at the top level of the JSON body, with no `resource` wrapper.
* **Updates:** a JSON merge-patch. Send only the fields you change, plus `version: {num, change_description}` with the `num` from your last read. Lists and maps you send replace the stored ones whole.

### Endpoints

All paths are relative to `https://api.moveworks.ai/configurations/v1alpha1`. Each endpoint page lists the request and response schema, an example, and the errors it can return.

| Method  | Path             | Endpoint reference                                                                                                       |
| ------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `GET`   | `/assistant/mls` | [Get language settings](/api-reference/configuration-api/platform-org/language-settings-mls/get-language-settings)       |
| `PATCH` | `/assistant/mls` | [Update language settings](/api-reference/configuration-api/platform-org/language-settings-mls/update-language-settings) |

### Fields

| Field                                | Type                                  | Required  | Notes                                                                                                                                                                            |
| ------------------------------------ | ------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `installed_locales`                  | array\<string>                        |           | Core languages installed for the organization, such as EN_US or FR_CA. Managed with the Moveworks MLS Operations team and cannot be changed through this API.                    |
| `pending_translation_locales`        | array\<string>                        |           | Languages requested for human translation, used only in the Moveworks Classic experience. Managed with the Moveworks MLS Operations team and cannot be changed through this API. |
| `machine_translation_locales`        | array\<string>                        |           | Languages enabled through machine translation. They are instantly available in both the Moveworks Classic and AI Assistant experiences.                                          |
| `default_dm_locale`                  | string                                |           | Default non-English response language for all users. Leave blank for English. Must be an installed locale and cannot be changed through this API.                                |
| `multi_languages_enabled`            | string                                |           | Moveworks DSL rule for which users get multilingual support. Use 'true' to enable for all users.                                                                                 |
| `ticket_translation_enabled`         | string                                |           | Moveworks DSL rule for which users get translation of ticket filing and ticket comments.                                                                                         |
| `use_ingested_user_default_locale`   | boolean                               |           | If true, a user's preferred language from your ingested user records is used instead of the organization-wide default response language.                                         |
| `display_record_translation_enabled` | boolean                               |           | If true, field values in display records such as ticket notifications and people cards are translated.                                                                           |
| `translation_override_configs`       | array\<TranslationOverrideConfig>     |           | Custom translations that replace the machine translation of specific source strings.                                                                                             |
| `disable_translation_configs`        | array\<MLSDisableTranslationConfig>   |           | Keywords after which text is not translated, per machine translation source.                                                                                                     |
| `locale_prompt_override_configs`     | array\<MLSLocalePromptOverrideConfig> |           | Custom gender and formality instructions for specific locales.                                                                                                                   |
| `updated_time`                       | string                                | read-only | When the configuration was last updated.                                                                                                                                         |
| `updated_by`                         | string                                | read-only | Who last updated the configuration.                                                                                                                                              |
| `version`                            | Version                               |           | Document version. On update, send back the num from your last read.                                                                                                              |

### Document fields (example)

The document as `GET` returns it. To change any of these, send only the fields you want to change in the `PATCH` body.

```json
{
  "installed_locales": [],
  "pending_translation_locales": [],
  "machine_translation_locales": [],
  "default_dm_locale": "EN_US",
  "multi_languages_enabled": "<string>",
  "ticket_translation_enabled": "<string>",
  "use_ingested_user_default_locale": true,
  "display_record_translation_enabled": true
}
```