---
title: "Update a listing"
method: PATCH
path: "/selling/listings/{listingId}"
tags: ["Listings"]
---

# Update a listing

`PATCH /selling/listings/{listingId}`

Operation used to update an existing listing by its ID.

## Path parameters

- `listingId` string, required

## Request body

- UpdateListingInput
  - `amount` string — The amount that will appear on stockx.com The amount this product is being listed for
  - `currencyCode` string — Currency in which the ask is placed<br><br>Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD" The currency code this product is being listed in. If not provided, it will default to USD. Only valid currencies supported on stockx.com are supported via API.<br><br>Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"
  - `expiresAt` string — When the ask expires UTC timestamp representing when this listing should auto-expire. If not provided, it will default to 999 days from today. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

## Response `200`

- ListingAsyncOperationResponse
  - `listingId` string, required — Unique ID for this listing
  - `operationId` string, required — Unique ID for this operation
  - `operationType` 'CREATE' | 'UPDATE' | 'DELETE' | 'ACTIVATE' | 'DEACTIVATE' | 'CANCEL_ORDER' | 'RECLAIM' | 'CANCEL_RECLAIM' | 'TPS_CHECK', required
  - `operationStatus` 'PENDING' | 'SUCCEEDED' | 'FAILED', required
  - `operationUrl` string, nullable, required — The URL used for to poll the status of the operation.
  - `operationInitiatedBy` 'USER' | 'SYSTEM', required
  - `operationInitiatedVia` 'IOS' | 'ANDROID' | 'WEB' | 'STOCKX-PRO' | 'SCOUT' | 'SHOPIFY' | 'PUBLIC-API' | 'INTERNAL-SYSTEM', required
  - `createdAt` string, required — When the listing was created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `updatedAt` string, required — When this listing was last updated in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `changes` ListingOperationsChangesDiff, required — JSON metadata object which include the changes of current listing
    - `additions` AdditionsRecursivePartialListingChangeableFields, required — The additions of current listing
    - `updates` UpdatesRecursivePartialListingChangeableFields, required — The updates of current listing
    - `removals` RemovalsRecursivePartialListingChangeableFields, required — The removals of current listing
  - `error` string, nullable — Error message if the creation failed

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/stockx/apis/stockx-public-api.md) · [All operations](https://skmtc.net/stockx/apis/stockx-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockx/stockx-public-api/versions/5b4ba84182d7/schema)