---
title: "Import Termbase"
method: POST
path: "/termbases/{termbaseId}/imports"
tags: ["Termbase Import"]
---

# Import Termbase

`POST /termbases/{termbaseId}/imports`

## Request

- Base URL: `https://api.eu.cloud.trados.com/public-api/v1`
- URL: `https://api.eu.cloud.trados.com/public-api/v1/termbases/{termbaseId}/imports`
- Auth: none declared. Required headers: `Authorization`, `X-LC-Tenant`

Generates an asynchronous import operation.<br>
Use the Poll Import Termbase endpoint to poll until the import status is `done`.<br>

## Query parameters

- `strictImport` boolean
- `duplicateEntriesStrategy` 'ignore' | 'merge' | 'overwrite'

## Headers

- `Authorization` string, required
- `X-LC-Tenant` string, required

## Request body `multipart/form-data`

- object
  - `properties` TermbaseImportRequest: Properties required for system status mapping
    - `statusMapping` TermbaseSystemStatusMapping[]
      - `systemStatusValue` 'preferred' | 'draft' | 'inReview' | 'deprecated' | 'recommended' | 'admitted' | 'forbidden' | 'rejected' | 'superseded', required
      - `statuses` string[], required
  - `file` string, binary, required: The file (binary string) to import into the termbase.<br> Accepted file types: <b>.xml</b>, <b>.tbx</b> <br>

## Response `200`

OK

- TermbaseImportResponse
  - `id` string, required: The unique identifier of the import operation.
  - `status` 'queued' | 'processing' | 'done' | 'cancelled' | 'failed' | 'error', required: The status of the import operation.<br> `queued` - The import passed the structural validation and it's waiting to be processed.<br> `processing` - The import is in progress.<br> `done` - The import was successfully processed and at least an entry changed its structure ( either inserted or modified )<br> `cancelled` - The import process was interrupted.<br> `failed` - The import was unsuccessful. Either one of the import files is not compliant with the TBX structure or no entry changed during the import process.<br> `error` - The import was unsuccessful due to an internal error.

## Other responses

- `400`: Error codes: * "invalid": Invalid input in the query parameter mentioned in the “name” field on the error response.
- `401`: The user could not be identified.
- `403`: Error codes: * "forbidden": - The authenticated user is not allowed to read entry. * "entitlementMissing": - Your subscription does not include access to the requested type of benefit.
- `409`: Error codes: * "invalidStatus": Cannot import as the termbase is currently being processed.

---

[API](https://skmtc.dev/rws/apis/trados-cloud-platform-api.md) - [All operations](https://skmtc.dev/rws/apis/trados-cloud-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rws/apis/trados-cloud-platform-api/revisions/3dfeb493a00b?raw)