Read object metadata

GET/v1/disks/{disk}/stat

GET

/v1/disks/{disk}/stat

const url = 'https://api.wabe.sh/v1/disks/demo/stat?path=%2Fnotes.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/stat?path=%2Fnotes.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.

Query Parameters

branch

string

commit

string format: uuid

label

string

path

required

string

Example

/notes.txt

Responses

200

Current file or directory metadata.

application/json

object

version

required

Allowed value: 2

kind

required

One of:

unknown
object

Allowed value: Directory

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

Example

{
  "version": 2,
  "object_id": "1a99088e-bfec-4eec-87e4-19ba5acf29e1",
  "version_id": "f75f43ae-8375-48f0-8bcd-862cb75c26ef",
  "branch_id": "8ec08f61-c6b4-4f3a-83e9-d46ae3e5bc30",
  "revision": 1,
  "first_edit_at_ms": 1794225600000,
  "last_edit_at_ms": 1794225600000,
  "mode": 33188,
  "kind": {
    "File": {
      "content_root": null,
      "size": 0,
      "chunk_bytes": 65536
    }
  }
}

400

Invalid input.

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

Object was not found.

text/plain

string

409

Conflict, nonempty destination or referenced object.

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