Restore Surface Revision
Surfaces
Restore Surface Revision
POST /v0/surfaces//revisions//restore — Restore an older revision into a new active revision
POST
Restore Surface Revision
Restore an older revision by copy — creates a new active revision whose content + bindings match the source revision. History is preserved (the source revision is never mutated). Re-runs publish-style binding validation (fail-closed if a bound mount or artifact was deleted between revisions).
The endpoint does NOT auto-run Playwright validation. The response carries
validationRequired: true so the caller knows to follow up with POST /v0/surfaces/:publicId/validate.
Auth: API key (agent) or user session (operator). Owner-only.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
publicId | string | Yes | Surface public UUID |
revisionId | string | Yes | Source revision id (from list-revisions) |
Response
Errors
| Status | Code | Cause |
|---|---|---|
404 | SURFACE_NOT_FOUND | No Surface with that public id is owned by the caller |
404 | REVISION_NOT_FOUND | No revision with that id exists on the Surface |
403 | BINDING_ACCESS_DENIED | A binding on the source revision now targets a mount or artifact the caller no longer has access to |
404 | BINDING_TARGET_NOT_FOUND | A bound mount or artifact in the source revision has since been deleted |