uploads

Send file bytes

Binary HTTP transport outside MCP. Use only the temporary Authorization header returned by createUploadSession and Content-Type: application/octet-stream. Send raw bytes, not JSON, base64 or multipart. One PUT attempt per session; the received byte count must match size_bytes even without Content-Length. Never follow redirects or forward your workspace credential. After a lost PUT response, try creating the translation with upload_id; if no complete upload exists, request a new session. This endpoint cannot be called inside AI Glot Code Mode. It does not create a translation or spend credits.

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>"
}

Use the upload_url, method and headers returned by creating an upload session. This endpoint requires the temporary upload-only Authorization header. A workspace API key or OAuth access token cannot authorize this request.

Send the file itself as the HTTP body with Content-Type: application/octet-stream. Do not wrap it in JSON, base64 or multipart. Content-Length, if supplied, must equal the session’s size_bytes. Requests without that header are still bounded by the expected size. Compressed HTTP bodies are refused; send the original document bytes.

A successful response contains upload_id, uploaded: true and size_bytes. Continue by sending upload_id to create a translation with the same workspace credential that created the session. Only approval starts the translation and spends credits.

Recovering safely

One session permits one PUT attempt. Concurrent requests and repeated PUT requests cannot replace its file. A failed or interrupted attempt needs a new session.

If the upload response was lost, first try creating the translation with the existing upload_id. A complete upload is retained even if the client did not receive its success response. If no complete upload exists, request a new session and send the file again. Never resend bytes to overwrite the old session. Recovery by upload_id is available until session cleanup, at least 24 hours after issuance. Keep the batch ID to retrieve the translation from your history afterwards.

An expired upload returns file_expired. A PUT after the capability has been used returns batch_not_editable. A different connection or workspace cannot consume the upload. Incomplete bytes or an incorrect size return invalid_parameter; bytes beyond the session size return file_too_large.

This binary endpoint is called by an external HTTP client, not by an MCP tool or an AI Glot Code Mode script. If your assistant cannot access the original file or make a PUT request, tell the user and offer the web app, CLI or an HTTPS download link. Never disclose the temporary secret in your explanation.

Response

application/json

Send raw bytes to a temporary upload session

dataobjectrequired

Show child attributes

upload_idstringrequired

uploadedbooleanrequired

size_bytesintegerrequired

request_idstringrequired

Send file bytes

Recovering safely

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown