@adcp/sdk 9.6.0 → 9.6.2

package/dist/lib/schemas-data/3.1/bundled/media-buy/create-media-buy-request.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.0/bundled/media-buy/create-media-buy-request.json",
+  "$id": "/schemas/3.1.1/bundled/media-buy/create-media-buy-request.json",
   "title": "Create Media Buy Request",
   "description": "Request parameters for creating a media buy. Supports two modes: (1) Manual mode - provide packages array with explicit line item configurations, or (2) Proposal mode - provide proposal_id and total_budget to execute a proposal from get_products. One of packages or proposal_id must be provided.",
   "type": "object",
@@ -28,7 +28,7 @@
           "maximum": 99
         }
       },
-      "$id": "/schemas/3.1.0/core/version-envelope.json"
+      "$id": "/schemas/3.1.1/core/version-envelope.json"
     }
   ],
   "x-mutates-state": true,
@@ -88,7 +88,7 @@
                     "nike",
                     "pampers"
                   ],
-                  "$id": "/schemas/3.1.0/core/brand-id.json"
+                  "$id": "/schemas/3.1.1/core/brand-id.json"
                 },
                 "industries": {
                   "type": "array",
@@ -433,7 +433,7 @@
                                             "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
                                             "type": "object",
                                             "additionalProperties": true,
-                                            "$id": "/schemas/3.1.0/core/ext.json"
+                                            "$id": "/schemas/3.1.1/core/ext.json"
                                           }
                                         },
                                         "additionalProperties": true
@@ -726,7 +726,7 @@
                   "width"
                 ]
               },
-              "$id": "/schemas/3.1.0/core/format-id.json"
+              "$id": "/schemas/3.1.1/core/format-id.json"
             },
             "minItems": 1
           },
@@ -792,7 +792,7 @@
                 }
               ],
               "additionalProperties": true,
-              "$id": "/schemas/3.1.0/core/format-option-ref.json"
+              "$id": "/schemas/3.1.1/core/format-option-ref.json"
             },
             "minItems": 1
           },
@@ -823,7 +823,7 @@
               "asap": "Spend remaining budget as quickly as possible",
               "front_loaded": "Allocate more remaining budget earlier in the remaining campaign period"
             },
-            "$id": "/schemas/3.1.0/enums/pacing.json"
+            "$id": "/schemas/3.1.1/enums/pacing.json"
           },
           "pricing_option_id": {
             "type": "string",
@@ -1089,7 +1089,7 @@
                         }
                       }
                     ],
-                    "$id": "/schemas/3.1.0/core/catalog-field-mapping.json"
+                    "$id": "/schemas/3.1.1/core/catalog-field-mapping.json"
                   },
                   "minItems": 1
                 }
@@ -1307,7 +1307,7 @@
                                 "unit"
                               ],
                               "additionalProperties": false,
-                              "$id": "/schemas/3.1.0/core/duration.json"
+                              "$id": "/schemas/3.1.1/core/duration.json"
                             }
                           ],
                           "description": "Time window over which frequency is measured (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Weekly windows are typical for brand campaigns; daily windows suit high-cadence direct response."
@@ -1585,11 +1585,11 @@
                                 "time_decay",
                                 "data_driven"
                               ],
-                              "$id": "/schemas/3.1.0/enums/attribution-model.json"
+                              "$id": "/schemas/3.1.1/enums/attribution-model.json"
                             }
                           },
                           "additionalProperties": true,
-                          "$id": "/schemas/3.1.0/core/attribution-window.json"
+                          "$id": "/schemas/3.1.1/core/attribution-window.json"
                         }
                       ],
                       "description": "Attribution window for this optimization goal — references the canonical `attribution-window` shape (post_click, post_view, model). Values must match an option declared in the seller's `conversion_tracking.attribution_windows` capability. Sellers MUST reject windows not in their declared capabilities. When the entire field is omitted, the seller uses their default window."
@@ -2127,7 +2127,7 @@
                         "co_view_index",
                         "incremental_lift_percent"
                       ],
-                      "$id": "/schemas/3.1.0/core/vendor-metric-id.json"
+                      "$id": "/schemas/3.1.1/core/vendor-metric-id.json"
                     },
                     "target": {
                       "description": "Target for this vendor metric. When omitted, the seller optimizes for maximum metric volume / score within budget. `cost_per` and `threshold_rate` semantics mirror the same target kinds on the `metric` kind — units are vendor-defined and depend on the vendor's `measurement.metrics[]` declaration for this `metric_id`.",
@@ -2741,7 +2741,7 @@
                           "saturday",
                           "sunday"
                         ],
