⚠️

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.