Read a file

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

GET

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

const url = 'https://api.wabe.sh/v1/disks/demo/files/notes.txt';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.wabe.sh/v1/disks/demo/files/notes.txt \
  --header 'Authorization: Bearer <token>'

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

Responses

200

Exact file bytes.

application/octet-stream

string format: binary

400

Invalid input, query, name or source.

text/plain

string

401

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

application/json

object

error

required

string

message

required

string

403

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

application/json

object

error

required

string

message

required

string

404

Requested file, parent or script was not found.

text/plain

string

500

Storage, I/O or corruption failure.

text/plain

string

503

Disk unavailable.

application/json

object

error

required

string

message

required

string