Sign in

v1

latestOpenAPI 3.1.02026-08-04151221521.2 KB
Filesystems

Upload File

Upload a single file into a filesystem by relative path. Defaults to overwrite mode; conditional mode can be used for strict concurrency control.

put/filesystems/{filesystem_id}/file-upload

Path parameters

filesystem_idstring required

Query parameters

pathstring required

Relative path to write.

Relative path to write.

writeMode'overwrite' | 'conditional'

Single-file upload write semantics.

Upload semantics: overwrite (default) or conditional.

baseVersionstring nullable

Required in conditional mode: expected current archive version.

Required in conditional mode: expected current archive version.

expectedVersionstring nullable

Conditional replace precondition on current file version.

Conditional replace precondition on current file version.

createOnlystring nullable

Conditional create precondition; must be '*'.

Conditional create precondition; must be '*'.

digeststring nullable

Optional digest in format sha-256=<base64>.

Optional digest in format sha-256=<base64>.

Headers

Idempotency-Keystring nullable

Optional idempotency key for safe retries.

Optional idempotency key for safe retries.

Response

File replaced

archive_versionstring required

New archive version token after this commit.

createdboolean required

True when the upload created a previously missing file.

file_versionstring required

New per-file version token (SHA256 of file content).

filesystem_idstring required

The filesystem ID.

pathstring required

Normalized relative path written.

size_bytesinteger required

Uploaded file size in bytes.

write_mode'overwrite' | 'conditional' required

Single-file upload write semantics.