Docs › HTTP API
HTTP API
Base URL https://api.runvouch.com. Auth: X-API-Key. JSON in, JSON out. Rate limit 600 requests/min per key.
On this page
Endpoints
| Method · path | Purpose |
|---|---|
POST /signup | {"email"} → free account + key (shown once) |
GET /v1/me · POST /v1/me/rotate-key | account, plan, key rotation |
PUT /v1/settings | telegram_token, telegram_chat, webhook_url · POST /v1/settings/test-alert |
POST /v1/agents · GET /v1/agents | upsert (name, cadence_s, grace_s, max_runtime_s, cap_run_cost, cap_day_cost, cap_run_tokens, evidence_required) · list with state |
POST /v1/agents/{name}/pause · GET /v1/agents/{name}/runs | pause/resume · run history |
POST /v1/runs/start · /tool · /heartbeat · /end | run lifecycle; tool events carry tool, input (hashed server-side) or input_hash, ok, cost, tokens |
GET /v1/alerts · POST /v1/alerts/{id}/ack | alerts |
Alert webhook payload
{"kind":"RETRY_STORM","agent":"repo-janitor","run_id":"9808c5af…","message":"tool 'Bash' called 41x with identical input in one run.","ts":1787673506.3}Need a key? Get one free · Stuck? [email protected]