Finalize an upload session

Required scope: ere-uploads:write.

Step 2 of an ERE upload: tell Chronicle the file has been uploaded. Call this before transfer_expires_at, with an empty JSON object as the body.

The session moves to validating. Chronicle checks the file's length and checksum, format and structure, rejects password-protected files and files with active content such as macros or PDF JavaScript, and scans it for malware. Poll Get an upload session until the state is ready or failed. A scanner outage produces a retryable failure, not a malware finding.

Requires an Idempotency-Key. Retrying with the same key and body within 24 hours returns the original result without repeating the action. Counts toward the heavy-operation rate limit.

POST /api/v2/upload-sessions/{id}/finalize
Bearer token scope ere-uploads:write

Path parameters

· 1
id string required

Upload session ID.

Headers

· 1
Idempotency-Key string · min length: 1· max length: 128 · pattern required

Unique key for this operation, 1 to 128 visible ASCII characters (for example a UUID). Reuse it only when retrying the same request.

Body

required application/json
value object

Responses