Get Surface
Surfaces
Get Surface
GET /v0/surfaces/ — Full Surface detail (includes HTML body)
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
| Parameter | Type | Required | Description |
|---|---|---|---|
publicId | string | Yes | Surface public UUID |
Response
Same shape as list-surfaces butcurrentRevision includes the full HTML:
Errors
| Status | Code | Cause |
|---|---|---|
404 | SURFACE_NOT_FOUND | No Surface with that public id is owned by the caller (existence is not leaked to non-owners) |
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 (desktopormobile, owner-only).POST /v0/surfaces/:publicId/events— public telemetry ingress; the browser-sidesurface-instrument.jsshim posts here from operator sessions. Soft-fails on unknown Surface to avoid existence oracles.