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

Headers

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: 5

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
  }
}
Partner API 0.1.0-draft.3 · Draft contract · Sandbox and SDK availability require confirmation.