v2-ingest

Ingest Files

Ingest uploaded FILES into RAG-ready chunks (202 + job_id).

The file counterpart of POST /v2/ingest: each uploaded document (PDF, DOCX, PPTX, XLSX, CSV, HTML, EPUB, TXT/MD, and legacy/ODF office) is converted to Markdown, split by the SAME heading-aware chunker, and assembled into the same single JSONL deliverable — one pipeline for both web and file RAG ingestion. Always asynchronous: the durable ingest worker drains it, and GET / DELETE /v2/ingest/{job_id} report status and cancel it.

Files are stored to object storage at submit (so the durable resume can re-read them) and deleted once the JSONL is assembled. Bills one op per file against the unified ops quota, re-checked per file in the worker.

post/v2/ingest/files

Request

Base URL: https://api.enconvert.com (the document declares no server; this is the origin it was published from)
URL: https://api.enconvert.com/v2/ingest/files
Auth: none declared

Headers

X-API-Keystring nullable

authorizationstring nullable

Response

Successful Response

job_idstring required

mode'urls' | 'sitemap' | 'crawl' | 'files' required

pages_discoveredinteger

pages_foundinteger nullable

Unique eligible URLs discovery yielded BEFORE the max_pages cap (sitemap: true unique count; crawl: bounded by the crawl budget, so a lower bound). Absent for explicit-urls jobs and jobs created before migration 026.

discovery_truncatedboolean

True when discovery found more unique URLs than max_pages allowed the job to enqueue.

pages_processedinteger

pages_failedinteger

total_chunksinteger

output_urlstring nullable

Signed URL to the final JSONL; present once completed.

error_messagestring nullable

webhook_urlstring nullable

Completion-webhook target registered for this job, if any.

webhook_deliveredboolean

True once the signed completion webhook got a 2xx (H.8).

created_atstring date-time nullable

completed_atstring date-time nullable

warningsstring[]

Changes

No recorded changes to this operation across all 1 revision of this API.