Documents

Upload a file against an upload-session token

Accepts the file for an upload session. This route is public: no Authorization header is required or read, because the single-use, short-lived session token in the path IS the credential. The token is claimed atomically, so a second request with the same token gets 404 even if it races the first.

Send the file as multipart/form-data in the file field. The default size cap is 500 MB. On success the document is stored and extraction is enqueued; the returned status is normally queued (uploaded when the queue is temporarily unavailable, in which case POST /v1/extract still processes the document inline).

post/v1/upload/{token}

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/upload/{token}
  • Auth: none required

Path parameters

tokenstring uuid required

Single-use upload token minted by POST /v1/documents/upload-session.

Response

File accepted and extraction enqueued.

document_idstring uuid required
statusstring required

Document status after upload, normally queued.

filenamestring required

Example response

{
  "document_id": "f0e1d2c3-b4a5-9687-8765-432109876543",
  "status": "queued",
  "filename": "invoice-2026-04.pdf"
}

Changes

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