Files

Save an uploaded file (step 3 of 3)

Saves the uploaded blob at path. An existing path gets a new version.

post/v1/mailboxes/{mailbox_id}/files

Request

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

Path parameters

mailbox_idstring required

Request body

pathstring required

Destination path. An existing path receives a new version. Paths under _email/ return EMAIL_PATH_READ_ONLY.

signed_blob_idstring required

data.signed_id from POST /v1/direct_uploads.

namestring

Display name; defaults to the last path segment.

role'source' | 'reference' | 'generated' | 'agent_output' | 'export' | 'artifact'
existing_file_policy'replace' | 'skip'
expected_mailbox_versionstring

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

account_idstring
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

Existing file kept

successtrue required

Changes

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