Uploads a source file (for example a PDF or other document) for a given article type and processes it asynchronously into one or more versioned articles.
This is the async, job-based alternative to POST /locations-directory/articles/bulk: instead of submitting article JSON directly, you upload the original source document and a Temporal workflow extracts, validates, and writes the resulting articles on your behalf.
The request is accepted (202) as soon as the job has been recorded and the ingestion workflow has been started — it does not wait for the ingestion to finish. Poll GET /locations-directory/articles/ingestions/{id} (the URL returned in the Location response header) to track status, and to read the warnings, errors, and summary the workflow reports once it has processed the file.
type_id must reference an article type that is both enabled for the account and configured with an ingestion workflow; an unrecognized, disabled, or unconfigured type is rejected with a 422 rather than accepted and left to fail asynchronously.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||