Eskyee · mintlify · Mar 20, 2026
diff --git a/api-reference/agents.mdx b/api-reference/agents.mdx
@@ -35,29 +35,6 @@
 }
 ```
 
-## Create agent
-
-```http
-POST /api/agents
-```
-
-### Request body
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| `name` | string | Yes | Name of the agent |
-| `config` | object | No | Agent configuration |
-
-### Response
-
-```json
-{
-  "id": "agent_456",
-  "name": "My Agent",
-  "status": "deploying"
-}
-```
-
 ## Get agent
 
 ```http
@@ -95,40 +72,6 @@
 | 404 | Agent not found or not owned by user |
 | 500 | Failed to fetch agent |
 
-## Update agent
-
-```http
-PUT /api/agents/:id
-```
-
-### Request body
-
-Any valid agent configuration fields.
-
-### Response
-
-```json
-{
-  "id": "agent_123",
-  "message": "Agent updated"
-}
-```
-
-## Delete agent
-
-```http
-DELETE /api/agents/:id
-```
-
-### Response
-
-```json
-{
-  "id": "agent_123",
-  "message": "Agent deleted"
-}
-```
-
 ## Provision agent
 
 ```http
@@ -527,7 +470,7 @@

 ## Agent verification

 Agents can be verified using multiple verification types: `eas` (Ethereum Attestation Service), `coinbase`, `ens`, or `webauthn`.

 ### Get verification status

@@ -600,7 +543,7 @@

 Provisions a new agent with messaging channel tokens. Requires authentication. Rate-limited per IP. At least one channel token is required.

 A dedicated Mux live stream is automatically created for the agent.

 ### Request body

@@ -624,18 +567,51 @@
 {
   "success": true,
   "userId": "a1b2c3d4e5f6g7h8",
+  "agentId": "agent_789",
+  "id": "a1b2c3d4e5f6g7h8",
+  "aiProvider": "openrouter",
+  "aiProviderConfig": {
+    "model": "anthropic/claude-sonnet-4-20250514",
+    "baseUrl": "https://openrouter.ai/api/v1",
+    "requiresKey": true
+  },
+  "plan": "free",
+  "streamKey": "live_abc123",
+  "liveStreamId": "stream_456",
+  "rtmpServer": "rtmps://global-live.mux.com:443/app",
+  "playbackUrl": "https://stream.mux.com/abc123.m3u8",
   "subdomain": "a1b2c3d4e5f6g7h8.agents.localhost",
   "url": "https://a1b2c3d4e5f6g7h8.agents.localhost",
-  "streamKey": "live_abc123",
-  "liveStreamId": "stream_456"
+  "hls": {
+    "playlistUrl": "https://stream.mux.com/abc123.m3u8"
+  },
+  "rtmp": {
+    "server": "rtmps://global-live.mux.com:443/app",
+    "key": "live_abc123"
+  },
+  "status": "active",
+  "createdAt": "2026-03-19T00:00:00Z",
+  "metadata": {
+    "channels": {
+      "telegram": true,
+      "discord": false,
+      "whatsapp": false
+    },
+    "streaming": {
+      "provider": "mux",
+      "lowLatency": true,
+      "resolution": "1080p",
+      "bitrate": "5000kbps"
+    }
+  }
 }
 ```
 
 ### Errors
 
 | Code | Description |
 |------|-------------|
-| 400 | At least one channel token required (Telegram, WhatsApp, or Discord) |
+| 400 | At least one channel token required, invalid AI provider, or invalid plan |
 | 401 | Unauthorized |
 | 429 | Too many requests |
 | 500 | Internal server error |
@@ -859,12 +835,48 @@
 POST /api/chat
 ```
 
+Requires session authentication.
+
 ### Request body
 
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `message` | string | Yes | Message to send |
+| `topic` | string | No | Conversation topic |
+
+### Response
+
 ```json
 {
-  "agentId": "agent_123",
+  "id": "msg_abc123",
   "message": "Hello!",
-  "platform": "telegram"
+  "topic": "general",
+  "status": "sent",
+  "timestamp": "2026-03-19T00:00:00Z",
+  "reply": "Message received by agent"
+}
+```
+
+### Get chat history
+
+```http
+GET /api/chat
+```
+
+Requires session authentication.
+
+```json
+{
+  "messages": [],
+  "count": 0
 }
 ```
+
+### Errors
+
+| Code | Description |
+|------|-------------|
+| 400 | Message required |
+| 401 | Unauthorized |
+| 500 | Failed to send message or failed to fetch messages |
+```
diff --git a/api-reference/ai.mdx b/api-reference/ai.mdx
@@ -7,6 +7,40 @@
 
 Endpoints for interacting with AI models through a unified provider layer. These endpoints are served by the backend API and do not require session authentication.
 
