Versions

Open a version in a preview session

Mints a short-lived URL that opens one page of this version — including a private one — with its stylesheets, scripts and images authorized too. The URL is meant to be framed: following it once exchanges the proof it carries for a cookie on the version's own origin and redirects to the same page without it, so the framed document holds no secret. The session authorizes that version only. Requires the same permission as minting a file link.

post/v1/spaces/{spaceId}/versions/{versionId}/preview-session

Request

  • Base URL: https://api.spacefast.com
  • URL: https://api.spacefast.com/v1/spaces/{spaceId}/versions/{versionId}/preview-session
  • Auth: HTTP bearer

Path parameters

spaceIdstring required
versionIdstring required

Request body

landingPathstring

Page to open in the preview. Defaults to the version's root.

Response

Response for status 200

$schemastring uri

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

Changes

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