Skip to main content
POST
Ingest Files
The alignment endpoints stop working on November 9, 2026. Use POST /v1/flow/ingestion for standalone file conversion, or POST /v1/flow/data-jobs/{data_job_id}/add-files to convert files as part of a data job.
Submit one or more uploaded file IDs to start an ingestion job. The system converts each file to markdown for use in downstream workflows like fine-tuning. The response includes a file_records array with per-file tracking. Each record contains the file’s status, timestamps for each state transition, and error diagnostics if a failure occurs. For job states, error codes, and SDK examples, see Monitor ingestion.

Authorizations

Authorization
string
header
required

Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.

Body

application/json
files
string[]
required

IDs of the files to convert.

method
string
default:best

Method used to convert the files.

Response

Success

id
string
required

ID of the file conversion job.

created_at
string<date-time>
required

Time the file conversion job was created, in ISO 8601 format.

status
enum<string>
required
Available options:
queued,
running,
completed,
failed
output_files
string[]
required

IDs of the files the job produced.

file_records
IngestionFileRecord · object[] | null

Detailed records for each file, including queue positions.

Last modified on November 4, 2026