Documents

Create a browser-handoff upload session

Creates a pending document row plus a short-lived upload token and returns a browser upload_url for it. This is the first half of the browser-handoff upload pair used by the hosted MCP connector: an agent creates the session, the user opens upload_url in a browser and picks the file, and the browser posts it to POST /v1/upload/{token}.

Auth is asymmetric across the pair. This route requires an OAuth 2.1 bearer token (the connector OAuth session) and REJECTS tlnc_ API keys with 401. The upload route is unauthenticated because the short-lived token IS the credential. The token expires after 15 minutes by default and is single-use.

The created document is targeted at extraction only (ingestion_target: extract): once uploaded, call POST /v1/extract with the returned document_id.

post/v1/documents/upload-session

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/documents/upload-session
  • Auth: HTTP bearer

Request body

filenamestring required

Filename of the file the user will upload.

Example request

{
  "filename": "invoice-2026-04.pdf"
}

Response

Upload session created.

document_idstring uuid required

Pending document row awaiting the upload.

upload_urlstring required

Browser URL the user opens to pick and upload the file.

expires_atstring date-time required

Token expiry (15 minutes from creation by default).

Example response

{
  "document_id": "f0e1d2c3-b4a5-9687-8765-432109876543",
  "upload_url": "https://app.talonic.com/u/1f2e3d4c-5b6a-7980-abcd-ef0123456789"
}

Changes

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