API keys

Use API keys to run Spud Agents from CI, scripts, or the CLI. Keys scope to a workspace and inherit that workspace's rate limits.

Treat keys like passwords. Spud shows the full secret exactly once, at creation. If you've lost a key, rotate it — don't share it in Slack or paste it into a shared doc.

LabelSecretCreated byScopesLast used

Production · CI runner

sk_live_8hF2 · Feb 04, 2026

…ff21Priya Nair

agents:runworkspace:read

2 min ago

Staging · Jenkins

sk_live_2kX9 · Jan 22, 2026

…a7e4Rahul Desai

agents:run

42 min ago

Local — Priya's laptop

sk_live_1qN4 · Jan 14, 2026

…b219Priya Nair

agents:runworkspace:readworkspace:write

Yesterday

Quickstart

Run a Spud Agent from your terminal

API docs

curl https://api.spud.dev/v1/agents/run \
  -H "Authorization: Bearer $SPUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "spud-dev-ai",
    "repo": "acme-fintech/ledger",
    "branch": "feat/batch-webhooks",
    "prompt": "Refactor UPI reconciliation to batch webhooks"
  }'