---
title: "Read shared-preview preparation status (links unavailable)"
method: GET
path: "/platform/previews/{id}/sharing"
tags: ["Platform"]
---

# Read shared-preview preparation status (links unavailable)

`GET /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 read scope and current ownership of
an existing custom preview and its agent/service. Always reports
available=false and server_protocol_ready=false. This response is not
a share link and does not grant access. Existing preview protection is
unchanged. preview-sharing-v1 is a reserved protocol, not a capability
implemented by the current agent. No secrets or destination are returned.

## Path parameters

- `id` string, required

## Response `200`

Preparation status; sharing unavailable and no access granted

## Other responses

- `401`: Authentication required
- `403`: Read scope required
- `404`: No such preview with current ownership on this account
- `503`: Storage 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)