---
title: "SaveBag"
method: POST
path: "/api/bag/save"
---

# SaveBag

`POST /api/bag/save`

## Request

- Base URL: `https://api.caddence.golf`
- URL: `https://api.caddence.golf/api/bag/save`
- Auth: none declared

## Request body

- SaveBagRequest
  - `clubs` BagClub[], required: Selected clubs
    - `slot` string, required: Category slot (driver, fairway_wood, etc.)
    - `product_id` integer, nullable: Product ID (null for custom clubs)
    - `variant` string, nullable: Selected variant (e.g., '10.5 Stiff')
    - `custom` CustomClub
      - `brand` string, required: Brand name
      - `model` string, required: Model name
      - `spec` string, nullable: Free-text spec, e.g. '4-PW, Stiff'
      - `price` number, nullable: Optional user-entered price
  - `name` string, nullable: Optional bag name

## Response `201`

Document created, URL follows

- SaveBagResponse
  - `id` string, required: Share ID for the bag
  - `url` string, required: Shareable URL

## Other responses

- `400`: Bad request syntax or unsupported method

---

[API](https://skmtc.dev/caddence/apis/golf-product-api.md) · [All operations](https://skmtc.dev/caddence/apis/golf-product-api/llms.txt) · [OpenAPI document](https://skmtc.dev/caddence/apis/golf-product-api/revisions/adef6c56f7c0?raw)
