Skip to main content
PATCH
Update a promotion URL. All fields are optional. When supplied, group_ids or product_ids replace the complete assignment set atomically.
A promotion URL that is currently a program or group default cannot be deactivated, deleted, or changed so that it no longer satisfies that default. Choose a replacement default first.

Path Parameters

string
required
The promotion URL identifier.

Body Parameters

string
Display name, 1–255 characters.
string
HTTP(S) destination URL, up to 2048 characters.
string | null
Optional description. Set to null to clear.
string
all_affiliates, groups, or products.
array
Complete replacement group assignment list.
array
Complete replacement product assignment list.
boolean
Enable or disable the URL.
integer
Non-negative selection priority.
The same audience rules as Create Promotion URL apply. Legacy URLs created from a program website, group website, or product landing page must retain their original audience and assignment.

Response

Returns the updated promotion URL. See List Promotion URLs for the response object.