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.
/api/v2/upload-sessions ere-uploads:write 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
· UploadSessionCreateclient_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