Skip to main content
POST
/
v1
/
flow
/
alignment
/
ingestion
Convert PDF files to markdown
curl --request POST \
  --url https://flow.seekr.com/v1/flow/alignment/ingestion \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "files": [
    "<string>"
  ],
  "method": "best"
}
'
{
  "id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "output_files": [
    "<string>"
  ],
  "file_records": [
    {
      "record_id": "<string>",
      "ingestion_job_id": "<string>",
      "alignment_file_id": "<string>",
      "user_id": "<string>",
      "filename": "<string>",
      "status": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "metaflow_job_id": "<string>",
      "method": "<string>",
      "queue_position": 123,
      "error_message": "<string>",
      "suggested_fix": "<string>",
      "worker_id": "<string>",
      "deleted": false,
      "processing_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "failed_at": "2023-11-07T05:31:56Z"
    }
  ]
}
⚠️ We recommend using the data jobs API instead. When using POST /v1/flow/data-jobs/{id}/add-files, ingestion is triggered automatically — you do not need to call this endpoint directly. See Create instruction fine-tuning data for the data jobs workflow.
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

Seekr API Key without 'Bearer' Prefix

Body

application/json
​
files
string[]
required

List of file ids to use for alignment

​
method
string
default:best

Method to use for ingestion

Response

Successful Response

​
id
string
required

Ingestion job ID

​
created_at
string<date-time>
required
​
status
enum<string>
required
Available options:
queued,
running,
completed,
failed
​
output_files
string[]
required
​
file_records
IngestionFileRecord · object[] | null

Detailed file records with queue positions

Last modified on June 18, 2026