---
title: "Update Preview Domains"
method: PATCH
path: "/applications/{uuid}/previews/{pull_request_id}"
tags: ["Applications"]
---

# Update Preview Domains

`PATCH /applications/{uuid}/previews/{pull_request_id}`

Replace domains for a preview deployment. Use domains for regular applications or docker_compose_domains for Docker Compose applications. Ports are stored as internal overrides while public domains remain portless.

## Path parameters

- `uuid` string, required
- `pull_request_id` integer, required

## Request body

- object
  - `domains` string, nullable
  - `docker_compose_domains` object[], nullable
    - `name` string
    - `domain` string, nullable
    - `redirect` 'www' | 'non-www' | 'both', nullable
  - `force_domain_override` boolean

## Response `200`

Preview domains updated.

## Other responses

- `401` — Unauthenticated.
- `403` — unresolved $ref
- `404` — Resource not found.
- `409` — Domain conflict.
- `422` — Validation error.

## Changes

- **2026-09-19** `b5f81ea5b5b5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/coollabsio/apis/coolify/changes/applications/:uuid/previews/:pull_request_id/patch.md)

---

[API](https://skmtc.dev/coollabsio/apis/coolify.md) · [All operations](https://skmtc.dev/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc.dev/coollabsio/apis/coolify/revisions/f8b16020e5dd?raw)