Agent APIKeys6

Agent Task Tracker3

Agents9

API Keys6

Authentication1

Branch Events1

Branches10

Builds3

CLI Authentication2

Environments7

Events2

Filesystems10

Groups14

Logs3

Messages v22

Namespaces8

OAuth2

Organizations9

Projects8

Raw Events1

Registry1

Schedules7

Search1

Secrets5

States5

Tasks19

Version Events1

Versions5

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

Request

Base URL
https://docs.terminaluse.com (the document declares no server; this is the origin it was published from)
Auth
none declared
TypeScript
https://skmtc.dev/terminaluse/apis/sb0-api/docs/filesystems/:filesystem_id/file-upload/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

filesystem_idstring required

Query parameters

pathstring required

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.

expectedVersionstring nullable

Conditional replace precondition on current file version.

createOnlystring nullable

Conditional create precondition; must be '*'.

digeststring nullable

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

Headers

Idempotency-Keystring nullable

Optional idempotency key for safe retries.

Request body application/octet-stream

string binary required

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