Browse a revision's file tree

GET

/api/sites/{path}/revisions/{rev}/files

• Your gotifacts apex (canonical base domain), fronted by your reverse proxy. Any configured alias domains serve the same API and sites, but responses (e.g. base_domain) always report the canonical domain.

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

Authorizations

• forwardAuth

Parameters

Path Parameters

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.

Responses

200

The file tree (root node).

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

401

Missing or invalid credentials.

object

error

required

string

404

No such site, key, or connection.

object

error

required

string