Update a promotion

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

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

// Basic field update
await client.promotions.update(promotionId, {
  description: 'Updated description',
})

// One-shot: rewrite rules + actions in a single request
await client.promotions.update(promotionId, {
  name: 'Holiday Sale',
  rules: [
    // Update an existing rule by id — `preferences` overwrite the prior set
    {
      id: 'prorule_existing',
      type: 'currency',
      preferences: { currency: 'EUR' },
    },
    // Add a new rule
    {
      type: 'item_total',
      preferences: { amount_min: 50, operator_min: 'gte' },
    },
  ],
  actions: [
    // Swap calculator type on an existing action
    {
      id: 'proaction_existing',
      type: 'create_item_adjustments',
      calculator: {
        type: 'percent_on_line_item',
        preferences: { percent: 15 },
      },
    },
  ],
})

// Remove all rules/actions
await client.promotions.update(promotionId, {
  rules: [],
  actions: [],
})

spree api patch /promotions/{id} -d '{"description":"Updated description"}'

{
  "id": "promo_UkLWZg9DAJ",
  "name": "Summer Sale",
  "description": null,
  "code": "summer",
  "starts_at": "2026-07-26T14:25:47.622Z",
  "expires_at": null,
  "usage_limit": null,
  "match_policy": "all",
  "path": null,
  "kind": "coupon_code",
  "multi_codes": false,
  "number_of_codes": null,
  "code_prefix": null,
  "promotion_category_id": null,
  "metadata": {},
  "created_at": "2026-07-26T14:25:47.622Z",
  "updated_at": "2026-07-26T14:25:47.927Z",
  "action_ids": [],
  "rule_ids": []
}