Update listing

Update fields on an existing seller-owned listing.

Use this endpoint for partial updates such as price changes, quantity adjustments, visibility toggles, notes, reference metadata, and grading details.

Authorization and state rules:

• Caller must be an active seller.
• Listing must belong to the authenticated seller.
• Listing updates are blocked while active holds exist; locked listings return 423.

Validation:

• Request body is partial, but grading metadata must remain complete:
  • gradingProvider, gradingScore, and gradingNumber must be provided together.
• notes is optional, normalized by the API, and limited to 255 characters.
• reference is optional integration metadata, normalized by the API, and limited to 255 characters.
• Setting reference: null clears any previously stored value.

Validity recalculation:

• The API recalculates valid during update.
• Listings priced at >= 2000 or containing grading metadata require at least one attachment.
• If photo requirements are not met, valid is set to false.

Side effects:

• Emits LISTING_UPDATED webhook events after a successful update.
• Returns the refreshed listing with item, seller, attachment metadata, and the normalized reference value.