---
title: "Live dark previews of this deployment, one per branch"
method: GET
path: "/platform/deployments/custom/{id}/previews"
tags: ["Platform"]
---

# Live dark previews of this deployment, one per branch

`GET /platform/deployments/custom/{id}/previews`

## Request

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

Every live preview: the branch, its `.onion`, and when it expires.
`git_credential_source` is the parent deployment ID when a private preview
uses its parent Git connection; otherwise null. Credentials are never returned.

A preview is a normal deployment with the clearnet half removed — a
fresh Tor v3 hidden service minted on your own box, no DNS record,
no certificate, no Certificate Transparency entry. That is the
difference from every other platform's preview URLs: theirs put
each branch name into public DNS and into an append-only,
worldwide-mirrored CT log, and branch names carry ticket ids,
customer names and unshipped feature names.

`url` is the onion or null. It is never a clearnet address; a
preview that somehow has one comes back with a `warning` and should
be reported, because it means the branch name went public.

## Path parameters

- `id` string, required

## Response `200`

Settings plus the live previews

## Other responses

- `404`: No such deployment on this account

---

[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)