schedule_workflow writes a new episode; it does not re-post last week's file
Run a recurring video series is one agent job. schedule_workflow regenerates on a cadence. Scheduling the same MP4 is a different job.
Set it once. It writes a new version every time it runs. Run a recurring video series is schedule_workflow on a saved scene workflow: each tick, a fresh plot around the same characters, style, and assets, then a full generate, optionally auto-posted. Using it to "post this MP4 every weekday," or using post or schedule to social media when you needed a new episode, is how you either burn a video-workflow generation per day you did not mean, or publish last Tuesday's file until someone notices.
The tool requires workflow_id. You translate the cadence into a 5-field UTC cron. Optional series premise, auto-post, accounts, caption prompt. active: false stops it. Prefer set_workflow_mode when the user language is "auto" vs "manual." Each run is priced like a full video-workflow generation, charged when that run actually generates — not when you set the clock.
You need a recipe first
Point it at a workflow that already has scenes and an asset map. No saved recipe, nothing to schedule. Save and reuse a video workflow is the keep. Scheduling is the clock. Building the recipe inside the schedule call is the wrong order.
"Post this every weekday" without "new footage each run" is social. Social reuses the file. This job is supposed to mint a new one. That mint is the bill. Do not turn it on to test a caption. Do not turn it on for a slideshow carousel — that is schedule a recurring slideshow series.
Cron is UTC. "9am" without a timezone is accepted as UTC. Daylight saving does not live on the job. Wrong hour for a week is still a week of generations if the workflow ran.
Fresh plot, same cast
The point of a series is reuse of the asset map and style, not reuse of the script. If you needed the identical cut every time, you wanted a scheduled post, not a scheduled generate. If you needed variety, do not strip the premise; a cadence without a premise is how repeats feel identical anyway.
FAQ
Does schedule_workflow upload the last export on a clock?
No. It generates a new video each tick. Re-posting a finished file is the social scheduler. Mixing those two is the credit leak (or the duplicate-post leak).
Am I charged when I set the schedule?
No. Charged when a run generates. A daily series is a daily video-workflow bill. Estimate that before you enable auto-post.
Can I schedule a slideshow with this tool?
No. Slideshow series is its own capability. This job is a saved video workflow.
What if the workflow has no scenes yet?
Save the recipe first. Scheduling an empty workflow is a clock with nothing to render, or a surprise generate of a hollow plan.