+## List models (frontend)
+
+```http
+GET /api/models
+```
+
+Returns available AI models from OpenRouter with additional featured models. No authentication required.
+
+### Response
+
+```json
+{
+  "models": [
+    {
+      "id": "anthropic/claude-sonnet-4-20250514",
+      "name": "Claude Sonnet",
+      "contextLength": 200000,
+      "pricing": {
+        "prompt": 0.003,
+        "completion": 0.015
+      },
+      "featured": true,
+      "description": "Anthropic's Claude Sonnet model"
+    }
+  ]
+}
+```
+
+### Errors
+
+| Code | Description |
+|------|-------------|
+| 500 | Failed to fetch models or invalid response from provider |
+
 ## Health check
 
 ```http

diff --git a/api-reference/keys.mdx b/api-reference/keys.mdx
@@ -5,7 +5,7 @@

 # API keys

 Create and manage API keys for authenticating with the Agentbot API. All endpoints require session authentication.

 ## List keys

@@ -29,6 +29,13 @@
 }
 ```
 
+### Errors
+
+| Code | Description |
+|------|-------------|
+| 401 | Unauthorized |
+| 500 | Failed to fetch keys |
+
 ## Create key
 
 ```http
@@ -88,6 +95,7 @@
 |------|-------------|
 | 401 | Unauthorized |
 | 404 | Key not found |
+| 500 | Failed to fetch key |
 
 ## Delete key
 
@@ -111,3 +119,4 @@
 |------|-------------|
 | 401 | Unauthorized |
 | 404 | Key not found |
+| 500 | Failed to delete key |
diff --git a/api-reference/overview.mdx b/api-reference/overview.mdx
@@ -1,11 +1,11 @@
 ---
 title: API reference
 description: "Complete API reference for Agentbot"
 ---

 # API reference

 Complete API reference for Agentbot.

 ## Base URL

@@ -15,7 +15,7 @@

 ## Authentication

 Agentbot supports two authentication methods depending on the endpoint.

 ### Session authentication

@@ -88,10 +88,7 @@
 |----------|--------|-------------|
 | `/api/v1/gateway` | POST | Route requests to plugins with Stripe or [MPP](/payments/mpp) payment |
 | `/api/agents` | GET | List all agents |
-| `/api/agents` | POST | Create an agent |
 | `/api/agents/:id` | GET | Get agent details |
-| `/api/agents/:id` | PUT | Update an agent |
-| `/api/agents/:id` | DELETE | Delete an agent |
 | `/api/agents/:id/config` | GET | Get agent configuration |
 | `/api/agents/:id/config` | PUT | Update agent configuration |
 | `/api/agents/:id/logs` | GET | Get agent logs |
@@ -112,6 +109,8 @@
 | `/api/agents/provision` | POST | Provision a new agent |
 | `/api/agents/provision` | GET | List provisioned agents |
 | `/api/chat` | POST | Send message to agent |
+| `/api/chat` | GET | Get chat history |
+| `/api/models` | GET | List available AI models |
 | `/api/health` | GET | Health check |
 | `/api/heartbeat` | GET | Get heartbeat settings |
 | `/api/heartbeat` | POST | Update heartbeat settings |
@@ -145,8 +144,8 @@
 | `/api/auth/callback/wallet` | POST | Wallet sign in (SIWE) |
 | `/api/auth/forgot-password` | POST | Request password reset |
 | `/api/auth/reset-password` | POST | Reset password |
 | `/api/auth/farcaster/verify` | POST | Verify Farcaster identity |
 | `/api/auth/farcaster/refresh` | POST | Refresh Farcaster token |
 | `/api/auth/token-gating/verify` | GET, POST | Verify token gating access |
 | `/api/billing` | GET | Get billing info |
 | `/api/billing` | POST | Billing actions (checkout, BYOK, usage, credits) |
@@ -162,7 +161,7 @@

 ## SDK

 Use the Agentbot SDK:

 ```bash
 npm install @agentbot/sdk

diff --git a/api-reference/wallet.mdx b/api-reference/wallet.mdx
@@ -5,7 +5,7 @@

 # Wallet API

 Manage wallets for on-chain transactions and payments. Supports both session-based wallets and Coinbase Developer Platform (CDP) wallets.

 ## Get wallet

@@ -30,7 +30,7 @@
      "x402_payments"
    ]
  },
  "instructions": "CDP Agentic Wallet is configured. Use /api/wallet/cdp/* endpoints."
 }
 ```

@@ -115,7 +115,9 @@
 |------|-------------|
 | 400 | Invalid action or wallet already exists |
 | 401 | Unauthorized |
+| 403 | Seed export is disabled for security (for `export_seed`) |
 | 404 | No wallet found (for `get_seed`) |
+| 500 | Failed to fetch wallet or failed to process request |
 
 ## Get CDP wallet address
 
@@ -123,7 +125,7 @@
 GET /api/wallet/address
 ```

 Returns the address of the CDP Agentic Wallet.

 ### Response (authenticated)

@@ -150,7 +152,7 @@
 POST /api/wallet/create
 ```

 Creates a new wallet using the Coinbase Developer Platform SDK.

 ### Request body

@@ -198,7 +200,7 @@
 POST /api/wallet/cdp
 ```

 Creates a viem wallet client on Base Sepolia.

 ### Request body