List directory entries

Endpoint

GET /v1/disks/{disk}/entries

Parameter	Location	Default	Meaning
disk	Path	Required	Named disk.
path	Query	/	Directory to list.

Request

curl --fail-with-body --get "https://api.wabe.sh/v1/disks/demo/entries" \
  -H "Authorization: Bearer YOUR_PROJECT_API_KEY" \
  --data-urlencode 'path=/notes'

Response

200, Content-Type: application/x-ndjson. Each line contains one child:

Example file entry

{"path":"/notes/hello.txt","metadata":{"version":2,"object_id":"00000000-0000-4000-8000-000000000001","version_id":"00000000-0000-4000-8000-000000000002","branch_id":"00000000-0000-4000-8000-000000000003","revision":1,"first_edit_at_ms":1792083906000,"last_edit_at_ms":1792083906000,"mode":33188,"kind":{"File":{"content_root":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","size":16,"chunk_bytes":65536}}}}

Example directory entry

{"path":"/notes/team","metadata":{"version":2,"object_id":"00000000-0000-4000-8000-000000000004","version_id":"00000000-0000-4000-8000-000000000005","branch_id":"00000000-0000-4000-8000-000000000003","revision":1,"first_edit_at_ms":1792083906000,"last_edit_at_ms":1792083906000,"mode":16384,"kind":"Directory"}}

object_id survives file edits and moves. version_id identifies a history point; a coalesced draft also needs its revision to identify current bytes. first_edit_at_ms and last_edit_at_ms are Unix milliseconds. content_root is a 64-character hexadecimal storage identifier, or null for an empty file. It can stay unchanged while an autosave draft changes; use version_id together with revision to identify the current bytes. Sealed versions have immutable content roots. Example identifiers and timestamps vary. See view selection.

An empty directory returns an empty body. The listing covers direct children. Use shell find or rg --files for a recursive listing. Consume or close the response to release its disk lease.

Errors

400 for an invalid path or a file supplied as the directory; 401 for authentication; 404 for a missing directory; 500 for storage failure. A failure after streaming starts terminates the body. See stream handling.