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

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.

Endpoint: POST /user/{domain}/records/manage
Version: 1.0.0

## Path parameters:

  - `domain` (string, required)
    The domain name to update on-chain records

## Header parameters:

  - `x-auth-domain` (string, required)
    The domain to authorize
    Example: "mydomain.tld"

  - `x-auth-expires` (string, required)
    The expiration time of the signature
    Example: 1765522015090

  - `x-auth-signature` (string, required)
    The signature generating using domain owner private key
    Example: "0b62348775da58077591e2d20506371e8d94a5a83031f34b9ac85845d3463e73b0f0a500875830785c093515806e354cda6c217acab0fce5245d662eff4105f5e1c"

## Request fields (application/json):

  - `address` (string)
    The wallet address
    Example: 4660

  - `primaryDomain` (boolean)
    Set this domain to the wallet's primary identity
    Example: true

  - `transferToAddress` (string)
    Transfer the domain to the specified address
    Example: 291

  - `clearRecords` (string)
    Clear all records upon transfer
    Example: true

  - `records` (object)
    Key value pairs of records to be updated

  - `records.key` (string)
    An arbitrary on-chain record key
    Example: "An arbitrary on-chain record value"

## Response 200 fields (application/json):

  - `type` (string)
    Description of response type
    Example: "unstoppabledomains.com/partner.v3.OperationType"

  - `operation` (object)

  - `operation.id` (string)
    The operation ID
    Example: 123

  - `operation.dependencies` (array)
    Tasks that must be completed before the operation is complete

  - `operation.dependencies.id` (string)
    The dependency ID
    Example: 456

  - `operation.dependencies.transaction` (object)
    On-chain transaction details

  - `operation.dependencies.transaction.hash` (string)
    Transaction hash of the on-chain operation
    Example: 291

  - `operation.dependencies.transaction.messageToSign` (string)
    A message that must be signed by the domain owner's wallet to complete the transaction
    Example: 1110


## Response 404 fields