---
title: "Empty the bag"
method: DELETE
path: "/v3/showroom/bag/{id}/items"
tags: ["Showroom"]
---

# Empty the bag

`DELETE /v3/showroom/bag/{id}/items`

## Request

- Base URL: `https://api.rhinoartisan.com`
- URL: `https://api.rhinoartisan.com/v3/showroom/bag/{id}/items`
- Auth: API key in header `apikey`
- TypeScript: <https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/docs/v3/showroom/bag/:id/items/delete.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Response `200`

The (now empty) bag

- Bag
  - `id` integer, nullable: null until it has lines
  - `client_id` integer, nullable
  - `status` 'open' | 'ordered'
  - `items` object[]
    - `id` integer
    - `kind` 'diamond' | 'design'
    - `quantity` integer
    - `unit_price` number, nullable
    - `currency` string, nullable
    - `line_total` number, nullable
    - `added_at` string, date-time
    - `diamond` object, nullable
    - `design` object, nullable
  - `count` integer
  - `total` number
  - `currency` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `404`: BAG_NOT_FOUND

## Changes

- **2026-10-18** `6cc8e3d2d85c`: 1 breaking, 9 info
  - the response's body type changed from no type to `object` for status `200`
  - added the optional property `client_id` to the response with the `200` status
  - added the optional property `count` to the response with the `200` status
  - added the optional property `created_at` to the response with the `200` status
  - …6 more
- **2026-10-15** `598bac108453`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/showroom/bag/:id/items/delete.md)

---

[API](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api.md) - [All operations](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/revisions/f0e1d3d69cfb?raw)