---
title: "Translate Label"
method: POST
path: "/translate/label"
tags: ["Translate"]
---

# Translate Label

`POST /translate/label`

## Request

- Base URL: `https://backend.ressl.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://backend.ressl.ai/translate/label`
- Auth: none declared

Translate custom labels (ExternalString) using deterministic translation.

The endpoint:
1. Detects language code (using predefined list or Gemini 2.5 Flash Lite API)
2. Creates a deterministic translation ticket handled by the custom labels translator
3. Enqueues classification task in the background
4. Uses request.type as the namespace filter (optional)
5. Supports file attachments (documents are converted to text and stored)

The actual translation is done deterministically in task_executor.py before
the execution agent runs, then the agent only verifies the output.

## Request body `multipart/form-data`

- BodyTranslateLabelTranslateLabelPost
  - `language` string, required
  - `type` string, required
  - `organization_id` string, required
  - `connection_id` string, required
  - `files` string[], nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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