---
title: "Update a self-custody domain (partial update)"
method: PATCH
path: "/external/domains/{name}"
tags: ["external_domains"]
---

# Update a self-custody domain (partial update)

`PATCH /external/domains/{name}`

Perform Self-Custody Domain updates while preserving the existing records.
Usage is the same as the [custody variant](/openapi/partner/v3/#operation/updateDomainPatch).

## Path parameters

- `name` string, required

## Request body

- DomainUpdateRequestBody
  - `owner` DomainUpdateRequestBodyOwner
    - `type` 'NONE' | 'UD' | 'SELF' | 'EXTERNAL', required — - `NONE`: Domain is not currently owned by anyone - `UD`: Domain is owned by a wallet/contract that belongs to Unstoppable Domains - `SELF`: Domain is owned by your account. You can manage this domains through the API - `EXTERNAL`: Owner doesn't qualify as any of the above.
    - `address` string, required
  - `records` UpdateDomainRecords

## Response `200`

- DomainOperationResponse
  - `@type` 'unstoppabledomains.com/partner.v3.DomainOperationResult', required
  - `operation` OperationCheckResponse, required
    - `id` string, required
    - `@type` 'unstoppabledomains.com/partner.v3.Operation', required
    - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
    - `type` 'DOMAIN_CLAIM' | 'DOMAIN_UPDATE' | 'DOMAIN_RETURN' | 'WALLET_CREATE' | 'WALLET_UPDATE' | 'WALLET_VERIFY' | 'ACCOUNT_UPDATE', required
    - `domain` string
    - `lastUpdatedTimestamp` number, required
    - `dependencies` union[], required
      - union
        - MintSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.BlockchainOperation', required
          - `transaction` SubOperationTransactionResponse
            - `hash` string
            - `blockchain` 'MATIC' | 'ETH' | 'BASE', required
          - `type` 'MINT', required
          - `parameters` MintParametersResponse, required
            - `initialRecords` DomainRecords
            - `toAddress` string, required
        - UpdateRecordsSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.BlockchainOperation', required
          - `transaction` SubOperationTransactionResponse
            - `hash` string
            - `blockchain` 'MATIC' | 'ETH' | 'BASE', required
          - `type` 'UPDATE_RECORDS', required
          - `parameters` UpdateRecordsParametersResponse, required
            - `recordUpdates` DomainRecords, required
            - `resetRecords` boolean, required
        - TransferSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.BlockchainOperation', required
          - `transaction` SubOperationTransactionResponse
            - `hash` string
            - `blockchain` 'MATIC' | 'ETH' | 'BASE', required
          - `type` 'TRANSFER', required
          - `parameters` TransferParametersResponse, required
            - `fromAddress` string, required
            - `toAddress` string, required
            - `resetRecords` boolean, required
        - ReturnSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.BlockchainOperation', required
          - `transaction` SubOperationTransactionResponse
            - `hash` string
            - `blockchain` 'MATIC' | 'ETH' | 'BASE', required
          - `type` 'RETURN', required
        - WalletCreateSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `result` WalletCreateResultResponse
            - `address` string, required
          - `type` 'WALLET_CREATE', required
        - WalletSetDefaultSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `parameters` WalletSetDefaultParametersResponse, required
            - `address` string, required
          - `type` 'WALLET_SET_DEFAULT', required
        - WebhookCreateSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `parameters` WebhookCreateParametersResponse, required
            - `type` 'OPERATION_FINISHED' | 'OPERATION_ACTION_REQUIRED', required
            - `url` string, uri, required
          - `result` WebhookCreateResultResponse
            - `id` string, required
          - `type` 'WEBHOOK_CREATE', required
        - WebhookDeleteSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `parameters` WebhookDeleteParametersResponse, required
            - `id` string, required
          - `type` 'WEBHOOK_DELETE', required

## Other responses

- `400`
- `502` — Blockchain access is currently degraded

---

[API](https://skmtc.net/unstoppabledomains/apis/web3-partner-api-v3.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/web3-partner-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/web3-partner-api-v3/versions/8331236de8e8/schema)