Skip to main content
GET
List Surfaces
List every Surface owned by the calling account, newest-updated first. Optionally filter by mount or by status. The response is a lean projection — the (potentially large) currentRevision.htmlContent is omitted; use GET /v0/surfaces/:publicId to fetch the body. Auth: API key (agent) or user session (operator).

Query parameters

Response

changedSinceValidation is true when the current revision id does not match lastValidation.revisionId — i.e. the Surface has been updated since its last validation run. sourceTemplateAlias is the imprint surfaces[] alias this Surface was cloned from, or null for ad-hoc / standalone Surfaces. agent carries the mount’s imprint { slug, displayName } for surfaces on a mount, or null for standalone Surfaces — use it to label provenance instead of a bare mountId.

Example