-                        "$id": "/schemas/3.1.0/enums/day-of-week.json"
+                        "$id": "/schemas/3.1.1/enums/day-of-week.json"
                       },
                       "minItems": 1
                     },
@@ -2768,7 +2768,7 @@
                     "end_hour"
                   ],
                   "additionalProperties": false,
-                  "$id": "/schemas/3.1.0/core/daypart-target.json"
+                  "$id": "/schemas/3.1.1/core/daypart-target.json"
                 },
                 "minItems": 1
               },
@@ -3006,7 +3006,7 @@
                                             "additionalProperties": true
                                           }
                                         ],
-                                        "$id": "/schemas/3.1.0/core/signal-ref.json"
+                                        "$id": "/schemas/3.1.1/core/signal-ref.json"
                                       },
                                       "value_type": {
                                         "type": "string",
@@ -3412,7 +3412,7 @@
                                     "additionalProperties": true
                                   }
                                 ],
-                                "$id": "/schemas/3.1.0/core/signal-targeting-expression.json"
+                                "$id": "/schemas/3.1.1/core/signal-targeting-expression.json"
                               }
                             ],
                             "properties": {
@@ -3476,11 +3476,11 @@
                                     "additionalProperties": true
                                   }
                                 ],
-                                "$id": "/schemas/3.1.0/core/activation-key.json"
+                                "$id": "/schemas/3.1.1/core/activation-key.json"
                               }
                             },
                             "additionalProperties": true,
-                            "$id": "/schemas/3.1.0/core/package-signal-targeting.json"
+                            "$id": "/schemas/3.1.1/core/package-signal-targeting.json"
                           },
                           "minItems": 1
                         }
@@ -3490,7 +3490,7 @@
                         "signals"
                       ],
                       "additionalProperties": true,
-                      "$id": "/schemas/3.1.0/core/package-signal-targeting-group.json"
+                      "$id": "/schemas/3.1.1/core/package-signal-targeting-group.json"
                     },
                     "minItems": 1
                   }
@@ -3500,7 +3500,7 @@
                   "groups"
                 ],
                 "additionalProperties": true,
-                "$id": "/schemas/3.1.0/core/package-signal-targeting-groups.json"
+                "$id": "/schemas/3.1.1/core/package-signal-targeting-groups.json"
               },
               "signal_targeting": {
                 "type": "array",
@@ -3743,7 +3743,7 @@
                               "additionalProperties": true
                             }
                           ],
-                          "$id": "/schemas/3.1.0/core/signal-id.json"
+                          "$id": "/schemas/3.1.1/core/signal-id.json"
                         },
                         "value_type": {
                           "type": "string",
@@ -4299,7 +4299,7 @@
                       "additionalProperties": true
                     }
                   ],
-                  "$id": "/schemas/3.1.0/core/signal-targeting.json"
+                  "$id": "/schemas/3.1.1/core/signal-targeting.json"
                 },
                 "minItems": 1
               },
@@ -4450,7 +4450,7 @@
                   "list_id"
                 ],
                 "additionalProperties": false,
-                "$id": "/schemas/3.1.0/core/property-list-ref.json"
+                "$id": "/schemas/3.1.1/core/property-list-ref.json"
               },
               "collection_list": {
                 "title": "Collection List Reference",
@@ -4478,7 +4478,7 @@
                   "list_id"
                 ],
                 "additionalProperties": false,
-                "$id": "/schemas/3.1.0/core/collection-list-ref.json"
+                "$id": "/schemas/3.1.1/core/collection-list-ref.json"
               },
               "collection_list_exclude": {
                 "title": "Collection List Reference",
@@ -4536,7 +4536,7 @@
                         "credit_card",
                         "world_id"
                       ],
-                      "$id": "/schemas/3.1.0/enums/age-verification-method.json"
+                      "$id": "/schemas/3.1.1/enums/age-verification-method.json"
                     },
                     "minItems": 1
                   }
@@ -4567,7 +4567,7 @@
                     "roku_os",
                     "unknown"
                   ],
-                  "$id": "/schemas/3.1.0/enums/device-platform.json"
+                  "$id": "/schemas/3.1.1/enums/device-platform.json"
                 },
                 "minItems": 1
               },
@@ -4664,7 +4664,7 @@
                             "min": "Minutes",
                             "hr": "Hours"
                           },
