Run

Ingest documents and run a Spec's pipeline in one call

Accepts one or more files, one or more file_urls, or a mix of both — at least one input is required. Ingests every input (metering each ingest leg), waits for OCR to finish, then compiles the named Spec's saved rail into a pipeline and starts it — the same compile step POST /v1/pipelines uses, minus the separate "upload documents first" step. Always returns 202; poll GET /v1/run/{id} or listen for the run.completed / run.failed webhook (POST /v1/webhooks). Requires write scope. Unlike POST /v1/process, this endpoint does not dedup — every call starts a fresh run. Content-based document dedup still applies per input within the call — see the documents response field.

post/v1/run

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/run
  • Auth: HTTP bearer

Response

Ingest + run accepted.

run_idstring uuid
spec_idstring uuid
status'processing'
input_countinteger

Total files + file_urls accepted.

poll_urlstring

Example response

{
  "poll_url": "/v1/run/3d44a4dc-e3e4-4bca-b079-a9c85bf75026",
  "documents": [
    {
      "document_id": "3d44a4dc-e3e4-4bca-b079-a9c85bf75026",
      "filename": "invoice.pdf",
      "size_bytes": 148213,
      "source": "file",
      "deduplicated": false
    }
  ]
}

Changes

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