---
title: "Request to update a domain's on-chain records"
method: POST
path: "/user/{domain}/records/manage"
tags: ["Profile management endpoints"]
---

# Request to update a domain's on-chain records

`POST /user/{domain}/records/manage`

The POST call can be used to start the process of modifying a domain's on-chain records. Authentication is required using domain owner signature.

## Path parameters

- `domain` string, required

## Headers

- `x-auth-domain` string, required
- `x-auth-expires` string, required
- `x-auth-signature` string, required

## Request body

- UpdateDomainRecordRequest
  - `address` string — The wallet address
  - `primaryDomain` boolean — Set this domain to the wallet's primary identity
  - `transferToAddress` string — Transfer the domain to the specified address
  - `clearRecords` string — Clear all records upon transfer
  - `records` object — Key value pairs of records to be updated
    - `key` string — An arbitrary on-chain record key

## Response `200`

Successful request of domain record update. The transaction hash must be signed and submitted to confirm the record update.

- OperationResponse
  - `type` string — Description of response type
  - `operation` Operation
    - `id` string — The operation ID
    - `dependencies` Dependency[] — Tasks that must be completed before the operation is complete
      - `id` string — The dependency ID
      - `transaction` object — On-chain transaction details
        - `hash` string — Transaction hash of the on-chain operation
        - `messageToSign` string — A message that must be signed by the domain owner's wallet to complete the transaction

## Other responses

- `404` — Domain not found

---

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