Vault — Get Upload URL
Step 1 of the Vault upload flow. Returns a single-use presigned upload (PUT) URL. Upload the file directly to that URL, then register it via POST /v2/vault/confirm.
Flow
POST /v2/vault/presigned_url→{ presigned_url, file_key, document_id }PUTthe file topresigned_urlwith a matchingContent-TypeheaderPOST /v2/vault/confirm→ registers the document and triggers processingGET /v2/vault/status→ poll untilstatusisSynced(for the slow tail)
PUT request’s Content-Type must match the content_type you sent here.Authorizations
Body
Original file name (with extension).
"Q4_report.pdf"
MIME type of the file.
"application/pdf"
Vault scope the document is uploaded into. Must match between presigned_url and confirm. Note: the analytics SSE search must use the same workspace to retrieve the document.
personal, organization Organization ID (optional).
User id (optional).
User email (optional).
User name (optional).
Response
Presigned upload URL generated
Single-use presigned upload (PUT) URL. Upload the file body via PUT with header Content-Type matching the request content_type.
Server-generated file key. Pass back to POST /v2/vault/confirm.
Document id for this upload. Pass back to confirm.
600