---
title: "Update landing page domain settings"
method: PUT
path: "/landing-pages/domain"
tags: ["Landing Pages"]
---

# Update landing page domain settings

`PUT /landing-pages/domain`

Replaces the custom landing page domain, verifies the current domain, or both.

## Request body

- object
  - `domain` string — Replacement custom landing page domain.
  - `verify` boolean — Check DNS and SSL status for the current domain.

## Response `200`

Domain settings updated

- object
  - `success` boolean
  - `domain` LandingPageDomain
    - `domain` string, nullable
    - `domainScope` 'page' | 'workspace', nullable — Domain assignment scope.
    - `landingPageId` string, nullable — Assigned landing page ID for a dedicated page domain.
    - `domainStatus` string
    - `fallbackDomain` string, nullable — Verified or pending workspace domain retained as a fallback for a page-scoped domain.
    - `fallbackDomainStatus` string — Workspace fallback-domain status; `not_started` when no fallback domain is configured.
    - `verifiedAt` string, date-time, nullable
    - `dnsRecordAddedAt` string, date-time, nullable
    - `sslStatus` string, nullable
    - `error` string, nullable
    - `verificationRecords` object[]
    - `lastCheckedAt` string, date-time, nullable
    - `cnameTarget` string
    - `dnsRecordType` 'A' | 'CNAME' — DNS record type to add - CNAME for subdomains, A for root domains.
    - `dnsRecordName` string, nullable — DNS record name (the connected hostname); null when no domain is connected.
    - `dnsRecordValue` string — DNS record value - the CNAME target for subdomains or the A record IP (76.76.21.21) for root domains.

## Other responses

- `400` — Missing input, invalid domain, or verification error
- `401` — Unauthorized
- `409` — Domain conflict
- `500` — Domain settings could not be updated
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

## Changes

- **2026-08-20** `721dbe59409a` — 3 info
  - added the optional property `domain/dnsRecordName` to the response with the `200` status
  - added the optional property `domain/dnsRecordType` to the response with the `200` status
  - added the optional property `domain/dnsRecordValue` to the response with the `200` status
- **2026-08-19** `ba3a29c6eb33` — 9 info
  - added the optional property `domain/domainScope` to the response with the `200` status
  - added the optional property `domain/fallbackDomain` to the response with the `200` status
  - added the optional property `domain/fallbackDomainStatus` to the response with the `200` status
  - added the optional property `domain/landingPageId` to the response with the `200` status
  - …5 more
- **2026-08-18** `8fbabe82a04d` — 1 info
  - added the non-success response with the status `503`
- **2026-08-16** `6fd2903b91ce` — 4 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `409` status
  - added the optional property `code` to the response with the `500` status
- …earlier changes not shown

[Full history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/landing-pages/domain/put.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/73f826277d9a/schema)