A
SpendGuard
Sign In
Get Started
Developer Portal

API Reference

Public beta API reference for sandbox-first agent spend. Management credentials stay in trusted backend code; agent tools use short-lived execution tokens and SpendGuard action routes.

BASE URLhttps://sandbox.spendguard.dev/v1

Authentication

Management routes use a backend-held management credential. Agent payment execution uses a short-lived execution token minted for one agent, mandate, action, and audience.

HTTP Header
Authorization: Bearer $SPENDGUARD_MANAGEMENT_KEY
Authorization: Bearer $SPENDGUARD_EXECUTION_TOKEN

Public beta remains sandbox-first. Production preview requires a completed tenant go/no-go packet with hosted health, hosted activation, provider, webhook, reconciliation, support, and rollback evidence.

Agents

POST/v1/agentsRegister a new agent
GET/v1/agents/:idGet agent details
DELETE/v1/agents/:idRevoke an agent

Payments

POST/v1/paymentsExecute a governed sandbox payment with an execution token
GET/v1/payments/:idGet payment status
GET/v1/paymentsList payments

Mandates

POST/v1/mandatesCreate a mandate
GET/v1/mandates/:idGet mandate details
PUT/v1/mandates/:idUpdate a mandate

Wallets

POST/v1/walletsCreate a wallet
GET/v1/wallets/:id/balanceGet wallet balance
POST/v1/wallets/:id/fundFund a wallet

Webhooks

POST/v1/webhooksCreate webhook endpoint
GET/v1/webhooks/:id/deliveriesGet delivery logs

SpendGuard Actions

POST/v1/spend-guard/estimateEstimate payment, token, tool, or delegated spend
POST/v1/spend-guard/authorizeReturn allow, deny, or approval-required without mutating budget
POST/v1/spend-guard/reservationsReserve budget before an agent action executes
POST/v1/spend-guard/reservations/:id/captureCapture reserved spend after a successful outcome
POST/v1/spend-guard/reservations/:id/releaseRelease reserved spend after failure or cancellation
GET/v1/spend-guard/usage/summarySummarize SpendGuard control-plane events
GET/v1/spend-guard/reservationsList reservation lifecycle evidence
GET/v1/spend-guard/budget-leasesList child-agent budget leases and remaining capacity
POST/v1/spend-guard/budget-leasesAllocate bounded budget to a child agent
POST/v1/spend-guard/budget-leases/:id/releaseRelease an active child-agent budget lease

Rate Limits

Sandbox Beta

Capped by beta launch packet

Controlled Preview

Tenant go/no-go packet

Enterprise GA

Deferred commercial boundary

Need Help?

Our engineering team is here to support your implementation. Join our developer discord or reach out via email.