uploads

Enviar los bytes del archivo

Transporte HTTP binario fuera de MCP. Usa únicamente la cabecera Authorization temporal devuelta por createUploadSession y Content-Type: application/octet-stream. Envía los bytes sin procesar, no JSON, base64 ni multipart. Se permite un único intento de PUT por sesión; el número de bytes recibidos debe coincidir con size_bytes, incluso si no se proporciona Content-Length. No sigas redirecciones ni reenvíes las credenciales del espacio de trabajo. Si se pierde la respuesta del PUT, intenta crear la traducción con upload_id; si no hay una carga completa, solicita una sesión nueva. Este endpoint no se puede llamar desde AI Glot Code Mode. No crea una traducción ni consume créditos.

PUT/v1/uploads/{upload_id}/bytes

Request

curl --fail-with-body --request PUT \
  --url 'https://api.ai-glot.com/v1/uploads/<upload_id>/bytes' \
  --header 'Authorization: Bearer <temporary-upload-token>' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@document.xlsx'

import { readFile } from "node:fs/promises";

const response = await fetch("https://api.ai-glot.com/v1/uploads/<upload_id>/bytes", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer <temporary-upload-token>",
    "Content-Type": "application/octet-stream"
  },
  body: await readFile("document.xlsx"),
  redirect: "error",
});
if (!response.ok) throw new Error(`Upload failed: ${response.status}`);
const data = await response.json();
console.log(data);

application/json

{
  "data": {
    "upload_id": "550e8400-e29b-41d4-a716-446655440000",
    "uploaded": true,
    "size_bytes": 123
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

Usa upload_url, method y headers, que se devuelven al crear una sesión de carga. Este endpoint requiere el encabezado temporal Authorization, exclusivo para cargas. Una clave de API del espacio de trabajo o un token de acceso OAuth no autorizan esta solicitud.

Envía el propio archivo en el cuerpo HTTP con Content-Type: application/octet-stream. No lo envuelvas en JSON, base64 ni multipart. Si incluyes Content-Length, debe coincidir con size_bytes de la sesión. Las solicitudes sin ese encabezado también están limitadas al tamaño esperado. Se rechazan los cuerpos HTTP comprimidos; envía los bytes originales del documento.

Una respuesta correcta incluye upload_id, uploaded: true y size_bytes. Continúa enviando upload_id para crear una traducción con las mismas credenciales del espacio de trabajo que crearon la sesión. La traducción no empieza ni consume créditos hasta que se aprueba.

Recuperación segura

Cada sesión permite un único intento PUT. Las solicitudes simultáneas o los intentos PUT repetidos no pueden sustituir el archivo. Si un intento falla o se interrumpe, necesitas una sesión nueva.

Si se perdió la respuesta de la carga, prueba primero a crear la traducción con el upload_id existente. La carga completa se conserva aunque el cliente no haya recibido la respuesta de confirmación. Si no hay ninguna carga completa, solicita una nueva sesión y vuelve a enviar el archivo. No vuelvas a enviar bytes para sobrescribir la sesión anterior. La recuperación mediante upload_id está disponible hasta que se elimine la sesión, como mínimo 24 horas después de su emisión. Guarda el ID del lote para recuperar la traducción de tu historial más adelante.

Una carga caducada devuelve file_expired. Un PUT después de que se haya usado la capacidad devuelve batch_not_editable. Otra conexión u otro espacio de trabajo no pueden usar la carga. Si faltan bytes o el tamaño no es correcto, se devuelve invalid_parameter; si se envían más bytes de los que admite el tamaño de la sesión, se devuelve file_too_large.

Este endpoint binario se invoca desde un cliente HTTP externo, no desde una herramienta MCP ni un script de AI Glot Code Mode. Si el asistente no puede acceder al archivo original o realizar una solicitud PUT, explícaselo al usuario y ofrécele la aplicación web, la CLI o un enlace de descarga HTTPS. No reveles el secreto temporal en tu explicación.

Respuesta

application/json

Enviar bytes sin procesar a una sesión temporal de carga

dataobjectrequired

Show child attributes

upload_idstringrequired

uploadedbooleanrequired

size_bytesintegerrequired

request_idstringrequired

Enviar los bytes del archivo

Recuperación segura

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown