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.
/api/v2/upload-sessions/{id}/finalize ere-uploads:write Path parameters
· 1id string required Upload session ID.
Headers
· 1Idempotency-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
value object