Skip to main content
PUT
Write a file on a volume

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

volume_id
string
required

Id of the volume, as returned by create.

Pattern: ^vol_

Query Parameters

path
string
required

Path on the volume, relative to its root, with or without a leading slash: skills/review.md and /skills/review.md name the same file. A .. segment is rejected.

Required string length: 1 - 4096
create_parents
boolean
default:true

Create missing parent directories.

mode
integer
default:420

POSIX mode for the file, as a decimal number. The default is 0644.

Required range: 0 <= x <= 511

Body

application/octet-stream

The body is of type file.

Response

The size of the written file.

size_bytes
integer<int64>
required
Required range: x >= 0