Skip to content

Browse a revision's file tree

GET
/api/sites/{path}/revisions/{rev}/files
curl --request GET \
--url https://example.com/api/sites/example/revisions/example/files \
--header 'Remote-User: <Remote-User>'

Returns the revision’s files as a nested tree. Available to any authenticated user; hidden sites are visible only to admins.

path
required
string

Full site path — group segments (0–2) plus the slug, e.g. claude/app or demo.

rev
required
string

A revision ID — current for the live content, or an archive timestamp from GET …/revisions.

The file tree (root node).

Media typeapplication/json

A node in a revision’s file tree. Directories carry children; files carry a size.

object
name
required

Segment name; empty for the root node.

string
path
required

Slash path relative to the revision root; empty for the root.

string
dir
required
boolean
size

File size in bytes (files only).

integer format: int64
children
Array<object> recursive
Examplegenerated
{
"name": "example",
"path": "example",
"dir": true,
"size": 1,
"children": []
}

Missing or invalid credentials.

Media typeapplication/json
object
error
required
string
Examplegenerated
{
"error": "example"
}

No such site, key, or connection.

Media typeapplication/json
object
error
required
string
Examplegenerated
{
"error": "example"
}