---
title: "Update basket item"
method: PUT
path: "/basket/{id}"
tags: ["basket"]
---

# Update basket item

`PUT /basket/{id}`

Updates quantity for an item that is already in the basket.

Use this for quantity steppers, inline quantity edits, and "update cart" actions.

What you get back:
- the refreshed basket item list, ready to re-render in the UI

Important behavior:
- Requires authentication.
- Validates listing availability for the new quantity.
- Returns listing-level errors when stock cannot satisfy the requested update.

## Path parameters

- `id` string, required — The ID of the basket to retrieve

## Request body

- object
  - `listingId` string, required — The ID of the listing
  - `quantity` integer — The quantity to reduce by, defaults to 1

## Response `200`

The updated basket items

- object

## Other responses

- `404` — A listing in the basket was not found
- `409` — The listings in the response body are no longer available in their requested quantity
- `500` — A listing in the basket was not found

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/5ed45d6a9e2f/schema)