Add member listings to a dynamic set.

PUT 
/sets/:set_id/listings

Adds the given listings to the set as members — the comparison listings the set is built from. Identify them by the internal listing_id values returned by GET /sets/candidates; only listings that are eligible comparison candidates can be added. Returns the set's member listings after the change, in the same shape as GET /sets/{set_id}/listings. Requires editor or manager access to the set when the set is shared. Works for free and paid sets. This is an upsert: a listing already in the set keeps its single membership and takes the requested status, so repeating an identical call leaves the set in the same state.

Request

Responses

200

The set's member listings after the change, grouped by status.

400

More than 500 listing IDs were sent.

401

API key authorization failed.

403

The set is shared with the user without editor or manager access, or the API key is read-only and may not be used with PUT.

404

Dynamic set not found or not accessible to the user, or one or more listing IDs are not eligible as members.

409

Another request is already in progress for this set. Retry after the concurrent request completes.

429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the Rate Limits section in the overview for the recommended exponential backoff strategy.