CastDoc Jobs

Create and manage CastDoc PDF-to-Office document conversion jobs

List CastDoc job history

GET

https://gw.ldxhub.io

/castdoc/jobs

Returns a list of jobs for the authenticated user, ordered by creation date descending. Use GET /castdoc/jobs/{job_id} to retrieve full details for a specific job.

List CastDoc job history › 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 CastDoc job history › Responses

A list of jobs

CastDocJobSummary[]

Create a CastDoc job

POST

https://gw.ldxhub.io

/castdoc/jobs

Enqueues an asynchronous PDF-to-Office document conversion job. Upload your PDF file via POST /files first, then submit the file_id here. Returns 202 Accepted immediately with a job_id. Poll GET /castdoc/jobs/{job_id} to check completion. When completed, download the converted document via GET /files/{output_file_id}/content.

Create a CastDoc job › 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.

Create a CastDoc job › Request Body

CastDocCreateJobRequest

engine

string · required

Engine ID obtained from GET /castdoc/engines

file_id

string · required

File ID of the input PDF file to process, obtained from POST /files

output_format

string · enum · required

Output document format

Enum values:

docx

xlsx

pptx

Create a CastDoc job › Responses

Job accepted

Full job details. Returned by GET /castdoc/jobs/{job_id}.

CastDocJobDetail

job_id

string

file_id

string

Input file ID

engine

string

status

string · enum

Enum values:

queued

processing

completed

failed

progress

number · float

output_file_id

string

File ID of the converted document output. Present only when status is completed. Download via GET /files/{output_file_id}/content.

JobError

Job-level error. Present only when job status is failed.

created_at

string · date-time

updated_at

string · date-time

completed_at

string · date-time

expires_at

string · date-time

Usage

Get CastDoc job status and results

GET

https://gw.ldxhub.io

/castdoc/jobs/{job_id}

Returns the current status of a CastDoc job. Poll this endpoint until status is completed or failed. Recommended polling interval: 1-5 seconds. When status is completed, use output_file_id to download the converted document via GET /files/{output_file_id}/content. Results are retained for a limited period after completion (expires_at).

Get CastDoc job status and results › path Parameters

job_id

string · required

The unique identifier of the job

Get CastDoc job status and results › 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 CastDoc job status and results › Responses

Job details

Full job details. Returned by GET /castdoc/jobs/{job_id}.

CastDocJobDetail

job_id

string

file_id

string

Input file ID

engine

string

status

string · enum

Enum values:

queued

processing

completed

failed

progress

number · float

output_file_id

string

File ID of the converted document output. Present only when status is completed. Download via GET /files/{output_file_id}/content.

JobError

Job-level error. Present only when job status is failed.

created_at

string · date-time

updated_at

string · date-time

completed_at

string · date-time

expires_at

string · date-time

Usage

CastDoc Engines ExtractDoc Engines