What an agent can change
Each call takes up to 50 objects in one ad account. A level below the one listed turns
the yes into an approval link. See Access levels and approvals.
Only what agents made
DATALYR keeps its own record of every object agents created through it.
Archive and delete also take everything underneath. A campaign takes its ad sets and
ads along, so every one of them must be agent-made too. For archive and delete, a copy
made with Ads Manager’s Duplicate doesn’t count as agent-made, even with the
datalyr-agent label.
Pause
pause_ad_objects pauses campaigns, ad sets or ads. It pauses the campaign first, so
spend stops soonest. To pause everything agents turned on at once, use
Stop agent ads.
Change a budget
Ask for a new amount in the ad account’s currency.50 means 50.00.
Give an ad new content (Meta)
update_ad_content replaces the text, image or video, link and call to action of one
Meta ad. The agent sends the full new ad, as for a create.
- The agent previews. DATALYR runs the same checks and placement previews as a new ad in that ad set.
- You read the summary:
Budget, targeting and status (…) stay as they are. - You say yes. Meta gets a new creative, and the ad switches to it.
Archive (Meta)
archive_ad_objects stops delivery and keeps the reporting. Archived objects can’t be
edited, and a person can unarchive them in Ads Manager. Prefer it to delete on Meta.
Delete (Meta and TikTok)
delete_ad_objects removes agent-made campaigns, ad sets, ad groups or ads, and everything
under them. DATALYR tells agents to delete only when you ask for it. It applies directly only for
the owner in chat with Publish live. Every other yes becomes an approval link for the owner.
Verify
- Ask the agent for the status of the objects it changed.
- It calls
get_ad_objects, which returns status, budget and today’s spend for up to 50 objects. - Compare with Ads Manager.
- Open Settings → Ad publishing → Activity.
- Confirm the change appears in the list.
When it does not work
Next
- Stop agent ads and alerts: pause everything at once.
- Turn ads on within spend limits: how raises count.
- Agent ad tools: the inputs of each change tool.