agent-cards cards preset save

Save (or update) a named preset from rule flags

agent-cards cards preset save --help

Usage: agent-cards cards preset save [options] <name>

Save (or update) a named preset from rule flags

Options:
  --total <dollars>          Lifetime spend cap in US dollars
  --per-day <dollars>        Spend cap per rolling 24 hours, in US dollars
  --per-week <dollars>       Spend cap per rolling 7 days, in US dollars
  --per-month <dollars>      Spend cap per rolling 30 days, in US dollars
  --only-categories <list>   Restrict to categories (strict), comma-separated:
                             meals, groceries, travel, software, ai, wellness,
                             retail
  --watch-categories <list>  Categories in Watch mode (allow + notify on
                             mismatch): meals, groceries, travel, software,
                             ai, wellness, retail
  --only-merchants <list>    Restrict to merchant name patterns,
                             comma-separated
  --only-in <places>         Restrict to places, comma-separated: a country
                             (US, Canada), a region (europe, eu,
                             north-america, apac), a US state (California,
                             US-CA). A region expands to its countries; a
                             state next to a region narrows only the US,
                             e.g. north-america,US-CA
  --only-currencies <codes>  Restrict to purchase currencies (strict),
                             comma-separated ISO 4217 codes or names: usd,eur
                             or dollars,euros,pounds,yen. Checked by Agentcard
                             at checkout and settlement, not by the card
                             network
  --watch-currencies <codes> Purchase currencies in Watch mode (allow + notify
                             on mismatch), comma-separated: usd,eur. Checked
                             by Agentcard, not by the card network
  --only-days <days>         Restrict to days, comma-separated: mon,tue or
                             weekdays/weekends
  --only-hours <range>       Restrict to an hour range, e.g. 9-17 or
                             09:00-17:00 (24-hour; defaults to UTC without
                             --timezone)
  --timezone <tz>            IANA timezone for --only-days/--only-hours
                             (default UTC), e.g. America/Los_Angeles
  --only-from <programs>     Restrict to callers, comma-separated: cli, mcp,
                             api, browser
  --json                     Output as JSON
  -h, --help                 display help for command

Save a set of rules under a name and reuse it with cards create --preset <name> or cards preset --set <name>. Save a name you already use and your change applies to the cards you create from now on; cards you already have keep the rules they were created with. The built-in names daily, weekday_meals, cli_only, and ai_labs cannot be saved over. Pass at least one rule flag. --timezone applies only with --only-days or --only-hours and must be a real IANA zone; a misspelled zone is refused.

agent-cards cards preset save lunch --per-day 25 --only-categories meals
agent-cards cards preset save weekday_meals_watch \
  --watch-categories meals --only-days weekdays --only-hours 11-14 \
  --timezone America/Los_Angeles
agent-cards cards preset save west-coast --only-in 'California, Oregon, Washington'
agent-cards cards preset save euro-zone --only-currencies 'dollars, euros'
agent-cards cards preset save euro-zone-watch --watch-currencies usd,eur
agent-cards cards create --amount 80 --preset lunch -y

The flags mean the same as on cards create. Categories, Strict and Watch, places, currencies, and time windows are explained in Set rules on a card. Save the currencies a card may pay in:

agent-cards cards preset save euro-zone --only-currencies 'dollars, euros'

A charge in any other currency is refused, and you are told why. Write codes or plain names in any case, comma-separated. If you would rather be told than refused, use --watch-currencies with the same list; pass one of the two, not both. The saved rule reads Currency: USD, EUR in the summary. Captured from a local sandbox:

── Preset saved ────────────────
│ Preset   Currency: USD, EUR. │
│ Version  v1                  │
│ Saved euro-zone.             │
└──────────────────────────────┘

If you write a name that means several currencies, the save is refused and the message lists what it could mean, so you can pick. A code that is not a currency is refused the same way. agent-cards cards preset save euro-zone --only-currencies pesos exits 1 with:

"pesos" could be MXN, ARS, CLP, COP, or PHP. Write the currency code, or name the country (Mexican pesos).

With --json the same refusal is one JSON line on stdout:

{"ok":false,"error":"policy_invalid","message":"\"pesos\" could be MXN, ARS, CLP, COP, or PHP. Write the currency code, or name the country (Mexican pesos)."}

CLI

Auth

Cards

Wallet and balance

Payment methods

Plan

Buy

Identity and rewards

Connections and approvals

Settings and tools

For coding agents

Engineer

Companies

Companies: credentials

Companies: balance

Companies: webhooks

agent-cards cards preset save