-                          "$id": "/schemas/3.1.0/enums/travel-time-unit.json"
+                          "$id": "/schemas/3.1.1/enums/travel-time-unit.json"
                         }
                       },
                       "required": [
@@ -4689,7 +4689,7 @@
                         "driving": "Motor vehicle travel on road networks",
                         "public_transport": "Public transit including bus, rail, metro, and ferry"
                       },
-                      "$id": "/schemas/3.1.0/enums/transport-mode.json"
+                      "$id": "/schemas/3.1.1/enums/transport-mode.json"
                     },
                     "radius": {
                       "type": "object",
@@ -4714,7 +4714,7 @@
                             "mi": "Miles",
                             "m": "Meters"
                           },
-                          "$id": "/schemas/3.1.0/enums/distance-unit.json"
+                          "$id": "/schemas/3.1.1/enums/distance-unit.json"
                         }
                       },
                       "required": [
@@ -5443,7 +5443,7 @@
                         "credit": "Seller issues a credit toward future media buys on the same account.",
                         "invoice_adjustment": "Seller reduces the invoice for the current media buy to reflect actual delivered value."
                       },
-                      "$id": "/schemas/3.1.0/enums/makegood-remedy.json"
+                      "$id": "/schemas/3.1.1/enums/makegood-remedy.json"
                     },
                     "minItems": 1,
                     "uniqueItems": true
@@ -5483,7 +5483,7 @@
                     "brand_safety": "Brand-safe impression rate (floor — must exceed threshold). Denominator: total_impressions.",
                     "attention_score": "Attention score rate (floor — must exceed threshold). Denominator: measurable_impressions."
                   },
-                  "$id": "/schemas/3.1.0/enums/performance-standard-metric.json"
+                  "$id": "/schemas/3.1.1/enums/performance-standard-metric.json"
                 },
                 "threshold": {
                   "type": "number",
@@ -6040,7 +6040,7 @@
                             "seller_attested": "The party serving the ad witnessed and counted the completion event. Includes ad-server / player completion beacons, walled-garden first-party measurement, and IAB-certified first-party podcast measurement on the platform's own inventory. Source of truth is the seller's delivery infrastructure.",
                             "vendor_attested": "An independent third-party measurement vendor (Nielsen, DV, IAS, Moat, HUMAN, Podtrac on third-party inventory, Edison Research panel, etc.) attested to the completion via SDK callbacks, server-beacon validation, or panel methodology. Source of truth is the vendor; vendor identity SHOULD be anchored on a matching `performance_standard.vendor` BrandRef in the buy contract — if a buyer wants vendor-attested completion for transparency without an accountability gate, they MAY commit a vendor metric via `vendor_metrics` on the product rather than `committed_metrics` with this qualifier."
                           },
-                          "$id": "/schemas/3.1.0/enums/completion-source.json"
+                          "$id": "/schemas/3.1.1/enums/completion-source.json"
                         },
                         "attribution_methodology": {
                           "title": "Attribution Methodology",
@@ -6058,7 +6058,7 @@
                             "panel_based": "Panel methodology — outcomes measured against a recruited respondent panel and projected to the population. Standard for Nielsen, comScore, Edison Research, and similar panel providers.",
                             "modeled": "Modeled output — Media Mix Modeling (MMM), Multi-Touch Attribution (MTA), incrementality testing, or other statistical inference that produces an estimated outcome rather than a directly-observed match. Includes most clean-room outputs."
                           },
-                          "$id": "/schemas/3.1.0/enums/attribution-methodology.json"
+                          "$id": "/schemas/3.1.1/enums/attribution-methodology.json"
                         },
                         "attribution_window": {
                           "title": "Duration",
@@ -6106,7 +6106,7 @@
                             "purchase_intent": "Lift in stated purchase intent — 'are you likely to buy [brand] in the next [N] days'.",
                             "ad_recall": "Lift in unaided or aided ad recall — 'do you remember seeing an ad for [brand]'."
                           },
-                          "$id": "/schemas/3.1.0/enums/lift-dimension.json"
+                          "$id": "/schemas/3.1.1/enums/lift-dimension.json"
                         }
                       },
                       "additionalProperties": false
@@ -6693,7 +6693,7 @@
                       "placement_id"
                     ],
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.0/core/placement-ref.json"
+                    "$id": "/schemas/3.1.1/core/placement-ref.json"
                   },
                   "minItems": 1
                 },
@@ -6710,7 +6710,7 @@
                 "creative_id"
               ],
               "additionalProperties": true,
-              "$id": "/schemas/3.1.0/core/creative-assignment.json"
+              "$id": "/schemas/3.1.1/core/creative-assignment.json"
             },
             "minItems": 1
           },
