Skip to main content
POST
Write content to a file in a volume

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Path Parameters

id
string
required

Volume ID

Body

application/json
path
string
required

Absolute volume-internal destination path rooted at /. Relative paths are rejected and .. may not escape the volume root. Volume file routes do not accept machine cwd or per-call user semantics. This JSON route is a convenience path for smaller payloads; use direct /file transfers or /uploads/* sessions for large transfers.

content
string
required
encoding
enum<string>
default:utf8
Available options:
utf8,
base64

Response

File written

name
string
required
path
string
required

Absolute resolved filesystem path. For machine routes this is an absolute machine path; for volume routes this is an absolute volume-internal path rooted at /.

is_dir
boolean
required
size
integer<uint64>
required
type
string
required

Entry type (e.g. "file", "directory", "symlink")

Example:

"file"

mode
string
Example:

"0644"

permissions
string
Example:

"0644"

owner
string
group
string
modified_time
string<date-time>