# AdCP Explorer — Ad Context Protocol 3.1.13 — full text corpus > Every request and response field of all 64 operations in Ad Context Protocol release 3.1.13, grouped by protocol area. Generated 2026-08-13. 10 documents. --- # AdCP Media Buy Source: https://adcpexplorer.com/areas/media-buy/ Media buy task request/response schemas ## create_media_buy create_media_buy task — create advertising campaigns in AdCP from discovered products. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - idempotency_key (string) [required]: Client-generated unique key for this request. - plan_id (string): Campaign governance plan identifier. - account (account-ref) [required]: Account to bill for this media buy. - proposal_id (string): ID of a committed proposal from get_products to execute. - total_budget (object): Total budget for the media buy when executing a proposal. - packages (package-request[]): Array of package configurations. - brand (brand-ref) [required]: Brand reference for this media buy. - advertiser_industry (advertiser-industry): Industry classification for this specific campaign. - invoice_recipient (business-entity): Override the account's default billing entity for this specific buy. - io_acceptance (object): Acceptance of an insertion order from a committed proposal. - po_number (string): Purchase order number for tracking - agency_estimate_number (string): Agency estimate or authorization number. - start_time (start-timing) [required]: Campaign start timing: 'asap' or ISO 8601 date-time - end_time (string) [required]: Campaign end date/time in ISO 8601 format - paused (boolean): Create the media buy in a paused delivery state. - push_notification_config (push-notification-config): Optional webhook configuration for async task status notifications. - reporting_webhook (reporting-webhook): Optional webhook configuration for automated reporting delivery - artifact_webhook (object): Optional webhook configuration for content artifact delivery. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/media-buy/create-media-buy-request.json @ a0fd0b5f ## get_media_buy_delivery get_media_buy_delivery task — retrieve impressions, spend, pacing, and dimensional breakdowns for active AdCP campaigns. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Filter delivery data to a specific account. - media_buy_ids (string[]): Array of media buy IDs to get delivery data for - status_filter (one of several): Filter by status. - start_date (string): Start date for reporting period (YYYY-MM-DD). - end_date (string): End date for reporting period (YYYY-MM-DD). - include_package_daily_breakdown (boolean): When true, include daily_breakdown arrays within each package in by_package. - time_granularity (reporting-frequency): Per-window slice granularity for the pull, using the same vocabulary as reporting_webhook.reporting_frequency. - include_window_breakdown (boolean): When true, the response includes media_buy_deliveries[].windows[] — an array of per-window delivery slices over the date range at the requested time_granularity. - attribution_window (object): Attribution window to apply for conversion metrics. - reporting_dimensions (object): Request dimensional breakdowns in delivery reporting. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - notification_type (string): Type of webhook notification (only present in webhook deliveries): scheduled = regular periodic update, final = campaign completed, delayed = data not yet available, adjusted = resending period with corrected data (same… - partial_data (boolean): Indicates if any media buys in this webhook have missing/delayed data (only present in webhook deliveries) - unavailable_count (integer): Number of media buys with reporting_delayed or failed status (only present in webhook deliveries when partial_data is true) - sequence_number (integer): Sequential notification number (only present in webhook deliveries, starts at 1) - next_expected_at (string): ISO 8601 timestamp for next expected notification (only present in webhook deliveries when notification_type is not 'final') - reporting_period (object) [required]: Date range for the report. - currency (string) [required]: ISO 4217 currency code - attribution_window (attribution-window): Attribution methodology and lookback windows used for conversion metrics in this response. - aggregated_totals (object): Combined metrics across all returned media buys. - media_buy_deliveries (object[]) [required]: Array of delivery data for media buys. - errors (error[]): Task-specific errors and warnings (e.g., missing delivery data, reporting platform issues) - sandbox (boolean): When true, this response contains simulated data from sandbox mode. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/media-buy/get-media-buy-delivery-request.json @ a0fd0b5f ## get_media_buys get_media_buys task — retrieve media buy status in AdCP including creative approvals, missing assets, configuration, and optional near-real-time delivery snapshots. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Account to retrieve media buys for. - media_buy_ids (string[]): Array of media buy IDs to retrieve. - status_filter (one of several): Filter by status. - include_snapshot (boolean): When true, include a near-real-time delivery snapshot for each package. - include_history (integer): When present, include the last N revision history entries for each media buy (returns min(N, available entries)). - include_webhook_activity (boolean): When true, each returned media buy includes a `webhook_activity` array describing recent delivery-report webhook fires for the calling principal. - webhook_activity_limit (integer): Maximum number of webhook delivery records to return per media buy, ordered most-recent first. - pagination (pagination-request): Cursor-based pagination controls. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - media_buys (object[]) [required]: Array of media buys with status, creative approval state, and optional delivery snapshots - errors (error[]): Task-specific errors (e.g., media buy not found) - pagination (pagination-response): Pagination metadata for the media_buys array. - sandbox (boolean): When true, this response contains simulated data from sandbox mode. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/media-buy/get-media-buys-request.json @ a0fd0b5f ## get_products get_products task — discover advertising inventory in AdCP using natural language campaign briefs or structured filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - buying_mode (string) [required]: Declares buyer intent for this request. - brief (string): Natural language description of campaign requirements. - refine (object[]): Array of change requests for iterating on products and proposals from a previous get_products response. - brand (brand-ref): Brand reference for product discovery context. - catalog (catalog): Catalog of items the buyer wants to promote. - account (account-ref): Account for product lookup. - preferred_delivery_types (delivery-type[]): Delivery types the buyer prefers, in priority order. - filters (product-filters): Structured filters for product discovery - property_list (property-list-ref): [AdCP 3.0] Reference to an externally managed property list. - fields (string[]): Specific product fields to include in the response. - time_budget (object): Maximum time the buyer will commit to this request. - push_notification_config (push-notification-config): Optional webhook configuration for async terminal completion/failure notifications on curated discovery. - pagination (pagination-request): Cursor-based pagination controls for get_products. - if_wholesale_feed_version (string): Opaque wholesale_feed_version token returned by a prior wholesale-mode get_products response from this agent. - if_pricing_version (string): Opaque pricing_version token from a prior get_products response. - context (context): Opaque correlation data that is echoed unchanged in responses. - required_policies (string[]): Registry policy IDs that the buyer requires to be enforced for products in this response. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - products (product[]): Array of matching products - extensions (object): Bundled platform-extension definitions referenced by any product in `products`. - proposals (proposal[]): Optional array of proposed media plans with budget allocations across products. - errors (error[]): Task-specific errors and warnings (e.g., product filtering issues) - property_list_applied (boolean): [AdCP 3.0] Indicates whether property_list filtering was applied. - catalog_applied (boolean): Whether the seller filtered results based on the provided catalog. - refinement_applied (object[]): Seller's response to each change request in the refine array, matched by position. - incomplete (object[]): Declares what the seller could not finish within the buyer's time_budget or due to internal limits. - filter_diagnostics (object): Optional non-fatal diagnostic block describing how the request's `filters` narrowed the candidate set. - pagination (pagination-response): Cursor metadata for paginated get_products responses. - wholesale_feed_version (string): Opaque token representing the version of the wholesale product feed state used to compose this response. - pricing_version (string): Opaque token representing the version of the pricing layer, including product pricing_options and nested signal_targeting_options pricing_options. - cache_scope (string): Declares whether the wholesale_feed_version and pricing_version on this response describe a universal layer or an account-specific overlay. - unchanged (boolean): Present and `true` ONLY on wholesale-mode responses when the request carried if_wholesale_feed_version (and/or if_pricing_version) matching the seller's current version for the buyer's cache_scope, in which case product… - sandbox (boolean): When true, this response contains simulated data from sandbox mode. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/media-buy/get-products-request.json @ a0fd0b5f ## list_creative_formats Request parameters for discovering supported creative formats Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - format_ids (format-id[]): Return only these specific format IDs (e.g., from get_products response) - asset_types (asset-content-type[]): Filter to formats that include these asset types. - max_width (integer): Maximum width in pixels (inclusive). - max_height (integer): Maximum height in pixels (inclusive). - min_width (integer): Minimum width in pixels (inclusive). - min_height (integer): Minimum height in pixels (inclusive). - is_responsive (boolean): Filter for responsive formats that adapt to container size. - name_search (string): Search for formats by name (case-insensitive partial match) - publisher_domain (string): Filter to formats supported by the named publisher. - property_id (property-id): Filter to formats supported on the named property within the publisher's catalog. - wcag_level (wcag-level): Filter to formats that meet at least this WCAG conformance level (A < AA < AAA) - disclosure_positions (disclosure-position[]): Filter to formats that support all of these disclosure positions. - disclosure_persistence (disclosure-persistence[]): Filter to formats where each requested persistence mode is supported by at least one position in disclosure_capabilities. - output_format_ids (format-id[]): Filter to formats whose output_format_ids includes any of these format IDs. - input_format_ids (format-id[]): Filter to formats whose input_format_ids includes any of these format IDs. - pagination (pagination-request): Standard cursor-based pagination parameters for list operations - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - formats (format[]) [required]: Full format definitions for all formats this agent supports. - source (string): Which tier of the resolution order produced this `formats[]` list when the request carried a `publisher_domain` filter. - creative_agents (object[]): Optional: Creative agents that provide additional formats. - errors (error[]): Task-specific errors and warnings (e.g., format availability issues) - pagination (pagination-response): Standard cursor-based pagination metadata for list responses - sandbox (boolean): When true, this response contains simulated data from sandbox mode. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/media-buy/list-creative-formats-request.json @ a0fd0b5f ## log_event log_event task — send conversion and marketing events to AdCP sellers in batches. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - event_source_id (string) [required]: Event source configured on the account via sync_event_sources - test_event_code (string): Test event code for validation without affecting production data. - events (event[]) [required]: Events to log - idempotency_key (string) [required]: Client-generated unique key for this request. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/media-buy/log-event-request.json @ a0fd0b5f ## provide_performance_feedback provide_performance_feedback task — share normalized performance scores with AdCP publishers so sellers can optimize delivery based on buyer-observed outcomes. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - media_buy_id (string) [required]: Seller's media buy identifier - idempotency_key (string) [required]: Client-generated unique key for this request. - measurement_period (datetime-range) [required]: Time period for performance measurement - performance_index (number) [required]: Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected) - package_id (string): Specific package within the media buy (if feedback is package-specific) - creative_id (string): Specific creative asset (if feedback is creative-specific) - metric_type (metric-type): The business metric being measured - feedback_source (feedback-source): Source of the performance data - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/media-buy/provide-performance-feedback-request.json @ a0fd0b5f ## sync_audiences sync_audiences task — upload hashed first-party CRM audiences to AdCP seller accounts for retargeting, suppression, and lookalike expansion. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. - account (account-ref) [required]: Account to manage audiences for. - audiences (object[]): Audiences to sync (create or update). - delete_missing (boolean): When true, buyer-managed audiences on the account not included in this sync will be removed. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/media-buy/sync-audiences-request.json @ a0fd0b5f ## sync_catalogs sync_catalogs task — sync product feeds, store locations, and vertical catalogs (hotel, flight, vehicle, real estate) to AdCP seller accounts for catalog-driven campaigns. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. - account (account-ref) [required]: Account that owns these catalogs. - catalogs (catalog[]): Array of catalog feeds to sync (create or update). - catalog_ids (string[]): Optional filter to limit sync scope to specific catalog IDs. - delete_missing (boolean): When true, buyer-managed catalogs on the account not included in this sync will be removed. - dry_run (boolean): When true, preview changes without applying them. - validation_mode (validation-mode): Validation strictness. - push_notification_config (push-notification-config): Optional webhook configuration for async sync notifications. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/media-buy/sync-catalogs-request.json @ a0fd0b5f ## sync_event_sources sync_event_sources task — configure website pixels, mobile SDKs, server-to-server integrations, and seller- or platform-native event sources on AdCP seller accounts for conversion tracking and attribution. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. - account (account-ref) [required]: Account to configure event sources for. - event_sources (object[]): Event sources to sync (create or update). - delete_missing (boolean): When true, event sources not included in this sync will be removed - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/media-buy/sync-event-sources-request.json @ a0fd0b5f ## update_media_buy update_media_buy task — modify active AdCP campaigns with PATCH semantics. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref) [required]: Account that owns this media buy. - media_buy_id (string) [required]: Seller's ID of the media buy to update - revision (integer): Expected current revision for optimistic concurrency. - paused (boolean): Pause/resume the entire media buy (true = paused, false = active) - canceled (boolean): Cancel the entire media buy. - cancellation_reason (string): Reason for cancellation. - start_time (start-timing): Campaign start timing: 'asap' or ISO 8601 date-time - end_time (string): New end date/time in ISO 8601 format - packages (package-update[]): Package-specific updates for existing packages - invoice_recipient (business-entity): Update who receives the invoice for this buy. - new_packages (package-request[]): New packages to add to this media buy. - reporting_webhook (reporting-webhook): Optional webhook configuration for automated reporting delivery. - push_notification_config (push-notification-config): Optional webhook configuration for async update notifications. - idempotency_key (string) [required]: Client-generated idempotency key for safe retries. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/media-buy/update-media-buy-request.json @ a0fd0b5f --- # AdCP Creative Source: https://adcpexplorer.com/areas/creative/ Creative protocol task request/response schemas and asset type definitions ## build_creative build_creative generates, transforms, or retrieves ad creative manifests in AdCP from a natural language brief to production-ready assets. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - message (string): Natural language instructions for the transformation or generation. - creative_manifest (creative-manifest): Creative manifest to transform or generate from. - creative_id (string): Reference to a creative in the agent's library. - concept_id (string): Creative concept containing the creative. - media_buy_id (string): Media buy identifier for tag generation context. - package_id (string): Package identifier within the media buy. - target_format_id (format-id): Single format ID to generate. - target_format_ids (format-id[]): Array of format IDs to generate in a single call. - transformer_id (string): Selects an account-scoped transformer (discovered via list_transformers) to perform the build. - config (object): Typed render configuration for the selected transformer, keyed by each param's `field` (from the transformer's params[] in list_transformers). - refine_from_build_variant_id (string): Refine a previously produced variant: re-build from the referenced `build_variant_id`, applying the natural-language instruction in `message` and any `config` delta, and return NEW lineage-linked variant(s) — each with… - mode (string): `execute` (default) produces and bills the creative(s). - max_spend (object): Hard per-call spend ceiling. - max_creatives (integer): Caps how many DISTINCT creatives to produce along the catalog/item fan-out axis — one creative per catalog item. - signal_conditions (any[]): Advisory keep-all PRODUCTION axis: produce one distinct creative group per signal condition, each kept and trafficked with its own signal targeting (e.g. - max_variants (integer): Caps how many ALTERNATIVES to produce per creative (different voices, themes, best-of-N, etc.). - variant_axis (object): Declares the dimension along which variants differ. - keep_mode (string): Advisory hint for how the buyer intends to use the variants. - selection_strategy (creative-selection-strategy): Governs HOW the agent samples when max_creatives < items_total (folds #5262). - account (account-ref): Account reference for pricing and billing. - brand (brand-ref): Brand reference for creative generation. - quality (creative-quality): Quality tier for generation. - evaluator (evaluator-spec): Optional advisory evaluator (buyer-attached pointer, #5280) declaring how produced variants should be evaluated and ranked — the rank-side of the get_creative_features feature oracle. - item_limit (integer): Maximum number of catalog items a SINGLE creative consumes when generating (DCO-style — e.g. - include_preview (boolean): When true, requests the creative agent to include preview renders in the response alongside the manifest. - preview_inputs (object[]): Input sets for preview generation when include_preview is true. - preview_quality (creative-quality): Render quality for inline preview when include_preview is true. - preview_output_format (preview-output-format): Output format for preview renders when include_preview is true. - macro_values (object): Macro values to pre-substitute into the output manifest's assets. - idempotency_key (string) [required]: Client-generated unique key for this request. - push_notification_config (push-notification-config): Optional webhook configuration for async terminal completion/failure notifications on build_creative. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/media-buy/build-creative-request.json @ a0fd0b5f ## get_creative_delivery get_creative_delivery retrieves variant-level delivery data with manifests and performance metrics for generative and static creatives in AdCP. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Account for routing and scoping. - media_buy_ids (string[]): Filter to specific media buys by publisher ID. - creative_ids (string[]): Filter to specific creatives by ID. - start_date (string): Start date for delivery period (YYYY-MM-DD). - end_date (string): End date for delivery period (YYYY-MM-DD). - max_variants (integer): Maximum number of variants to return per creative. - pagination (pagination-request): Pagination parameters for the creatives array in the response. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - account_id (string): Account identifier. - media_buy_id (string): Publisher's media buy identifier. - currency (string) [required]: ISO 4217 currency code for monetary values in this response (e.g., 'USD', 'EUR') - reporting_period (object) [required]: Date range for the report. - creatives (object[]) [required]: Creative delivery data with variant breakdowns - pagination (object): Pagination information. - errors (error[]): Task-specific errors and warnings - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/creative/get-creative-delivery-request.json @ a0fd0b5f ## list_creative_formats Request parameters for discovering creative formats provided by this creative agent Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - format_ids (format-id[]): Return only these specific format IDs - type (string): Filter by format type (technical categories with distinct requirements) - asset_types (asset-content-type[]): Filter to formats that include these asset types. - max_width (integer): Maximum width in pixels (inclusive). - max_height (integer): Maximum height in pixels (inclusive). - min_width (integer): Minimum width in pixels (inclusive). - min_height (integer): Minimum height in pixels (inclusive). - is_responsive (boolean): Filter for responsive formats that adapt to container size. - name_search (string): Search for formats by name (case-insensitive partial match) - wcag_level (wcag-level): Filter to formats that meet at least this WCAG conformance level (A < AA < AAA) - disclosure_positions (disclosure-position[]): Filter to formats that support all of these disclosure positions. - disclosure_persistence (disclosure-persistence[]): Filter to formats where each requested persistence mode is supported by at least one position in disclosure_capabilities. - output_format_ids (format-id[]): **DEPRECATED in 3.1.** Discover build capability via `list_transformers` (filter its `output_format_ids`) instead — build capability is a property of transformers, not a relationship between formats. - input_format_ids (format-id[]): **DEPRECATED in 3.1.** Discover build capability via `list_transformers` (filter its `input_format_ids`) instead. - include_pricing (boolean): Include pricing_options on each format. - account (account-ref): Account reference for pricing. - pagination (pagination-request): Standard cursor-based pagination parameters for list operations - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - formats (format[]) [required]: Full format definitions for all formats this agent supports. - creative_agents (object[]): Optional: Creative agents that provide additional formats. - errors (error[]): Task-specific errors and warnings - pagination (pagination-response): Standard cursor-based pagination metadata for list responses - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/creative/list-creative-formats-request.json @ a0fd0b5f ## list_creatives list_creatives browses and filters creatives in an AdCP library by asset type, format, status, concept, and tags with cursor-based pagination. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - filters (creative-filters): Filter criteria for querying creatives from a creative library. - sort (object): Sorting parameters - pagination (pagination-request): Standard cursor-based pagination parameters for list operations - include_assignments (boolean): Include package assignment information in response - include_snapshot (boolean): Include a lightweight delivery snapshot per creative (lifetime impressions and last-served date). - include_items (boolean): Include items for multi-asset formats like carousels and native ads - include_variables (boolean): Include dynamic content variable definitions (DCO slots) for each creative - include_pricing (boolean): Include pricing_options on each creative. - include_purged (boolean): Include soft-purged creative tombstones in the result set. - include_webhook_activity (boolean): Include recent webhook activity per creative. - webhook_activity_limit (integer): Maximum number of `webhook_activity[]` records to return per creative. - account (account-ref): Account reference for pricing and access. - fields (string[]): Specific fields to include in response (omit for all fields). - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - query_summary (object) [required]: Summary of the query that was executed - pagination (pagination-response) [required]: Standard cursor-based pagination metadata for list responses - creatives (object[]) [required]: Array of creative assets matching the query - format_summary (object): Breakdown of creatives by format. - status_summary (object): Breakdown of creatives by status - errors (error[]): Task-specific errors (e.g., invalid filters, account not found) - sandbox (boolean): When true, this response contains simulated data from sandbox mode. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/creative/list-creatives-request.json @ a0fd0b5f ## list_transformers list_transformers discovers account-scoped creative transformers — the agent-offered, selectable units of build capability (voices, models, styles) used by build_creative. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - transformer_ids (string[]): Return only these specific transformer IDs. - input_format_ids (format-id[]): Filter to transformers that accept any of these formats as input. - output_format_ids (format-id[]): Filter to transformers that can produce any of these output formats. - name_search (string): Search transformers by name (case-insensitive partial match). - brief (string): Natural-language brief used to rank and filter transformers (and their enumerable option values when expanded) — e.g. - expand_params (string[]): Param `field` names for which to return the FIRST page of account-scoped option VALUES inline on each transformer's `params[].options[]`. - expand_pagination (object[]): Fetch the NEXT page of a specific param's account-scoped options, using the `options_cursor` a prior response returned for that `(transformer, param)`. - include_pricing (boolean): Include `pricing_options` on each transformer. - account (account-ref): Account reference. - pagination (pagination-request): Standard cursor-based pagination parameters for list operations - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - transformers (transformer[]) [required]: Transformer descriptors matching the query. - errors (error[]): Task-specific errors and warnings. - pagination (pagination-response): Standard cursor-based pagination metadata for list responses - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/creative/list-transformers-request.json @ a0fd0b5f ## preview_creative preview_creative renders an existing creative manifest into viewable output in AdCP, in single or batch mode, returning URL, image, or HTML output. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - request_type (string) [required]: Preview mode. - creative_manifest (creative-manifest): Complete creative manifest with all required assets for the format. - format_id (format-id): Always a structured object {agent_url, id} — never a plain string. - inputs (object[]): Array of input sets for generating multiple preview variants. - template_id (string): Specific template ID for custom format rendering. - quality (creative-quality): Render quality. - output_format (preview-output-format): Output format. - item_limit (integer): Maximum number of catalog items to render per preview variant. - requests (object[]): Array of preview requests (1-50 items). - variant_id (string): Platform-assigned variant identifier from get_creative_delivery response. - creative_id (string): Creative identifier for context. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/creative/preview-creative-request.json @ a0fd0b5f ## sync_creatives sync_creatives uploads and manages creative assets in an AdCP library with bulk uploads, upsert semantics, and generative creative support. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref) [required]: Account that owns these creatives. - creatives (creative-asset[]) [required]: Array of creative assets to sync (create or update) - creative_ids (string[]): Optional filter to limit sync scope to specific creative IDs. - assignments (object[]): Optional bulk assignment of creatives to packages. - idempotency_key (string) [required]: Client-generated idempotency key for safe retries. - delete_missing (boolean): When true, creatives not included in this sync will be archived. - dry_run (boolean): When true, rehearse this sync_creatives operation without applying it. - validation_mode (validation-mode): Validation strictness. - push_notification_config (push-notification-config): Optional webhook configuration for async sync notifications. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/creative/sync-creatives-request.json @ a0fd0b5f ## validate_input Request payload for the validate_input task. Request fields: - account (account-ref): Optional account scope for seller-specific product validation. - brand (brand-ref): Optional brand scope when account is omitted or the seller keys sandbox validation by brand identity. - manifest (creative-manifest) [required]: Creative manifest to validate. - targets (object[]): Discriminated list of validation targets. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - results (validate-input-result[]) [required]: Per-target validation results. Source: dist/schemas/3.1.13/creative/validate-input-request.json @ a0fd0b5f --- # AdCP Signals Source: https://adcpexplorer.com/areas/signals/ Signals protocol task request/response schemas ## activate_signal activate_signal is the AdCP task for pushing audience segments to DSPs and sales agents. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - action (string): Whether to activate or deactivate the signal. - signal_agent_segment_id (string) [required]: Opaque activation handle returned in the signal_agent_segment_id field of each get_signals response entry. - destinations (destination[]) [required]: Target destination(s) for activation. - pricing_option_id (string): The pricing option selected from the signal's pricing_options in the get_signals response. - governance_context (string): Opaque governance context returned by check_governance for this signal activation. - account (account-ref): Account for this activation. - idempotency_key (string) [required]: Client-generated unique key for this request. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/signals/activate-signal-request.json @ a0fd0b5f ## get_signals get_signals is the AdCP task for discovering audience and contextual signals. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - discovery_mode (string): Declares caller intent for this request. - account (account-ref): Account for this request. - signal_spec (string): Natural language description of the desired signals. - signal_refs (signal-ref[]): Specific signals to look up by reference. - signal_ids (signal-id[]): DEPRECATED. - destinations (destination[]): Filter signals to those activatable on specific agents/platforms. - countries (string[]): Countries where signals will be used (ISO 3166-1 alpha-2 codes). - filters (signal-filters): Filters to refine signal discovery results - fields (string[]): Specific signal fields to include in the response, aligned with get_products.fields. - max_results (integer): DEPRECATED: Use pagination.max_results instead. - pagination (pagination-request): Pagination parameters. - push_notification_config (push-notification-config): Optional webhook configuration for async terminal completion/failure notifications on semantic signal discovery. - if_wholesale_feed_version (string): Opaque wholesale_feed_version token returned by a prior wholesale-mode get_signals response from this agent. - if_pricing_version (string): Opaque pricing_version token from a prior get_signals response. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - signals (object[]): Array of matching signals - errors (error[]): Task-specific errors and warnings (e.g., signal discovery or pricing issues) - incomplete (object[]): Declares what the agent could not finish within the caller's time_budget or due to internal limits. - wholesale_feed_version (string): Opaque token representing the version of the wholesale signals feed state used to compose this response. - pricing_version (string): Opaque token representing the version of the pricing layer. - cache_scope (string): Declares whether the wholesale_feed_version and pricing_version on this response describe a universal layer or an account-specific overlay. - unchanged (boolean): Present and `true` ONLY on wholesale-mode responses when the request carried if_wholesale_feed_version (and/or if_pricing_version) matching the agent's current version for the caller's cache_scope, in which case signals… - pagination (pagination-response): Standard cursor-based pagination metadata for list responses - sandbox (boolean): When true, this response contains simulated data from sandbox mode. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/signals/get-signals-request.json @ a0fd0b5f --- # AdCP Protocol Source: https://adcpexplorer.com/areas/protocol/ Protocol-level tasks that work across all AdCP domain protocols ## get_adcp_capabilities get_adcp_capabilities is the first call a buyer makes to discover an AdCP seller's supported protocols, auth model, version, and feature capabilities. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - protocols (string[]): Specific protocols to query capabilities for. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - adcp (object) [required]: Core AdCP protocol information - supported_protocols (string[]) [required]: AdCP protocols this agent supports. - account (object): Account management capabilities. - media_buy (object): Media-buy protocol capabilities. - signals (object): Signals protocol capabilities. - governance (object): Governance protocol capabilities. - sponsored_intelligence (object): Sponsored Intelligence protocol capabilities. - brand (object): Brand protocol capabilities. - creative (object): Creative protocol capabilities. - request_signing (object): RFC 9421 HTTP Signatures support for incoming requests. - webhook_signing (object): RFC 9421 webhook-signature support for outbound webhook callbacks (top-level peer of request_signing). - identity (object): Operator identity posture — trust-root pointer (`brand_json_url`) plus key-scoping and compromise-response controls the agent operates. - measurement (object): Experimental measurement capability block. - compliance_testing (object): Compliance testing capabilities. - specialisms (specialism[]): Optional — specialized compliance claims this agent supports. - extensions_supported (string[]): Extension namespaces this agent supports. - experimental_features (string[]): Experimental AdCP surfaces this agent implements. - wholesale_feed_versioning (object): Conditional-fetch token capabilities for get_products and get_signals. - last_updated (string): ISO 8601 timestamp of when capabilities were last updated. - errors (error[]): Task-specific errors and warnings - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. - wholesale_feed_webhooks (object): Per-agent wholesale product-feed and wholesale signals-feed webhook capabilities. Source: dist/schemas/3.1.13/protocol/get-adcp-capabilities-request.json @ a0fd0b5f ## get_task_status Request parameters for the get_task_status AdCP tool. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - task_id (string) [required]: Unique identifier of the task to retrieve - account (account-ref): Account scope for the task lookup. - include_history (boolean): Include full conversation history for this task (may increase response size) - include_result (boolean): Include the task's result payload when status is completed. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string) [required]: Unique identifier for this task - status (task-status) [required]: Current task status - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - task_type (task-type) [required]: Type of AdCP operation - protocol (adcp-protocol) [required]: AdCP protocol this task belongs to - created_at (string) [required]: When the task was initially created (ISO 8601) - updated_at (string) [required]: When the task was last updated (ISO 8601) - completed_at (string): When the task completed (ISO 8601, only for completed/failed/canceled tasks) - has_webhook (boolean): Whether this task has webhook configuration - progress (object): Progress information for long-running tasks - error (object): Error details for failed tasks - history (object[]): Complete conversation history for this task (only included if include_history was true in request) - result (async-response-data): Task-specific completion payload. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/protocol/get-task-status-request.json @ a0fd0b5f ## list_tasks Request parameters for the list_tasks AdCP tool. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Account scope for task reconciliation. - filters (object): Filter criteria for querying tasks - sort (object): Sorting parameters - pagination (pagination-request): Standard cursor-based pagination parameters for list operations - include_history (boolean): Include full conversation history for each task (may significantly increase response size) - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - query_summary (object) [required]: Summary of the query that was executed - tasks (object[]) [required]: Array of tasks matching the query criteria - pagination (pagination-response) [required]: Standard cursor-based pagination metadata for list responses - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/protocol/list-tasks-request.json @ a0fd0b5f --- # AdCP Accounts Source: https://adcpexplorer.com/areas/account/ Account management task request/response schemas ## get_account_financials get_account_financials returns spend summaries, credit balances, payment status, and invoice history for operator-billed AdCP accounts. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref) [required]: Account to query financials for. - period (date-range): Date range for the spend summary. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/account/get-account-financials-request.json @ a0fd0b5f ## list_accounts list_accounts returns all advertiser accounts an authenticated agent can operate on an AdCP vendor agent. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Optional exact account filter. - status (string): Filter accounts by status. - pagination (pagination-request): Standard cursor-based pagination parameters for list operations - sandbox (boolean): Filter by sandbox status. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - accounts (account-with-authorization[]) [required]: Array of accounts accessible to the authenticated agent. - errors (error[]): Task-specific errors and warnings - pagination (pagination-response): Standard cursor-based pagination metadata for list responses - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/account/list-accounts-request.json @ a0fd0b5f ## report_usage report_usage sends consumption data to AdCP vendor agents after campaign delivery — impressions served, signals queried, governance checks run — so vendors can track revenue and verify billing. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - idempotency_key (string) [required]: Client-generated unique key for this request. - reporting_period (datetime-range) [required]: The time range covered by this usage report. - usage (object[]) [required]: One or more usage records. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - accepted (integer) [required]: Number of usage records successfully stored. - errors (error[]): Validation errors for individual records. - sandbox (boolean): When true, the account is a sandbox account and no billing occurred. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/account/report-usage-request.json @ a0fd0b5f ## sync_accounts sync_accounts provisions buyer-declared accounts or updates settings on existing accounts with an AdCP seller agent. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. - accounts (object[]) [required]: Per-account sync entries. - delete_missing (boolean): When true, accounts previously synced by this agent but not included in this request will be deactivated. - dry_run (boolean): When true, preview what would change without applying. - push_notification_config (push-notification-config): Webhook for async notifications when account status changes (e.g., pending_approval transitions to active). - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/account/sync-accounts-request.json @ a0fd0b5f ## sync_governance sync_governance syncs governance agent endpoints to specific accounts. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. - accounts (object[]) [required]: Per-account governance agent configuration. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/account/sync-governance-request.json @ a0fd0b5f --- # AdCP Brand Protocol Source: https://adcpexplorer.com/areas/brand-protocol/ Brand protocol for identity retrieval, rights discovery, acquisition, and lifecycle management ## acquire_rights acquire_rights is the AdCP task for binding rights acquisition. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - rights_id (string) [required]: Rights offering identifier from get_rights response - pricing_option_id (string) [required]: Selected pricing option from the rights offering - buyer (brand-ref) [required]: The buyer's brand identity - account (account-ref): Account context for this acquisition. - campaign (object) [required]: Campaign details for rights clearance - revocation_webhook (push-notification-config) [required]: Webhook for rights revocation notifications. - push_notification_config (push-notification-config): Webhook for async status updates if the acquisition requires approval. - idempotency_key (string) [required]: Client-generated key for safe retries. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/brand/acquire-rights-request.json @ a0fd0b5f ## get_brand_identity get_brand_identity is the AdCP task for retrieving brand data from a brand agent. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - brand_id (string) [required]: Brand identifier from brand.json brands array - fields (string[]): Optional identity sections to include in the response. - use_case (string): Intended use case, so the agent can tailor the response. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/brand/get-brand-identity-request.json @ a0fd0b5f ## get_rights get_rights is the AdCP task for discovering licensable talent, music, and stock media. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - query (string) [required]: Natural language description of desired rights. - uses (right-use[]) [required]: Rights uses being requested. - buyer_brand (brand-ref): The buyer's brand. - countries (string[]): Countries where rights are needed (ISO 3166-1 alpha-2). - brand_id (string): Search within a specific brand's rights. - right_type (right-type): Filter by type of rights (talent, music, stock_media, etc.) - include_excluded (boolean): Include filtered-out results in the excluded array with reasons. - pagination (pagination-request): Pagination parameters for large result sets - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/brand/get-rights-request.json @ a0fd0b5f ## update_rights update_rights is the AdCP task for modifying active rights grants. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - rights_id (string) [required]: Rights grant identifier from acquire_rights response - account (account-ref): Account context for this update. - end_date (string): New end date for the rights grant (must be >= current end_date). - impression_cap (integer): New impression cap for the grant. - pricing_option_id (string): Switch to a different pricing option from the original get_rights offering. - paused (boolean): Pause or resume the rights grant. - push_notification_config (push-notification-config): Webhook for async update notifications if the update requires approval - idempotency_key (string) [required]: Client-generated idempotency key for safe retries. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/brand/update-rights-request.json @ a0fd0b5f ## verify_brand_claim verify_brand_claim is the unified AdCP brand-protocol task for asking a brand-agent whether a specific claim about its identity is owned, pending, disputed, or licensed. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/brand/verify-brand-claim-request.json @ a0fd0b5f ## verify_brand_claims verify_brand_claims is the bulk variant of verify_brand_claim — verify many claims against one brand-agent in a single round-trip. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - claims (claim_entry[]) [required]: Ordered list of verification claims. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/brand/verify-brand-claims-request.json @ a0fd0b5f --- # AdCP Governance Source: https://adcpexplorer.com/areas/governance/ Governance protocol for property governance, brand standards, content standards, and compliance ## calibrate_content calibrate_content aligns buyers and sellers on brand suitability standards through structured dialogue before AdCP campaign execution begins. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - standards_id (string) [required]: Standards configuration to calibrate against - artifact (artifact) [required]: Artifact to evaluate - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/content-standards/calibrate-content-request.json @ a0fd0b5f ## check_governance check_governance is the universal validation gate in AdCP — orchestrators and sellers call it before executing any campaign action. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - plan_id (string) [required]: Campaign governance plan identifier. - caller (string) [required]: URL of the agent making the request. - purchase_type (purchase-type): The type of financial commitment being checked. - tool (string): The AdCP tool being checked (e.g., 'create_media_buy', 'acquire_rights', 'activate_signal'). - payload (object): The full tool arguments as they would be sent to the seller. - governance_context (string): Governance context token from a prior check_governance response. - phase (governance-phase): The phase of the governed action's lifecycle. - planned_delivery (planned-delivery): What the seller will actually deliver. - delivery_metrics (object): Actual delivery performance data. - modification_summary (string): Human-readable summary of what changed. - invoice_recipient (business-entity): Invoice recipient from the purchase request. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - check_id (string) [required]: Unique identifier for this governance check record. - verdict (governance-decision) [required]: Governance verdict: approved | denied | conditions. - plan_id (string) [required]: Echoed from request. - explanation (string) [required]: Human-readable explanation of the governance decision. - findings (object[]): Specific issues found during the governance check. - conditions (object[]): Present when verdict is 'conditions'. - expires_at (string): When this approval expires. - next_check (string): When the seller should next call check_governance with delivery metrics. - categories_evaluated (string[]): Governance categories evaluated during this check. - policies_evaluated (string[]): Policy IDs evaluated during this check. - mode (governance-mode): Governance enforcement mode active when this check was evaluated. - governance_context (string): Governance context token for this governed action. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/governance/check-governance-request.json @ a0fd0b5f ## create_collection_list Collection list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists for content programs, combining explicit program references with dynamic genre and content rating filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Account that will own the list. - name (string) [required]: Human-readable name for the list - description (string): Description of the list's purpose - base_collections (base-collection-source[]): Array of collection sources to evaluate. - filters (collection-list-filters): Dynamic filters to apply when resolving the list - brand (brand-ref): Brand reference. - idempotency_key (string) [required]: Client-generated unique key for this request. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - list (collection-list) [required]: The created collection list - auth_token (string) [required]: Token that authorizes sellers to fetch this list via get_collection_list. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/collection/create-collection-list-request.json @ a0fd0b5f ## create_content_standards create_content_standards defines a brand suitability configuration with content policies, risk thresholds, and category rules for AdCP campaigns. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - scope (object) [required]: Where this standards configuration applies - registry_policy_ids (string[]): Registry policy IDs to use as the evaluation basis for this content standard. - policies (policy-entry[]): Bespoke policies for this content-standards configuration, using the same shape as registry entries. - calibration_exemplars (object): Training/test set to calibrate policy interpretation. - idempotency_key (string) [required]: Client-generated unique key for this request. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/content-standards/create-content-standards-request.json @ a0fd0b5f ## create_property_list Property list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists combining static sets with dynamic filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Account that will own the list. - name (string) [required]: Human-readable name for the list - description (string): Description of the list's purpose - base_properties (base-property-source[]): Array of property sources to evaluate. - filters (property-list-filters): Dynamic filters to apply when resolving the list - brand (brand-ref): Brand reference. - idempotency_key (string) [required]: Client-generated unique key for this request. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - list (property-list) [required]: The created property list - auth_token (string) [required]: Token that can be shared with sellers to authorize fetching this list. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/property/create-property-list-request.json @ a0fd0b5f ## delete_collection_list Collection list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists for content programs, combining explicit program references with dynamic genre and content rating filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - list_id (string) [required]: ID of the collection list to delete - account (account-ref): Account that owns the list. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - deleted (boolean) [required]: Whether the list was successfully deleted - list_id (string) [required]: ID of the deleted list - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/collection/delete-collection-list-request.json @ a0fd0b5f ## delete_property_list Property list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists combining static sets with dynamic filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - list_id (string) [required]: ID of the property list to delete - account (account-ref): Account that owns the list. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - deleted (boolean) [required]: Whether the list was successfully deleted - list_id (string) [required]: ID of the deleted list - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/property/delete-property-list-request.json @ a0fd0b5f ## get_collection_list Collection list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists for content programs, combining explicit program references with dynamic genre and content rating filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - list_id (string) [required]: ID of the collection list to retrieve - account (account-ref): Account that owns the list. - resolve (boolean): Whether to apply filters and return resolved collections (default: true) - pagination (object): Pagination parameters. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - list (collection-list) [required]: The collection list metadata (always returned) - collections (object[]): Resolved collections that passed filters (if resolve=true). - pagination (pagination-response): Standard cursor-based pagination metadata for list responses - resolved_at (string): When the list was resolved - cache_valid_until (string): Cache expiration timestamp. - coverage_gaps (object): Collections included in the list despite missing metadata for a filtered dimension. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/collection/get-collection-list-request.json @ a0fd0b5f ## get_content_standards get_content_standards retrieves the full content safety policy configuration for a specific standards ID in AdCP. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - standards_id (string) [required]: Identifier for the standards configuration to retrieve - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/content-standards/get-content-standards-request.json @ a0fd0b5f ## get_creative_features get_creative_features evaluates a creative manifest against a governance agent and returns feature values for brand safety and compliance in AdCP. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - creative_manifest (creative-manifest) [required]: The creative manifest to evaluate. - feature_ids (string[]): Optional filter to specific features. - account (account-ref): Account for billing this evaluation. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/creative/get-creative-features-request.json @ a0fd0b5f ## get_media_buy_artifacts get_media_buy_artifacts retrieves content context records from a media buy for post-delivery brand suitability validation in AdCP. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Filter artifacts to a specific account. - media_buy_id (string) [required]: Media buy to get artifacts from - package_ids (string[]): Filter to specific packages within the media buy - failures_only (boolean): When true, only return artifacts where the seller's local model returned local_verdict: 'fail'. - time_range (object): Filter to specific time period - pagination (object): Pagination parameters. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/content-standards/get-media-buy-artifacts-request.json @ a0fd0b5f ## get_plan_audit_logs get_plan_audit_logs retrieves governance state, budget tracking, and a complete audit trail for AdCP campaign plans or portfolios. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - plan_ids (string[]): Plan IDs to retrieve. - portfolio_plan_ids (string[]): Portfolio plan IDs. - governance_contexts (string[]): Filter audit entries by governance context. - purchase_types (purchase-type[]): Filter audit entries by purchase type. - include_entries (boolean): Include the full audit trail. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - plans (object[]) [required]: Audit data for each requested plan. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/governance/get-plan-audit-logs-request.json @ a0fd0b5f ## get_property_list Property list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists combining static sets with dynamic filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - list_id (string) [required]: ID of the property list to retrieve - account (account-ref): Account that owns the list. - resolve (boolean): Whether to apply filters and return resolved identifiers (default: true) - pagination (object): Pagination parameters. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - list (property-list) [required]: The property list metadata (always returned) - identifiers (identifier[]): Resolved identifiers that passed filters (if resolve=true). - pagination (pagination-response): Standard cursor-based pagination metadata for list responses - resolved_at (string): When the list was resolved - cache_valid_until (string): Cache expiration timestamp. - coverage_gaps (object): Properties included in the list despite missing feature data. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/property/get-property-list-request.json @ a0fd0b5f ## list_collection_lists Collection list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists for content programs, combining explicit program references with dynamic genre and content rating filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Filter to lists owned by this account. - name_contains (string): Filter to lists whose name contains this string - pagination (pagination-request): Standard cursor-based pagination parameters for list operations - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - lists (collection-list[]) [required]: Array of collection lists (metadata only, not resolved collections) - pagination (pagination-response): Standard cursor-based pagination metadata for list responses - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/collection/list-collection-lists-request.json @ a0fd0b5f ## list_content_standards list_content_standards returns available content safety configurations with optional filtering and pagination in AdCP. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - channels (channels[]): Filter by channel - languages (string[]): Filter by BCP 47 language tags - countries (string[]): Filter by ISO 3166-1 alpha-2 country codes - pagination (pagination-request): Standard cursor-based pagination parameters for list operations - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/content-standards/list-content-standards-request.json @ a0fd0b5f ## list_property_lists Property list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists combining static sets with dynamic filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - account (account-ref): Filter to lists owned by this account. - name_contains (string): Filter to lists whose name contains this string - pagination (pagination-request): Standard cursor-based pagination parameters for list operations - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - lists (property-list[]) [required]: Array of property lists (metadata only, not resolved properties) - pagination (pagination-response): Standard cursor-based pagination metadata for list responses - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/property/list-property-lists-request.json @ a0fd0b5f ## report_plan_outcome report_plan_outcome sends action results to the AdCP governance agent so it can update budget tracking, state, and compliance records. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - plan_id (string) [required]: The plan this outcome is for. - check_id (string): The check_id from check_governance. - idempotency_key (string) [required]: Client-generated unique key for this request. - purchase_type (purchase-type): The type of financial commitment this outcome is for. - outcome (outcome-type) [required]: Outcome type. - seller_response (object): The seller's full response. - delivery (object): Delivery metrics. - error (object): Error details. - governance_context (string) [required]: Opaque governance context from the check_governance response that authorized this action. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - outcome_id (string) [required]: Unique identifier for this outcome record. - outcome_state (string) [required]: Outcome state. - committed_budget (number): Budget committed from this outcome. - findings (object[]): Issues detected. - plan_summary (object): Updated plan budget state. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/governance/report-plan-outcome-request.json @ a0fd0b5f ## sync_plans sync_plans pushes campaign plans with budget limits, channels, flight dates, and compliance policies to an AdCP governance agent. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. - plans (object[]) [required]: One or more campaign plans to sync. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - plans (object[]) [required]: Status for each synced plan. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/governance/sync-plans-request.json @ a0fd0b5f ## update_collection_list Collection list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists for content programs, combining explicit program references with dynamic genre and content rating filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - list_id (string) [required]: ID of the collection list to update - account (account-ref): Account that owns the list. - name (string): New name for the list - description (string): New description - base_collections (base-collection-source[]): Complete replacement for the base collections list (not a patch). - filters (collection-list-filters): Complete replacement for the filters (not a patch) - brand (brand-ref): Update brand reference. - webhook_url (string): Update the webhook URL for list change notifications (set to empty string to remove). - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - list (collection-list) [required]: The updated collection list - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/collection/update-collection-list-request.json @ a0fd0b5f ## update_content_standards update_content_standards modifies an existing content standards configuration in AdCP, creating a new version for audit purposes. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - standards_id (string) [required]: ID of the standards configuration to update - scope (object): Updated scope for where this standards configuration applies - registry_policy_ids (string[]): Registry policy IDs to use as the evaluation basis. - policies (policy-entry[]): Updated bespoke policies for this content-standards configuration, using the same shape as registry entries. - calibration_exemplars (object): Updated training/test set to calibrate policy interpretation. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/content-standards/update-content-standards-request.json @ a0fd0b5f ## update_property_list Property list tasks in AdCP create, update, get, list, and delete inclusion and exclusion lists combining static sets with dynamic filters. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - list_id (string) [required]: ID of the property list to update - account (account-ref): Account that owns the list. - name (string): New name for the list - description (string): New description - base_properties (base-property-source[]): Complete replacement for the base properties list (not a patch). - filters (property-list-filters): Complete replacement for the filters (not a patch) - brand (brand-ref): Update brand reference. - webhook_url (string): Update the webhook URL for list change notifications (set to empty string to remove) - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - list (property-list) [required]: The updated property list - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/property/update-property-list-request.json @ a0fd0b5f ## validate_content_delivery validate_content_delivery batch-evaluates delivery records against content safety policies asynchronously in AdCP. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - standards_id (string) [required]: Standards configuration to validate against - records (object[]) [required]: Delivery records to validate (max 10,000) - feature_ids (string[]): Specific features to evaluate (defaults to all) - include_passed (boolean): Include passed records in results - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/content-standards/validate-content-delivery-request.json @ a0fd0b5f --- # AdCP Sponsored Intelligence Source: https://adcpexplorer.com/areas/sponsored-intelligence/ Sponsored Intelligence Protocol for conversational brand experiences in AI assistants ## si_get_offering si_get_offering is the AdCP task for anonymous pre-session offering lookups. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - offering_id (string) [required]: Offering identifier from the catalog to get details for - intent (string): Optional natural language description of user intent for personalized results (e.g., 'mens size 14 near Cincinnati'). - context (context): Opaque correlation data that is echoed unchanged in responses. - include_products (boolean): Whether to include matching products in the response - product_limit (integer): Maximum number of matching products to return - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - available (boolean) [required]: Whether the offering is currently available - offering_token (string): Token to pass to si_initiate_session for session continuity. - ttl_seconds (integer): How long this offering information is valid (seconds). - checked_at (string): When this offering information was retrieved - offering (object): Offering details - matching_products (object[]): Products matching the request context. - sponsored_context (si-sponsored-context): Declaration for the sponsored context carried by this offering response. - total_matching (integer): Total number of products matching the context (may be more than returned in matching_products) - unavailable_reason (string): If not available, why (e.g., 'expired', 'sold_out', 'region_restricted') - alternative_offering_ids (string[]): Alternative offerings to consider if this one is unavailable - errors (error[]): Errors during offering lookup - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/sponsored-intelligence/si-get-offering-request.json @ a0fd0b5f ## si_initiate_session si_initiate_session is the AdCP task that starts a Sponsored Intelligence session. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - intent (string) [required]: Natural language description of user intent — the conversation handoff from the host describing what the user needs from the brand agent - context (context): Opaque correlation data that is echoed unchanged in responses. - identity (si-identity) [required]: User identity shared with brand agent (with explicit consent) - media_buy_id (string): AdCP media buy ID if session was triggered by advertising - placement (string): Where this session was triggered (e.g., 'chatgpt_search', 'claude_chat') - offering_id (string): Brand-specific offering identifier to apply - supported_capabilities (si-capabilities): What capabilities the host supports - offering_token (string): Token from si_get_offering response for session continuity. - sponsored_context_receipt (si-sponsored-context-receipt): Host receipt for sponsored context accepted from a prior si_get_offering response or other pre-session context package. - idempotency_key (string) [required]: Client-generated unique key for this request. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - session_id (string) [required]: Unique session identifier for subsequent messages - response (object): Brand agent's initial response - negotiated_capabilities (si-capabilities): Intersection of brand and host capabilities for this session - sponsored_context (si-sponsored-context): Declaration for sponsored context carried by the initial brand-agent response. - session_status (si-session-status) [required]: Current session lifecycle state. - session_ttl_seconds (integer): Session inactivity timeout in seconds. - errors (error[]): Errors during session initiation - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/sponsored-intelligence/si-initiate-session-request.json @ a0fd0b5f ## si_send_message si_send_message is the AdCP task for exchanging messages in an active SI session. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - idempotency_key (string) [required]: Client-generated unique key for at-most-once execution. - session_id (string) [required]: Active session identifier - message (string): User's message to the brand agent - action_response (object): Response to a previous action_button (e.g., user clicked checkout) - sponsored_context_receipt (si-sponsored-context-receipt): Host receipt for sponsored context accepted from a prior SI response in this session. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - session_id (string) [required]: Session identifier - response (object): Brand agent's response - mcp_resource_uri (string): MCP resource URI for hosts with MCP Apps support (e.g., ui://si/session-abc123) - sponsored_context (si-sponsored-context): Declaration for sponsored context carried by this brand-agent response. - session_status (si-session-status) [required]: Current session status. - handoff (object): Handoff request when session_status is pending_handoff - errors (error[]) - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/sponsored-intelligence/si-send-message-request.json @ a0fd0b5f ## si_terminate_session si_terminate_session is the AdCP task for ending an SI session. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - session_id (string) [required]: Session identifier to terminate - reason (string) [required]: Reason for termination - termination_context (object): Context for the termination - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Opaque correlation data that is echoed unchanged in responses. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - session_id (string) [required]: Terminated session identifier - terminated (boolean) [required]: Whether session was successfully terminated - session_status (si-session-status): Resulting session state. - acp_handoff (object): ACP checkout handoff data. - follow_up (object): Suggested follow-up actions - errors (error[]) - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. Source: dist/schemas/3.1.13/sponsored-intelligence/si-terminate-session-request.json @ a0fd0b5f --- # AdCP Trusted Match Source: https://adcpexplorer.com/areas/trusted-match/ Trusted Match Protocol (TMP) — real-time execution layer for activating pre-negotiated packages across any surface. ## context_match Sent by publisher to router or provider to evaluate packages against contextual signals. Request fields: - $schema (string): Optional schema URI for validation. - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version. - type (string) [required]: Message type discriminator for deserialization. - protocol_version (string): TMP protocol version. - request_id (string) [required]: Unique request identifier. - property_rid (string) [required]: Property catalog UUID (UUID v7). - property_id (property-id): Publisher's human-readable property slug (e.g., 'cnn_homepage'). - property_type (property-type) [required]: Type of the publisher property - placement_id (string) [required]: Placement identifier from the publisher's placement registry in adagents.json. - seller_agent_url (string) [required]: API endpoint URL of the seller agent issuing this request. - artifact (artifact): Full content artifact adjacent to this ad opportunity. - artifact_refs (object[]): Public content references adjacent to this ad opportunity. - geo (object): Coarse geographic location of the viewer. - context_signals (object): Pre-computed classifier outputs for the content environment. - package_ids (string[]): Restrict evaluation to specific packages. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - type (string) [required]: Message type discriminator for deserialization. - request_id (string) [required]: Echoed request identifier from the context match request - offers (offer[]) [required]: Offers from the buyer, one per activated package. - cache_ttl (integer): Optional override for the default 5-minute cache TTL, in seconds. - signals (object): Response-level targeting signals for ad server pass-through. Source: dist/schemas/3.1.13/trusted-match/context-match-request.json @ a0fd0b5f ## identity_match Sent by publisher to evaluate user eligibility for packages using an opaque identity token. Request fields: - $schema (string): Optional schema URI for validation. - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version. - type (string) [required]: Message type discriminator for deserialization. - protocol_version (string): TMP protocol version. - request_id (string) [required]: Unique request identifier. - seller_agent_url (string) [required]: API endpoint URL of the seller agent issuing this request. - identities (object[]) [required]: Identity tokens for the user, each tagged with its type. - consent (object): Privacy consent signals. - package_ids (string[]): Optional. - country (string): ISO 3166-1 alpha-2 country code. - sealed_credentials (object[]): Optional HPKE-sealed credentials addressed to specific audiences — the network-as-RP ("issuer-as-RP"/Mechanism B) carrier. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). - type (string) [required]: Message type discriminator for deserialization. - request_id (string) [required]: Echoed request identifier from the identity match request - eligible_package_ids (string[]) [required]: Package IDs the user is eligible for. - serve_window_sec (integer) [required]: Per-package single-shot fcap window, in seconds. - tmpx (string): DEPRECATED in favor of tmpx_providers. - tmpx_providers (object): Router-populated: ordered TMPX chunk/value pairs grouped by the originating identity provider's `provider_id`. Source: dist/schemas/3.1.13/trusted-match/identity-match-request.json @ a0fd0b5f --- # AdCP Compliance Source: https://adcpexplorer.com/areas/compliance/ Compliance testing tool schemas. ## comply_test_controller Request payload for the comply_test_controller tool. Request fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - scenario (string) [required]: Test scenario to execute. - params (object): Scenario-specific parameters. - context (context): Opaque correlation data that is echoed unchanged in responses. - ext (ext): Extension object for platform-specific, vendor-namespaced parameters. - account (object) [required]: Sandbox account assertion. Response fields: - adcp_version (string): Release-precision AdCP version (VERSION.RELEASE, e.g. - adcp_major_version (integer): DEPRECATED in favor of adcp_version (release-precision string). - context_id (string): Session/conversation identifier for tracking related operations across multiple task invocations. - context (context): Per-request opaque caller-supplied correlation object echoed unchanged in the response. - task_id (string): Unique identifier for tracking asynchronous operations. - status (task-status) [required]: Current task execution state. - message (string): Human-readable summary of the task result. - timestamp (string): ISO 8601 timestamp when the response was generated. - replayed (boolean): Set to true when this response was returned from the idempotency cache rather than from a fresh execution. - adcp_error (error): Transport-envelope error signal for fatal task failures. - push_notification_config (push-notification-config): Push notification configuration for async task updates (A2A and REST protocols). - governance_context (string): Governance context token issued by the account's governance agent during check_governance. - payload (object): Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Source: dist/schemas/3.1.13/compliance/comply-test-controller-request.json @ a0fd0b5f ---