---
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`

## Request

- Base URL: `https://api.unstoppabledomains.com/profile`
- URL: `https://api.unstoppabledomains.com/profile/user/{domain}/records/manage`
- Auth: none declared. Required headers: `x-auth-domain`, `x-auth-expires`, `x-auth-signature`
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/profile-api/docs/user/:domain/records/manage/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/unstoppabledomains/apis/profile-api.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/profile-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/profile-api/revisions/10f8400cb1c1?raw)