Update a listing
Read and write keySeller API v1 · Updated 7 November 2026
PATCHhttps://klodivo.com/api/v1/inventory/{id}
Changes the fields you send. Fields you leave out keep their value. The listing follows the same rules as on the site.
Authentication
API key in the header Authorization: Bearer kv_live_…. This call needs a Read and write key. Create keys under Your store → API.
Path parameters
| Name | Type | Description |
|---|---|---|
| id Required | integer | The listing's id (from GET /inventory). |
Body application/json
| Field | Type | Description |
|---|---|---|
| state | string | new or used. |
| grade | string | Used items: like_new, good or acceptable. |
| notes | string | Shown to buyers, up to 500 characters. Required for a used set. |
| quantity | integer | 0 to 99,999. 0 marks it sold out. |
| price | string | Price per unit in your store's currency, like "12.50". |
| status | string | active or hidden. |
| external_ref | string | Your own id for the listing, up to 64 characters. |
Any field of a listing can be changed: Listing object.
Responses
OK. The changed listing. See the example response with the request examples.
No listing with this id in your store.
{
"error": {
"code": "not_found",
"message": "No listing with this id in your store."
}
}Fields need a look.
{
"error": {
"code": "invalid_listing",
"message": "Some fields need a look.",
"fields": {
"price": "Enter a price above 0."
}
}
}Missing, unknown or revoked key.
{
"error": {
"code": "unauthorized",
"message": "This API key doesn't exist or was revoked."
}
}A Read only key, or the store is suspended or closed.
{
"error": {
"code": "read_only_key",
"message": "This is a read-only key. Create a read and write key to change anything."
}
}Too many requests. Wait the seconds in Retry-After.
{
"error": {
"code": "rate_limited",
"message": "Too many requests: up to 120 a minute per key. Try again in 12 s."
}
}Still stuck? Contact us; we reply within 2 business days.