Chunked Upload for Large Files

Use this flow instead of POST /v2/documents/submit when:

Files exceed 50 MB
You need resumable uploads that survive network interruptions
You want to track per-file progress during upload

With organizationUnitId, the unit is checked only when the last chunk arrives: if it cannot be resolved then, the last chunk returns 404 and the session becomes Failed.

A session started with the deprecated v1 upload start finishes normally on either the v1 or the v2 chunk and status paths; it keeps the rules of the version that started it. Start new sessions with POST /v2/documents/upload/start. See Migrating to v2.

Step 1: Start a session

curl -X POST "https://sandbox-api.sannos.ai/v2/documents/upload/start" \
  -H "X-API-Key: $EVE_COMPANY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [{ "fileName": "large-report.pdf", "fileSize": 157286400 }],
    "complianceReviewId": "01REV..."
  }'

const res = await fetch("https://sandbox-api.sannos.ai/v2/documents/upload/start", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.EVE_COMPANY_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    files: [{ fileName: "large-report.pdf", fileSize: 157286400 }],
    complianceReviewId: "01REV...",
  }),
});
const session = await res.json();

import os, requests

res = requests.post(
    "https://sandbox-api.sannos.ai/v2/documents/upload/start",
    headers={"X-API-Key": os.environ["EVE_COMPANY_KEY"], "Content-Type": "application/json"},
    json={
        "files": [{"fileName": "large-report.pdf", "fileSize": 157286400}],
        "complianceReviewId": "01REV...",
    },
)
session = res.json()

To create a new compliance review under an organization unit of any type instead, send organizationUnitId together with complianceFrameworkId and controlId (both are required with organizationUnitId):

curl

curl -X POST "https://sandbox-api.sannos.ai/v2/documents/upload/start" \
  -H "X-API-Key: $EVE_COMPANY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [{ "fileName": "large-report.pdf", "fileSize": 157286400 }],
    "organizationUnitId": "01ORG...",
    "complianceFrameworkId": "01FRM...",
    "controlId": "01CTL..."
  }'

Provide either complianceReviewId or organizationUnitId, not both. Response gives you sessionId and per-file fileId, chunkSizeBytes, totalChunks:

{
  "sessionId": "01SES...",
  "expiresAt": "2025-01-21T14:30:00Z",
  "files": [
    {
      "fileId": "01FIL...",
      "fileName": "large-report.pdf",
      "chunkSizeBytes": 5242880,
      "totalChunks": 30
    }
  ]
}

Step 2: Upload chunks

Send each chunk as raw binary. Chunks are zero-indexed — send them in order.

curl

# Upload chunk 0 (e.g. the first 5 MB slice, split locally beforehand)
curl -X PUT \
  "https://sandbox-api.sannos.ai/v2/documents/upload/$SESSION_ID/files/$FILE_ID/chunks/0" \
  -H "X-API-Key: $EVE_COMPANY_KEY" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @chunk-0.bin

Each response shows progress: { "receivedChunks": 1, "totalChunks": 30, "isComplete": false } The last chunk automatically commits the upload and triggers compliance processing:

{
  "receivedChunks": 30,
  "totalChunks": 30,
  "isComplete": true,
  "documentId": "01DOC...",
  "complianceReviewId": "01REV...",
  "status": "Pending"
}

Step 3: Poll for results (same as regular submit)

curl

curl "https://sandbox-api.sannos.ai/v2/documents/$DOCUMENT_ID/status" \
  -H "X-API-Key: $EVE_COMPANY_KEY"
curl "https://sandbox-api.sannos.ai/v2/documents/$DOCUMENT_ID/result" \
  -H "X-API-Key: $EVE_COMPANY_KEY"

Session expiry: Sessions expire after 24 hours. Expired sessions return 410 Gone on chunk upload.

Introduction

Guides

Reference

Step 1: Start a session

Step 2: Upload chunks

Step 3: Poll for results (same as regular submit)

​Step 1: Start a session

​Step 2: Upload chunks

​Step 3: Poll for results (same as regular submit)

Step 1: Start a session

Step 2: Upload chunks

Step 3: Poll for results (same as regular submit)