---
title: "Reserved shared-preview creation entry (always unavailable)"
method: POST
path: "/platform/previews/{id}/sharing"
tags: ["Platform"]
---

# Reserved shared-preview creation entry (always unavailable)

`POST /platform/previews/{id}/sharing`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/previews/{id}/sharing`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Preparation only (F60.3); requires manage scope and current ownership
of the custom preview and its agent/service. Always refuses with
HTTP 503 / PREVIEW_SHARING_UNAVAILABLE after admission. No accepted
creation payload, token, link, grant, domain write or ingress command
exists. Configuration or an advertised capability cannot enable this
entry. Shared access requires server and effective ingress enforcement
of expiry and revocation, explicit consent and separate physical proofs.

## Path parameters

- `id` string, required

## Other responses

- `401`: Authentication required
- `403`: Manage scope required
- `404`: No such preview with current ownership on this account
- `503`: PREVIEW_SHARING_UNAVAILABLE; no access granted

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)