Update listing

curl --request PATCH \
  --url https://{host}/v1/sellers/{sellerId}/watches/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "watches",
    "id": "91827",
    "attributes": {
      "price": 1395000,
      "status": "sold"
    }
  }
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/vnd.api+json'},
  body: JSON.stringify({
    data: {type: 'watches', id: '91827', attributes: {price: 1395000, status: 'sold'}}
  })
};

fetch('https://{host}/v1/sellers/{sellerId}/watches/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/v1/sellers/{sellerId}/watches/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        'type' => 'watches',
        'id' => '91827',
        'attributes' => [
                'price' => 1395000,
                'status' => 'sold'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/vnd.api+json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

url = "https://{host}/v1/sellers/{sellerId}/watches/{id}"

payload = { "data": {
        "type": "watches",
        "id": "91827",
        "attributes": {
            "price": 1395000,
            "status": "sold"
        }
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/vnd.api+json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "type": "watches",
    "id": "91827",
    "attributes": {
      "reference": "116610LN",
      "name": "Rolex Submariner Date",
      "description": "Full set, bought new in 2019 and worn sparingly.",
      "translatedDescription": "Full set, bought new in 2019 and worn sparingly.",
      "externalIdentifier": "PIM-10294",
      "dealerProductCode": "RLX-116610LN-02",
      "price": 1295000,
      "shippingCosts": 0,
      "priceOnRequest": false,
      "applicationFee": 38850,
      "box": true,
      "warranty": true,
      "papers": true,
      "status": "available",
      "reviewNote": null,
      "reserved": false,
      "feedManaged": false,
      "minimumProposal": 1165500,
      "agreedPrice": null,
      "favorited": false,
      "viewerOrder": null,
      "webUrl": "https://wristler.eu/nl/horloges/91827-rolex-submariner-date-116610ln",
      "purchasable": true,
      "availabilityOnRequest": false,
      "productSafety": null,
      "manufacturerWarranty": null,
      "referencedWatchUuid": null,
      "specifications": {
        "AVAILABILITY": "READY_TO_SHIP_IN_1_3_DAYS",
        "STATE": "PRE_OWNED",
        "CONDITION": "VERY_GOOD",
        "YEAR_OF_PRODUCTION": "2019",
        "CASE_MATERIAL": "STEEL"
      },
      "specificationLabels": {
        "AVAILABILITY": {
          "label": "Availability",
          "value": "Ready to ship in 1-3 days"
        },
        "STATE": {
          "label": "State",
          "value": "Pre-owned"
        },
        "CONDITION": {
          "label": "Condition",
          "value": "Very good"
        },
        "YEAR_OF_PRODUCTION": {
          "label": "Year of production",
          "value": "2019"
        },
        "CASE_MATERIAL": {
          "label": "Case material",
          "value": "Steel"
        }
      },
      "createdAt": "2026-08-04T08:21:00.000000Z",
      "updatedAt": "2026-09-19T12:02:11.000000Z"
    },
    "relationships": {
      "seller": {
        "links": {
          "related": "https://api.wristler.eu/v1/sellers/42/watches/91827/seller"
        }
      },
      "images": {
        "links": {
          "related": "https://api.wristler.eu/v1/sellers/42/watches/91827/images",
          "self": "https://api.wristler.eu/v1/sellers/42/watches/91827/relationships/images"
        }
      },
      "watchModel": {
        "links": {
          "related": "https://api.wristler.eu/v1/sellers/42/watches/91827/watch-model"
        }
      }
    },
    "links": {
      "self": "https://api.wristler.eu/v1/sellers/42/watches/91827"
    }
  }
}

{
  "errors": [
    {
      "status": "404",
      "code": "watch_reserved",
      "title": "Not Found",
      "detail": "<string>",
      "meta": {},
      "source": {
        "pointer": "/data/attributes/reference",
        "parameter": "<string>"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

{
  "errors": [
    {
      "status": "404",
      "code": "watch_reserved",
      "title": "Not Found",
      "detail": "<string>",
      "meta": {},
      "source": {
        "pointer": "/data/attributes/reference",
        "parameter": "<string>"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

{
  "errors": [
    {
      "status": "404",
      "code": "watch_reserved",
      "title": "Not Found",
      "detail": "<string>",
      "meta": {},
      "source": {
        "pointer": "/data/attributes/reference",
        "parameter": "<string>"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

{
  "errors": [
    {
      "status": "404",
      "code": "watch_reserved",
      "title": "Not Found",
      "detail": "<string>",
      "meta": {},
      "source": {
        "pointer": "/data/attributes/reference",
        "parameter": "<string>"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

Inventory

Update listing

Scope: watches:write

Send only the fields you are changing. In specifications that goes per name: the ones you send are replaced, the rest stay, and a name sent as null is cleared — except the four a listing cannot be reviewed without.

imageSources and imageHandles are the exception to that in one way: each replaces the gallery with exactly what it names, in that order, so a shorter list is how an image is removed. Leaving both out leaves the gallery alone.

The price, as the dashboard’s quick edit does it: name, price and priceOnRequest in one PATCH. A listing needs a price (at least 100000, cents) unless it is priced on request, so price: null without priceOnRequest: true is a 422 on price. Only asked when the body says something about the price.

To add a photograph, send the handle of every image the listing already has (read them with include=images) plus the new one from POST /v1/uploads, in the order you want them. The images you name again are kept as they are; only the new one is attached. A handle already on a listing of another business is refused.

A sold listing stays sold. Any other status for one — available, unavailable, draft — is 409 listing_sold, pointing at status, as the dashboard draws no status select for it. An order points at it. To sell the watch again, start a new listing with duplicateOf: a draft, which goes through review when published. Sending sold again changes nothing and is not refused.

A draft goes to review only when it is ready, by the dashboard’s rule: at least one photo and a price of at least € 1,000 (or priceOnRequest: true), judged on the listing as this request leaves it — so the photos and the price may come in the same PATCH as status: available. Without them it is a 422 on status. Other 422s on status: unavailable or sold for a listing that has not been through review (draft, awaiting_review, awaiting_update), and available for one held as unsubscribed_trader, which comes back with the subscription. duplicateOf is for a create only and is a 422 here.

PATCH

sellers

{sellerId}

watches

{id}

Update listing

curl --request PATCH \
  --url https://{host}/v1/sellers/{sellerId}/watches/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "watches",
    "id": "91827",
    "attributes": {
      "price": 1395000,
      "status": "sold"
    }
  }
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/vnd.api+json'},
  body: JSON.stringify({
    data: {type: 'watches', id: '91827', attributes: {price: 1395000, status: 'sold'}}
  })
};

fetch('https://{host}/v1/sellers/{sellerId}/watches/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/v1/sellers/{sellerId}/watches/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        'type' => 'watches',
        'id' => '91827',
        'attributes' => [
                'price' => 1395000,
                'status' => 'sold'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/vnd.api+json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

url = "https://{host}/v1/sellers/{sellerId}/watches/{id}"

payload = { "data": {
        "type": "watches",
        "id": "91827",
        "attributes": {
            "price": 1395000,
            "status": "sold"
        }
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/vnd.api+json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "type": "watches",
    "id": "91827",
    "attributes": {
      "reference": "116610LN",
      "name": "Rolex Submariner Date",
      "description": "Full set, bought new in 2019 and worn sparingly.",
      "translatedDescription": "Full set, bought new in 2019 and worn sparingly.",
      "externalIdentifier": "PIM-10294",
      "dealerProductCode": "RLX-116610LN-02",
      "price": 1295000,
      "shippingCosts": 0,
      "priceOnRequest": false,
      "applicationFee": 38850,
      "box": true,
      "warranty": true,
      "papers": true,
      "status": "available",
      "reviewNote": null,
      "reserved": false,
      "feedManaged": false,
      "minimumProposal": 1165500,
      "agreedPrice": null,
      "favorited": false,
      "viewerOrder": null,
      "webUrl": "https://wristler.eu/nl/horloges/91827-rolex-submariner-date-116610ln",
      "purchasable": true,
      "availabilityOnRequest": false,
      "productSafety": null,
      "manufacturerWarranty": null,
      "referencedWatchUuid": null,
      "specifications": {
        "AVAILABILITY": "READY_TO_SHIP_IN_1_3_DAYS",
        "STATE": "PRE_OWNED",
        "CONDITION": "VERY_GOOD",
        "YEAR_OF_PRODUCTION": "2019",
        "CASE_MATERIAL": "STEEL"
      },
      "specificationLabels": {
        "AVAILABILITY": {
          "label": "Availability",
          "value": "Ready to ship in 1-3 days"
        },
        "STATE": {
          "label": "State",
          "value": "Pre-owned"
        },
        "CONDITION": {
          "label": "Condition",
          "value": "Very good"
        },
        "YEAR_OF_PRODUCTION": {
          "label": "Year of production",
          "value": "2019"
        },
        "CASE_MATERIAL": {
          "label": "Case material",
          "value": "Steel"
        }
      },
      "createdAt": "2026-08-04T08:21:00.000000Z",
      "updatedAt": "2026-09-19T12:02:11.000000Z"
    },
    "relationships": {
      "seller": {
        "links": {
          "related": "https://api.wristler.eu/v1/sellers/42/watches/91827/seller"
        }
      },
      "images": {
        "links": {
          "related": "https://api.wristler.eu/v1/sellers/42/watches/91827/images",
          "self": "https://api.wristler.eu/v1/sellers/42/watches/91827/relationships/images"
        }
      },
      "watchModel": {
        "links": {
          "related": "https://api.wristler.eu/v1/sellers/42/watches/91827/watch-model"
        }
      }
    },
    "links": {
      "self": "https://api.wristler.eu/v1/sellers/42/watches/91827"
    }
  }
}

{
  "errors": [
    {
      "status": "404",
      "code": "watch_reserved",
      "title": "Not Found",
      "detail": "<string>",
      "meta": {},
      "source": {
        "pointer": "/data/attributes/reference",
        "parameter": "<string>"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

{
  "errors": [
    {
      "status": "404",
      "code": "watch_reserved",
      "title": "Not Found",
      "detail": "<string>",
      "meta": {},
      "source": {
        "pointer": "/data/attributes/reference",
        "parameter": "<string>"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

{
  "errors": [
    {
      "status": "404",
      "code": "watch_reserved",
      "title": "Not Found",
      "detail": "<string>",
      "meta": {},
      "source": {
        "pointer": "/data/attributes/reference",
        "parameter": "<string>"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

{
  "errors": [
    {
      "status": "404",
      "code": "watch_reserved",
      "title": "Not Found",
      "detail": "<string>",
      "meta": {},
      "source": {
        "pointer": "/data/attributes/reference",
        "parameter": "<string>"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

Authorizations

Authorization

string

header

required

A bearer token obtained through one of the two flows below.

Scopes

watches:write

Add, update and remove watches in your inventory

Headers

Idempotency-Key

string

Optional. A UUID per logical operation, not per attempt: a retry carrying the same key gets the first attempt's answer back, headers and all, rather than performing the write twice. Honoured for 24 hours.

A refusal is an answer. A 422 is remembered like any other, so sending a corrected body under the same key answers 422 idempotency_key_reuse rather than accepting the correction — the point of a key is that one key means one decision. Use a new key for a new attempt at the request, and keep the old one only for retrying the same bytes after a timeout.

A 5xx is the exception: nothing was decided, so the key is released and the same one may be retried.

Refusal	Status	`code`
The same key with a different body	`422`	`idempotency_key_reuse`
The first request with this key is still running	`409`	`idempotency_in_progress`
The key's record vanished between two requests: retry with a new key	`409`	`idempotency_conflict`
A key longer than 191 characters	`400`	`idempotency_key_invalid`

A replayed answer carries Idempotent-Replay: true.

Maximum string length: 191

Path Parameters

sellerId

string

required

string

required

Body

application/vnd.api+json

A JSON:API document holding one resource.

data

object

required

Show child attributes

included

object[]

Show child attributes

Response

The listing, as we stored it.

A JSON:API document holding one resource.

data

object

required

Show child attributes

included

object[]

Show child attributes

Authentication

Account

Sellers

Inventory

Orders

Messaging (Quick replies)

Messaging (Blocked buyers)

Content (Filter pages)

Content (Insights)

Content (Pages)

Content (FAQ)

Catalogue

Messaging

Uploads

Messaging (Reports)

Account (Notifications)

Account (Security)

Account (Favorites)

Account (Blocked businesses)

Account (Saved searches)

Account (Orders)

Account (Checkout)

Account (Addresses)

Account (Devices)

Update listing

Authorizations

Scopes

Headers

Path Parameters

Body

Response