Register a batch of document uploads
Adapts existing multi-file batch creation. Every accepted file receives an independent document lifecycle; rejected entries report client-safe failure codes. Bytes are sent through the existing upload flow. Requires an upload Access Decision and the standard 24-hour idempotency policy. Per-file metadata uses the same extractData/scrubPII defaults and rejects both false with HTTP 422 (validation_failed).
Path Parameters
- Type:user
Id required
Headers
- Type: stringIdempotency
- Key min length:1max length:255required
Body·
required
application/json
Creates upload slots and independent document lifecycles, not a multipart transfer. The 100-file draft bound needs launch capacity verification.
- Properties: 5Type: 1…100filesrequired
- Type: stringexternal
Id min length:1max length:255
Responses
- application/json
- application/problem+json
- application/problem+json
- application/problem+json
- application/problem+json
- application/problem+json
- application/problem+json
Request Example for post/users/{userId} /document-batches
curl https://api.eno.health/users/usr_01JA2Y7Q3K8V5T0N4R6M2P9XWE/document-batches \
--request POST \
--header 'Idempotency-Key: ' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"externalId": "",
"files": [
{
"externalId": "",
"fileName": "",
"contentType": "",
"sizeBytes": 1,
"metadata": {
"externalId": "",
"extractData": true,
"scrubPII": true
}
}
]
}'
{
"id": "string",
"userId": "usr_01JA2Y7Q3K8V5T0N4R6M2P9XWE",
"externalId": "string",
"createdAt": "2026-11-16T17:41:53.997Z",
"totalCount": 0,
"acceptedCount": 0,
"rejectedCount": 0,
"items": [
{
"externalId": "string",
"documentId": "string",
"status": "accepted",
"errorCode": "string",
"uploadUrl": "https://example.com",
"uploadExpiresAt": "2026-11-16T17:41:53.997Z"
}
],
"statusCounts": {
"additionalProperty": 0
}
}