Append streamed bytes to current EOF

POST

/v1/disks/{disk}/files/{path}

Code sample: cURL

curl --fail-with-body -X POST 'https://api.wabe.sh/v1/disks/demo/files/notes.txt' \
  -H 'Authorization: Bearer YOUR_PROJECT_API_KEY' \
  -H 'Content-Type: application/octet-stream' \
  --data-binary @./notes.txt

Authorizations

• bearerAuth
• runtimeAccess

Parameters

Path Parameters

disk

required

string

/^[A-Za-z0-9_-]{1,128}$/

Example

demo

Project disk name, or the disk ID in the actor runtime disk URL.

path

required

Virtual file path relative to root; may contain slash-separated components.

string

Example

notes.txt

Query Parameters

branch

string

commit

string format: uuid

label

string

expected_id

string format: uuid

expected_revision

integer

Request Body^required

Media typeapplication/octet-stream

string format: binary

Responses

200

Byte count and updated metadata.

Media typeapplication/json

object

bytes

required

integer

metadata

required

object

version

required

Allowed value: 2

kind

required

One of:

unknown

Allowed value: Directory

object

object

File

required

object

size

required

integer

chunk_bytes

required

integer

>= 4096 <= 4194304

content_root

required

string | null

/^[0-9a-f]{64}$/

object_id

required

string format: uuid

version_id

required

string format: uuid

branch_id

required

Origin of the version; inherited or imported versions may refer to an internal or deleted branch absent from the branch list.

string format: uuid

revision

required

integer

first_edit_at_ms

required

integer

last_edit_at_ms

required

integer

mode

required

integer

Allowed values: 16384 33188 33261 40960

400

Invalid input.

Media typetext/plain

string

401

Missing, invalid or revoked project API key, or an invalid runtime access token.

Media typeapplication/json

object

error

required

string

message

required

string

403

Actor runtime token does not authorize this disk or instance generation.

Media typeapplication/json

object

error

required

string

message

required

string

404

Object was not found.

Media typetext/plain

string

409

Conflict, nonempty destination or referenced object.

Media typetext/plain

string

500

Storage, I/O or corruption failure.

Media typetext/plain

string

503

Disk unavailable.

Media typeapplication/json

object

error

required

string

message

required

string