---
title: "Set Trusted Preview Hosts"
method: PUT
path: "/settings/preview-hosts"
tags: ["Settings"]
---

# Set Trusted Preview Hosts

`PUT /settings/preview-hosts`

Sets the host patterns trusted to embed previews for a standalone team or parent organization. Organization child teams cannot override this setting.

## Request body

- object
  - `hosts` string[], required — The complete list of exact or wildcard hostname patterns trusted to embed previews. Provide hostnames only, without a scheme, port, path, userinfo, query string, or fragment. Use *.example.com for exactly one subdomain label and **.example.com for one or more. Wildcards do not include example.com itself; add the apex as a separate entry when needed.

## Response `200`

Response for status 200

- TrustedPreviewHosts
  - `hosts` string[], required — Canonicalized hostname patterns trusted to embed previews. Exact hosts match only themselves; *.example.com matches exactly one subdomain label; **.example.com matches one or more subdomain labels. Wildcards do not include the apex, so list example.com separately when it should also be trusted.

## Other responses

- `401` — Response for status 401
- `403` — Response for status 403
- `404` — Response for status 404
- `422` — Response for status 422
- `500` — Response for status 500

## Changes

> 34 revisions in range; 5 could not be searched.

- **2026-07-30** `da68370a2aea` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/settings/preview-hosts/put.md)

---

[API](https://skmtc.dev/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.dev/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/3cf5debd6cf4/schema)