Actions25
Listing → Update
AI-generatedSummary
Update a specific existing listing by its Listing ID with any number of modifiable fields.
Inputs
- Listing ID (required) — The unique identifier of the listing to update, starting with 'lst_'.
- Update Fields — Collection of fields to update on the listing such as name, price, description, badges, image URL, and more. All fields are optional and any combination can be sent.
Output shape
A single updated listing object reflecting the changes made.
The update operation sends a PUT request to /v1/listings/{listingId} and returns the updated listing. You can optionally specify an Idempotency Key in update fields for safe retries to avoid duplicate updates. All update fields are optional except Listing ID, so you only send the fields you want to change.
Examples
Example 1: Update the name and price of a listing
Specify the Listing ID and set the 'Name' and 'Price (Cents)' fields inside Update Fields with new values.
Example 2: Add badges and change the cover image
Specify the Listing ID and update 'Badges' (as a comma-separated string) and 'Image URL' with new values in Update Fields.