---
title: "Create auto-translation jobs"
method: POST
path: "/api/v2/jobs/auto-translate"
tags: ["Auto-translation"]
---

# Create auto-translation jobs

`POST /api/v2/jobs/auto-translate`

## Request

- Base URL: `https://api.simplelocalize.io`
- URL: `https://api.simplelocalize.io/api/v2/jobs/auto-translate`
- Auth: API key in header `X-SimpleLocalize-Token`
- TypeScript: <https://skmtc.dev/simplelocalize/apis/simplelocalize-api/docs/api/v2/jobs/auto-translate/post.ts> (a function with typed inputs; its response is checked against the schema)

Create auto-translation jobs for a project and one or more languages

## Headers

- `X-SimpleLocalize-Token` string, required

## Request body

- ApiAutoTranslateRequestV2
  - `languageKeys` string[]: Project source language keys, if not provided then all languages will be translated. Auto-translation configuration will be used from the last auto-translation job.
  - `options` string[]: Options for auto-translation

## Response `200`

OK

- object
  - `msg` string
  - `status` integer
  - `data` JobItem[]
    - `jobId` string
    - `progress` number, float
    - `state` string
    - `type` string
    - `message` string
    - `started` string, date-time
    - `metadata` object

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2025-11-12** `0329534cd557`: 16 info
  - the endpoint scheme security `Project API Key` was added to the API
  - the endpoint scheme security `apiKey` was removed from the API
  - added the optional property `title` to the response with the `400` status
  - added the optional property `title` to the response with the `402` status
  - …12 more
- **2025-04-19** `5475c7163be9`: 11 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `402` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - …7 more
- **2023-11-30** `18bfbf87af44`: 8 breaking, 1 warning, 11 info
  - request property `options` was restricted to a list of enum values
  - removed the media type `*/*` for the response with the status `200`
  - removed the media type `*/*` for the response with the status `400`
  - removed the media type `*/*` for the response with the status `402`
  - …16 more

[Operation history](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/changes/api/v2/jobs/auto-translate/post.md)

---

[API](https://skmtc.dev/simplelocalize/apis/simplelocalize-api.md) - [All operations](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/llms.txt) - [OpenAPI document](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/revisions/67a25a25863a?raw)