@@ -7233,7 +7233,8 @@
                             },
                             {
                               "title": "Video Asset",
-                              "description": "Video asset with URL and technical specifications including audio track properties",
+                              "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                              "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                               "type": "object",
                               "properties": {
                                 "asset_type": {
@@ -7249,12 +7250,12 @@
                                 "width": {
                                   "type": "integer",
                                   "minimum": 1,
-                                  "description": "Width in pixels"
+                                  "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                                 },
                                 "height": {
                                   "type": "integer",
                                   "minimum": 1,
-                                  "description": "Height in pixels"
+                                  "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                                 },
                                 "duration_ms": {
                                   "type": "integer",
@@ -8154,7 +8155,7 @@
                             },
                             {
                               "title": "VAST Asset",
-                              "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving",
+                              "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving. Unlike the hosted `video` asset, a VAST tag carries no `width`/`height`: a VAST response can return multiple renditions of differing dimensions, and the player selects one per device at serve time, so there is no single width/height for the ad. Dimensional, duration, and codec *constraints* for a placement live on the format/requirements layer, not on this asset.",
                               "type": "object",
                               "properties": {
                                 "asset_type": {
@@ -11850,7 +11851,7 @@
                                           "role"
                                         ],
                                         "additionalProperties": true,
-                                        "$id": "/schemas/3.1.0/core/reference-asset.json"
+                                        "$id": "/schemas/3.1.1/core/reference-asset.json"
                                       }
                                     },
                                     "compliance": {
@@ -13141,7 +13142,8 @@
                                     },
                                     {
                                       "title": "Video Asset",
-                                      "description": "Video asset with URL and technical specifications including audio track properties",
+                                      "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                                      "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                                       "type": "object",
                                       "properties": {
                                         "asset_type": {
@@ -13157,12 +13159,12 @@
                                         "width": {
                                           "type": "integer",
                                           "minimum": 1,
-                                          "description": "Width in pixels"
+                                          "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                                         },
                                         "height": {
                                           "type": "integer",
                                           "minimum": 1,
-                                          "description": "Height in pixels"
+                                          "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                                         },
                                         "duration_ms": {
                                           "type": "integer",
@@ -14063,7 +14065,7 @@
                                         "digest": "sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"
                                       }
                                     ],
-                                    "$id": "/schemas/3.1.0/core/platform-extension-ref.json"
+                                    "$id": "/schemas/3.1.1/core/platform-extension-ref.json"
                                   }
                                 },
                                 "provenance": {
@@ -16084,7 +16086,8 @@
                               },
                               {
                                 "title": "Video Asset",
-                                "description": "Video asset with URL and technical specifications including audio track properties",
+                                "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                                "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                                 "type": "object",
                                 "properties": {
                                   "asset_type": {
@@ -16100,12 +16103,12 @@
                                   "width": {
                                     "type": "integer",
                                     "minimum": 1,
-                                    "description": "Width in pixels"
+                                    "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                                   },
                                   "height": {
                                     "type": "integer",
                                     "minimum": 1,
-                                    "description": "Height in pixels"
+                                    "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                                   },
                                   "duration_ms": {
                                     "type": "integer",
@@ -17005,7 +17008,7 @@
                               },
                               {
                                 "title": "VAST Asset",
-                                "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving",
+                                "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving. Unlike the hosted `video` asset, a VAST tag carries no `width`/`height`: a VAST response can return multiple renditions of differing dimensions, and the player selects one per device at serve time, so there is no single width/height for the ad. Dimensional, duration, and codec *constraints* for a placement live on the format/requirements layer, not on this asset.",
                                 "type": "object",
                                 "properties": {
                                   "asset_type": {
@@ -21991,7 +21994,8 @@
                                       },
                                       {
                                         "title": "Video Asset",
-                                        "description": "Video asset with URL and technical specifications including audio track properties",
+                                        "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                                        "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                                         "type": "object",
                                         "properties": {
                                           "asset_type": {
@@ -22007,12 +22011,12 @@
                                           "width": {
                                             "type": "integer",
                                             "minimum": 1,
-                                            "description": "Width in pixels"
+                                            "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                                           },
                                           "height": {
                                             "type": "integer",
                                             "minimum": 1,
-                                            "description": "Height in pixels"
+                                            "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                                           },
                                           "duration_ms": {
                                             "type": "integer",
@@ -24606,7 +24610,7 @@
                     "rejected": "Creative was rejected due to content policy, technical issues, or terminal dependency/authorization loss. Reached from 'pending_review' (initial review failure), from 'approved' (post-approval revocation by the seller — policy change, takedown request, content drift), or from 'suspended' when a previously recoverable dependency is determined unrecoverable for this creative. Not terminal — the buyer may fix the issue and resubmit via sync_creatives, which returns the creative to processing.",
                     "archived": "Creative has been archived and is excluded from default queries. Archive MAY be buyer-initiated (explicit cleanup) or seller-initiated (inactivity, post-flight expiry, storage policy, account suspension) — seller-initiated archive is only valid when no active package assignments reference the creative. Archived creatives retain their data and may be unarchived back to approved by the buyer. Buyer-initiated archive is acknowledged on the `sync_creatives` response path. Seller-initiated archive (`approved → archived`) fires `creative.status_changed` against the account's `notification_configs[]` subscribers (see `notification-type.json` and `sync_accounts`); buyers MUST observe the new status on the next `list_creatives` read regardless of whether the webhook was delivered. Destruction is a distinct event (`creative.purged`); purged creatives do not appear in default `list_creatives` results and MAY surface as tombstones when `include_purged: true` is supplied — see `list_creatives` for the tombstone shape."
                   },
-                  "$id": "/schemas/3.1.0/enums/creative-status.json"
+                  "$id": "/schemas/3.1.1/enums/creative-status.json"
                 },
                 "weight": {
                   "type": "number",
@@ -24678,7 +24682,7 @@
                           "clearcast_clock",
                           "idcrea"
                         ],
-                        "$id": "/schemas/3.1.0/enums/creative-identifier-type.json"
+                        "$id": "/schemas/3.1.1/enums/creative-identifier-type.json"
                       },
                       "value": {
                         "type": "string",
@@ -24691,7 +24695,7 @@
                       "value"
                     ],
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.0/core/industry-identifier.json"
+                    "$id": "/schemas/3.1.1/core/industry-identifier.json"
                   },
                   "uniqueItems": true
                 },
@@ -25093,7 +25097,7 @@
             "description": "Opaque package-level correlation data echoed unchanged in the package response, webhooks, and read surfaces. Buyers targeting mixed seller populations SHOULD include a per-package correlation value here, commonly context.buyer_ref, so responses from legacy sellers that do not echo product_id can still be mapped back to the requested product or line item. Do not use deprecated top-level buyer_ref for v3 correlation.",
             "type": "object",
             "additionalProperties": true,
-            "$id": "/schemas/3.1.0/core/context.json"
+            "$id": "/schemas/3.1.1/core/context.json"
           },
           "ext": {
             "title": "Extension Object",
@@ -25786,7 +25790,7 @@
         "travel_hospitality.cruise": "Cruise lines and ocean travel",
         "travel_hospitality.tourism": "Tourism boards and travel agencies"
       },
-      "$id": "/schemas/3.1.0/enums/advertiser-industry.json"
+      "$id": "/schemas/3.1.1/enums/advertiser-industry.json"
     },
     "invoice_recipient": {
       "title": "Business Entity",
@@ -25995,7 +25999,7 @@
           }
         }
       ],
-      "$id": "/schemas/3.1.0/core/business-entity.json"
+      "$id": "/schemas/3.1.1/core/business-entity.json"
     },
     "io_acceptance": {
       "type": "object",
@@ -26052,7 +26056,7 @@
           "description": "Scheduled start date/time in ISO 8601 format"
         }
       ],
-      "$id": "/schemas/3.1.0/core/start-timing.json"
+      "$id": "/schemas/3.1.1/core/start-timing.json"
     },
     "end_time": {
       "type": "string",
@@ -26305,7 +26309,7 @@
         "human_edits": "Content augmented, corrected, or enhanced by humans using non-generative tools",
         "data_driven_media": "Assembled from structured data feeds (DCO templates, product catalogs, weather-triggered variants)"
       },
-      "$id": "/schemas/3.1.0/enums/digital-source-type.json"
+      "$id": "/schemas/3.1.1/enums/digital-source-type.json"
     },
     "EmbeddedProvenanceMethod": {
       "title": "Embedded Provenance Method",
@@ -26319,7 +26323,7 @@
         "manifest_wrapper": "A provenance manifest embedded in the file container per format-specific rules (e.g., JUMBF box in JPEG, C2PATextManifestWrapper in plaintext per C2PA Section A.7). The manifest travels with the file but is tied to the file's byte structure.",
         "provenance_markers": "Invisible markers embedded within the content stream that encode or reference a provenance record. Designed to survive reformatting, copy-paste, CMS ingestion, and ad-server transcoding that breaks file-level bindings."
       },
-      "$id": "/schemas/3.1.0/enums/embedded-provenance-method.json"
+      "$id": "/schemas/3.1.1/enums/embedded-provenance-method.json"
     },
     "WatermarkMediaType": {
       "title": "Watermark Media Type",
@@ -26337,7 +26341,7 @@
         "video": "Watermark applied to video content (e.g., per-frame image watermarking, temporal watermarking)",
         "text": "Watermark applied to text content (e.g., synonym substitution, structural modification)"
       },
-      "$id": "/schemas/3.1.0/enums/watermark-media-type.json"
+      "$id": "/schemas/3.1.1/enums/watermark-media-type.json"
     },
     "C2PAWatermarkAction": {
       "title": "C2PA Watermark Action",
@@ -26351,7 +26355,7 @@
         "c2pa.watermarked.bound": "Watermark linked to a C2PA manifest for this asset. The watermark and manifest are mutually reinforcing: the manifest references the watermark, and the watermark can be used to locate the manifest.",
         "c2pa.watermarked.unbound": "Watermark independent of any C2PA manifest. Applied before any provenance signing event (e.g., by the AI generator at creation time) or in pipelines where no manifest is present."
       },
-      "$id": "/schemas/3.1.0/enums/c2pa-watermark-action.json"
+      "$id": "/schemas/3.1.1/enums/c2pa-watermark-action.json"
     },
     "DisclosurePersistence": {
       "title": "Disclosure Persistence",
@@ -26367,7 +26371,7 @@
         "initial": "Disclosure must appear at the start of content for a minimum duration before it may be removed. Pair with min_duration_ms in render_guidance or creative brief to specify the required duration.",
         "flexible": "Disclosure presence is sufficient; placement timing and duration are at the publisher's discretion"
       },
-      "$id": "/schemas/3.1.0/enums/disclosure-persistence.json"
+      "$id": "/schemas/3.1.1/enums/disclosure-persistence.json"
     },
     "DisclosurePosition": {
       "title": "Disclosure Position",
@@ -26383,7 +26387,7 @@
         "pre_roll",
         "companion"
       ],
-      "$id": "/schemas/3.1.0/enums/disclosure-position.json"
+      "$id": "/schemas/3.1.1/enums/disclosure-position.json"
     },
     "CanonicalFormatKind": {
       "title": "Canonical Format Kind",
@@ -26404,7 +26408,7 @@
         "agent_placement",
         "custom"
       ],
-      "$id": "/schemas/3.1.0/core/canonical-format-kind.json"
+      "$id": "/schemas/3.1.1/core/canonical-format-kind.json"
     },
     "CatalogType": {
       "title": "Catalog Type",
@@ -26425,7 +26429,7 @@
         "destination",
         "app"
       ],
-      "$id": "/schemas/3.1.0/enums/catalog-type.json"
+      "$id": "/schemas/3.1.1/enums/catalog-type.json"
     },
     "FeedFormat": {
       "title": "Feed Format",
@@ -26451,7 +26455,7 @@
         "openai_product_feed": "OpenAI Commerce product feed for ChatGPT shopping — a GMC-derived dialect adding ChatGPT-specific eligibility flags (is_eligible_search / is_eligible_checkout / is_eligible_ads). Spec: https://developers.openai.com/commerce/specs/file-upload/products",
         "custom": "A feed whose shape is not one of the named formats above. The buyer MUST supply feed_field_mappings to normalize it to the AdCP catalog item schema."
       },
