@adcp/sdk 9.6.1 → 9.7.0

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

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.0/bundled/media-buy/update-media-buy-request.json",
+  "$id": "/schemas/3.1.1/bundled/media-buy/update-media-buy-request.json",
   "title": "Update Media Buy Request",
   "description": "Request parameters for updating campaign and package settings",
   "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,
@@ -76,7 +76,7 @@
                     "nike",
                     "pampers"
                   ],
-                  "$id": "/schemas/3.1.0/core/brand-id.json"
+                  "$id": "/schemas/3.1.1/core/brand-id.json"
                 },
                 "industries": {
                   "type": "array",
@@ -421,7 +421,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
@@ -637,7 +637,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",
@@ -933,7 +933,7 @@
                         }
                       }
                     ],
-                    "$id": "/schemas/3.1.0/core/catalog-field-mapping.json"
+                    "$id": "/schemas/3.1.1/core/catalog-field-mapping.json"
                   },
                   "minItems": 1
                 }
@@ -1152,7 +1152,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."
@@ -1961,7 +1961,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`.",
@@ -2827,7 +2827,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",
@@ -3233,7 +3233,7 @@
                                     "additionalProperties": true
                                   }
                                 ],
-                                "$id": "/schemas/3.1.0/core/signal-targeting-expression.json"
+                                "$id": "/schemas/3.1.1/core/signal-targeting-expression.json"
                               }
                             ],
                             "properties": {
@@ -3297,11 +3297,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
                         }
@@ -3311,7 +3311,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
                   }
@@ -3321,7 +3321,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",
@@ -3564,7 +3564,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",
@@ -4120,7 +4120,7 @@
                       "additionalProperties": true
                     }
                   ],
-                  "$id": "/schemas/3.1.0/core/signal-targeting.json"
+                  "$id": "/schemas/3.1.1/core/signal-targeting.json"
                 },
                 "minItems": 1
               },
@@ -4271,7 +4271,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",
@@ -4299,7 +4299,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",
@@ -4778,7 +4778,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
                 },
@@ -4795,7 +4795,7 @@
                 "creative_id"
               ],
               "additionalProperties": true,
-              "$id": "/schemas/3.1.0/core/creative-assignment.json"
+              "$id": "/schemas/3.1.1/core/creative-assignment.json"
             }
           },
           "creatives": {
@@ -4860,7 +4860,7 @@
                       "width"
                     ]
                   },
-                  "$id": "/schemas/3.1.0/core/format-id.json"
+                  "$id": "/schemas/3.1.1/core/format-id.json"
                 },
                 "format_kind": {
                   "$ref": "#/$defs/CanonicalFormatKind"
@@ -4924,7 +4924,7 @@
                     }
                   ],
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.0/core/format-option-ref.json"
+                  "$id": "/schemas/3.1.1/core/format-option-ref.json"
                 },
                 "assets": {
                   "type": "object",
@@ -5319,7 +5319,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": {
@@ -5335,12 +5336,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",
@@ -6240,7 +6241,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": {
@@ -9936,7 +9937,7 @@
                                           "role"
                                         ],
                                         "additionalProperties": true,
-                                        "$id": "/schemas/3.1.0/core/reference-asset.json"
+                                        "$id": "/schemas/3.1.1/core/reference-asset.json"
                                       }
                                     },
                                     "compliance": {
@@ -11227,7 +11228,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": {
@@ -11243,12 +11245,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",
@@ -12149,7 +12151,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": {
@@ -14170,7 +14172,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": {
@@ -14186,12 +14189,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",
@@ -15091,7 +15094,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": {
@@ -20077,7 +20080,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": {
@@ -20093,12 +20097,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",
@@ -23133,7 +23137,7 @@
             "description": "Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.",
             "type": "object",
             "additionalProperties": true,
-            "$id": "/schemas/3.1.0/core/context.json"
+            "$id": "/schemas/3.1.1/core/context.json"
           },
           "ext": {
             "title": "Extension Object",
@@ -23395,7 +23399,7 @@
           }
         }
       ],
-      "$id": "/schemas/3.1.0/core/business-entity.json"
+      "$id": "/schemas/3.1.1/core/business-entity.json"
     },
     "new_packages": {
       "type": "array",
@@ -28088,7 +28092,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
@@ -28128,7 +28132,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",
@@ -28685,7 +28689,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",
@@ -28703,7 +28707,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",
@@ -28751,7 +28755,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
@@ -29876,7 +29880,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": {
@@ -29892,12 +29897,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",
@@ -30797,7 +30802,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": {
@@ -35783,7 +35788,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": {
@@ -35799,12 +35805,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",
@@ -38725,7 +38731,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": {
@@ -38741,12 +38748,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",
@@ -39646,7 +39653,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": {
@@ -44632,7 +44639,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": {
@@ -44648,12 +44656,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",
@@ -47886,7 +47894,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",
@@ -47900,7 +47908,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",
@@ -47918,7 +47926,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",
@@ -47932,7 +47940,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",
@@ -47948,7 +47956,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",
@@ -47964,7 +47972,7 @@
         "pre_roll",
         "companion"
       ],
-      "$id": "/schemas/3.1.0/enums/disclosure-position.json"
+      "$id": "/schemas/3.1.1/enums/disclosure-position.json"
     },
     "Pacing": {
       "title": "Pacing",
@@ -47980,7 +47988,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"
     },
     "CatalogType": {
       "title": "Catalog Type",
@@ -48001,7 +48009,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",
@@ -48027,7 +48035,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",
@@ -48039,7 +48047,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",
@@ -48111,7 +48119,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",
@@ -48131,7 +48139,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",
@@ -48153,7 +48161,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"
     },
     "AttributionModel": {
       "title": "Attribution Model",
@@ -48166,7 +48174,7 @@
         "time_decay",
         "data_driven"
       ],
-      "$id": "/schemas/3.1.0/enums/attribution-model.json"
+      "$id": "/schemas/3.1.1/enums/attribution-model.json"
     },
     "MetroAreaSystem": {
       "title": "Metro Area System",
@@ -48179,7 +48187,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",
@@ -48210,7 +48218,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",
@@ -48230,7 +48238,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"
     },
     "DayOfWeek": {
       "title": "Day of Week",
@@ -48245,7 +48253,7 @@
         "saturday",
         "sunday"
       ],
-      "$id": "/schemas/3.1.0/enums/day-of-week.json"
+      "$id": "/schemas/3.1.1/enums/day-of-week.json"
     },
     "AgeVerificationMethod": {
       "title": "Age Verification Method",
@@ -48258,7 +48266,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"
     },
     "DevicePlatform": {
       "title": "Device Platform",
@@ -48278,7 +48286,7 @@
         "roku_os",
         "unknown"
       ],
-      "$id": "/schemas/3.1.0/enums/device-platform.json"
+      "$id": "/schemas/3.1.1/enums/device-platform.json"
     },
     "DeviceType": {
       "title": "Device Type",
@@ -48292,7 +48300,7 @@
         "dooh",
         "unknown"
       ],
-      "$id": "/schemas/3.1.0/enums/device-type.json"
+      "$id": "/schemas/3.1.1/enums/device-type.json"
     },
     "TravelTimeUnit": {
       "title": "Travel Time Unit",
@@ -48306,7 +48314,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"
     },
     "TransportMode": {
       "title": "Transport Mode",
@@ -48324,7 +48332,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"
     },
     "DistanceUnit": {
       "title": "Distance Unit",
@@ -48340,7 +48348,7 @@
         "mi": "Miles",
         "m": "Meters"
       },
-      "$id": "/schemas/3.1.0/enums/distance-unit.json"
+      "$id": "/schemas/3.1.1/enums/distance-unit.json"
     },
     "MatchType": {
       "title": "Match Type",
@@ -48356,7 +48364,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"
     },
     "CanonicalFormatKind": {
       "title": "Canonical Format Kind",
@@ -48377,7 +48385,7 @@
         "agent_placement",
         "custom"
       ],
-      "$id": "/schemas/3.1.0/core/canonical-format-kind.json"
+      "$id": "/schemas/3.1.1/core/canonical-format-kind.json"
     },
     "FrameRateType": {
       "title": "Frame Rate Type",
@@ -48391,7 +48399,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",
@@ -48405,7 +48413,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",
@@ -48419,7 +48427,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",
@@ -48433,7 +48441,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",
@@ -48445,7 +48453,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",
@@ -48458,7 +48466,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",
@@ -48502,7 +48510,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",
@@ -48513,7 +48521,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",
@@ -48524,7 +48532,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",
@@ -48534,7 +48542,7 @@
         "GET",
         "POST"
       ],
-      "$id": "/schemas/3.1.0/enums/http-method.json",
+      "$id": "/schemas/3.1.1/enums/http-method.json",
       "default": "POST"
     },
     "UniversalMacro": {
@@ -48695,7 +48703,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",
@@ -48707,7 +48715,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",
@@ -48718,7 +48726,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",
@@ -48728,7 +48736,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",
@@ -48759,7 +48767,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",
@@ -48769,7 +48777,7 @@
         "commonmark",
         "gfm"
       ],
-      "$id": "/schemas/3.1.0/enums/markdown-flavor.json",
+      "$id": "/schemas/3.1.1/enums/markdown-flavor.json",
       "default": "commonmark"
     },
     "CreativeStatus": {
@@ -48792,7 +48800,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"
     },
     "CreativeIdentifierType": {
       "title": "Creative Identifier Type",
@@ -48816,7 +48824,7 @@
         "clearcast_clock",
         "idcrea"
       ],
-      "$id": "/schemas/3.1.0/enums/creative-identifier-type.json"
+      "$id": "/schemas/3.1.1/enums/creative-identifier-type.json"
     },
     "ViewabilityStandard": {
       "title": "Viewability Standard",
@@ -48830,7 +48838,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",
@@ -48874,7 +48882,7 @@
         "conversion_lift",
         "brand_search_lift"
       ],
-      "$id": "/schemas/3.1.0/enums/available-metric.json"
+      "$id": "/schemas/3.1.1/enums/available-metric.json"
     },
     "AuthenticationScheme": {
       "title": "Authentication Scheme",
@@ -48884,11 +48892,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:01.011Z",
+    "generatedAt": "2026-06-30T19:14:40.348Z",
     "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
   }
 }