---
title: "Update domain flags"
method: PATCH
path: "/domains/{name}/flags"
tags: ["domain-flags"]
---

# Update domain flags

`PATCH /domains/{name}/flags`

Update one or more flags for the specified domain. Use this to toggle transfer lock, auto-renew, WHOIS privacy, and other domain settings. Use `$preview=true` to validate without applying changes.

## Path parameters

- `name` string, required

## Query parameters

- `$preview` boolean, required

## Request body

- DomainFlagUpdateRequestBody — Update domain flag settings. Only include the flags you want to change — omitted flags remain unchanged.
  - `DNS_RESOLUTION` DomainFlagUpdateRequestBodyFlag
    - `status` 'ENABLED' | 'DISABLED', required
  - `DNS_TRANSFER_OUT` DomainFlagUpdateRequestBodyFlag
    - `status` 'ENABLED' | 'DISABLED', required
  - `DNS_DELETE` DomainFlagUpdateRequestBodyFlag
    - `status` 'ENABLED' | 'DISABLED', required
  - `DNS_UPDATE` DomainFlagUpdateRequestBodyFlag
    - `status` 'ENABLED' | 'DISABLED', required
  - `DNS_RENEW` DomainFlagUpdateRequestBodyFlag
    - `status` 'ENABLED' | 'DISABLED', required
  - `DNS_WHOIS_PROXY` DomainFlagUpdateRequestBodyFlag
    - `status` 'ENABLED' | 'DISABLED', required

## Response `200`

Flag update operation created

