Files

Start a batch upload

Starts an upload session for many files and returns storage targets for the first files. The session locks the mailbox for other writers; incoming email still arrives. Send files in batches with POST .../uploads, PUT the bytes to each upload.url, save each batch with POST .../finalize_batch, then call POST .../finalize. Unsaved uploads are discarded when the session expires.

post/v1/mailboxes/{mailbox_id}/upload_sessions

Request

  • Base URL: https://api.revdoku.com
  • URL: https://api.revdoku.com/v1/mailboxes/{mailbox_id}/upload_sessions
  • Auth: HTTP bearer

Path parameters

mailbox_idstring required

Request body

expected_file_countinteger

Total files you will upload in this session. Used for progress.

client_session_keystring

Your own key for this batch. Repeating it with the same credential while the session is pending returns that session instead of a new one.

existing_file_policy'replace' | 'skip'

skip keeps existing files at the same paths.

expected_mailbox_versionstring

Mailbox version_id from your last read. A different current version returns MAILBOX_VERSION_CONFLICT.

account_idstring

Select another granted account for this request.

reasonstring nullable

Optional purpose for this action. AI agents should explain intentional reads and changes when known; omit when unknown. Do not include secrets, file contents, or transcripts.

Response

Created

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.