Create an upload session

Required scope: ere-uploads:write.

Step 1 of an ERE upload: declare the file and get a URL to upload it to.

Send the client_id, purpose (ere), filename, content_type, exact byte_length and lowercase hexadecimal sha256 of the file. Supported formats are PDF, TIFF, MDI, WPD, DOC, DOCX, TXT, RTF, XLS and XLSX, up to 80 MiB, and content_type must match the file extension.

Upload the file with an HTTP PUT to transfer.url, sending exactly the Content-Type and Content-Length headers in transfer.headers. Do not send your API key to that URL, and do not log it. The URL expires 15 minutes after the session is created; retries do not extend it. Then call Finalize an upload session.

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
Bearer token scope ere-uploads:write

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

· UploadSessionCreate
required application/json
client_id string · pattern required
purpose string required
filename string · min length: 1· max length: 200 · pattern required
byte_length integer · min: 1· max: 83886080 required
content_type string required
sha256 string · pattern required

Responses