-      "$id": "/schemas/3.1.0/enums/feed-format.json"
+      "$id": "/schemas/3.1.1/enums/feed-format.json"
     },
     "UpdateFrequency": {
       "title": "Update Frequency",
@@ -26463,7 +26467,7 @@
         "daily",
         "weekly"
       ],
-      "$id": "/schemas/3.1.0/enums/update-frequency.json"
+      "$id": "/schemas/3.1.1/enums/update-frequency.json"
     },
     "EventType": {
       "title": "Event Type",
@@ -26535,7 +26539,7 @@
         "submit_application": "User submitted an application (loan, job, etc.)",
         "custom": "Custom event type (specify in custom_event_name)"
       },
-      "$id": "/schemas/3.1.0/enums/event-type.json"
+      "$id": "/schemas/3.1.1/enums/event-type.json"
     },
     "ContentIDType": {
       "title": "Content ID Type",
@@ -26555,7 +26559,7 @@
         "destination_id",
         "app_id"
       ],
-      "$id": "/schemas/3.1.0/enums/content-id-type.json"
+      "$id": "/schemas/3.1.1/enums/content-id-type.json"
     },
     "ReachUnit": {
       "title": "Reach Unit",
@@ -26577,7 +26581,7 @@
         "cookies": "Unique browser cookies.",
         "custom": "Publisher-defined reach unit. Describe in ext."
       },
