Promote Surface to Imprint
Surfaces
Promote Surface to Imprint
POST /v0/surfaces//promote-to-imprint — Ship a mount surface as an imprint starter template
POST
Promote Surface to Imprint
Promote a validated mount Surface into a reusable imprint template so every future mount of that imprint inherits it. This is the inverse of materialization: it derives alias bindings from the surface’s concrete bindings, snapshots the current HTML into a starter artifact, and writes a
surfaces[] entry into the imprint manifest.
Auth: API key (agent) or user session (operator). Imprint-owner-only — you can only promote a surface built on a mount of an imprint you own.
This is a draft manifest edit — it updates the imprint’s manifest but does not bump the published version. Publish the imprint afterward (
POST /v0/agents, or rip agent publish) to ship the template to new mounts.