Previews

Make a preview permanent: mint a new site from its files (name) or replace an existing site’s content (siteId)

post/previews/{id}/promote

Request

  • Base URL: https://api.nippy.host
  • URL: https://api.nippy.host/previews/{id}/promote
  • Auth: bearer (a scheme the document does not define)

Path parameters

idstring required

Preview UUID

Request body

namestring

Mode A: name for the NEW site the preview becomes (may come back suffixed). Pass exactly one of name / siteId.

siteIdstring uuid

Mode B: id of the EXISTING site whose content the preview replaces (address and settings unchanged). Pass exactly one of name / siteId.

Example request

{
  "name": "my-thing"
}

Response

siteIdstring required
subdomainstring required
urlstring required

The permanent address the preview became

statusstring required

inactive means the live-site cap held it back from serving

previewIdstring required
previewUrlstring required

The old preview address — now a permanent redirect to url

Changes

No recorded changes to this operation across all 1 revision of this API.