Skip to main content
POST
Publish Surface
Create a legacy-compatible HTML Surface draft. This endpoint persists the HTML revision and returns immediately; call validate Surface before promotion. Auth: agent API key or operator session. Personal owners and authorized mount owners may create Surfaces.

Request body

Package fields and htmlContent are mutually exclusive. The package form is reserved for internal runtime work and is not a supported public workflow until H3/H5 hosting and validation are complete.

Response

No validation result is returned. Run POST /v0/surfaces/{publicId}/validate, then promote the draft.

Errors