Put discovery on a schedule
set_campaign_scheduleTurn standing discovery on or off for a campaign. Calling this is free, but switching it ON authorizes spend that happens LATER and unattended: an hourly job runs discovery on its own and bills the user 12 credits per post it finds, with nobody in the loop. So there are two steps and you must not skip the first. STEP 1 — call with enabled:true and NO confirmed flag: nothing is changed and you get back the projected daily and monthly cost, the balance, and how many days of runway that is. STEP 2 — show the user those numbers, get a real yes, then call again with confirmed:true. Never send confirmed:true on your own initiative, on an assumption, or because the user said something general like 'keep it going' — the user has to have seen a number. Turning it OFF (enabled:false) is always safe and needs no confirmation; do it whenever the user asks to stop. Limits on this path are deliberately lower than the website's: up to 4 runs/day, up to 20 posts/run, and never more than 600 projected credits/day. Read the current schedule with get_campaign.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| enabled | Yes | true starts standing discovery, false stops it | |
| confirmed | No | Set true ONLY after the user has seen the projected cost from a previous call and explicitly agreed to it. Omit on the first call — that is what produces the projection. | |
| campaign_id | Yes | ||
| posts_per_run | No | Target posts per run (1-20). Defaults to the campaign's current setting, else 5. Each post found bills 12 credits. | |
| frequency_per_day | No | Discovery runs per day (1-4). Defaults to the campaign's current setting, else 1. |