-      "$id": "/schemas/3.1.0/enums/reach-unit.json"
+      "$id": "/schemas/3.1.1/enums/reach-unit.json"
     },
     "MetroAreaSystem": {
       "title": "Metro Area System",
@@ -26590,7 +26594,7 @@
         "eurostat_nuts2",
         "custom"
       ],
-      "$id": "/schemas/3.1.0/enums/metro-system.json"
+      "$id": "/schemas/3.1.1/enums/metro-system.json"
     },
     "PostalCodeSystem": {
       "title": "Postal Code System",
@@ -26621,7 +26625,7 @@
         "ch_plz",
         "at_plz"
       ],
-      "$id": "/schemas/3.1.0/enums/postal-system.json"
+      "$id": "/schemas/3.1.1/enums/postal-system.json"
     },
     "LegacyPostalCodeSystem": {
       "title": "Legacy Postal Code System",
@@ -26641,7 +26645,7 @@
         "ch_plz",
         "at_plz"
       ],
-      "$id": "/schemas/3.1.0/enums/legacy-postal-system.json"
+      "$id": "/schemas/3.1.1/enums/legacy-postal-system.json"
     },
     "DeviceType": {
       "title": "Device Type",
@@ -26655,7 +26659,7 @@
         "dooh",
         "unknown"
       ],
