A preview link
GET
https://api.norreach.app/v1/pages/{id}/preview-linkA 15-minute link that shows the working copy (or version) on the page's own address, for a look before anything is published. Needs pages:write, like the editor's preview.
pages:writeRole must allow: pages.editOperation id: get_page_preview_link
GET/pages/{id}/preview-link
curl -X GET "https://api.norreach.app/v1/pages/{id}/preview-link" \
-H "Authorization: Bearer $NORREACH_API_KEY"A preview link
{
"object": "preview_link",
"page_id": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d",
"url": "https://acme.norreach.page/__preview/…",
"expires_in": 900
}Authorizations
Authorizationstringheaderrequired
Bearer authentication: send Authorization: Bearer <key>, with an API key or an OAuth access token. The key needs the scope pages:write. API keys and scopes
Path parameters
idstring (uuid)pathrequired
An id (UUID).
Query parameters
version"draft" | string (uuid)query
Response
200application/json— A preview link
object"preview_link"required
page_idstring (uuid)required
An id (UUID).
urlstringrequired
expires_inintegerrequired
Errors
Errors are application/problem+json with a stable code.
| Status | Code | Meaning |
|---|---|---|
| 400 | bad_request | The request couldn't be read. |
| 400 | unknown_field | The request has a field this operation doesn't know. |
| 401 | unauthorized | A valid API key is required. |
| 403 | insufficient_scope | This API key doesn't have the scope this operation needs. |
| 403 | feature_not_enabled | The API isn't switched on for this workspace. |
| 403 | role_forbidden | The key's creator's role can't do this. |
| 404 | not_found | That doesn't exist. |
| 429 | rate_limited | Too many requests. Slow down and try again. |
| 500 | server_error | Something went wrong on our side. |
| 503 | unavailable | The API isn't available right now. Try again shortly. |