Skip to navigation
Developer ReferenceAPI ReferenceStyle AgentTerminology

Import XML Dump

Import an Acrolinx terminology XML database dump. Maximum file size: 100MB.

This replaces all existing terminology in the organization. Every term, category, and custom field is removed and rebuilt from the file.

Returns immediately with a job to poll via GET /jobs/{job_id} or GET /jobs/current; the import continues in the background and can take several minutes for a large dump. A file that fails validation is reported on the job as a failure, not on this response.

Returns 413 if the file exceeds the size limit, and 409 if a publish or import is already in progress — only one runs per organization at a time.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a multipart form containing a file.
filefileRequired

Response

Successful Response
idstringformat: "uuid"
job_typestring

Either publish or import.

statusstring

One of queued, running, succeeded, failed, or canceled. The first two mean the job is still holding the lock.

started_atdatetime
stagestring or nullOptional

Coarse progress label while running; null once finished.

started_bystring or nullOptional
Who started the job, for display.
finished_atdatetime or nullOptional
errorstring or nullOptional

Why the job failed; null unless status is failed.

term_countinteger or nullOptional
Terms published, for a successful publish.
statsmap from strings to integers or nullOptional

Per-record-type counts, for a successful import.

languageslist of objectsOptional

How each language fared, for a publish. Empty for an import, and for publishes that ran before per-language reporting existed.

import_term_filterslist of objectsOptional
What an import did with each of the legacy terminology's saved term filters. Empty for a publish, and for imports that ran before this was reported.
publish_term_filterslist of objectsOptional
What a publish did with each filter used for checking. Empty for an import, and for publishes that ran before this was reported.

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error