---
title: "Update marketplace listings"
method: POST
path: "/mcp/v1/actions/ud_listing_update"
tags: ["Marketplace"]
---

# Update marketplace listings

`POST /mcp/v1/actions/ud_listing_update`

## Request

- Base URL: `https://api.unstoppabledomains.com`
- URL: `https://api.unstoppabledomains.com/mcp/v1/actions/ud_listing_update`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/user-api/docs/mcp/v1/actions/ud_listing_update/post.ts> (a function with typed inputs; its response is checked against the schema)

Update price, settings, or options for existing listings.

## Request body

- object
  - `listings` object[], required
    - `id` number, required: Listing ID
    - `priceInCents` number
    - `expiresAt` string: New listing expiration date as ISO 8601 string (e.g., "2025-12-31"). Must be 1-36500 days from now.
    - `isEmailAliasUsed` boolean
    - `listingSettings` object: Listing-level settings such as offers and display preferences.
      - `minOfferAmountInCents` number: Minimum offer amount (in cents) accepted for this listing.
      - `isOfferFeatureEnabled` boolean: Indicates whether the offer feature is enabled for this listing.
      - `domainDisplayName` string: Custom display name to use for this domain in marketplace contexts.
    - `leaseToOwnOptions` object: Lease-to-own configuration options for the listing.
      - `type` 'equal_installments' | 'down_payment_plus_equal_installments'
      - `maxTermLength` integer: Maximum term length in months (2-120)
      - `downPaymentPercentage` number: Down payment percentage (10-90), required for down_payment type

## Response `200`

Listing update results

- UpdateListingResponse
  - `results` object[]
    - `listingId` number
    - `domainName` string
    - `success` boolean
    - `status` string
    - `isLazy` boolean
    - `error` string
  - `successCount` number
  - `failureCount` number
  - `message` string
  - `signatureRequired` boolean
  - `signatureNote` string

## Other responses

- `401`: Authentication required

---

[API](https://skmtc.dev/unstoppabledomains/apis/user-api.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/user-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/user-api/revisions/c1def8e34b41?raw)