Update Program Group

PUT /siren/v1/program-groups/{id}

Updates an existing program group. Only provided fields are changed. The record must exist (enforced by RecordExistsMiddleware).

When the programs array is provided, it replaces the full set of program associations for this group. Existing associations are removed and new ones are created from the provided IDs. Programs already assigned to another group are silently skipped. Omitting programs from the request leaves existing associations untouched.

Request Body:

Field	Type	Required	Description
name	string	No	Updated display name
description	string	No	Updated description
sorter	string	No	Updated sorting strategy: oldestBindingWins or newestBindingWins
programs	integer[]	No	Replacement set of program IDs. All IDs must reference existing programs.

Example Request:

{
  "name": "Seasonal Promotions 2026",
  "programs": [3, 7, 15]
}

Example Response:

{
  "id": 2,
  "name": "Seasonal Promotions 2026",
  "description": "Holiday and seasonal bonus programs that override the default commission.",
  "sorter": "newestBindingWins"
}

Error Responses:

• 404. No record found with that ID.
• 500. Database error.