---
title: "Changes to Update Audience"
method: PATCH
path: "/v2/campaigns/{id}/audiences/{audience_id}"
---

# Changes to Update Audience

`PATCH /v2/campaigns/{id}/audiences/{audience_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 29 revisions.

- **2026-10-29** `778a11cd2c15`: 4 warning, 6 info
- **2026-10-16** `882b8ce1ff7a`: 2 breaking
- **2026-09-09** `217c96dc9a29`: 22 breaking, 1 warning, 130 info

## Changes

- **2026-10-29** `778a11cd2c15`: 4 warning, 6 info
  - added the new `credentials_missing` enum value to the `code/anyOf[subschema #1]/` response property for the response status `403`
  - added the new `credentials_missing` enum value to the `code/anyOf[subschema #1]/` response property for the response status `404`
  - added the new `credentials_missing` enum value to the `code/anyOf[subschema #1]/` response property for the response status `422`
  - added the new `credentials_missing` enum value to the `code/anyOf[subschema #1]/` response property for the response status `429`
  - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `500`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the response body `anyOf` list for the response status `401`
  - added `subschema #2, subschema #3, subschema #4` to the response body `anyOf` list for the response status `400`
  - removed `subschema #1, subschema #2` from the response body `anyOf` list for the response status `500`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` from the response body `anyOf` list for the response status `401`
  - removed `subschema #2, subschema #3, subschema #4` from the response body `anyOf` list for the response status `400`
- **2026-10-16** `882b8ce1ff7a`: 2 breaking
  - request property `variants/anyOf[subschema #1]/items/percentage` list-of-types was narrowed by removing types `number` from media type `application/json`
  - the `variants/anyOf[subschema #1]/items/percentage/anyOf[subschema #1]/` request property type changed from `number` to `integer`
- **2026-09-09** `217c96dc9a29`: 22 breaking, 1 warning, 130 info
  - removed `subschema #1, subschema #2` from the `description` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `frequency_limit` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `variant_optimization` request property `anyOf` list
  - the `enabled` request property type changed from `boolean` to no type
  - the `variants` request property type changed from `array` to no type
  - the `code` response's property type changed from `string` to no type for status `403`
  - the `code` response's property type changed from `string` to no type for status `404`
  - the `code` response's property type changed from `string` to no type for status `422`
  - the `code` response's property type changed from `string` to no type for status `429`
  - the `doc_url` response's property type changed from `string` to no type for status `403`
  - the `doc_url` response's property type changed from `string` to no type for status `404`
  - the `message` response's property type changed from `string` to no type for status `404`
  - the `message` response's property type changed from `string` to no type for status `429`
  - the `param` response's property type changed from `string` to no type for status `404`
  - the `required_scope` response's property type changed from `string` to no type for status `403`
  - the `resource_id` response's property type changed from `string` to no type for status `404`
  - the `resource_type` response's property type changed from `string` to no type for status `404`
  - the `retry_after` response's property type changed from `number` to no type for status `429`
  - the `type` response's property type changed from `string` to no type for status `403`
  - the `type` response's property type changed from `string` to no type for status `404`
  - the `type` response's property type changed from `string` to no type for status `422`
  - the `type` response's property type changed from `string` to no type for status `429`
  - removed `#/components/schemas/RuleConditions` from the `rule_conditions` request property `allOf` list
  - added `#/components/schemas/RuleConditions` to the `rule_conditions` request property `anyOf` list
  - added `subschema #1` to the `description` request property `anyOf` list
  - added `subschema #1` to the `enabled` request property `anyOf` list
  - added `subschema #1` to the `frequency_limit` request property `anyOf` list
  - added `subschema #1` to the `variant_optimization` request property `anyOf` list
  - added `subschema #1` to the `variants` request property `anyOf` list
  - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `500`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the response body `anyOf` list for the response status `401`
  - added `subschema #2, subschema #3, subschema #4` to the response body `anyOf` list for the response status `400`
  - removed `subschema #1: Missing API Key, subschema #2: Invalid API Key Format, subschema #3: Invalid API Key, subschema #4: Authentication Failed, subschema #5: Invalid Session` from the response body `anyOf` list for the response status `401`
  - removed `subschema #1: Side Effect Execution Error, subschema #2: Internal Server Error` from the response body `anyOf` list for the response status `500`
  - removed `subschema #2: Bad Request, subschema #3: Invalid Variant Percentages, subschema #4: Invalid Paywall Reference` from the response body `anyOf` list for the response status `400`
  - added `subschema #1` to the `code` response property `anyOf` list for the response status `403`
  - added `subschema #1` to the `code` response property `anyOf` list for the response status `404`
  - added `subschema #1` to the `code` response property `anyOf` list for the response status `422`
  - added `subschema #1` to the `code` response property `anyOf` list for the response status `429`
  - added `subschema #1` to the `doc_url` response property `anyOf` list for the response status `403`
  - …113 more
  - …this revision’s changelog is incomplete

---

[Operation](https://skmtc.dev/superwall/apis/superwall-api-v2/docs/v2/campaigns/:id/audiences/:audience_id/patch.md) - [API](https://skmtc.dev/superwall/apis/superwall-api-v2.md) - [Page](https://skmtc.dev/superwall/apis/superwall-api-v2/changes/v2/campaigns/:id/audiences/:audience_id/patch)