Function mediaBuyResponse

Parameters

• data: {
      media_buy_id: string;
      account?: {
          account_id: string;
          name: string;
          advertiser?: string;
          billing_proxy?: string;
          status: AccountStatus;
          brand?: {
              domain: string;
              brand_id?: string;
              industries?: string[];
              data_subject_contestation?: {
                  url?: string;
                  email?: string;
                  languages?: string[];
              };
              brand_kit_override?: {
                  logo?: {
                      asset_type: "image";
                      url: string;
                      width: number;
                      height: number;
                      format?: string;
                      alt_text?: string;
                      provenance?: {
                          digital_source_type?: ...;
                          ai_tool?: ...;
                          human_oversight?: ...;
                          declared_by?: ...;
                          declared_at?: ...;
                          created_time?: ...;
                          c2pa?: ...;
                          embedded_provenance?: ...;
                          watermarks?: ...;
                          disclosure?: ...;
                          verification?: ...;
                          ext?: ...;
                      };
                  };
                  colors?: { primary?: string; secondary?: string; accent?: string };
                  voice?: string;
                  tagline?: string;
              };
          };
          operator?: string;
          billing?: BillingParty;
          billing_entity?: Omit<
              {
                  legal_name: string;
                  vat_id?: string;
                  tax_id?: string;
                  registration_number?: string;
                  address?: {
                      street: string;
                      city: string;
                      postal_code: string;
                      region?: string;
                      country: string;
                  };
                  contacts?: {
                      role: "billing"
                      | "legal"
                      | "creative"
                      | "general";
                      name?: string;
                      email?: string;
                      phone?: string;
                  }[];
                  bank?: {
                      account_holder: string;
                      iban?: string;
                      bic?: string;
                      routing_number?: string;
                      account_number?: string;
                  };
                  ext?: Omit<Omit<{}, "bank">, "authentication"> & {
                      authentication?: unknown;
                  };
              },
              "bank",
          >;
          rate_card?: string;
          payment_terms?: PaymentTerms;
          credit_limit?: { amount: number; currency: string };
          setup?: { url?: string; message: string; expires_at?: string };
          account_scope?: AccountScope;
          governance_agents?: { url: string }[];
          reporting_bucket?: {
              protocol: CloudStorageProtocol;
              bucket: string;
              prefix?: string;
              region?: string;
              format?: "jsonl" | "csv" | "parquet" | "avro" | "orc";
              compression?: "gzip" | "none";
              file_retention_days: number;
              setup_instructions?: string;
          };
          sandbox?: boolean;
          notification_configs?: (
              Omit<
                  {
                      subscriber_id: string;
                      url: string;
                      event_types: NotificationType[];
                      authentication?: { schemes: (...)[]; credentials?: (...) | (...) };
                      active?: boolean;
                      ext?: Omit<(...), (...)> & { authentication?: ... };
                  },
                  "authentication",
              > & {
                  authentication?: Omit<
                      { schemes: (...)[]; credentials?: (...) | (...) },
                      "credentials",
                  >;
              }
          )[];
          ext?: Omit<Omit<{}, "bank">, "authentication"> & {
              authentication?: unknown;
          };
      };
      invoice_recipient?: Omit<
          {
              legal_name: string;
              vat_id?: string;
              tax_id?: string;
              registration_number?: string;
              address?: {
                  street: string;
                  city: string;
                  postal_code: string;
                  region?: string;
                  country: string;
              };
              contacts?: {
                  role: "billing"
                  | "legal"
                  | "creative"
                  | "general";
                  name?: string;
                  email?: string;
                  phone?: string;
              }[];
              bank?: {
                  account_holder: string;
                  iban?: string;
                  bic?: string;
                  routing_number?: string;
                  account_number?: string;
              };
              ext?: Omit<Omit<{}, "bank">, "authentication"> & {
                  authentication?: unknown;
              };
          },
          "bank",
      >;
      media_buy_status?: MediaBuyStatus;
      status?: MediaBuyStatus;
      confirmed_at?: string
      | null;
      creative_deadline?: string;
      revision?: number;
      currency?: string;
      total_budget?: number;
      valid_actions?: MediaBuyValidAction[];
      available_actions?: {
          action: MediaBuyValidAction;
          mode: MediaBuyActionMode;
          sla?: { response_max?: string; completion_max?: string };
          terms_ref?: string;
      }[];
      packages: {
          package_id: string;
          product_id?: string;
          budget?: number;
          pacing?: Pacing;
          pricing_option_id?: string;
          bid_price?: number;
          price_breakdown?: {
              list_price: number;
              adjustments: (
                  Omit<Omit<{ [key: string]: unknown }, "bank">, "authentication"> & {
                      authentication?: unknown;
                  }
              )[];
          };
          impressions?: number;
          catalogs?: {
              catalog_id?: string;
              name?: string;
              type: CatalogType;
              url?: string;
              feed_format?: FeedFormat;
              update_frequency?: UpdateFrequency;
              items?: (
                  Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  }
              )[];
              ids?: string[];
              gtins?: string[];
              tags?: string[];
              category?: string;
              query?: string;
              conversion_events?: EventType[];
              content_id_type?: ContentIDType;
              feed_field_mappings?: {
                  feed_field?: string;
                  catalog_field?: string;
                  asset_group_id?: string;
                  value?: unknown;
                  transform?: "boolean"
                  | "date"
                  | "divide"
                  | "split";
                  format?: string;
                  timezone?: string;
                  by?: number;
                  separator?: string;
                  default?: unknown;
                  ext?: (...) & (...);
              }[];
          }[];
          format_ids?: {
              agent_url: string;
              id: string;
              width?: number;
              height?: number;
              duration_ms?: number;
          }[];
          format_option_refs?: (
              | {
                  scope: "publisher";
                  publisher_domain: string;
                  format_option_id: string;
              }
              | {
                  scope: "product";
                  format_option_id: string;
                  publisher_domain?: undefined;
              }
          )[];
          format_kind?: CanonicalFormatKind;
          params?: Omit<Omit<{}, "bank">, "authentication"> & {
              authentication?: unknown;
          };
          targeting_overlay?: {
              geo_countries?: string[];
              geo_countries_exclude?: string[];
              geo_regions?: string[];
              geo_regions_exclude?: string[];
              geo_metros?: { system: MetroAreaSystem; values: string[] }[];
              geo_metros_exclude?: { system: MetroAreaSystem; values: string[] }[];
              geo_postal_areas?: (
                  | { country: string; system: PostalCodeSystem; values: string[] }
                  | { system: LegacyPostalCodeSystem; values: string[] }
              )[];
              geo_postal_areas_exclude?: (
                  | { country: string; system: PostalCodeSystem; values: string[] }
                  | { system: LegacyPostalCodeSystem; values: string[] }
              )[];
              daypart_targets?: {
                  days: DayOfWeek[];
                  start_hour: number;
                  end_hour: number;
                  label?: string;
              }[];
              axe_include_segment?: string;
              axe_exclude_segment?: string;
              audience_include?: string[];
              audience_exclude?: string[];
              signal_targeting_groups?: {
                  operator: "all";
                  groups: {
                      operator: "none"
                      | "any";
                      signals: {
                          pricing_option_id?: ...;
                          signal_agent_segment_id?: ...;
                          activation_key?: ...;
                      }[];
                  }[];
              };
              signal_targeting?: (
                  | {
                      signal_ref?: | { scope: ...; signal_id: ... }
                      | { scope: ...; data_provider_domain: ...; signal_id: ... }
                      | { scope: ...; signal_source_url: ...; signal_id: ... };
                      signal_id?:
                          | { source: ...; data_provider_domain: ...; id: ... }
                          | { source: ...; agent_url: ...; id: ... };
                      value_type: "binary";
                      value: boolean;
                  }
                  | {
                      signal_ref?: | { scope: ...; signal_id: ... }
                      | { scope: ...; data_provider_domain: ...; signal_id: ... }
                      | { scope: ...; signal_source_url: ...; signal_id: ... };
                      signal_id?:
                          | { source: ...; data_provider_domain: ...; id: ... }
                          | { source: ...; agent_url: ...; id: ... };
                      value_type: "categorical";
                      values: string[];
                  }
                  | {
                      signal_ref?: | { scope: ...; signal_id: ... }
                      | { scope: ...; data_provider_domain: ...; signal_id: ... }
                      | { scope: ...; signal_source_url: ...; signal_id: ... };
                      signal_id?:
                          | { source: ...; data_provider_domain: ...; id: ... }
                          | { source: ...; agent_url: ...; id: ... };
                      value_type: "numeric";
                      min_value?: number;
                      max_value?: number;
                  }
              )[];
              frequency_cap?: {
                  suppress?: {
                      interval: number;
                      unit: "seconds"
                      | "minutes"
                      | "hours"
                      | "days"
                      | "campaign";
                  };
                  suppress_minutes?: number;
                  max_impressions?: number;
                  per?: ReachUnit;
                  window?: {
                      interval: number;
                      unit: "seconds"
                      | "minutes"
                      | "hours"
                      | "days"
                      | "campaign";
                  };
              };
              property_list?: {
                  agent_url: string;
                  list_id: string;
                  auth_token?: string;
              };
              collection_list?: {
                  agent_url: string;
                  list_id: string;
                  auth_token?: string;
              };
              collection_list_exclude?: {
                  agent_url: string;
                  list_id: string;
                  auth_token?: string;
              };
              age_restriction?: {
                  min: number;
                  verification_required?: boolean;
                  accepted_methods?: AgeVerificationMethod[];
              };
              device_platform?: DevicePlatform[];
              device_type?: DeviceType[];
              device_type_exclude?: DeviceType[];
              store_catchments?: {
                  catalog_id: string;
                  store_ids?: string[];
                  catchment_ids?: string[];
              }[];
              geo_proximity?: (
                  | {
                      lat: number;
                      lng: number;
                      label?: string;
                      travel_time: { value: number; unit: TravelTimeUnit };
                      transport_mode: TransportMode;
                      ext?: (...) & (...);
                  }
                  | {
                      lat: number;
                      lng: number;
                      label?: string;
                      transport_mode?: TransportMode;
                      radius: { value: number; unit: DistanceUnit };
                      ext?: (...) & (...);
                  }
                  | {
                      lat?: number;
                      lng?: number;
                      label?: string;
                      transport_mode?: TransportMode;
                      geometry: { type: (...)
                      | (...); coordinates: (...)[] };
                      ext?: (...) & (...);
                  }
              )[];
              language?: string[];
              keyword_targets?: {
                  keyword: string;
                  match_type: MatchType;
                  bid_price?: number;
              }[];
              negative_keywords?: { keyword: string; match_type: MatchType }[];
          };
          measurement_terms?: {
              billing_measurement?: {
                  vendor: {
                      domain: string;
                      brand_id?: string;
                      industries?: string[];
                      data_subject_contestation?: {
                          url?: (...)
                          | (...);
                          email?: (...) | (...);
                          languages?: (...) | (...);
                      };
                      brand_kit_override?: {
                          logo?: (...)
                          | (...);
                          colors?: (...) | (...);
                          voice?: (...) | (...);
                          tagline?: (...) | (...);
                      };
                  };
                  max_variance_percent?: number;
                  measurement_window?: string;
                  finalization_deadline_hours?: number;
              };
              makegood_policy?: { available_remedies: MakegoodRemedy[] };
          };
          performance_standards?: {
              metric: PerformanceStandardMetric;
              threshold: number;
              standard?: ViewabilityStandard;
              vendor: {
                  domain: string;
                  brand_id?: string;
                  industries?: string[];
                  data_subject_contestation?: {
                      url?: string;
                      email?: string;
                      languages?: (...)[];
                  };
                  brand_kit_override?: {
                      logo?: {
                          asset_type: ...;
                          url: ...;
                          width: ...;
                          height: ...;
                          format?: ...;
                          alt_text?: ...;
                          provenance?: ...;
                      };
                      colors?: { primary?: ...; secondary?: ...; accent?: ... };
                      voice?: string;
                      tagline?: string;
                  };
              };
          }[];
          committed_metrics?: (
              | {
                  scope: "standard";
                  metric_id: AvailableMetric;
                  qualifier?: {
                      viewability_standard?: ViewabilityStandard;
                      completion_source?: CompletionSource;
                      attribution_methodology?: AttributionMethodology;
                      attribution_window?: { interval: ...; unit: ... };
                      lift_dimension?: LiftDimension;
                  };
                  committed_at: string;
              }
              | {
                  scope: "vendor";
                  vendor: {
                      domain: string;
                      brand_id?: string;
                      industries?: string[];
                      data_subject_contestation?: {
                          url?: (...)
                          | (...);
                          email?: (...) | (...);
                          languages?: (...) | (...);
                      };
                      brand_kit_override?: {
                          logo?: (...)
                          | (...);
                          colors?: (...) | (...);
                          voice?: (...) | (...);
                          tagline?: (...) | (...);
                      };
                  };
                  metric_id: string;
                  committed_at: string;
              }
          )[];
          creative_assignments?: {
              creative_id: string;
              weight?: number;
              placement_refs?: { publisher_domain?: string; placement_id: string }[];
              placement_ids?: string[];
          }[];
          format_ids_to_provide?: {
              agent_url: string;
              id: string;
              width?: number;
              height?: number;
              duration_ms?: number;
          }[];
          optimization_goals?: (
              | {
                  kind: "metric";
                  metric: | "attention_score"
                  | "clicks"
                  | "views"
                  | "completed_views"
                  | "reach"
                  | "engagements"
                  | "follows"
                  | "saves"
                  | "profile_visits"
                  | "viewed_seconds"
                  | "attention_seconds";
                  reach_unit?: ReachUnit;
                  target_frequency?: {
                      min?: number;
                      max?: number;
                      window: {
                          interval: number;
                          unit: (...)
                          | (...)
                          | (...)
                          | (...)
                          | (...);
                      };
                  };
                  view_duration_seconds?: number;
                  target?: | { kind: "cost_per"; value: number }
                  | { kind: "threshold_rate"; value: number };
                  priority?: number;
              }
              | {
                  kind: "event";
                  event_sources: {
                      event_source_id: string;
                      event_type: EventType;
                      custom_event_name?: string;
                      value_field?: string;
                      value_factor?: number;
                  }[];
                  target?: | { kind: "cost_per"; value: number }
                  | { kind: "per_ad_spend"; value: number }
                  | { kind: "maximize_value" };
                  attribution_window?: {
                      post_click?: { interval: ...; unit: ... };
                      post_view?: { interval: ...; unit: ... };
                      model?: AttributionModel;
                  };
                  priority?: number;
              }
              | {
                  kind: "vendor_metric";
                  vendor: {
                      domain: string;
                      brand_id?: string;
                      industries?: string[];
                      data_subject_contestation?: {
                          url?: (...)
                          | (...);
                          email?: (...) | (...);
                          languages?: (...) | (...);
                      };
                      brand_kit_override?: {
                          logo?: (...)
                          | (...);
                          colors?: (...) | (...);
                          voice?: (...) | (...);
                          tagline?: (...) | (...);
                      };
                  };
                  metric_id: string;
                  target?: | { kind: "cost_per"; value: number }
                  | { kind: "threshold_rate"; value: number };
                  priority?: number;
              }
          )[];
          start_time?: string;
          end_time?: string;
          paused?: boolean;
          canceled?: boolean;
          cancellation?: {
              canceled_at: string;
              canceled_by: CanceledBy;
              reason?: string;
              acknowledged_at?: string;
          };
          agency_estimate_number?: string;
          creative_deadline?: string;
          context?: Omit<Omit<{}, "bank">, "authentication"> & {
              authentication?: unknown;
          };
          ext?: Omit<Omit<{}, "bank">, "authentication"> & {
              authentication?: unknown;
          };
      }[];
      planned_delivery?: {
          geo?: { countries?: string[]; regions?: string[] };
          channels?: MediaChannel[];
          start_time?: string;
          end_time?: string;
          frequency_cap?: {
              suppress?: {
                  interval: number;
                  unit: "seconds" | "minutes" | "hours" | "days" | "campaign";
              };
              suppress_minutes?: number;
              max_impressions?: number;
              per?: ReachUnit;
              window?: {
                  interval: number;
                  unit: "seconds"
                  | "minutes"
                  | "hours"
                  | "days"
                  | "campaign";
              };
          };
          audience_summary?: string;
          audience_targeting?: (
              | {
                  type: "signal";
                  signal_ref?: | { scope: "product"; signal_id: string }
                  | {
                      scope: "data_provider";
                      data_provider_domain: string;
                      signal_id: string;
                  }
                  | {
                      scope: "signal_source";
                      signal_source_url: string;
                      signal_id: string;
                  };
                  signal_id?: | {
                      source: "catalog";
                      data_provider_domain: string;
                      id: string;
                  }
                  | { source: "agent"; agent_url: string; id: string };
                  value_type: "binary";
                  value: boolean;
              }
              | {
                  type: "signal";
                  signal_ref?: | { scope: "product"; signal_id: string }
                  | {
                      scope: "data_provider";
                      data_provider_domain: string;
                      signal_id: string;
                  }
                  | {
                      scope: "signal_source";
                      signal_source_url: string;
                      signal_id: string;
                  };
                  signal_id?: | {
                      source: "catalog";
                      data_provider_domain: string;
                      id: string;
                  }
                  | { source: "agent"; agent_url: string; id: string };
                  value_type: "categorical";
                  values: string[];
              }
              | {
                  type: "signal";
                  signal_ref?: | { scope: "product"; signal_id: string }
                  | {
                      scope: "data_provider";
                      data_provider_domain: string;
                      signal_id: string;
                  }
                  | {
                      scope: "signal_source";
                      signal_source_url: string;
                      signal_id: string;
                  };
                  signal_id?: | {
                      source: "catalog";
                      data_provider_domain: string;
                      id: string;
                  }
                  | { source: "agent"; agent_url: string; id: string };
                  value_type: "numeric";
                  min_value?: number;
                  max_value?: number;
              }
              | { type: "description"; description: string; category?: string }
          )[];
          total_budget?: number;
          currency?: string;
          enforced_policies?: string[];
          ext?: Omit<Omit<{}, "bank">, "authentication"> & {
              authentication?: unknown;
          };
      };
      sandbox?: boolean;
      context?: Omit<Omit<{}, "bank">, "authentication"> & {
          authentication?: unknown;
      };
      ext?: Omit<Omit<{}, "bank">, "authentication"> & {
          authentication?: unknown;
      };
  }

  • media_buy_id: string

    Seller's unique identifier for the created media buy

  • Optionalaccount?: {
        account_id: string;
        name: string;
        advertiser?: string;
        billing_proxy?: string;
        status: AccountStatus;
        brand?: {
            domain: string;
            brand_id?: string;
            industries?: string[];
            data_subject_contestation?: {
                url?: string;
                email?: string;
                languages?: string[];
            };
            brand_kit_override?: {
                logo?: {
                    asset_type: "image";
                    url: string;
                    width: number;
                    height: number;
                    format?: string;
                    alt_text?: string;
                    provenance?: {
                        digital_source_type?: ...;
                        ai_tool?: ...;
                        human_oversight?: ...;
                        declared_by?: ...;
                        declared_at?: ...;
                        created_time?: ...;
                        c2pa?: ...;
                        embedded_provenance?: ...;
                        watermarks?: ...;
                        disclosure?: ...;
                        verification?: ...;
                        ext?: ...;
                    };
                };
                colors?: { primary?: string; secondary?: string; accent?: string };
                voice?: string;
                tagline?: string;
            };
        };
        operator?: string;
        billing?: BillingParty;
        billing_entity?: Omit<
            {
                legal_name: string;
                vat_id?: string;
                tax_id?: string;
                registration_number?: string;
                address?: {
                    street: string;
                    city: string;
                    postal_code: string;
                    region?: string;
                    country: string;
                };
                contacts?: {
                    role: "billing"
                    | "legal"
                    | "creative"
                    | "general";
                    name?: string;
                    email?: string;
                    phone?: string;
                }[];
                bank?: {
                    account_holder: string;
                    iban?: string;
                    bic?: string;
                    routing_number?: string;
                    account_number?: string;
                };
                ext?: Omit<Omit<{}, "bank">, "authentication"> & {
                    authentication?: unknown;
                };
            },
            "bank",
        >;
        rate_card?: string;
        payment_terms?: PaymentTerms;
        credit_limit?: { amount: number; currency: string };
        setup?: { url?: string; message: string; expires_at?: string };
        account_scope?: AccountScope;
        governance_agents?: { url: string }[];
        reporting_bucket?: {
            protocol: CloudStorageProtocol;
            bucket: string;
            prefix?: string;
            region?: string;
            format?: "jsonl" | "csv" | "parquet" | "avro" | "orc";
            compression?: "gzip" | "none";
            file_retention_days: number;
            setup_instructions?: string;
        };
        sandbox?: boolean;
        notification_configs?: (
            Omit<
                {
                    subscriber_id: string;
                    url: string;
                    event_types: NotificationType[];
                    authentication?: { schemes: (...)[]; credentials?: (...) | (...) };
                    active?: boolean;
                    ext?: Omit<(...), (...)> & { authentication?: ... };
                },
                "authentication",
            > & {
                authentication?: Omit<
                    { schemes: (...)[]; credentials?: (...) | (...) },
                    "credentials",
                >;
            }
        )[];
        ext?: Omit<Omit<{}, "bank">, "authentication"> & {
            authentication?: unknown;
        };
    }

    • account_id: string

      Unique identifier for this account

    • name: string

      Human-readable account name (e.g., 'Acme', 'Acme c/o Pinnacle')

    • Optionaladvertiser?: string

      The advertiser whose rates apply to this account

    • Optionalbilling_proxy?: string

      Optional intermediary who receives invoices on behalf of the advertiser (e.g., agency)

    • status: AccountStatus

    • Optionalbrand?: {
          domain: string;
          brand_id?: string;
          industries?: string[];
          data_subject_contestation?: {
              url?: string;
              email?: string;
              languages?: string[];
          };
          brand_kit_override?: {
              logo?: {
                  asset_type: "image";
                  url: string;
                  width: number;
                  height: number;
                  format?: string;
                  alt_text?: string;
                  provenance?: {
                      digital_source_type?: ...;
                      ai_tool?: ...;
                      human_oversight?: ...;
                      declared_by?: ...;
                      declared_at?: ...;
                      created_time?: ...;
                      c2pa?: ...;
                      embedded_provenance?: ...;
                      watermarks?: ...;
                      disclosure?: ...;
                      verification?: ...;
                      ext?: ...;
                  };
              };
              colors?: { primary?: string; secondary?: string; accent?: string };
              voice?: string;
              tagline?: string;
          };
      }

      • domain: string

        Domain where /.well-known/brand.json is hosted, or the brand's operating domain

        Pattern

        ^a-z0-9?(.a-z0-9?)*$

      • Optionalbrand_id?: string

      • Optionalindustries?: string[]

        Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json.

      • Optionaldata_subject_contestation?: { url?: string; email?: string; languages?: string[] }

        Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand → house → missing.

        • Optionalurl?: string

          Pattern

          ^https://

        • Optionalemail?: string

          Format

          email

        • Optionallanguages?: string[]

      • Optionalbrand_kit_override?: {
            logo?: {
                asset_type: "image";
                url: string;
                width: number;
                height: number;
                format?: string;
                alt_text?: string;
                provenance?: {
                    digital_source_type?: ...;
                    ai_tool?: ...;
                    human_oversight?: ...;
                    declared_by?: ...;
                    declared_at?: ...;
                    created_time?: ...;
                    c2pa?: ...;
                    embedded_provenance?: ...;
                    watermarks?: ...;
                    disclosure?: ...;
                    verification?: ...;
                    ext?: ...;
                };
            };
            colors?: { primary?: string; secondary?: string; accent?: string };
            voice?: string;
            tagline?: string;
        }

        Inline override for brand-kit fields normally resolved from /.well-known/brand.json on domain (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call — e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as industries and data_subject_contestation above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (voice_attributes, prohibited_terms, etc.) MUST publish a different brand.json and reference it via a different domain — the inline override is intentionally narrow to a small high-traffic subset.

        Merge semantics (normative). The merge is field-level, not whole-object replacement. Each field within brand_kit_override (logo, colors, voice, tagline) is evaluated independently — when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (colors.primary, colors.secondary, colors.accent), the merge is one level deeper: each color slot is evaluated independently — a producer can override colors.primary while still inheriting colors.secondary from brand.json. SDKs MUST NOT treat a present brand_kit_override.colors as wiping the brand.json colors block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.

        • Optionallogo?: {
              asset_type: "image";
              url: string;
              width: number;
              height: number;
              format?: string;
              alt_text?: string;
              provenance?: {
                  digital_source_type?: ...;
                  ai_tool?: ...;
                  human_oversight?: ...;
                  declared_by?: ...;
                  declared_at?: ...;
                  created_time?: ...;
                  c2pa?: ...;
                  embedded_provenance?: ...;
                  watermarks?: ...;
                  disclosure?: ...;
                  verification?: ...;
                  ext?: ...;
              };
          }

          • asset_type: "image"

            Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry.

          • url: string

            URL to the image asset

          • width: number

            Width in pixels

            Minimum

            1

          • height: number

            Height in pixels

            Minimum

            1

          • Optionalformat?: string

            Image file format (jpg, png, gif, webp, etc.)

          • Optionalalt_text?: string

            Alternative text for accessibility

          • Optionalprovenance?: {
                digital_source_type?: ...;
                ai_tool?: ...;
                human_oversight?: ...;
                declared_by?: ...;
                declared_at?: ...;
                created_time?: ...;
                c2pa?: ...;
                embedded_provenance?: ...;
                watermarks?: ...;
                disclosure?: ...;
                verification?: ...;
                ext?: ...;
            }

            • Optionaldigital_source_type?: ...

            • Optionalai_tool?: ...

              AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.

            • Optionalhuman_oversight?: ...

              Level of human involvement in the AI-assisted creation process. Independent of disclosure.required — the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting edited or directed does not by itself justify disclosure.required: false.

            • Optionaldeclared_by?: ...

              Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.

            • Optionaldeclared_at?: ...

              When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance.

              Format

              date-time

            • Optionalcreated_time?: ...

              When this content was created or generated (ISO 8601)

              Format

              date-time

            • Optionalc2pa?: ...

              C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.

            • Optionalembedded_provenance?: ...

              Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in creative_policy.accepted_verifiers).

            • Optionalwatermarks?: ...

              Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in creative_policy.accepted_verifiers).

            • Optionaldisclosure?: ...

              Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.

            • Optionalverification?: ...

              Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.

            • Optionalext?: ...

        • Optionalcolors?: { primary?: string; secondary?: string; accent?: string }

          Override brand colors (hex strings).

          • Optionalprimary?: string

            Pattern

            ^#[0-9a-fA-F]{6}$

          • Optionalsecondary?: string

            Pattern

            ^#[0-9a-fA-F]{6}$

          • Optionalaccent?: string

            Pattern

            ^#[0-9a-fA-F]{6}$

        • Optionalvoice?: string

          Override brand-voice description for surface-composed text/audio output.

        • Optionaltagline?: string

          Override tagline.

    • Optionaloperator?: string

      Domain of the entity operating this account. When the brand operates directly, this is the brand's domain.

      Pattern

      ^a-z0-9?(.a-z0-9?)*$

    • Optionalbilling?: BillingParty

    • Optionalbilling_entity?: Omit<
          {
              legal_name: string;
              vat_id?: string;
              tax_id?: string;
              registration_number?: string;
              address?: {
                  street: string;
                  city: string;
                  postal_code: string;
                  region?: string;
                  country: string;
              };
              contacts?: {
                  role: "billing"
                  | "legal"
                  | "creative"
                  | "general";
                  name?: string;
                  email?: string;
                  phone?: string;
              }[];
              bank?: {
                  account_holder: string;
                  iban?: string;
                  bic?: string;
                  routing_number?: string;
                  account_number?: string;
              };
              ext?: Omit<Omit<{}, "bank">, "authentication"> & {
                  authentication?: unknown;
              };
          },
          "bank",
      >

    • Optionalrate_card?: string

      Identifier for the rate card applied to this account

    • Optionalpayment_terms?: PaymentTerms

    • Optionalcredit_limit?: { amount: number; currency: string }

      Maximum outstanding balance allowed

      • amount: number

        Minimum

        0

      • currency: string

        Pattern

        ^[A-Z]{3}$

    • Optionalsetup?: { url?: string; message: string; expires_at?: string }

      Present when status is 'pending_approval'. Contains next steps for completing account activation.

      • Optionalurl?: string

        URL where the human can complete the required action (credit application, legal agreement, add funds).

      • message: string

        Human-readable description of what's needed.

      • Optionalexpires_at?: string

        When this setup link expires.

        Format

        date-time

    • Optionalaccount_scope?: AccountScope

    • Optionalgovernance_agents?: { url: string }[]

      Governance agent endpoint registered on this account. Exactly one entry per sync_governance's one-agent-per-account invariant. The array shape is preserved for wire compatibility with 3.0; maxItems: 1 is load-bearing and mirrors the singular governance_context on the protocol envelope. Authentication credentials are write-only and not included in responses — use sync_governance to set or update credentials.

    • Optionalreporting_bucket?: {
          protocol: CloudStorageProtocol;
          bucket: string;
          prefix?: string;
          region?: string;
          format?: "jsonl" | "csv" | "parquet" | "avro" | "orc";
          compression?: "gzip" | "none";
          file_retention_days: number;
          setup_instructions?: string;
      }

      Cloud storage bucket where the seller delivers offline reporting files for this account. Seller provisions a dedicated bucket or a per-account prefix within a shared bucket, and grants the buyer read access out-of-band. Access MUST be scoped at the IAM layer so each account can only read its own prefix — bucket-wide grants are non-compliant even with per-account prefixes. Seller MUST revoke access when the account's status transitions to inactive, suspended, or closed. See security considerations for offline delivery in docs/media-buy/media-buys/optimization-reporting. Only present when the seller supports offline delivery (reporting_delivery_methods includes 'offline' in capabilities).

      • protocol: CloudStorageProtocol

      • bucket: string

        Bucket or container name

        Min Length

        3

        Max Length

        63

        Pattern

        ^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$

      • Optionalprefix?: string

        Path prefix within the bucket. Seller appends date-based partitioning beneath this prefix.

        Max Length

        512

        Pattern

        ^[a-zA-Z0-9/_.-]+$

      • Optionalregion?: string

        Cloud region for the bucket

        Max Length

        64

        Pattern

        ^[a-z0-9-]+$

      • Optionalformat?: "jsonl" | "csv" | "parquet" | "avro" | "orc"

        File format for delivered files. Parquet, Avro, and ORC use internal compression (the top-level compression field is ignored for these formats).

      • Optionalcompression?: "gzip" | "none"

        Compression applied to delivered files

      • file_retention_days: number

        How long reporting files are retained in the bucket before deletion. Buyers must read files within this window. Minimum recommended: 14 days.

        Minimum

        1

      • Optionalsetup_instructions?: string

        URL to documentation for configuring buyer read access to this bucket (IAM role, service account, etc.). Operator-facing documentation — buyer agents MUST NOT auto-fetch this URL; surface it to a human operator. If an implementation fetches it (for preview), apply webhook URL SSRF validation and do not pass the fetched content into an LLM context without indirect-prompt-injection guarding. See docs/media-buy/media-buys/optimization-reporting#security-considerations-for-offline-delivery.

        Pattern

        ^https://

    • Optionalsandbox?: boolean

      When true, this is a sandbox account — no real platform calls, no real spend. For account-id namespaces, sandbox accounts are pre-existing test accounts on the platform discovered via list_accounts or supplied out-of-band. For buyer-declared accounts, sandbox is part of the natural key: the same brand/operator pair can have both a production and sandbox account.

    • Optionalnotification_configs?: (
          Omit<
              {
                  subscriber_id: string;
                  url: string;
                  event_types: NotificationType[];
                  authentication?: { schemes: (...)[]; credentials?: (...) | (...) };
                  active?: boolean;
                  ext?: Omit<(...), (...)> & { authentication?: ... };
              },
              "authentication",
          > & {
              authentication?: Omit<
                  { schemes: (...)[]; credentials?: (...) | (...) },
                  "credentials",
              >;
          }
      )[]

      Account-level webhook subscriptions for notifications whose lifecycle outlives any single media buy (e.g., creative.status_changed, creative.purged, wholesale feed change payloads). This is an account-scoped delivery surface, not an account-object lifecycle event stream; account status changes are observed through list_accounts polling or the one-shot sync_accounts.push_notification_config async result channel. Distinct from push_notification_config on individual operations, which anchors at a per-resource scope. Buyers register and update entries via sync_accounts; sellers echo the applied state here on list_accounts reads so buyers can verify what's active. The set is keyed by account-scoped subscriber_id; re-registering the same subscriber_id replaces that subscriber's config. authentication.credentials is write-only — sellers MUST NOT echo legacy auth credentials in this response. When two or more entries register the same event_types, each receives an independent fire — see #3009 multi-subscriber composition.

    • Optionalext?: Omit<Omit<{}, "bank">, "authentication"> & { authentication?: unknown }

  • Optionalinvoice_recipient?: Omit<
        {
            legal_name: string;
            vat_id?: string;
            tax_id?: string;
            registration_number?: string;
            address?: {
                street: string;
                city: string;
                postal_code: string;
                region?: string;
                country: string;
            };
            contacts?: {
                role: "billing"
                | "legal"
                | "creative"
                | "general";
                name?: string;
                email?: string;
                phone?: string;
            }[];
            bank?: {
                account_holder: string;
                iban?: string;
                bic?: string;
                routing_number?: string;
                account_number?: string;
            };
            ext?: Omit<Omit<{}, "bank">, "authentication"> & {
                authentication?: unknown;
            };
        },
        "bank",
    >

  • Optionalmedia_buy_status?: MediaBuyStatus

  • Optionalstatus?: MediaBuyStatus

  • Optionalconfirmed_at?: string | null

    ISO 8601 timestamp when this media buy was committed by the seller. Stable after it is set; do not update on later pause/resume/status/reporting transitions. May be null in deferred or manual-approval flows until seller commitment occurs.

    Format

    date-time

  • Optionalcreative_deadline?: string

    ISO 8601 timestamp for creative upload deadline

    Format

    date-time

  • Optionalrevision?: number

    Initial revision number for this media buy. Use in subsequent update_media_buy requests intended to change state for optimistic concurrency.

    Minimum

    1

  • Optionalcurrency?: string

    ISO 4217 currency code (e.g., USD, EUR, GBP) for monetary values at this media buy level. total_budget is denominated in this currency. Package-level fields may override with package.currency. In proposal mode the seller derives this from the request's total_budget object (total_budget.currency); in manual mode it is present when all packages share a currency. Matches the currency field in subsequent get_media_buys responses.

    Pattern

    ^[A-Z]{3}$

  • Optionaltotal_budget?: number

    Total budget amount across all packages, denominated in currency. Note: the create_media_buy request encodes total_budget as an object {amount, currency} (proposal mode only); this response field is the flattened scalar amount, with currency promoted to the sibling currency field. Present when the seller can compute a deterministic aggregate — always in proposal mode, conditionally in manual mode when all packages share a currency. Matches the total_budget field in subsequent get_media_buys responses.

    Minimum

    0

  • Optionalvalid_actions?: MediaBuyValidAction[]

    Flat-vocabulary actions the buyer can perform on this media buy after creation. Saves a round-trip to get_media_buys. Deprecated in favor of available_actions[], which carries mode, optional SLA, and optional terms_ref. Sellers SHOULD populate both during the 3.x deprecation window; consumers MUST prefer available_actions[] when both are present. Removed in 4.0.

  • Optionalavailable_actions?: {
        action: MediaBuyValidAction;
        mode: MediaBuyActionMode;
        sla?: { response_max?: string; completion_max?: string };
        terms_ref?: string;
    }[]

    Structured per-buy resolution of actions available immediately after creation. Authoritative — see get-media-buys-response.json for full semantics.

  • packages: {
        package_id: string;
        product_id?: string;
        budget?: number;
        pacing?: Pacing;
        pricing_option_id?: string;
        bid_price?: number;
        price_breakdown?: {
            list_price: number;
            adjustments: (
                Omit<Omit<{ [key: string]: unknown }, "bank">, "authentication"> & {
                    authentication?: unknown;
                }
            )[];
        };
        impressions?: number;
        catalogs?: {
            catalog_id?: string;
            name?: string;
            type: CatalogType;
            url?: string;
            feed_format?: FeedFormat;
            update_frequency?: UpdateFrequency;
            items?: (
                Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                }
            )[];
            ids?: string[];
            gtins?: string[];
            tags?: string[];
            category?: string;
            query?: string;
            conversion_events?: EventType[];
            content_id_type?: ContentIDType;
            feed_field_mappings?: {
                feed_field?: string;
                catalog_field?: string;
                asset_group_id?: string;
                value?: unknown;
                transform?: "boolean"
                | "date"
                | "divide"
                | "split";
                format?: string;
                timezone?: string;
                by?: number;
                separator?: string;
                default?: unknown;
                ext?: (...) & (...);
            }[];
        }[];
        format_ids?: {
            agent_url: string;
            id: string;
            width?: number;
            height?: number;
            duration_ms?: number;
        }[];
        format_option_refs?: (
            | {
                scope: "publisher";
                publisher_domain: string;
                format_option_id: string;
            }
            | {
                scope: "product";
                format_option_id: string;
                publisher_domain?: undefined;
            }
        )[];
        format_kind?: CanonicalFormatKind;
        params?: Omit<Omit<{}, "bank">, "authentication"> & {
            authentication?: unknown;
        };
        targeting_overlay?: {
            geo_countries?: string[];
            geo_countries_exclude?: string[];
            geo_regions?: string[];
            geo_regions_exclude?: string[];
            geo_metros?: { system: MetroAreaSystem; values: string[] }[];
            geo_metros_exclude?: { system: MetroAreaSystem; values: string[] }[];
            geo_postal_areas?: (
                | { country: string; system: PostalCodeSystem; values: string[] }
                | { system: LegacyPostalCodeSystem; values: string[] }
            )[];
            geo_postal_areas_exclude?: (
                | { country: string; system: PostalCodeSystem; values: string[] }
                | { system: LegacyPostalCodeSystem; values: string[] }
            )[];
            daypart_targets?: {
                days: DayOfWeek[];
                start_hour: number;
                end_hour: number;
                label?: string;
            }[];
            axe_include_segment?: string;
            axe_exclude_segment?: string;
            audience_include?: string[];
            audience_exclude?: string[];
            signal_targeting_groups?: {
                operator: "all";
                groups: {
                    operator: "none"
                    | "any";
                    signals: {
                        pricing_option_id?: ...;
                        signal_agent_segment_id?: ...;
                        activation_key?: ...;
                    }[];
                }[];
            };
            signal_targeting?: (
                | {
                    signal_ref?: | { scope: ...; signal_id: ... }
                    | { scope: ...; data_provider_domain: ...; signal_id: ... }
                    | { scope: ...; signal_source_url: ...; signal_id: ... };
                    signal_id?:
                        | { source: ...; data_provider_domain: ...; id: ... }
                        | { source: ...; agent_url: ...; id: ... };
                    value_type: "binary";
                    value: boolean;
                }
                | {
                    signal_ref?: | { scope: ...; signal_id: ... }
                    | { scope: ...; data_provider_domain: ...; signal_id: ... }
                    | { scope: ...; signal_source_url: ...; signal_id: ... };
                    signal_id?:
                        | { source: ...; data_provider_domain: ...; id: ... }
                        | { source: ...; agent_url: ...; id: ... };
                    value_type: "categorical";
                    values: string[];
                }
                | {
                    signal_ref?: | { scope: ...; signal_id: ... }
                    | { scope: ...; data_provider_domain: ...; signal_id: ... }
                    | { scope: ...; signal_source_url: ...; signal_id: ... };
                    signal_id?:
                        | { source: ...; data_provider_domain: ...; id: ... }
                        | { source: ...; agent_url: ...; id: ... };
                    value_type: "numeric";
                    min_value?: number;
                    max_value?: number;
                }
            )[];
            frequency_cap?: {
                suppress?: {
                    interval: number;
                    unit: "seconds"
                    | "minutes"
                    | "hours"
                    | "days"
                    | "campaign";
                };
                suppress_minutes?: number;
                max_impressions?: number;
                per?: ReachUnit;
                window?: {
                    interval: number;
                    unit: "seconds"
                    | "minutes"
                    | "hours"
                    | "days"
                    | "campaign";
                };
            };
            property_list?: {
                agent_url: string;
                list_id: string;
                auth_token?: string;
            };
            collection_list?: {
                agent_url: string;
                list_id: string;
                auth_token?: string;
            };
            collection_list_exclude?: {
                agent_url: string;
                list_id: string;
                auth_token?: string;
            };
            age_restriction?: {
                min: number;
                verification_required?: boolean;
                accepted_methods?: AgeVerificationMethod[];
            };
            device_platform?: DevicePlatform[];
            device_type?: DeviceType[];
            device_type_exclude?: DeviceType[];
            store_catchments?: {
                catalog_id: string;
                store_ids?: string[];
                catchment_ids?: string[];
            }[];
            geo_proximity?: (
                | {
                    lat: number;
                    lng: number;
                    label?: string;
                    travel_time: { value: number; unit: TravelTimeUnit };
                    transport_mode: TransportMode;
                    ext?: (...) & (...);
                }
                | {
                    lat: number;
                    lng: number;
                    label?: string;
                    transport_mode?: TransportMode;
                    radius: { value: number; unit: DistanceUnit };
                    ext?: (...) & (...);
                }
                | {
                    lat?: number;
                    lng?: number;
                    label?: string;
                    transport_mode?: TransportMode;
                    geometry: { type: (...)
                    | (...); coordinates: (...)[] };
                    ext?: (...) & (...);
                }
            )[];
            language?: string[];
            keyword_targets?: {
                keyword: string;
                match_type: MatchType;
                bid_price?: number;
            }[];
            negative_keywords?: { keyword: string; match_type: MatchType }[];
        };
        measurement_terms?: {
            billing_measurement?: {
                vendor: {
                    domain: string;
                    brand_id?: string;
                    industries?: string[];
                    data_subject_contestation?: {
                        url?: (...)
                        | (...);
                        email?: (...) | (...);
                        languages?: (...) | (...);
                    };
                    brand_kit_override?: {
                        logo?: (...)
                        | (...);
                        colors?: (...) | (...);
                        voice?: (...) | (...);
                        tagline?: (...) | (...);
                    };
                };
                max_variance_percent?: number;
                measurement_window?: string;
                finalization_deadline_hours?: number;
            };
            makegood_policy?: { available_remedies: MakegoodRemedy[] };
        };
        performance_standards?: {
            metric: PerformanceStandardMetric;
            threshold: number;
            standard?: ViewabilityStandard;
            vendor: {
                domain: string;
                brand_id?: string;
                industries?: string[];
                data_subject_contestation?: {
                    url?: string;
                    email?: string;
                    languages?: (...)[];
                };
                brand_kit_override?: {
                    logo?: {
                        asset_type: ...;
                        url: ...;
                        width: ...;
                        height: ...;
                        format?: ...;
                        alt_text?: ...;
                        provenance?: ...;
                    };
                    colors?: { primary?: ...; secondary?: ...; accent?: ... };
                    voice?: string;
                    tagline?: string;
                };
            };
        }[];
        committed_metrics?: (
            | {
                scope: "standard";
                metric_id: AvailableMetric;
                qualifier?: {
                    viewability_standard?: ViewabilityStandard;
                    completion_source?: CompletionSource;
                    attribution_methodology?: AttributionMethodology;
                    attribution_window?: { interval: ...; unit: ... };
                    lift_dimension?: LiftDimension;
                };
                committed_at: string;
            }
            | {
                scope: "vendor";
                vendor: {
                    domain: string;
                    brand_id?: string;
                    industries?: string[];
                    data_subject_contestation?: {
                        url?: (...)
                        | (...);
                        email?: (...) | (...);
                        languages?: (...) | (...);
                    };
                    brand_kit_override?: {
                        logo?: (...)
                        | (...);
                        colors?: (...) | (...);
                        voice?: (...) | (...);
                        tagline?: (...) | (...);
                    };
                };
                metric_id: string;
                committed_at: string;
            }
        )[];
        creative_assignments?: {
            creative_id: string;
            weight?: number;
            placement_refs?: { publisher_domain?: string; placement_id: string }[];
            placement_ids?: string[];
        }[];
        format_ids_to_provide?: {
            agent_url: string;
            id: string;
            width?: number;
            height?: number;
            duration_ms?: number;
        }[];
        optimization_goals?: (
            | {
                kind: "metric";
                metric: | "attention_score"
                | "clicks"
                | "views"
                | "completed_views"
                | "reach"
                | "engagements"
                | "follows"
                | "saves"
                | "profile_visits"
                | "viewed_seconds"
                | "attention_seconds";
                reach_unit?: ReachUnit;
                target_frequency?: {
                    min?: number;
                    max?: number;
                    window: {
                        interval: number;
                        unit: (...)
                        | (...)
                        | (...)
                        | (...)
                        | (...);
                    };
                };
                view_duration_seconds?: number;
                target?: | { kind: "cost_per"; value: number }
                | { kind: "threshold_rate"; value: number };
                priority?: number;
            }
            | {
                kind: "event";
                event_sources: {
                    event_source_id: string;
                    event_type: EventType;
                    custom_event_name?: string;
                    value_field?: string;
                    value_factor?: number;
                }[];
                target?: | { kind: "cost_per"; value: number }
                | { kind: "per_ad_spend"; value: number }
                | { kind: "maximize_value" };
                attribution_window?: {
                    post_click?: { interval: ...; unit: ... };
                    post_view?: { interval: ...; unit: ... };
                    model?: AttributionModel;
                };
                priority?: number;
            }
            | {
                kind: "vendor_metric";
                vendor: {
                    domain: string;
                    brand_id?: string;
                    industries?: string[];
                    data_subject_contestation?: {
                        url?: (...)
                        | (...);
                        email?: (...) | (...);
                        languages?: (...) | (...);
                    };
                    brand_kit_override?: {
                        logo?: (...)
                        | (...);
                        colors?: (...) | (...);
                        voice?: (...) | (...);
                        tagline?: (...) | (...);
                    };
                };
                metric_id: string;
                target?: | { kind: "cost_per"; value: number }
                | { kind: "threshold_rate"; value: number };
                priority?: number;
            }
        )[];
        start_time?: string;
        end_time?: string;
        paused?: boolean;
        canceled?: boolean;
        cancellation?: {
            canceled_at: string;
            canceled_by: CanceledBy;
            reason?: string;
            acknowledged_at?: string;
        };
        agency_estimate_number?: string;
        creative_deadline?: string;
        context?: Omit<Omit<{}, "bank">, "authentication"> & {
            authentication?: unknown;
        };
        ext?: Omit<Omit<{}, "bank">, "authentication"> & {
            authentication?: unknown;
        };
    }[]

    Array of created packages with complete state information

  • Optionalplanned_delivery?: {
        geo?: { countries?: string[]; regions?: string[] };
        channels?: MediaChannel[];
        start_time?: string;
        end_time?: string;
        frequency_cap?: {
            suppress?: {
                interval: number;
                unit: "seconds" | "minutes" | "hours" | "days" | "campaign";
            };
            suppress_minutes?: number;
            max_impressions?: number;
            per?: ReachUnit;
            window?: {
                interval: number;
                unit: "seconds"
                | "minutes"
                | "hours"
                | "days"
                | "campaign";
            };
        };
        audience_summary?: string;
        audience_targeting?: (
            | {
                type: "signal";
                signal_ref?: | { scope: "product"; signal_id: string }
                | {
                    scope: "data_provider";
                    data_provider_domain: string;
                    signal_id: string;
                }
                | {
                    scope: "signal_source";
                    signal_source_url: string;
                    signal_id: string;
                };
                signal_id?: | {
                    source: "catalog";
                    data_provider_domain: string;
                    id: string;
                }
                | { source: "agent"; agent_url: string; id: string };
                value_type: "binary";
                value: boolean;
            }
            | {
                type: "signal";
                signal_ref?: | { scope: "product"; signal_id: string }
                | {
                    scope: "data_provider";
                    data_provider_domain: string;
                    signal_id: string;
                }
                | {
                    scope: "signal_source";
                    signal_source_url: string;
                    signal_id: string;
                };
                signal_id?: | {
                    source: "catalog";
                    data_provider_domain: string;
                    id: string;
                }
                | { source: "agent"; agent_url: string; id: string };
                value_type: "categorical";
                values: string[];
            }
            | {
                type: "signal";
                signal_ref?: | { scope: "product"; signal_id: string }
                | {
                    scope: "data_provider";
                    data_provider_domain: string;
                    signal_id: string;
                }
                | {
                    scope: "signal_source";
                    signal_source_url: string;
                    signal_id: string;
                };
                signal_id?: | {
                    source: "catalog";
                    data_provider_domain: string;
                    id: string;
                }
                | { source: "agent"; agent_url: string; id: string };
                value_type: "numeric";
                min_value?: number;
                max_value?: number;
            }
            | { type: "description"; description: string; category?: string }
        )[];
        total_budget?: number;
        currency?: string;
        enforced_policies?: string[];
        ext?: Omit<Omit<{}, "bank">, "authentication"> & {
            authentication?: unknown;
        };
    }

    • Optionalgeo?: { countries?: string[]; regions?: string[] }

      Geographic targeting the seller will apply.

      • Optionalcountries?: string[]

        ISO 3166-1 alpha-2 country codes where ads will deliver.

      • Optionalregions?: string[]

        ISO 3166-2 subdivision codes where ads will deliver.

    • Optionalchannels?: MediaChannel[]

      Channels the seller will deliver on.

    • Optionalstart_time?: string

      Actual flight start the seller will use.

      Format

      date-time

    • Optionalend_time?: string

      Actual flight end the seller will use.

      Format

      date-time

    • Optionalfrequency_cap?: {
          suppress?: {
              interval: number;
              unit: "seconds" | "minutes" | "hours" | "days" | "campaign";
          };
          suppress_minutes?: number;
          max_impressions?: number;
          per?: ReachUnit;
          window?: {
              interval: number;
              unit: "seconds"
              | "minutes"
              | "hours"
              | "days"
              | "campaign";
          };
      }

      • Optionalsuppress?: {
            interval: number;
            unit: "seconds" | "minutes" | "hours" | "days" | "campaign";
        }

        Cooldown period between consecutive exposures to the same entity. Prevents back-to-back ad delivery (e.g. {"interval": 60, "unit": "minutes"} for a 1-hour cooldown). Preferred over suppress_minutes.

        • interval: number

          Number of time units. Must be 1 when unit is 'campaign'.

          Minimum

          1

        • unit: "seconds" | "minutes" | "hours" | "days" | "campaign"

          Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight.

      • Optionalsuppress_minutes?: number

        Deprecated — use suppress instead. Cooldown period in minutes between consecutive exposures to the same entity (e.g. 60 for a 1-hour cooldown).

        Minimum

        0

      • Optionalmax_impressions?: number

        Maximum number of impressions per entity per window. For duration windows, implementations typically use a rolling window; 'campaign' applies a fixed cap across the full flight.

        Minimum

        1

      • Optionalper?: ReachUnit

        Entity granularity for impression counting. Required when max_impressions is set.

      • Optionalwindow?: {
            interval: number;
            unit: "seconds" | "minutes" | "hours" | "days" | "campaign";
        }

        Time window for the max_impressions cap (e.g. {"interval": 7, "unit": "days"} or {"interval": 1, "unit": "campaign"} for the full flight). Required when max_impressions is set.

        • interval: number

          Number of time units. Must be 1 when unit is 'campaign'.

          Minimum

          1

        • unit: "seconds" | "minutes" | "hours" | "days" | "campaign"

          Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight.

    • Optionalaudience_summary?: string

      Human-readable summary of the audience the seller will target.

    • Optionalaudience_targeting?: (
          | {
              type: "signal";
              signal_ref?: | { scope: "product"; signal_id: string }
              | {
                  scope: "data_provider";
                  data_provider_domain: string;
                  signal_id: string;
              }
              | { scope: "signal_source"; signal_source_url: string; signal_id: string };
              signal_id?:
                  | { source: "catalog"; data_provider_domain: string; id: string }
                  | { source: "agent"; agent_url: string; id: string };
              value_type: "binary";
              value: boolean;
          }
          | {
              type: "signal";
              signal_ref?: | { scope: "product"; signal_id: string }
              | {
                  scope: "data_provider";
                  data_provider_domain: string;
                  signal_id: string;
              }
              | { scope: "signal_source"; signal_source_url: string; signal_id: string };
              signal_id?:
                  | { source: "catalog"; data_provider_domain: string; id: string }
                  | { source: "agent"; agent_url: string; id: string };
              value_type: "categorical";
              values: string[];
          }
          | {
              type: "signal";
              signal_ref?: | { scope: "product"; signal_id: string }
              | {
                  scope: "data_provider";
                  data_provider_domain: string;
                  signal_id: string;
              }
              | { scope: "signal_source"; signal_source_url: string; signal_id: string };
              signal_id?:
                  | { source: "catalog"; data_provider_domain: string; id: string }
                  | { source: "agent"; agent_url: string; id: string };
              value_type: "numeric";
              min_value?: number;
              max_value?: number;
          }
          | { type: "description"; description: string; category?: string }
      )[]

      Structured audience targeting the seller will activate. Each entry is either a signal reference or a descriptive criterion. When present, governance agents MUST use this for bias/fairness validation and SHOULD ignore audience_summary for validation purposes. The audience_summary field is a human-readable rendering of this array, not an independent declaration.

    • Optionaltotal_budget?: number

      Total budget the seller will deliver against.

      Minimum

      0

    • Optionalcurrency?: string

      ISO 4217 currency code for the budget.

      Pattern

      ^[A-Z]{3}$

    • Optionalenforced_policies?: string[]

      Registry policy IDs the seller will enforce for this delivery.

    • Optionalext?: Omit<Omit<{}, "bank">, "authentication"> & { authentication?: unknown }

  • Optionalsandbox?: boolean

    When true, this response contains simulated data from sandbox mode.

  • Optionalcontext?: Omit<Omit<{}, "bank">, "authentication"> & { authentication?: unknown }

  • Optionalext?: Omit<Omit<{}, "bank">, "authentication"> & { authentication?: unknown }

• Optionalsummary: string