--- title: "Changes to Update audience" method: PATCH path: "/ad_accounts/{ad_account_id}/audiences/{audience_id}" --- # Changes to Update audience `PATCH /ad_accounts/{ad_account_id}/audiences/{audience_id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 8 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 5 breaking, 2 warning, 26 info - **2025-12-11** (v5) `79f62f71f05b`: 34 breaking, 16 warning, 29 info - **2025-07-16** (v5) `43134ca41f18`: 2 breaking, 2 info - **2025-04-04** (v5) `10f9eba4ad97`: 1 info - **2024-08-14** (v5) `89c27ed39cfd`: 3 warning, 3 info - **2024-04-23** (v5) `f9321315766f`: 1 breaking - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking, 1 warning - **2022-09-07** (v5) `bd20b6eb152f`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 5 breaking, 2 warning, 26 info - response property `rule/percentage` list-of-types was widened by adding types `string` to media type `application/json` of response `200` - response property `rule/visitor_source_id` list-of-types was widened by adding types `array` to media type `application/json` of response `200` - the `audience_type` response's property type changed from `string` to no type for status `200` - the `rule/seed_id` response's property type changed from `array` to no type for status `200` - the `status` response's property type changed from `string` to no type for status `200` - removed `#/components/schemas/AudienceCommon, subschema #2: AudienceUpdateRequest` from the request body `allOf` list - added the new `SALES` enum value to the `rule/objective_type/items/` response property for the response status `200` - added the new optional request property `ad_account_id` - added the new optional request property `audience_type` - added the new optional request property `description` - added the new optional request property `name` - added the new optional request property `operation_type` - added the new optional request property `rule` - added the non-success response with the status `400` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `404` - added the non-success response with the status `429` - added the optional property `is_nca` to the response with the `200` status - the response optional property `created_by_company_name` became read-only for the status `200` - the response optional property `created_timestamp` became read-only for the status `200` - the response optional property `size` became read-only for the status `200` - the response optional property `status` became read-only for the status `200` - the response optional property `type` became read-only for the status `200` - the response optional property `updated_timestamp` became read-only for the status `200` - added `#/components/schemas/AudienceStatus` to the `status` response property `allOf` list for the response status `200` - added `#/components/schemas/AudienceType` to the `audience_type` response property `allOf` list for the response status `200` - added `subschema #1, subschema #2` to the `rule/seed_id` response property `anyOf` list for the response status `200` - the response property `id` became required for the status `200` - the `rule/ad_id/items/` response's property pattern `^\d+$` was removed for the status `200` - the `rule/campaign_id/items/` response's property pattern `^\d+$` was removed for the status `200` - the `rule/pin_id/items/` response's property pattern `^\d+$` was removed for the status `200` - the `rule/visitor_source_id` response's property pattern `^\d+$` was removed for the status `200` - **2025-12-11** (v5) `79f62f71f05b`: 34 breaking, 16 warning, 29 info - request body became required - added `#/components/schemas/Currency` to the `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` request property `allOf` list - added `#/components/schemas/LineItem` to the `allOf[subschema #1: AudienceCommon]/rule/event_data/line_items` request property `allOf` list - removed the enum value `ARS` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `AUD` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `BRL` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `CAD` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `CHF` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `CLP` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `COP` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `CZK` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `DKK` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `EUR` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `GBP` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `HKD` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `HUF` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `ILS` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `INR` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `JPY` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `KRW` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `MXN` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `NOK` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `NZD` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `PLN` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `RON` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `SEK` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `SGD` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `TRY` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `UNK` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - removed the enum value `USD` of the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - the `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` request property type changed from `string` to no type - the `allOf[subschema #1: AudienceCommon]/rule/event_data/line_items` request property type changed from `object` to no type - the `rule/event_data/currency` response's property type changed from `string` to no type for status `200` - the `rule/event_data/line_items` response's property type changed from `object` to no type for status `200` - removed the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/line_items/product_brand` - removed the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/line_items/product_category` - removed the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/line_items/product_id` - removed the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/line_items/product_name` - removed the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/line_items/product_price` - removed the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/line_items/product_quantity` - …39 more - **2025-07-16** (v5) `43134ca41f18`: 2 breaking, 2 info - removed the enum value `VIDEO_VIEW` of the request property `allOf[subschema #1: AudienceCommon]/rule/objective_type/items/` - removed the enum value `WEB_SESSIONS` of the request property `allOf[subschema #1: AudienceCommon]/rule/objective_type/items/` - removed the `VIDEO_VIEW` enum value from the `rule/objective_type/items/` response property for the response status `200` - removed the `WEB_SESSIONS` enum value from the `rule/objective_type/items/` response property for the response status `200` - **2025-04-04** (v5) `10f9eba4ad97`: 1 info - added the optional property `created_by_company_name` to the response with the `200` status - **2024-08-14** (v5) `89c27ed39cfd`: 3 warning, 3 info - added the new `INR` enum value to the `rule/event_data/currency` response property for the response status `200` - added the new `TRY` enum value to the `rule/event_data/currency` response property for the response status `200` - added the new `VIDEO_COMPLETION` enum value to the `rule/objective_type/items/` response property for the response status `200` - added the new `INR` enum value to the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - added the new `TRY` enum value to the request property `allOf[subschema #1: AudienceCommon]/rule/event_data/currency` - added the new `VIDEO_COMPLETION` enum value to the request property `allOf[subschema #1: AudienceCommon]/rule/objective_type/items/` - **2024-04-23** (v5) `f9321315766f`: 1 breaking - the request's body type changed from no type to `object` - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking, 1 warning - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18` - for the `path` request parameter `audience_id`, the maxLength was set to `18` - **2022-09-07** (v5) `bd20b6eb152f`: 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/audiences/:audience_id/patch.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/audiences/:audience_id/patch)