Document Translation

Document translation jobs allow you to translate office documents — Word, Excel, and PowerPoint files — directly, using natural language instructions to control what gets translated. Upload your document via the files endpoints first, then create a job with the file’s S3 key. Each endpoint responds with a job object; use the translation jobs endpoints to track job status and retrieve results.

Create a Word document translation job

POST /v1/jobs/translate/docx This endpoint allows you to create a new Word document translation job with content-level filtering. DOCX files are translated using memoQ/AIMT, with optional content exclusions via natural language instructions (e.g. “do not translate the highlighted text”). Upload the .docx file via files first.

Required attributes

string

required

S3 key of the .docx file (uploaded via /files).

string

required

Natural language instruction for content filtering, e.g. “do not translate the highlighted text”.

string

required

Source language code (e.g., “en”).

array

required

Target language codes (e.g., [“de”, “fr”]).

Optional attributes

string

Content domain for the translation (e.g., “technical”, “legal”, “marketing”).

array

List of glossary IDs to use for terminology consistency.

array

List of context store IDs to provide reference materials (styleguide content).

string

Additional translation instructions or styleguide content.

curl -X POST https://api.elanlanguages.ai/v1/jobs/translate/docx \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -H "Content-Type: application/json" \
  -d '{
    "source_file": "uploads/employee-handbook.docx",
    "instruction": "do not translate the highlighted text",
    "source_language": "en",
    "target_languages": ["de", "fr"],
    "domain": "legal",
    "glossaries": [1, 2]
  }'

Response

{
  "job_id": "job_docx_abc123def456",
  "status": "queued",
  "message": "Word document translation job created successfully",
  "created_at": "2025-12-21T10:34:41.135Z"
}

Create an Excel translation job

POST /v1/jobs/translate/excel This endpoint allows you to create a new Excel translation job driven by natural language instructions. Excel files are translated directly using AI, without TMS/XLIFF intermediaries. Upload the .xlsx file via files first, then provide instructions like “translate column A, put Spanish in B, Italian in C”.

Required attributes

string

required

S3 key of the .xlsx file (uploaded via /files).

string

required

Natural language instruction, e.g. “translate column A, put results in B and C”.

string

required

Source language code (e.g., “en”).

array

required

Target language codes (e.g., [“es”, “it”]).

Optional attributes

string

Content domain for the translation (e.g., “marketing”, “legal”).

string

Translation provider (default: “openai”).

array

List of glossary IDs to use for terminology consistency.

array

List of context store IDs to provide reference materials (styleguide content).

string

Additional translation instructions or styleguide content.

string

Name of the sheet to process (default: active sheet).

integer

1-based header row override.

integer

1-based data start row override.

curl -X POST https://api.elanlanguages.ai/v1/jobs/translate/excel \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -H "Content-Type: application/json" \
  -d '{
    "source_file": "uploads/product-catalog.xlsx",
    "instruction": "translate column A, put Spanish in B and Italian in C",
    "source_language": "en",
    "target_languages": ["es", "it"],
    "sheet_name": "Products"
  }'

Response

{
  "job_id": "job_xlsx_abc123def456",
  "status": "queued",
  "message": "Excel translation job created successfully",
  "created_at": "2025-12-21T10:34:41.135Z"
}

Create a PowerPoint translation job

POST /v1/jobs/translate/ppt This endpoint allows you to create a new PowerPoint translation job with slide-level filtering. PPTX files are translated using memoQ/AIMT, with optional slide selection via natural language instructions (e.g. “translate only slides 1-3 and 6-7”). Upload the .pptx file via files first.

Required attributes

string

required

S3 key of the .pptx file (uploaded via /files).

string

required

Natural language instruction for slide selection, e.g. “translate only slides 1-3 and 6-7”.

string

required

Source language code (e.g., “en”).

array

required

Target language codes (e.g., [“de”, “fr”]).

Optional attributes

string

Content domain for the translation (e.g., “technical”, “legal”, “marketing”).

array

List of glossary IDs to use for terminology consistency.

array

List of context store IDs to provide reference materials (styleguide content).

string

Additional translation instructions or styleguide content.

curl -X POST https://api.elanlanguages.ai/v1/jobs/translate/ppt \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -H "Content-Type: application/json" \
  -d '{
    "source_file": "uploads/quarterly-review.pptx",
    "instruction": "translate only slides 1-3 and 6-7",
    "source_language": "en",
    "target_languages": ["de", "fr"]
  }'

Response

{
  "job_id": "job_ppt_abc123def456",
  "status": "queued",
  "message": "PowerPoint translation job created successfully",
  "created_at": "2025-12-21T10:34:41.135Z"
}

Guides

Jobs & Translation

Resources

Webhooks

Account

Create a Word document translation job

Required attributes

Optional attributes

Create an Excel translation job

Required attributes

Optional attributes

Create a PowerPoint translation job

Required attributes

Optional attributes

​Create a Word document translation job

​Required attributes

​Optional attributes

​Create an Excel translation job

​Required attributes

​Optional attributes

​Create a PowerPoint translation job

​Required attributes

​Optional attributes

Create a Word document translation job

Required attributes

Optional attributes

Create an Excel translation job

Required attributes

Optional attributes

Create a PowerPoint translation job

Required attributes

Optional attributes