Skip to main content

Agents

Create and manage AI agent accounts

Create Agent

POST /v1/agents

Creates a new agent with a virtual card and crypto wallets.

{
  "name": "Ad Spender",
  "budget": 50000,
  "description": "Manages Google Ads campaigns"
}

Response

{
  "data": {
    "id": "agent_abc123",
    "name": "Ad Spender",
    "status": "active",
    "budget_allocated": 50000,
    "budget_spent": 0,
    "card_last4": "4242",
    "evm_wallet_address": "0x7a3f...8c21",
    "created_at": "2026-03-28T12:00:00Z"
  }
}

List Agents

GET /v1/agents

Returns all agents for the authenticated organization.

Freeze Agent (Kill Switch)

POST /v1/agents/:id/freeze

Instantly freezes the agent's card and wallets. Takes effect in under 2 seconds.