Manage fleets of AI agents with master keys. Create, monitor, and control agents at scale.

Platform Management

Platforms are for businesses that operate fleets of AI agents. A platform operator uses a master key to create agents, set spending limits, rotate API keys, and monitor activity -- all without needing individual agent credentials.

Master keys

Master keys (mk_ prefix) authenticate platform-level operations. They are separate from agent API keys (ak_ prefix).

All platform endpoints require the X-Master-Key header:

curl -H "X-Master-Key: mk_your_master_key" \
  http://localhost:4000/v1/platform/agents

Creating a master key

Use an existing master key to create additional ones:

curl -X POST http://localhost:4000/v1/platform/master-keys \
  -H "X-Master-Key: mk_existing_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "production", "owner_email": "admin@company.com"}'

Response:

{
  "id": "key-uuid",
  "key": "mk_a1b2c3d4...",
  "name": "production",
  "owner_email": "admin@company.com",
  "created_at": "2026-03-26T12:00:00.000Z"
}

Creating agents via platform

Unlike self-registration, platform-created agents have custom credit allocations and spending limits.

curl -X POST http://localhost:4000/v1/platform/agents \
  -H "X-Master-Key: mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "research-bot",
    "email": "research@company.com",
    "credits_usd": 50.0,
    "daily_limit_usd": 200,
    "weekly_limit_usd": 1000,
    "monthly_limit_usd": 3000,
    "per_tx_limit_usd": 100
  }'

Response includes the agent's API key and wallet:

{
  "agentId": "agent-uuid",
  "apiKey": "ak_new_agent_key",
  "name": "research-bot",
  "credits_usd": 50.0,
  "wallet": {
    "id": "wallet-uuid",
    "addresses": {
      "ethereum": "0x...",
      "base": "0x...",
      "solana": "..."
    }
  },
  "spending_controls": {
    "daily_limit_usd": 200,
    "weekly_limit_usd": 1000,
    "monthly_limit_usd": 3000,
    "per_tx_limit_usd": 100
  }
}

Fleet operations

Operation	Endpoint	Description
List agents	`GET /v1/platform/agents`	Paginated list of all agents
Get agent	`GET /v1/platform/agents/:id`	Full details including wallets, controls, claim status
Update agent	`PUT /v1/platform/agents/:id`	Modify credits, spending limits, email
Delete agent	`DELETE /v1/platform/agents/:id`	Remove agent and all associated data
Rotate key	`POST /v1/platform/agents/:id/rotate-key`	Generate new API key, invalidate old one

Updating spending limits

curl -X PUT http://localhost:4000/v1/platform/agents/agent-uuid \
  -H "X-Master-Key: mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "daily_limit_usd": 500,
    "credits_usd": 100.0,
    "allowed_addresses": ["0xTrustedAddress"]
  }'

Key rotation

Rotate an agent's API key without downtime:

curl -X POST http://localhost:4000/v1/platform/agents/agent-uuid/rotate-key \
  -H "X-Master-Key: mk_your_key"

{
  "agentId": "agent-uuid",
  "oldKey": "ak_a1b...f6g7",
  "newKey": "ak_h8i9j0k1...",
  "rotated_at": "2026-03-26T12:00:00.000Z"
}

The old key is immediately invalidated.

Platforms