---
title: "Hand the counter bag to a client"
method: POST
path: "/v3/showroom/bag/{id}/assign"
tags: ["Showroom"]
---

# Hand the counter bag to a client

`POST /v3/showroom/bag/{id}/assign`

## Request

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

The counter bag becomes the client's open bag, or its lines are merged into the one the client already has (a repeated stone is kept once, a repeated design adds units).

## Path parameters

- `id` integer, required

## Request body

- object
  - `client_id` integer

## Response `200`

The client's 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

- `400`: BAG_ALREADY_ASSIGNED
- `404`: BAG_NOT_FOUND | CLIENT_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/assign/post.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)