PATCH /translations

Manually replace the stored content of an existing translation. Use this when machine-generated output needs to be corrected without retranslating the entire document.

Endpoint: PATCH /translations Auth: Bearer JWT (WorkOS)

Request body

{
  "document_id": "<uuid>",
  "language": "fr",
  "content": {
    "title": "Bonjour",
    "body": "..."
  }
}

The combination of document_id and language identifies the translation row.

Response

{
  "document_id": "<uuid>",
  "language": "fr",
  "updated": true
}

Source-hash behavior

Manually updating a translation does not change its source_hash.

As a result:

• if the source document has not changed, a later POST /translation skips the translation and preserves the manual correction
• if the source document changes, its hash no longer matches and a later translation job may regenerate and overwrite the manually corrected content

Example

curl -X PATCH '{TRANSLATION_API_URL}/translations' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -H 'Content-Type: application/json' \
  -d '{
    "document_id": "<uuid>",
    "language": "fr",
    "content": {
      "title": "Bonjour",
      "body": "Contenu corrigé."
    }
  }'

Errors

• 400 Bad Request — content is not a JSON object
• 401 Unauthorized — bearer token is missing or invalid
• 404 Not Found — no translation exists for the supplied document_id and language
• 500 Internal Server Error — the translation could not be updated due to a database or service error