Start a document inbox upload

Starts an upload of one PDF, JPEG or PNG into the document inbox, then call documentExtraction.uploadSession.complete. With upload_transport: direct (always over MCP), upload_url is a presigned storage URL valid for 10 minutes: PUT the raw bytes to it with only the returned headers and no Authorization header. The bytes go straight to storage, so files up to 10 MB work. Without it (api, the default for API keys), upload_url is the API-hosted route: PUT with your bearer token; API requests are capped at 1 MB on the wire, so use direct for anything larger. The answer names the upload_transport used. Idempotency-Key is required. Requires the document-extractions:write OAuth scope. The credential's user needs the create_document_extractions permission.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Fields accepted to start a document inbox upload. The schema identifies required and optional values.

string
required
length ≤ 255
string
enum
required
Allowed:
string | null
enum

direct (up to 10 MB): upload_url is a presigned storage URL; PUT the bytes with only the
returned headers, no Authorization. api (default for API keys, about 1 MB in practice):
PUT to the API with your bearer token. MCP sessions are always direct.

Allowed:
Headers
string
required
length ≤ 191

Required unique key whose request hash and terminal response are stored durably for 24 hours.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*