LDX hubLDX hub
  • Pricing
  • Documentation
  • API Reference
Information
Files
    List uploaded filesgetUpload a filepostGet file infogetDownload file contentget
Uploads
    Create an upload sessionpostAppend a chunk to an uploadput
StructFlow Models
    List available modelsget
StructFlow Jobs
    List StructFlow job historygetCreate a StructFlow jobpostGet StructFlow job status and resultsget
RefineLoop Models
    List available modelsget
RefineLoop Jobs
    List RefineLoop job historygetCreate a RefineLoop jobpostGet RefineLoop job status and resultsget
RenderOCR Engines
    List available enginesget
RenderOCR Jobs
    List RenderOCR job historygetCreate a RenderOCR jobpostGet RenderOCR job status and resultsget
CastDoc Engines
    List available enginesget
CastDoc Jobs
    List CastDoc job historygetCreate a CastDoc jobpostGet CastDoc job status and resultsget
ExtractDoc Engines
    List available enginesget
ExtractDoc Jobs
    List ExtractDoc job historygetCreate an ExtractDoc jobpostGet ExtractDoc job status and resultsget
MCP
    MCP Serverpost
Schemas
powered by Zuplo
LDX hub API
LDX hub API

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[]
GET/files
curl https://gw.ldxhub.io/files \ --header 'Authorization: Bearer <token>'
Example Responses
{ "data": [ { "file_id": "ako5rgx309ehwlbqprs8s2xxnsp0y85q", "filename": "document.xlf", "size": 78578, "created_at": "2026-04-13T05:32:04Z", "updated_at": "2026-04-13T05:32:04Z", "expires_at": "2026-04-14T05:32:04Z" } ] }
json
application/json

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

POST/files
curl https://gw.ldxhub.io/files \ --request POST \ --header 'Content-Type: multipart/form-data' \ --header 'Authorization: Bearer <token>' \ --form 'file=<binary>'
Example Request Body
{ "file": "<binary>" }
text
Example Responses
{ "file_id": "ako5rgx309ehwlbqprs8s2xxnsp0y85q", "filename": "document.xlf", "size": 78578, "created_at": "2026-04-13T05:32:04Z", "updated_at": "2026-04-13T05:32:04Z", "expires_at": "2026-04-14T05:32:04Z" }
json
application/json

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

GET/files/{file_id}
curl https://gw.ldxhub.io/files/:file_id \ --header 'Authorization: Bearer <token>'
Example Responses
{ "file_id": "ako5rgx309ehwlbqprs8s2xxnsp0y85q", "filename": "document.xlf", "size": 78578, "created_at": "2026-04-13T05:32:04Z", "updated_at": "2026-04-13T05:32:04Z", "expires_at": "2026-04-14T05:32:04Z" }
json
application/json

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
GET/files/{file_id}/content
curl https://gw.ldxhub.io/files/:file_id/content \ --header 'Authorization: Bearer <token>'
Example Responses
No example specified for this content type
application/octet-stream

Uploads