Files

Upload and manage files used as job inputs or outputs

List uploaded files

GET

https://gw.ldxhub.io

/files

Returns a list of files uploaded by the authenticated user.

List uploaded files › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List uploaded files › Responses

A list of files

FileInfo[]

Upload a file

POST

https://gw.ldxhub.io

/files

Upload a file (e.g. XLIFF) to use as input for a job. Returns a file_id that can be referenced when creating a job. Files expire after a period of time. Maximum file size: 200MB.

This endpoint accepts multipart/form-data. For JSON-based chunk uploads (e.g. from MCP clients), use POST /uploads instead.

Upload a file › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Upload a file › Request Body

file

string · binary · required

The file to upload (binary, multipart/form-data)

Upload a file › Responses

File uploaded successfully

FileInfo

file_id

string

Unique file identifier. Use this value in job requests.

filename

string

Original filename

size

integer

File size in bytes

created_at

string · date-time

updated_at

string · date-time

expires_at

string · date-time

Files are automatically deleted after a period of time

Get file info

GET

https://gw.ldxhub.io

/files/{file_id}

Returns metadata for a specific file.

Get file info › path Parameters

file_id

string · required

The unique identifier of the file

Get file info › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get file info › Responses

File metadata

FileInfo

file_id

string

Unique file identifier. Use this value in job requests.

filename

string

Original filename

size

integer

File size in bytes

created_at

string · date-time

updated_at

string · date-time

expires_at

string · date-time

Files are automatically deleted after a period of time

Download file content

GET

https://gw.ldxhub.io

/files/{file_id}/content

Downloads the binary content of a file. Supports Range and If-Unmodified-Since headers for partial content retrieval.

Download file content › path Parameters

file_id

string · required

The unique identifier of the file

Download file content › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Range

string

Byte range for partial content (e.g. bytes=0-1023)

If-Unmodified-Since

string

Conditional request header

Download file content › Responses

Full file content

string · binary

Uploads