--- title: "Changes to Update ads" method: PATCH path: "/ad_accounts/{ad_account_id}/ads" --- # Changes to Update ads `PATCH /ad_accounts/{ad_account_id}/ads` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 14 of 29 revisions. - **2026-06-04** (v5) `b698c180678a` — 1 breaking, 1 warning, 75 info - **2025-12-11** (v5) `537bde5a50b1` — 4 info - **2025-10-16** (v5) `14c297539b64` — 3 warning, 3 info - **2025-04-04** (v5) `10f9eba4ad97` — 11 warning, 11 info - **2024-08-14** (v5) `89c27ed39cfd` — 1 breaking, 1 warning, 6 info - **2024-04-23** (v5) `f9321315766f` — 1 breaking - **2024-02-08** (v5) `7529b464d5cb` — 4 warning, 9 info - **2023-08-17** (v5) `0ff12596bafd` — 2 info - **2023-07-14** (v5) `52586a274771` — 2 warning, 2 info - **2023-05-12** (v5) `689b4b267639` — 1 warning, 1 info - **2023-02-14** (v5) `be19b77aa78a` — 5 breaking, 2 warning, 1 info - **2022-11-14** (v5) `e041d7b0cef0` — 1 breaking - **2022-09-07** (v5) `bd20b6eb152f` — 2 breaking, 3 warning, 4 info - **2022-07-11** (v5) `0d5998752011` — 1 info ## Changes - **2026-06-04** (v5) `b698c180678a` — 1 breaking, 1 warning, 75 info - added the new required request property `items/id` - removed `#/components/schemas/AdCommon, subschema #2: AdUpdateRequest` from the `items/` request property `allOf` list - added the new optional request property `items/ad_group_id` - added the new optional request property `items/android_deep_link` - added the new optional request property `items/carousel_android_deep_links` - added the new optional request property `items/carousel_destination_urls` - added the new optional request property `items/carousel_ios_deep_links` - added the new optional request property `items/click_tracking_url` - added the new optional request property `items/collection_items_destination_url_template` - added the new optional request property `items/collections_header_type` - added the new optional request property `items/creative_type` - added the new optional request property `items/customizable_cta_type` - added the new optional request property `items/destination_url` - added the new optional request property `items/disclosure_type` - added the new optional request property `items/disclosure_url` - added the new optional request property `items/grid_click_type` - added the new optional request property `items/ios_deep_link` - added the new optional request property `items/is_carting` - added the new optional request property `items/is_collage_accepted_terms` - added the new optional request property `items/is_collage_single_destination` - added the new optional request property `items/is_pin_deleted` - added the new optional request property `items/is_removable` - added the new optional request property `items/lead_form_id` - added the new optional request property `items/name` - added the new optional request property `items/pin_id` - added the new optional request property `items/quiz_pin_data` - added the new optional request property `items/status` - added the new optional request property `items/tracking_urls` - added the new optional request property `items/view_tracking_url` - 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 `items/items/data/android_deep_link` to the response with the `200` status - added the optional property `items/items/data/carousel_android_deep_links` to the response with the `200` status - added the optional property `items/items/data/carousel_destination_urls` to the response with the `200` status - added the optional property `items/items/data/carousel_ios_deep_links` to the response with the `200` status - added the optional property `items/items/data/carting_platform_type` to the response with the `200` status - added the optional property `items/items/data/carting_products` to the response with the `200` status - …37 more - **2025-12-11** (v5) `537bde5a50b1` — 4 info - added the new optional request property `items/allOf[#/components/schemas/AdCommon]/disclosure_type` - added the new optional request property `items/allOf[#/components/schemas/AdCommon]/disclosure_url` - added the optional property `items/items/data/allOf[#/components/schemas/AdCommon]/disclosure_type` to the response with the `200` status - added the optional property `items/items/data/allOf[#/components/schemas/AdCommon]/disclosure_url` to the response with the `200` status - **2025-10-16** (v5) `14c297539b64` — 3 warning, 3 info - added the new `COLLAGE` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/creative_type` response property for the response status `200` - added the new `MAX_WIDTH_REGULAR_COLLECTION` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/creative_type` response property for the response status `200` - added the new `MAX_WIDTH_VIDEO_COLLECTION` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/creative_type` response property for the response status `200` - added the new `COLLAGE` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `MAX_WIDTH_REGULAR_COLLECTION` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `MAX_WIDTH_VIDEO_COLLECTION` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/creative_type` - **2025-04-04** (v5) `10f9eba4ad97` — 11 warning, 11 info - added the new `BUY_TICKETS` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `DONATE_NOW` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `DOWNLOAD` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `EXPLORE_MORE` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `FIND_A_LOCATION` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `GET_DEAL` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `GET_RECIPE` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `GET_SHOWTIMES` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `ON_SALE` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `PLAY_GAME` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `TRY_IT` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new `BUY_TICKETS` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `DONATE_NOW` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `DOWNLOAD` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `EXPLORE_MORE` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `FIND_A_LOCATION` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `GET_DEAL` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `GET_RECIPE` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `GET_SHOWTIMES` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `ON_SALE` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `PLAY_GAME` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `TRY_IT` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - **2024-08-14** (v5) `89c27ed39cfd` — 1 breaking, 1 warning, 6 info - removed the enum value `VISIT_WEBSITE` of the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `VISIT_SITE` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - added the new optional request property `items/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_custom_result` - added the new optional request property `items/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_type` - added the new `VISIT_SITE` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the optional property `items/items/data/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_custom_result` to the response with the `200` status - added the optional property `items/items/data/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_type` to the response with the `200` status - removed the `VISIT_WEBSITE` enum value from the `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` response property for the response status `200` - **2024-04-23** (v5) `f9321315766f` — 1 breaking - the `items/` request property type changed from no type to `object` - **2024-02-08** (v5) `7529b464d5cb` — 4 warning, 9 info - added the new `DELETED_DRAFT` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/status` response property for the response status `200` - added the new `DELETED_DRAFT` enum value to the `items/items/data/allOf[subschema #3]/summary_status/allOf[#/components/schemas/PinPromotionSummaryStatus]/` response property for the response status `200` - added the new `DRAFT` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/status` response property for the response status `200` - added the new `DRAFT` enum value to the `items/items/data/allOf[subschema #3]/summary_status/allOf[#/components/schemas/PinPromotionSummaryStatus]/` response property for the response status `200` - added the new optional request property `items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new optional request property `items/allOf[#/components/schemas/AdCommon]/grid_click_type` - added the new optional request property `items/allOf[#/components/schemas/AdCommon]/quiz_pin_data` - added the new optional request property `items/allOf[subschema #2: AdUpdateRequest]/pin_id` - added the new `DELETED_DRAFT` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/status` - added the new `DRAFT` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/status` - added the optional property `items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type` to the response with the `200` status - added the optional property `items/items/data/allOf[#/components/schemas/AdCommon]/grid_click_type` to the response with the `200` status - added the optional property `items/items/data/allOf[#/components/schemas/AdCommon]/quiz_pin_data` to the response with the `200` status - **2023-08-17** (v5) `0ff12596bafd` — 2 info - added the new optional request property `items/allOf[#/components/schemas/AdCommon]/lead_form_id` - added the optional property `items/items/data/allOf[#/components/schemas/AdCommon]/lead_form_id` to the response with the `200` status - **2023-07-14** (v5) `52586a274771` — 2 warning, 2 info - added the new `COLLECTION` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/creative_type` response property for the response status `200` - added the new `SHOWCASE` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/creative_type` response property for the response status `200` - added the new `COLLECTION` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `SHOWCASE` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/creative_type` - **2023-05-12** (v5) `689b4b267639` — 1 warning, 1 info - added the new `QUIZ` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/creative_type` response property for the response status `200` - added the new `QUIZ` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/creative_type` - **2023-02-14** (v5) `be19b77aa78a` — 5 breaking, 2 warning, 1 info - the `items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/audience_verification/items/` response property's maxLength was unset from `2000` for the response status `200` - the `items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/buyable_button/items/` response property's maxLength was unset from `2000` for the response status `200` - the `items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/click/items/` response property's maxLength was unset from `2000` for the response status `200` - the `items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/engagement/items/` response property's maxLength was unset from `2000` for the response status `200` - the `items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/impression/items/` response property's maxLength was unset from `2000` for the response status `200` - removed the request property `items/allOf[#/components/schemas/AdCommon]/pin_id` - removed the optional property `items/items/data/allOf[#/components/schemas/AdCommon]/pin_id` from the response with the `200` status - added `#/components/schemas/AdPinId` to the `items/items/data` response property `allOf` list for the response status `200` - **2022-11-14** (v5) `e041d7b0cef0` — 1 breaking - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18` - **2022-09-07** (v5) `bd20b6eb152f` — 2 breaking, 3 warning, 4 info - the request's body minItems was increased to `1` - removed the enum value `STORY` of the request property `items/allOf[#/components/schemas/AdCommon]/creative_type` - for the `path` request parameter `ad_account_id`, the maxLength was set to `19` - changed the pattern of the request property `items/allOf[#/components/schemas/AdCommon]/ad_group_id` from `^\d+$` to `^(AG)?\d+$` - added the new `IDEA` enum value to the `items/items/data/allOf[#/components/schemas/AdCommon]/creative_type` response property for the response status `200` - added the new `IDEA` enum value to the request property `items/allOf[#/components/schemas/AdCommon]/creative_type` - the `items/allOf[subschema #2: AdUpdateRequest]/` request property's minLength was decreased from `1` to `0` - removed the `STORY` enum value from the `items/items/data/allOf[#/components/schemas/AdCommon]/creative_type` response property for the response status `200` - the `items/items/data/allOf[#/components/schemas/AdCommon]/ad_group_id` response's property pattern was changed from `^\d+$` to `^(AG)?\d+$` for the status `200` - **2022-07-11** (v5) `0d5998752011` — 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/ads/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/ads/patch)