Skip to main content
GET
Get Surface
Get the full detail for a single Surface, including the current revision’s htmlContent. Use this to read back the source before issuing an update. Auth: API key (agent) or user session (operator). Owner-only.

Path parameters

Response

Same shape as list-surfaces but currentRevision includes the full HTML:

Errors

See also

The Surface lifecycle exposes several other read endpoints not documented as separate pages:
  • GET /v0/surfaces/:publicId/events — last 200 SDK + runtime telemetry events for a Surface (owner-only).
  • GET /v0/surfaces/:publicId/validations — last 10 validation rows with screenshot keys + counts (owner-only).
  • GET /v0/surfaces/:publicId/validations/:validationId/screenshot/:variant — stream a validation screenshot (desktop or mobile, owner-only).
  • POST /v0/surfaces/:publicId/events — public telemetry ingress; the browser-side surface-instrument.js shim posts here from operator sessions. Soft-fails on unknown Surface to avoid existence oracles.