Scheduled Sume runs: cron or API trigger is fixed at create
A Sume Action is either cron or api triggered, chosen at creation. How to author one, why you cannot create it over the public API, and how to run the api kind.
An Action has a trigger_type of cron or api, and it cannot be changed after creation. Authoring happens in the dashboard at sume.com/agents/scheduled; there is no create or edit endpoint in the public API, and no MCP tool or CLI command for it. What the API does expose, under /v1/actions with aut_ ids, is running and reading Actions with the actions:read and actions:write scopes.
Only an api Action can be started on demand. Call POST /v1/actions/{handle}/{slug}/runs and poll /v1/action-runs/{id}. Team-owned Actions are not reachable over the public API.
Cron versus api
| Trigger | Starts when | Public API start |
|---|---|---|
| cron | On its schedule | No |
| api | You call the run endpoint | Yes |
Errors you will meet
Calling the run endpoint on a paused Action returns 409 action_inactive; on a cron Action it returns 409 action_api_trigger_disabled. Runs are not jobs, so poll the run, and note that events_url is always null for Action runs.
Sources
Related posts
More in Agents
- VS Code Copilot automations on a schedule: Sume jobs and idempotency
VS Code automations can run agent tasks hourly, daily, weekly or on demand. Make each Sume create idempotent so a rerun resumes a job instead of paying twice.
- What can a $5 generation spend cap make? Clips, stills, captions
A $5 cap on an Agent Completion covers 16 five-second Wan 3.0 clips at 480p, or 50 nano-banana-2 stills, but not one Seedance 2.5 clip at 720p and 15 seconds.
- What is an AI video agent? One that talks, or one that makes
An AI video agent can mean a live on-camera persona like a Tavus PAL, or an agent that makes videos for you. Which one Sume is, and how to call it from code.
- Zed ask_user forms: confirm a Sume estimate before paying
Zed's ask_user tool lets agents ask with forms. Use it as a spend checkpoint with Sume's dry_run preview, so people approve a number, not a tool name.
Written by Sume