Agent Management

What Is an Agent Plan?

An agent plan is the core unit in Router9. Each agent plan gets:

• A unique API key for authentication
• Its own usage quotas (rate limits and skill quotas)
• Isolated file storage
• Separate audit logs
• An independent subscription tier (Free, Assistant, or Engineer)

Think of each agent plan as a dedicated environment for one AI agent or application.

Creating an Agent Plan

1. Go to the Dashboard
2. Click New Agent Plan
3. Enter a name (required, max 100 characters) and optional description
4. Click Create

You'll be redirected to the API Keys tab where your new key is displayed.

Fleet Dashboard

The dashboard provides a fleet-level overview of all your agent plans:

• Agent Plans Table — Shows each agent's name, plan tier, and real-time usage
• Usage Bars — Color-coded progress for 4-hour and weekly windows
  • Green: Under 80%
  • Yellow: 80-95%
  • Red: Over 95%
• Fleet Summary — Aggregated usage across all agents
• Alerts — Real-time warnings when agents approach or exceed limits

Agent Detail Pages

Click Manage on any agent to access its detail pages:

API Key Management

Each agent has a single active API key. After creating an agent or regenerating a key, the full key is displayed only once.

Integration Snippet

The API Keys tab provides a ready-to-copy .env block:

OPENAI_BASE_URL=https://api.router9.com/v1
OPENAI_API_KEY=sk-r9k-your-key-here

Regenerating a Key

1. Go to Agent → API Keys
2. Click Regenerate Key
3. Confirm in the dialog (this immediately invalidates the old key)
4. Copy the new key — it won't be shown again

Managing via API

List Agents

GET /v1/agents

Create Agent

POST /v1/agents

{
  "name": "My Production Agent",
  "description": "Handles customer support"
}

Update Agent

PATCH /v1/agents/:id

{
  "name": "Updated Name",
  "description": "Updated description"
}

Delete Agent

DELETE /v1/agents/:id

Regenerate Key

POST /v1/agents/:id/key/regenerate

Returns the new full key (displayed once).