accept_plan_billing_tos
ChatGPTApp-only Terms of Service acceptance after explicit human confirmation inside the Plan & Billing Page.
apply_marketplace_supply_batch
ChatGPTINTERNAL directly authenticated human SuperAdmin mutation for up to 25 Sellers. Preflights the batch, applies governed writes independently, stops on cancellation or deadline, and reports partial results. Requires preview revisions, Critical Supply choices, confirmation, and an audit reason.
buyer_notification_page
ChatGPTApp-only notification Page action. The server selects the audited account-specific operation; this tool is not exposed to the model.
buyer_sellers_page
ChatGPTApp-only Sellers Page mutation. The server selects one audited buyer operation from a closed action enum; this tool is never exposed to the model.
complete_partner_connection
ChatGPTApp-only partner connection form action.
generate_variants
ChatGPTGenerate variants from a saved brief; use Creative Sessions for voice/audio, radio spots, and voiceovers. Send kind, scope, and variantAction; reuse actionKey only on retries.
get
ChatGPTReturn one object or singleton. Buyer sellers use search ids; Seller Discovery Card uses include:["discoveryCard"].
get_buyer_sellers_page
ChatGPTApp-only Sellers Page read. The server selects one audited buyer read from a closed action enum; this tool is never exposed to the model.
get_delivery
ChatGPTQuery seller delivery, buyer campaign delivery, or seller margin facts. Authority, denomination, freshness, finality, missing values, truncation, and billing eligibility stay explicit; buyer measurement is excluded.
get_plan_billing_account
ChatGPTApp-only hydration for the Plan & Billing Page. The full billing document is delivered to the trusted Page and is not exposed to model context.
get_proposals_diagnostic
ChatGPTReturns a sanitized per-seller outcome summary for a request_proposals execution: allowlisted error codes, counts, and IDs. Use the executionId from a request_proposals response.
get_rfp_performance
ChatGPTQuery grouped Seller RFP quality, efficiency, and commercial metrics with metric-specific availability and immutable pages. Defaults to live terminal turns; synthetic purposes are opt-in and excluded from commercial metrics. Use get for individual RFPs or turns.
get_status
ChatGPTCurrent account, state, blockers, exact fixes, and reachable accounts. For missing seller demand, this is the authority on whether readiness stops requests before an inventory source is called. Read it before blaming source health, empty responses, or lack of demand.
get_status_setup_nav
ChatGPTApp-only hydration for the exhaustive seller setup rail. It extends canonical status without entering model context.
library_discard_draft
ChatGPTApp-only Library widget action. Permanently discards one Draft and its stored objects.
library_get_evaluation_status
ChatGPTApp-only synthetic evaluation status. The held-out brief becomes available when every synthetic teaching source is ready.
library_get_material
ChatGPTApp-only Page. Read one object by kind and id, or an account singleton without id. Never guess ids. Campaign reads return targetingOverlay to verify before proposals. include adds detail only for kinds that serve it.
library_get_minimum_requirements
ChatGPTApp-only Library widget read. Returns the seller Library requirements checklist.
library_get_rfp_turn
ChatGPTApp-only Page. Read one object by kind and id, or an account singleton without id. Never guess ids. Campaign reads return targetingOverlay to verify before proposals. include adds detail only for kinds that serve it.
library_open_proposal_pass
ChatGPTApp-only Page. Open Proposal Pass on one exact immutable RFP turn. Supply the matching rfpId and turnId from save_rfp or get; the Page loads the private response itself.
library_prepare_synthetic_materials
ChatGPTApp-only Demo Seller action that loads six visibly synthetic teaching sources. It never exposes or accepts a buyer brief.
library_renew_capability
ChatGPTApp-only renewal for an expired Seller Page capability. Performs no canonical read or mutation.
library_save_draft
ChatGPTApp-only Library widget action. Saves one Draft with its final name, category and description.
library_save_material
ChatGPTRegister, revise, archive, restore, or reprocess seller Materials; manage candidate decisions and receipts; mark a slide, page, or sheet reusable only when it has no commercial figures (UNIT_NOT_REUSABLE_KIND rejects document containers, UNIT_CONTAINS_PRICING rejects priced units).
library_save_request
ChatGPTApp-only Page. Open a seller library request or close it with seller Material.
library_save_rfp
ChatGPTApp-only Page. Save RFPs and turns: imported origins, typed feedback, response pairs, endorsement, and proposal-file requests.
library_search_materials
ChatGPTApp-only Page. Find objects in this account, or answer questions from the docs. Pass kind to list one object type, query to match text, or both. Before a multi-step task, search kind skill for a workflow. Reread a docs hit with its document (and revision, for agreements) before you cite it.
library_search_requests
ChatGPTApp-only Page. Find objects in this account, or answer questions from the docs. Pass kind to list one object type, query to match text, or both. Before a multi-step task, search kind skill for a workflow. Reread a docs hit with its document (and revision, for agreements) before you cite it.
library_search_rfps
ChatGPTApp-only Page. Find objects in this account, or answer questions from the docs. Pass kind to list one object type, query to match text, or both. Before a multi-step task, search kind skill for a workflow. Reread a docs hit with its document (and revision, for agreements) before you cite it.
library_start_synthetic_evaluation
ChatGPTApp-only Demo Seller action. Starts the fixed synthetic held-out evaluation after the synthetic teaching sources are ready.
open_add_advertiser
ChatGPTOpen Advertiser Setup to create an advertiser or edit the supplied advertiserId. The form allows eligible name, channel, and reporting-time-zone edits while keeping governed identity fields read-only. Operator identity is managed in Buyer Setup.
open_connections_page
ChatGPTOpen the live Connections Page for a buyer to view or manage provider connections, reconnect integrations, and map provider accounts to advertisers. Use for requests such as “show my connections,” “connect Google Ads,” “link an ad account,” or “map this account to an advertiser.”
open_page
ChatGPTCompatibility navigation for a human workflow without a fixed V3 Page owner. External hosts may return text instead of a widget. Credential collection and changes to who can act remain human ceremonies.
open_variant_gallery
ChatGPTShow a saved Creative Session’s variants (find via search/get kind creative_session). Not for generating new variants.
preview_marketplace_supply_batch
ChatGPTINTERNAL SuperAdmin preview for up to 25 Seller Market Maker reviews. Returns revisions, before/after state, missing IDs, and non-Seller blockers without mutating.
proposal_pass_get_rfp_turn
ChatGPTApp-only Page. Read one object by kind and id, or an account singleton without id. Never guess ids. Campaign reads return targetingOverlay to verify before proposals. include adds detail only for kinds that serve it.
proposal_pass_open_source_diagnostics
ChatGPTApp-only Page. Open source diagnostics only for the seller's evidence-bound Proposal Pass turn and named source.
proposal_pass_renew_capability
ChatGPTApp-only renewal for an expired Seller Page capability. Performs no canonical read or mutation.
proposal_pass_save_rfp
ChatGPTApp-only Page. Save RFPs and turns: imported origins, typed feedback, response pairs, endorsement, and proposal-file requests.
proposal_pass_search_rfp_turns
ChatGPTApp-only Page. Find objects in this account, or answer questions from the docs. Pass kind to list one object type, query to match text, or both. Before a multi-step task, search kind skill for a workflow. Reread a docs hit with its document (and revision, for agreements) before you cite it.
read_partner_connection_setup
ChatGPTApp-only partner connection form action.
record_widget_telemetry
ChatGPTApp-only. Records closed-schema widget timing and operational failures. Never model-exposed.
refresh_inventory_source_health
ChatGPTRechecks one external sales-agent source with no-spend get_products. Returns evidence IDs and seller readiness; no source configuration or media buy.
request_proposals
ChatGPTRequest product offers from sellers. Returns quoted proposals, bare products, or both. Pass the returned productQueryId as idempotencyKey to save_media_buy. New idempotencyKey starts a fresh round; same key replays the same execution.
request_seller_reporting_update
ChatGPTRequests a scheduler-run reporting refresh or a bounded replay for one seller media buy. It never polls a provider directly.
save_advertiser
ChatGPTCreate or update an advertiser. Omit advertiserId to create. Supply it to update.
save_advertiser_instructions
ChatGPTSeller-only CRM notes for an exact brand × operator pair. Buyers use save_advertiser.privateNotes; see /v3/manage-ads#private-advertiser-notes. Effective discounts, routing, access and trust are read-only.
save_ask
ChatGPTFile or update a typed ask in the Interchange support workflow; returns askId. Supply is buyer inventory. Call immediately with type support when a person explicitly asks for a human; do not diagnose first.
save_audience
ChatGPTSync first-party CRM audiences for a buyer advertiser. Each audiences[] item may add, remove, or delete members. Returns an operationId; use get(kind: audience, advertiserId: "...") to read match status after it settles.
save_business_rules
ChatGPTWrite seller AI Business Rules. Policy content needs an account admin and both policy fields. Approval auto needs acknowledgeNoHumanReview.
save_buyer_operator
ChatGPTSave buyer commercial identity. Read get_status; use identityContract:confirmed-v1 for preview and confirmation. Guide: /v2/setup/v3/identity-setup.
save_campaign
ChatGPTCreate or update a campaign. Omit campaignId to create (advertiserId, name, flight, budget required). Supply it to update. desiredPhase: "active" requires confirmLaunch: true to launch; first call without it shows what will launch. For brief: ask goal, audience, promoted item.
save_catalog
ChatGPTCreate or replace a catalog: type and exactly one of url (feed URL) or non-empty items are required. If missing, ask the buyer for the feed URL or items before calling. URL saves refetch the feed. To archive, set isArchived: true with identity only; type, url and items are not needed.
save_connection
ChatGPTManage seller or creative-engine authorization, accounts and advertiser mappings. Seller-only: reporting, selection, billing, policy, activation.
save_coverage
ChatGPTDeclare publisher domains this Seller sells and its claimed properties. domains replaces the complete set; add, remove, declareProperties, and removeProperties change named items only. Read authorization; never assume it.
save_creative
ChatGPTCreate or update a creative. Omit creativeId to create (requires campaignId + name). Supply creativeId to update. Set isArchived: true with advertiserId to archive globally.
save_creative_collection
ChatGPTCreate or update a creative collection - a grouping and joint-review workspace for saved creatives. Omit collectionId to create (requires campaignId + name). Supply collectionId to update. addMemberIds/removeMemberIds add or remove members.
save_dimension
ChatGPTCreate a dimension, or update an existing dimension by its id. Tags is built in and open. Labels belong only to objects in appliesTo.
save_directed_campaign_subscription
ChatGPTImport native campaigns from Spotify Ads Manager or other platforms, including future-start campaigns, as read-only mirrors. Confirm ongoing sync first. No provider changes. /v3/import-existing-campaigns.
save_event_source
ChatGPTCreate, change, archive, or restore up to 50 advertiser conversion event sources (pixels, server feeds). Each entry is keyed by eventSourceId and succeeds or fails alone. Setup is not proof events flow: check health with get, then use eventSourceId in an optimization goal.
save_library_request
ChatGPTOpen a seller library request or close it with seller Material.
save_media_buy
ChatGPTStage or update a media buy. To accept a proposal: fromProposalId. To create from products: sellerId + campaignId + products + idempotencyKey (use the productQueryId value). To update a draft: mediaBuyId.
save_media_kit
ChatGPTDeprecated compatibility tool ("listing" is the modern term). It writes only the legacy businessProfile and does not update the canonical buyer-visible listing. New clients must read with get({ kind: "seller", include: ["listing"] }) and write with save_seller.
save_playbook
ChatGPTWrite how the seller sells. active creates and activates a new version in one step — no separate activate; the response names the version created and replaced. pricing replaces the whole fact list. discounts sets or removes brand/operator rules one by one. Halves never roll back each other.
save_property_list
ChatGPTCreate, update, archive, restore, or AAO-check an advertiser property list. Check uses identifiers without saving. Search/get read saved lists.
save_seller
ChatGPTSave Seller identity, capabilities, Apostra listing, buyer-visible listing (mediaKit is a deprecated alias), Distribution's OpenAI challenge token, or a seller-controlled admission. Scope3 eligibility and Market Maker entitlements are read-only here. Read Distribution with get(kind:"distribution").
save_signal
ChatGPTCreate, replace, or archive a signal. Managed writes need a complete draft; read before updates. Without sourceId, writes the seller catalog.
save_wholesale_product
ChatGPTCreate, change, or delete one wholesale product on an ad-server source — what buyers discover and buy. Omit id to create: needs name and inventory, validated first. Pass id to change only the fields you name. active = buyable, archived = off the market and reversible, delete is not.
save_work_item
ChatGPTDecide a creative or media-buy approval, or complete a modular-source follow-up. Repeats preserve evidence; retry, evaluation, and reassignment stay on the approvals Page.
search
ChatGPTSearch objects/docs. Always pass query, kind, or both; never call with {}. Seller products: kind=wholesale_product. Seller identity/Discovery Card uses get or save_seller.
seller_dashboard_get_demo_evaluation_analytics
ChatGPTApp-only Demo Seller rehearsal analytics. Returns synthetic evaluation facts only for the authenticated owner of an active demo lease.
seller_dashboard_get_rfp
ChatGPTApp-only Page. Read one object by kind and id, or an account singleton without id. Never guess ids. Campaign reads return targetingOverlay to verify before proposals. include adds detail only for kinds that serve it.
seller_dashboard_get_rfp_performance
ChatGPTApp-only Page. Query grouped Seller RFP quality, efficiency, and commercial metrics with metric-specific availability and immutable pages. Defaults to live terminal turns; synthetic purposes are opt-in and excluded from commercial metrics. Use get for individual RFPs or turns.
seller_dashboard_renew_capability
ChatGPTApp-only renewal for an expired Seller Page capability. Performs no canonical read or mutation.
seller_dashboard_search_rfps
ChatGPTApp-only Page. Find objects in this account, or answer questions from the docs. Pass kind to list one object type, query to match text, or both. Before a multi-step task, search kind skill for a workflow. Reread a docs hit with its document (and revision, for agreements) before you cite it.
seller_media_buy_timeline_page
ChatGPTApp-only Media Buy Timeline Page data bridge.
seller_media_buys_page
ChatGPTApp-only Media Buys Page data bridge.
set_plan_billing_payout_payee
ChatGPTApp-only primary payout-payee write after explicit human submission inside the Plan & Billing Page. Bank fields remain outside model context.
switch_account
ChatGPTMove to another account you belong to. The tools available change with the account, so call get_status afterwards to see what this one can do. Omit accountId only when asked to go back to the home account.
teach_get_evaluation_status
ChatGPTApp-only synthetic evaluation status. The held-out brief becomes available when every synthetic teaching source is ready.
teach_get_material
ChatGPTApp-only Page. Read one object by kind and id, or an account singleton without id. Never guess ids. Campaign reads return targetingOverlay to verify before proposals. include adds detail only for kinds that serve it.
teach_open_proposal_pass
ChatGPTApp-only Page. Open Proposal Pass on one exact immutable RFP turn. Supply the matching rfpId and turnId from save_rfp or get; the Page loads the private response itself.
teach_prepare_synthetic_materials
ChatGPTApp-only Demo Seller action that loads six visibly synthetic teaching sources. It never exposes or accepts a buyer brief.
teach_renew_capability
ChatGPTApp-only renewal for an expired Seller Page capability. Performs no canonical read or mutation.
teach_save_material
ChatGPTRegister, revise, archive, restore, or reprocess seller Materials; manage candidate decisions and receipts; mark a slide, page, or sheet reusable only when it has no commercial figures (UNIT_NOT_REUSABLE_KIND rejects document containers, UNIT_CONTAINS_PRICING rejects priced units).
teach_search_materials
ChatGPTApp-only Page. Find objects in this account, or answer questions from the docs. Pass kind to list one object type, query to match text, or both. Before a multi-step task, search kind skill for a workflow. Reread a docs hit with its document (and revision, for agreements) before you cite it.
teach_start_synthetic_evaluation
ChatGPTApp-only Demo Seller action. Starts the fixed synthetic held-out evaluation after the synthetic teaching sources are ready.
test_creative_macros
ChatGPTDry-runs one tracker URL through exact raw input, canonical AdCP compilation, recipient translation, and deterministic synthetic substitution. Use it before preview or trafficking; unresolved required macros fail closed.