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

---

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