Edit my listing
seller_update_listingEdit one of the seller's own listings the way the website's Edit listing does: title, price (price_usd), lowest_acceptable_usd, category, condition, pickup location and photos. Give only what changes. Without confirmed: true nothing changes: the result lists the change and, when the price or category moves, would_result_in (take-home, buyer price, fees). What price_usd and lowest_acceptable_usd mean follows the listing's pricing_basis in seller_list_listings. take_home (every listing made from Sept 4 2026 on): price_usd is what the seller takes home, and our transaction and pickup fees and the delivery are added on top for buyers; lowest_acceptable_usd is the least they take home. asking_price (older listings): price_usd is the asking price before delivery (asking_usd), the take-home is that less our fees, and lowest_acceptable_usd is an asking price too. The platform adds the condition and city to the title, as it does at publish, and rebuilds them when the title, condition or pickup location changes; the preview's public_title is the exact result, and the listing's link does not change. photos is the whole ordered list after the edit, the first being the cover. A reserved or sold listing cannot be edited, and the description is not edited here (support corrects it).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | ||
| photos | No | The listing's photos after the edit, in order, the first being the cover. "existing:N" keeps the photo now at index N (catalog_get_listing's photo_urls end in /N); an https image URL or a data:image URL adds one (at most 8 new per edit). Leave a photo out to remove it; at least one must remain. "file:N" places the Nth of photo_files, the photos attached in the chat. | |
| category | No | A category slug from catalog_list_categories or listing_resolve_category. It changes the fees and what buyers pay, so preview first. | |
| condition | No | One of the category's condition_options from listing_resolve_category. | |
| confirmed | Yes | false: nothing changes, and the result says what would. true: do it, once the seller has agreed. | |
| price_usd | No | New price in US dollars, in the listing's pricing_basis: its take-home, or on an older listing its asking price. | |
| listing_id | Yes | ||
| photo_files | No | Photos the seller attached in the chat. The chat app fills these in (each a download_url and file_id); never write one by hand. They get the same checks as photo_urls. Place them with "file:N" in photos ("file:0" first makes it the cover); any not placed are added after the photos. | |
| pickup_location | No | Where the item is now: "City, ST", or a full address that contains it. A ZIP alone cannot move where the listing says it is. | |
| lowest_acceptable_usd | No | The auto-accept floor, in the listing's pricing_basis: the least the seller takes home, or on an older listing the lowest asking price. Offers that reach it are accepted automatically. 0 removes it. It cannot be above price_usd. |