API
ReferenceSelling

Edit a listing

Open raw markdownFor pasting into AI assistants
PATCH
/public/v1/list

Changes the price of your active listings. Every listing holds one copy, so price is the only thing an edit changes; amount is not accepted. Send exactly one of price (cents) or price_decay, which puts the listing on an auto-decaying price falling from start_price to end_price over total_hours (24-168). Three body shapes: a single listing_id; a listings array of up to 50, each with its own price, where each row is applied in its own transaction and comes back in results with ok and, when it failed, the error code the single form would have returned; or a listing_ids array of up to 500 sharing one price, applied in one transaction, so if any id fails nothing changes, and the response lists every listing. While listing is switched off site-wide, edits fail with LISTING_DISABLED.

AuthorizationBearer <token>

API key generated from your account settings on the website. Send as Authorization: Bearer csd_....

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PATCH "https://example.com/public/v1/list" \  -H "Content-Type: application/json" \  -d '{    "listing_id": 1  }'
{  "id": 1,  "app_id": 1,  "market_hash_name": "string",  "price": -9007199254740991,  "amount": -9007199254740991,  "commodity": true,  "created_at": "2019-08-24T14:15:22Z"}