---
title: "Initialize glossary import process"
method: POST
path: "/glossary-api/v3/accounts/{accountUid}/glossaries/{glossaryUid}/import"
tags: ["Glossary API"]
---

# Initialize glossary import process

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

## Request

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

Initialize glossary import process. Upload file, and perform validation. ( No changes will be done during this method call ). In case of success glossary import will be created with 'PENDING' status.

## Path parameters

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

## Request body `multipart/form-data`

- GlossaryImportCommandPTO: Glossary import command.
  - `archiveMode` boolean: In case if `true` passed - all entries that are not in import file will be archived.
  - `importFile` string, binary, required: Binary file data to upload (CSV, XLSX or TBX).
  - `importFileName` string: Name and extension of the import file. Optional: used to detect the format when it can't be detected from the uploaded file name.
  - `importFileMediaType` 'text/csv' | 'text/xml' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': Import file media type. One of 'text/csv | text/xml | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'. Optional: used to detect the format when it can't be detected from the uploaded file name.

## Response `200`

OK

- GlossaryImportResponsePTO
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` GlossaryImportResponse: Glossary import meta-data.
      - `glossaryImport` GlossaryImport: Glossary import process meta-data.
        - `glossaryUid` string, uuid: Glossary uid.
        - `importUid` string, uuid: Import uid.
        - `importStatus` 'PENDING' | 'IN_PROGRESS' | 'SUCCESSFUL' | 'FAILED': Status of the import.
      - `entryChanges` ImportEntryChanges: Glossary entry change stats.
        - `newEntries` integer: Amount of glossary entries to be created.
        - `existingEntryUpdates` integer: Amount of glossary entries to be updated.
        - `notMatchedEntries` integer: Amount of glossary entries that wont be updated.
        - `entriesToArchive` integer: Amount of glossary entries to be archived.
      - `translationChanges` ImportEntryTranslationChanges[]: Translation changes stats.
        - `localeId` 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.
        - `newTranslations` integer: Amount of translations to be created.
        - `updatedTranslations` integer: Amount of translations to be updated.
        - `translationsToRemove` integer: Amount of translations to be removed.
      - `warnings` ImportWarning[]: Import process warnings.
        - `key` string: Warning key.
        - `message` string: Warning message.

## 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`: 1 breaking, 3 info
  - the response's body type changed from no type to `object` for status `200`
  - the `archiveMode` request property default value `false` was added
  - removed `#/components/schemas/SuccessResponse, subschema #2` from the response body `allOf` list for the response status `200`
  - added the required property `response` to the response with the `200` status
- **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/import/post.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)