API ReferenceSettings

Delete Trusted Preview Hosts

Deletes exact normalized host patterns. Returns 404 if any pattern is not configured. Wildcard coverage does not count as an exact match. The entire request succeeds or fails together.

DEL/v2/settings/preview-hosts

Hostname matching

PatternMatches
preview.example.comOnly that exact hostname.
*.example.comExactly one subdomain level, such as app.example.com; not a.b.example.com.
**.example.comOne or more subdomain levels, including app.example.com and a.b.example.com.

Neither wildcard includes example.com itself. Add the root domain as a separate pattern when needed. Wildcards must appear as *. or **. at the beginning, followed by at least two fixed hostname labels.

Use hostnames only, without a scheme, port, path, user information, query, or fragment. Patterns are normalized to lowercase, and at most 100 can be configured. See exact hosts and wildcards for examples and updating patterns for mutation behavior.

Deletes exact normalized patterns. With only *.example.com configured, deleting app.example.com returns 404; wildcard coverage does not count as a configured entry. Removing an exact entry does not stop trusting that hostname if a remaining wildcard still matches it. An empty list or repeated normalized patterns returns 422. If any requested pattern is missing, nothing is deleted. Success returns 200 with { success: true }.

Usage

TypeScript Example
import { v0 } from 'v0'const result = await v0.settings.deletePreviewHosts({  hosts: ['*.example.com'],})console.log(result)

API Signature

Request

Request Body

hosts: string[]

Distinct hostname patterns to delete. Provide hostnames only, without scheme, port, path, userinfo, query, or fragment. *.example.com matches one subdomain label; **.example.com matches one or more. Neither includes the apex. Patterns are canonicalized before comparison.

Minimum items:
1
Maximum items:
100

Response

success: 'true'