- DomainFlagUpdateOperationResponse
  - `@type` 'unstoppabledomains.com/partner.v3.DomainFlagOperationResult', required
  - `operation` OperationCheckResponse, required
    - `@type` 'unstoppabledomains.com/partner.v3.Operation', required
    - `id` string, required — Operation ID
    - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required
    - `type` 'ADMIN_GENERIC' | 'DOMAIN_ADMIN_UPDATE' | 'DOMAIN_RENEW' | 'ACCOUNT_UPDATE' | 'DOMAIN_DNS_RECORD_CREATE' | 'DOMAIN_DNS_RECORD_UPDATE' | 'DOMAIN_DNS_RECORD_DELETE' | 'DOMAIN_DNS_RECORD_BATCH' | 'DOMAIN_DNS_SECURITY_ENABLE' | 'DOMAIN_DNS_SECURITY_DELETE' | 'DOMAIN_DNS_NAME_SERVER_UPDATE' | 'DOMAIN_HOSTING_UPDATE' | 'DOMAIN_HOSTING_DISABLE' | 'DOMAIN_TRANSFER_OUT' | 'DOMAIN_TRANSFER_OUT_TOGGLE' | 'DOMAIN_FLAGS_UPDATE' | 'DOMAIN_CONTACTS_UPDATE' | 'CONTACT_CREATE' | 'DOMAIN_SUGGESTION_CREATE' | 'DOMAIN_SUGGESTION_REFRESH' | 'DOMAIN_ADMIN_DNS_ZONE_MIGRATE', required
    - `domain` string
    - `createdAtTimestamp` number, required
    - `lastUpdatedTimestamp` number, required
    - `validUntilTimestamp` number
    - `dependencies` PlatformOperationDependency[], required — List of platform operation dependencies that make up this operation
      - union — A platform operation dependency. Discriminated by the `type` field — each type has its own `parameters` and `result` shape.
        - PlatformOperationDomainRegister — Registers a new domain with the specified owner contact and optional role contacts
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DOMAIN_REGISTER', required
          - `parameters` object, required
            - `owner` ContactAssignment, required — Reference to an existing or newly created contact
              - …
            - `contacts` NonRegistrantContacts — Non-registrant contact role assignments (admin, billing, tech)
              - …
            - `period` integer — Registration period in years
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDomainDnsRenew — Renews a domain for the specified period
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DOMAIN_DNS_RENEW', required
          - `parameters` object, required
            - `period` integer, required — Renewal period in years
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDnsRecordCreate — Creates a new DNS record for the domain
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DNS_RECORD_CREATE', required
          - `parameters` object, required
            - `subName` string — Subdomain name (empty for apex domain)
            - `type` 'A' | 'AAAA' | 'ALIAS' | 'CAA' | 'CNAME' | 'DNSKEY' | 'DS' | 'HTTPS' | 'IPSECKEY' | 'MX' | 'NAPTR' | 'NS' | 'PTR' | 'SOA' | 'SPF' | 'SRV' | 'SSHFP' | 'SVCB' | 'TLSA' | 'TXT', required
            - `values` string[], required
            - `ttl` integer, required — Time-to-live in seconds
          - `result` object
            - `id` string, required — ID of the created DNS record
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDnsRecordUpdate — Updates an existing DNS record
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DNS_RECORD_UPDATE', required
          - `parameters` object, required
            - `id` string, required — DNS record ID to update
            - `values` string[]
            - `ttl` integer — Time-to-live in seconds
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDnsRecordDelete — Deletes a DNS record
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DNS_RECORD_DELETE', required
          - `parameters` object, required
            - `id` string, required — DNS record ID to delete
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDomainSetNameServers — Sets the nameservers for a domain (external nameservers or revert to UD-managed)
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DOMAIN_SET_NAMESERVERS', required
          - `parameters` object, required
            - `items` string[] — Nameserver hostnames
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDomainDnsSecuritySetDnssec — Configures DNSSEC DS records at the registry for a domain
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DOMAIN_DNS_SECURITY_SET_DNSSEC', required
          - `parameters` object, required
            - `domain` string — Domain name
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDomainDnsSecurityDeleteDnssec — Removes DNSSEC DS records from the registry for a domain
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DOMAIN_DNS_SECURITY_DELETE_DNSSEC', required
          - `parameters` object, required
            - `domain` string — Domain name
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDomainDnsSecurityUpdateZone — Updates the DNS zone configuration for DNSSEC signing
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DOMAIN_DNS_SECURITY_UPDATE_ZONE', required
          - `parameters` object, required
            - `domain` string — Domain name
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDomainFlagLockUpdate — Updates domain flag lock settings (e.g., transfer lock, delete lock)
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DOMAIN_FLAG_LOCK_UPDATE', required
          - `parameters` object, required
            - `locks` DomainFlagLocks — Map of domain flag names to boolean lock values. Keys are DomainFlagType values.
            - `policyLocks` DomainFlagLocks — Map of domain flag names to boolean lock values. Keys are DomainFlagType values.
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationDomainDnsContactSet — Updates contact role assignments for the domain
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'DOMAIN_DNS_CONTACT_SET', required
          - `parameters` object, required
            - `owner` ContactAssignment — Reference to an existing or newly created contact
              - …
            - `admin` ContactAssignment — Reference to an existing or newly created contact
              - …
            - `billing` ContactAssignment — Reference to an existing or newly created contact
              - …
            - `tech` ContactAssignment — Reference to an existing or newly created contact
              - …
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationContactCreate — Creates a new contact for use in domain registration or management
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'CONTACT_CREATE', required
          - `parameters` object, required
            - `purposes` ContactPurpose[], required — Intended roles for this contact
          - `result` object
            - `id` string, required — ID of the created contact
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationWebhookCreate — Creates a webhook subscription
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'WEBHOOK_CREATE', required
          - `parameters` object, required
            - `url` string, required — Webhook callback URL
            - `type` 'OPERATION_FINISHED' | 'OPERATION_ACTION_REQUIRED' | 'OPERATION_CREATED', required
          - `result` object
            - `id` string, required — ID of the created webhook
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description
        - PlatformOperationWebhookDelete — Deletes a webhook subscription
          - `id` string, required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `status` 'PREVIEW' | 'QUEUED' | 'PROCESSING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'AWAITING_UPDATES', required — Status of a platform operation dependency
          - `type` 'WEBHOOK_DELETE', required
          - `parameters` object, required
            - `id` string, required — Webhook ID to delete
          - `error` OperationDependencyError — Error details for a failed operation dependency
            - `code` string, required — Error code identifying the failure type
            - `message` string, required — Human-readable error description

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/unstoppabledomains/apis/reseller-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/reseller-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/reseller-api/revisions/e0ac88d02fe7/schema)