Operations 21
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“Which campaigns are running for a particular advertiser?”
“Can I include archived campaigns when listing?”
Tell an agent
List campaigns for advertiser {advertiserId}.
Show campaigns with status {status}.
Ask an LLM
“How do I start a new ad campaign?”
“Will my campaign brief be screened by content moderation when I create it?”
Tell an agent
Create a new campaign.
Draft a new campaign with a brief for my advertiser.
Ask an LLM
“Can I edit a campaign's name or brief after creating it?”
“What happens if my updated campaign brief violates moderation policy?”
Tell an agent
Update campaign {id}.
Change the brief on campaign {id}.
Ask an LLM
“Can I see the full detail of one campaign including its property lists?”
“Is there a way to fetch fresh campaign data rather than cached?”
Tell an agent
Get campaign {id}.
Show campaign {id} with product details.
Ask an LLM
“Can I delete a campaign I no longer need?”
“Is deleting a campaign permanent?”
Tell an agent destructive · confirm first
Delete campaign {id}.
Remove campaign {id} entirely.
Ask an LLM
“How is my tracked campaign actually delivering right now?”
“Can I break campaign delivery down by placement?”
Tell an agent
Get live delivery for campaign {campaignId}.
Show delivery for campaign {campaignId} from {startDate} to {endDate} broken down by placement.
Ask an LLM
“How do I launch a campaign so it starts delivering ads?”
“Can I get debug details when a campaign launch fails?”
Tell an agent
Launch campaign {id}.
Execute campaign {id} with debug output {debug}.
Ask an LLM
“Does pausing a campaign also pause all of its media buys?”
“Can I stop a running campaign temporarily?”
Tell an agent
Pause campaign {id}.
Pause all delivery on campaign {id}.
Ask an LLM
“How do I resume a campaign I paused?”
“Does reactivating a campaign restart its paused media buys too?”
Tell an agent
Reactivate campaign {id}.
Resume paused campaign {id} and its media buys.
POST
/campaigns/{campaignId}/auto-select-products
Auto-select products for a campaign · Auto-select products
#
Ask an LLM
“Can Scope3 pick products automatically for my draft performance campaign?”
“Is there a cap on how many products auto-selection chooses?”
Tell an agent
Auto-select products for campaign {id}.
Auto-select up to {maxProducts} products for campaign {id}.
GET
/campaigns/{campaignId}/media-buy-status
Poll live ADCP status of a campaign's media buys · Get media buy ADCP status
#
Ask an LLM
“What is the live seller-side status of every media buy in my campaign?”
“Can I sync media buy statuses from the sales agents for a campaign?”
Tell an agent
Poll ADCP status for all media buys in campaign {id}.
Check live sales-agent status of campaign {id}'s media buys.
Ask an LLM
“Why is my media buy not delivering yet?”
“What error code and pending reason does a single media buy have?”
Tell an agent
Get media buy {mediaBuyId}.
Explain why media buy {mediaBuyId} is pending.
Ask an LLM
“Can I change the end date or creatives of one media buy?”
“Is it possible to edit a media buy's packages without touching the campaign?”
Tell an agent
Change the end time of media buy {mediaBuyId} to {end_time}.
Swap the creatives on media buy {mediaBuyId} to {creative_ids}.
Ask an LLM
“Which packages make up a media buy and what are their flight dates?”
“Can I see each package's pacing period?”
Tell an agent
List packages in media buy {mediaBuyId}.
Show products and pacing for each package of media buy {mediaBuyId}.
Ask an LLM
“Can I pause one media buy without pausing the whole campaign?”
“Will pausing a media buy affect its sibling buys?”
Tell an agent
Pause media buy {mediaBuyId}.
Pause only media buy {mediaBuyId}, leaving the rest running.
Ask an LLM
“Can I resume one paused media buy on its own?”
“Does reactivating a media buy touch other buys in the campaign?”
Tell an agent
Reactivate media buy {mediaBuyId}.
Resume paused media buy {mediaBuyId} only.
Ask an LLM
“What products are queued on my campaign before launch?”
“Which discovery run found each product on a campaign?”
Tell an agent
List products staged on campaign {id}.
Show the queued products and their media buys for campaign {id}.
Ask an LLM
“What targeting dimensions can I use in campaign constraints?”
“Can I get targeting dimension names in another language?”
Tell an agent
List the supported targeting dimensions.
Show targeting dimensions in locale {locale}.
GET
/targeting/dimensions/{system}
List codes for a targeting dimension · List targeting dimension values
#
Ask an LLM
“Which codes are valid for a given targeting dimension?”
“Can I get all code-name pairs for one targeting system?”
Tell an agent
List the values for targeting dimension {system}.
Show code-name pairs for {system} in locale {locale}.
GET
/targeting/dimensions/{system}/resolve
Resolve text to targeting codes · Resolve targeting dimension text
#
Ask an LLM
“How do I turn a place or label typed in plain text into a targeting code?”
“Can I tell when a targeting text match is ambiguous?”
Tell an agent
Resolve {q} to a code in targeting dimension {system}.
Look up targeting code candidates for {q} within {system}.
Ask an LLM
“Which metro area codes can I target?”
“Are geo metro codes numeric strings?”
Tell an agent
List the geo metro codes.
Show geo metros for system {system}.