import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

// Sets the count the shelf should end at; the difference is recorded in the stock history.
const stockLevel = await client.stockLevels.update('sl_UkLWZg9DAJ', {
  count_on_hand: 42,
  reason: 'Cycle count',
})

spree api patch /stock_levels/{id} -d '{"count_on_hand":42,"reason":"Cycle count"}'

{
  "id": "sl_EfhxLZ9ck8",
  "count_on_hand": 25,
  "backorderable": false,
  "stock_location_id": "sloc_gbHJdmfrXB",
  "variant_id": "variant_gbHJdmfrXB",
  "external_references": {},
  "metadata": {},
  "reserved_count": 0,
  "incoming_count": 0,
  "purchasable_count": 25,
  "variant_name": "Product 1919378",
  "variant_sku": "SKU-240",
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "stock_location_name": "Gilbert Marquardt",
  "product_id": "prod_UkLWZg9DAJ",
  "options_text": "Size: S",
  "thumbnail_url": null,
  "allocated_count": 0,
  "available_count": 25
}