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
- Type:user
Id required
Headers
- Type: stringIdempotency
- Key max length:255
Body
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.
- Type: stringcontent
Type required - Type: stringfile
Name required - Type: stringsha256required
- Type: integersize
Bytes max:104857600requiredInteger numbers.
- Type: stringexternal
Id max length:128 - Type: booleanextract
Data Extract structured health data. Set false to store without data extraction; PII scrubbing must remain enabled. Omission means true. Cannot be false together with scrubPII.
- Type: booleanscrub
P I I Scrub personally identifiable information from the document. Omission means true. Cannot be false together with extractData.
Responses
- application/json
- application/problem+json
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"
}