Start a large-file upload (presigned URL)

​

Returns a presigned PUT URL valid 15 minutes. After the PUT succeeds, call POST /documents/{documentId}/complete. Category is inferred by DIP classification and is not an upload input. Language, issuers, title and documentDate are returned only after DIP completes and are not upload inputs. Both extractData and scrubPII default to true; setting both to false returns HTTP 422 (validation_failed).

Path Parameters

Headers

Body

required
application/json

Caller-supplied upload metadata contains only externalId, extractData and scrubPII. Category, language, issuers, title and documentDate are inferred by DIP and are not upload inputs.

Responses

  • application/json
  • application/problem+json
Request Example for post/users/{userId}/document-uploads
curl https://api.eno.health/users/usr_01JA2Y7Q3K8V5T0N4R6M2P9XWE/document-uploads \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "externalId": "",
  "extractData": true,
  "scrubPII": true,
  "fileName": "",
  "contentType": "",
  "sizeBytes": 1,
  "sha256": ""
}'
{
  "documentId": "doc_01JA2Z...",
  "uploadUrl": "https://example.com",
  "uploadExpiresAt": "2026-11-16T17:41:53.856Z"
}
Partner API 0.1.0-draft.3 · Draft contract · Sandbox and SDK availability require confirmation.