---
title: "Update glossary"
method: PUT
path: "/glossary-api/v3/accounts/{accountUid}/glossaries/{glossaryUid}"
tags: ["Glossary API"]
---

# Update glossary

`PUT /glossary-api/v3/accounts/{accountUid}/glossaries/{glossaryUid}`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/glossary-api/v3/accounts/{accountUid}/glossaries/{glossaryUid}`
- Auth: HTTP bearer

Update glossary endpoint.

## Path parameters

- `accountUid` string, required
- `glossaryUid` string, uuid, required

## Request body

- GlossaryCommandPTO: Glossary command.
  - `glossaryName` string, required: Name of the glossary, unique within the account. Character limit is equal to 170 characters.
  - `description` string: Description of the glossary. Character limit is equal to 250 characters.
  - `verificationMode` boolean: Verification mode.
  - `localeIds` LocaleId[], required: Supported locale ids. Must not be empty; each locale must be a supported Smartling locale.
  - `fallbackLocales` FallbackLocaleCommandPTO[]: Fallback locales configuration. Items whose locales are not listed in `localeIds` are ignored.
    - `fallbackLocaleId` string, required: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
    - `localeIds` LocaleId[], required: Locales ids.

## Response `200`

- GlossaryResponsePTO
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` GlossaryResponse: Glossary response.
      - `glossaryUid` string: Glossary uid.
      - `accountUid` string: Account uid.
      - `glossaryName` string: Glossary name.
      - `description` string: Glossary description.
      - `verificationMode` boolean: Glossary verificationMode.
      - `archived` boolean: Glossary archived. In case if {@code true} set, then glossary is archived.
      - `createdByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
      - `modifiedByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
      - `createdDate` string, date-time: ISO 8601 UTC timestamp.
      - `modifiedDate` string, date-time: ISO 8601 UTC timestamp.
      - `localeIds` LocaleId[]: Locale ids that current glossary supports.
      - `fallbackLocales` FallbackLocalePTO[]: Fallback locales configuration.
        - `fallbackLocaleId` string: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
        - `localeIds` LocaleId[]: Locale ids.

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Provided credentials are not valid.
- `403`: Access denied.
- `404`: Resource not found.
- `429`: Too many simultaneous API requests.
- `500`: Unexpected error.

## Changes

- **2026-10-26** `0da6569bfcb7`: 3 breaking, 2 warning, 2 info
  - the request property `localeIds` became required
  - the `localeIds` request property's minItems was increased to `1`
  - the response's body type changed from no type to `object` for status `200`
  - the `description` request property's maxLength was set to `250`
  - …3 more
- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/glossary-api/v3/accounts/:accountUid/glossaries/:glossaryUid/put.md)

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) - [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)