---
title: "Put Brand Ship Option Groups"
method: PUT
path: "/brand/ship-option-groups"
---

# Put Brand Ship Option Groups

`PUT /brand/ship-option-groups`

## Request

- Base URL: `https://app.datesnrates.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.datesnrates.com/brand/ship-option-groups`
- Auth: HTTP bearer

## Request body

- ShipOptionGroupsUpdatePayload
  - `groups` ShipOptionGroupPayload[], required
    - `group_id` string, nullable
    - `display_name` string, required
    - `operator` 'cheapest' | 'fastest'
    - `destination_scope` 'domestic' | 'international'
    - `shipping_method_ids` integer[], required
    - `destination_countries` string[], nullable
    - `destination_provinces` string[], nullable
    - `max_transit_days` integer, nullable
    - `excluded_provinces` string[]

## Response `200`

Successful Response

- ShipOptionGroupsResponse
  - `groups` ShipOptionGroupResponse[], required
    - `group_id` string, required
    - `display_name` string, required
    - `operator` 'cheapest' | 'fastest'
    - `destination_scope` 'domestic' | 'international'
    - `shipping_method_ids` integer[], required
    - `destination_countries` string[], nullable
    - `destination_provinces` string[], nullable
    - `max_transit_days` integer, nullable
    - `excluded_provinces` string[]
  - `methods` ShipOptionGroupMethod[], required
    - `id` integer, required
    - `external_code` string, required
    - `display_name` string, required
    - `international` string, required
    - `enabled` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `dbcc2e28b94b`: 8 info
  - added the new optional request property `groups/items/destination_countries`
  - added the new optional request property `groups/items/destination_provinces`
  - added the new optional request property `groups/items/excluded_provinces`
  - added the new optional request property `groups/items/max_transit_days`
  - …4 more
- **2026-08-13** `8ec1cdb5926b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datesnrates/apis/datesnrates-api/changes/brand/ship-option-groups/put.md)

---

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