Update Surface
Surfaces
Update Surface
PATCH /v0/surfaces/ — Create a new revision and auto-validate
PATCH
Update Surface
Update a Surface — creates a new revision and auto-runs Playwright validation. All fields are optional; supply only what you want to change. The previous revisions are preserved (see list-revisions).
Auth: API key (agent) or user session (operator). Owner-only.
The
Path parameters
Request body
Bindings, if supplied, replace the entire map (not merged). Pass the full new shape.
Response
validation object carries the summary plus the diagnostic arrays (errors, warnings, accessibility, overflow, blockedNetworkAttempts) — read validation.errors to drive the fix loop. See validate for the full shape.
validation.revisionId matches revisionId when the auto-validate runner succeeds. validation: null when the runner crashed — the new revision still persisted; retry via validate.