PATCH /translations

Reemplaza manualmente el contenido almacenado de una traducción existente. Úsalo cuando sea necesario corregir la salida generada por máquina sin volver a traducir todo el documento.

Punto de conexión: PATCH /translations Autenticación: Bearer JWT (WorkOS)

Cuerpo de la solicitud

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

La combinación de document_id y language identifica la fila de la traducción.

Respuesta

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

Comportamiento del hash de origen

Actualizar manualmente una traducción no cambia su source_hash.

Como resultado:

• si el documento de origen no ha cambiado, un POST /translation posterior omite la traducción y conserva la corrección manual
• si el documento de origen cambia, su hash ya no coincide y un trabajo de traducción posterior puede regenerar y sobrescribir el contenido corregido manualmente

Ejemplo

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": "Contenido corregido."
    }
  }'

Errores

• 400 Bad Request — content no es un objeto JSON
• 401 Unauthorized — falta el token de portador o no es válido
• 404 Not Found — no existe una traducción para el document_id y language proporcionados
• 500 Internal Server Error — no se pudo actualizar la traducción debido a un error de base de datos o del servicio