Sign in
Campaigns V2

Update Audience Weights

Bulk-updates treatment-variant traffic percentages in place (preserving variant identity). Every treatment must be present, with no duplicate IDs; the HOLDOUT variant (if any) is auto-balanced to (100 - sum). Requires campaigns:write scope.

put/v2/campaigns/{id}/audiences/{audience_id}/weights

Path parameters

idstring required

Campaign ID

Campaign ID

audience_idstring required

Audience ID

Audience ID

Request body

Response

Success

idstring required

Unique identifier for the audience

object'audience' required

Object type, always audience

enabledboolean required

Whether this audience is enabled

expressionstring nullable required

Compiled filter expression for matching users, or null for all users

{"stackTrail":"paths:/v2/campaigns/{id}/audiences/{audience_id}/weights:put:responses:200:content:application/json:schema:properties:rule_conditions","oasType":"schema","type":"unknown","title":"unknown","description":"Structured targeting rule (RuleConditions AST) when this audience uses the rule editor, or null for legacy raw-expression audiences. Returned as stored; send it back via the typed `rule_conditions` field on update."}
expression_celstring nullable required

The CEL expression evaluated by modern SDKs, derived from rule_conditions. Null when the audience has no structured rule.

expression_sqlstring nullable required

The dashboard-side SQL compilation of rule_conditions (for preview/copy). Null when the audience has no structured rule.

rankstring required

Priority rank of this audience within the campaign

descriptionstring nullable required

Human-readable description of the audience

Changes

No recorded changes to this endpoint across all 4 revisions of this API.