-      "$id": "/schemas/3.1.0/enums/device-type.json"
+      "$id": "/schemas/3.1.1/enums/device-type.json"
     },
     "MatchType": {
       "title": "Match Type",
@@ -26671,7 +26675,7 @@
         "phrase": "Ads serve when the query contains the keyword phrase in order",
         "exact": "Ads serve only when the query matches the keyword exactly"
       },
-      "$id": "/schemas/3.1.0/enums/match-type.json"
+      "$id": "/schemas/3.1.1/enums/match-type.json"
     },
     "ViewabilityStandard": {
       "title": "Viewability Standard",
@@ -26685,7 +26689,7 @@
         "mrc": "MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).",
         "groupm": "GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."
       },
-      "$id": "/schemas/3.1.0/enums/viewability-standard.json"
+      "$id": "/schemas/3.1.1/enums/viewability-standard.json"
     },
     "AvailableMetric": {
       "title": "Available Metric",
@@ -26729,7 +26733,7 @@
         "conversion_lift",
         "brand_search_lift"
       ],
-      "$id": "/schemas/3.1.0/enums/available-metric.json"
+      "$id": "/schemas/3.1.1/enums/available-metric.json"
     },
     "FrameRateType": {
       "title": "Frame Rate Type",
@@ -26743,7 +26747,7 @@
         "constant": "Constant frame rate (CFR) — each frame occupies an identical time interval",
         "variable": "Variable frame rate (VFR) — frame intervals may differ"
       },
-      "$id": "/schemas/3.1.0/enums/frame-rate-type.json"
+      "$id": "/schemas/3.1.1/enums/frame-rate-type.json"
     },
     "ScanType": {
       "title": "Scan Type",
@@ -26757,7 +26761,7 @@
         "progressive": "All lines of each frame are drawn in sequence",
         "interlaced": "Alternating lines drawn in two passes per frame (legacy broadcast)"
       },
-      "$id": "/schemas/3.1.0/enums/scan-type.json"
+      "$id": "/schemas/3.1.1/enums/scan-type.json"
     },
     "GOPType": {
       "title": "GOP Type",
@@ -26771,7 +26775,7 @@
         "closed": "Each GOP is independently decodable — required for SSAI and broadcast splicing",
         "open": "GOPs may reference frames from adjacent GOPs — not suitable for splicing"
       },
-      "$id": "/schemas/3.1.0/enums/gop-type.json"
+      "$id": "/schemas/3.1.1/enums/gop-type.json"
     },
     "MoovAtomPosition": {
       "title": "Moov Atom Position",
@@ -26785,7 +26789,7 @@
         "start": "moov atom at beginning of file — enables progressive download and streaming delivery",
         "end": "moov atom at end of file — requires full download before playback can begin"
       },
-      "$id": "/schemas/3.1.0/enums/moov-atom-position.json"
+      "$id": "/schemas/3.1.1/enums/moov-atom-position.json"
     },
     "AudioChannelLayout": {
       "title": "Audio Channel Layout",
@@ -26797,7 +26801,7 @@
         "5.1",
         "7.1"
       ],
