Upsert a product group
Creates or updates a single product group. Pass id to update the matching group; omit id to create a new one. A create returns 201, an update returns 200.
name is the only editable field and is required on both create and update; the update replaces the group's name. A group's name must be unique within the company, compared case-insensitively (Flower and flower collide) — a duplicate is rejected with a 400. The name may contain only letters, digits, spaces, underscores, and the characters ~ # - $ / | % & ' ( ) .; any other special character, and two colons in a row (::), are rejected with a 400.
Assigning products to a group is not done here: a product's group is set on the product itself, not on this endpoint. This endpoint only defines the group's identity.
Required permission: settings_permissions_product_groups.
Request body
Response
The updated product group
Changes
No recorded changes to this endpoint across all 1 revision of this API.