Skip to main content
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.

Path parameters

Request body

Bindings, if supplied, replace the entire map (not merged). Pass the full new shape.

Response

The 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.

Errors

Example