-      "$id": "/schemas/3.1.0/enums/audio-channel-layout.json"
+      "$id": "/schemas/3.1.1/enums/audio-channel-layout.json"
     },
     "VASTVersion": {
       "title": "VAST Version",
@@ -26810,7 +26814,7 @@
         "4.1",
         "4.2"
       ],
-      "$id": "/schemas/3.1.0/enums/vast-version.json"
+      "$id": "/schemas/3.1.1/enums/vast-version.json"
     },
     "VASTTrackingEvent": {
       "title": "VAST Tracking Event",
@@ -26854,7 +26858,7 @@
         "measurableImpression",
         "viewableImpression"
       ],
-      "$id": "/schemas/3.1.0/enums/vast-tracking-event.json"
+      "$id": "/schemas/3.1.1/enums/vast-tracking-event.json"
     },
     "URLAssetType": {
       "title": "URL Asset Type",
@@ -26865,7 +26869,7 @@
         "tracker_pixel",
         "tracker_script"
       ],
-      "$id": "/schemas/3.1.0/enums/url-asset-type.json"
+      "$id": "/schemas/3.1.1/enums/url-asset-type.json"
     },
     "JavaScriptModuleType": {
       "title": "JavaScript Module Type",
@@ -26876,7 +26880,7 @@
         "commonjs",
         "script"
       ],
-      "$id": "/schemas/3.1.0/enums/javascript-module-type.json"
+      "$id": "/schemas/3.1.1/enums/javascript-module-type.json"
     },
     "HTTPMethod": {
       "title": "HTTP Method",
@@ -26886,7 +26890,7 @@
         "GET",
         "POST"
       ],
-      "$id": "/schemas/3.1.0/enums/http-method.json",
+      "$id": "/schemas/3.1.1/enums/http-method.json",
       "default": "POST"
     },
     "UniversalMacro": {
@@ -27047,7 +27051,7 @@
         "ITEM_PRICE": "Price amount of the catalog item being rendered (catalog_field: price.amount). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.",
         "ITEM_PRICE_CURRENCY": "ISO 4217 currency code of the catalog item being rendered (catalog_field: price.currency). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules."
       },
-      "$id": "/schemas/3.1.0/enums/universal-macro.json"
+      "$id": "/schemas/3.1.1/enums/universal-macro.json"
     },
     "WebhookResponseType": {
       "title": "Webhook Response Type",
@@ -27059,7 +27063,7 @@
         "xml",
         "javascript"
       ],
-      "$id": "/schemas/3.1.0/enums/webhook-response-type.json"
+      "$id": "/schemas/3.1.1/enums/webhook-response-type.json"
     },
     "WebhookSecurityMethod": {
       "title": "Webhook Security Method",
@@ -27070,7 +27074,7 @@
         "api_key",
         "none"
       ],
-      "$id": "/schemas/3.1.0/enums/webhook-security-method.json"
+      "$id": "/schemas/3.1.1/enums/webhook-security-method.json"
     },
     "DAASTVersion": {
       "title": "DAAST Version",
@@ -27080,7 +27084,7 @@
         "1.0",
         "1.1"
       ],
-      "$id": "/schemas/3.1.0/enums/daast-version.json"
+      "$id": "/schemas/3.1.1/enums/daast-version.json"
     },
     "DAASTTrackingEvent": {
       "title": "DAAST Tracking Event",
@@ -27111,7 +27115,7 @@
         "measurableImpression",
         "viewableImpression"
       ],
-      "$id": "/schemas/3.1.0/enums/daast-tracking-event.json"
+      "$id": "/schemas/3.1.1/enums/daast-tracking-event.json"
     },
     "MarkdownFlavor": {
       "title": "Markdown Flavor",
@@ -27121,7 +27125,7 @@
         "commonmark",
         "gfm"
       ],
-      "$id": "/schemas/3.1.0/enums/markdown-flavor.json",
+      "$id": "/schemas/3.1.1/enums/markdown-flavor.json",
       "default": "commonmark"
     },
     "AuthenticationScheme": {
@@ -27132,11 +27136,11 @@
         "Bearer",
         "HMAC-SHA256"
       ],
-      "$id": "/schemas/3.1.0/enums/auth-scheme.json"
+      "$id": "/schemas/3.1.1/enums/auth-scheme.json"
     }
   },
   "_bundled": {
-    "generatedAt": "2026-06-18T08:17:00.780Z",
+    "generatedAt": "2026-06-30T19:14:40.160Z",
     "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
   }
 }