Scheduled Sume agent runs: the $1.00 default cap and min(request, cap)

A Sume schedule saves a spend cap, defaulting to $1.00 when unset. An API trigger can lower a run's cap but never raise it past the saved one.

5 min readSume
All posts

A schedule has its own saved cap, and an API-triggered run is clamped to the smaller of the request and that cap. If the schedule does not set one, the docs give a default of $1.00. So a trigger can only lower what a run may spend. Raise the saved cap on the schedule itself if the work needs more, and do it on purpose.

How the cap shows up

A run also reports what it did. usage.billable_amount_usd_micros is the generation spend of that run, and generation_spend_cap_usd_micros is the ceiling that applied. usage is null when Sume could not read the spend, which is different from 0.

Scheduled run cap behavior (read 2026-10-05)
CaseSaved capRequest capCap that applies
No request capSet on the schedulenoneSaved cap
Lower requestSet on the scheduleBelow the saved capThe request
Higher requestSet on the scheduleAbove the saved capSaved cap
Nothing savedUnsetnone$1.00 default

Two limits to remember

The receipt figure excludes the agent's own LLM turn, which bills the separate Agent wallet, and GET /v1/usage is the authoritative record. Read Runs and results before you build a cost alert on billable_amount_usd_micros alone.

A schedule that is still running when the next fire arrives does not stack: the new run has status skipped and skip_reason of previous_run_active.

Check the docs before you ship

Sume's limits and field names change faster than blog posts do. Read the linked docs pages for the current request fields before you ship, and send a dry_run or a low spend cap on your first real call.

Sources

Related posts

More in Agents

All Agents posts

Written by Sume