Developers
REST API
Integrate BotForge with your stack. Authenticate with a scoped API key and manage customers, orders, products, tickets and analytics over HTTPS.
Authentication
Create a key in the dashboard under Developers → API keys, then send it as a Bearer token. Keys are scoped to specific permissions and can be IP-restricted.
curl https://bot-forge-coral.vercel.app/api/v1/customers \
-H "Authorization: Bearer bf_live_xxx"Endpoints
| GET | /v1/customers | List customers |
| GET | /v1/customers/:id | Get a customer |
| GET | /v1/orders | List orders (?status=) |
| GET | /v1/orders/:id | Get an order |
| GET | /v1/products | List products |
| POST | /v1/products | Create a product |
| PUT | /v1/products/:id | Update a product |
| DELETE | /v1/products/:id | Delete a product |
| GET | /v1/tickets | List tickets (?status=) |
| GET | /v1/tickets/:id | Get a ticket |
| GET | /v1/analytics | Workspace summary |
List endpoints accept ?limit (max 100) and ?offset. Full machine-readable spec at /api/v1/openapi.json.
Rate limits
Limits are per plan. Exceeding them returns 429 with a Retry-After header.
| Plan | Req / min | Req / day |
|---|---|---|
| Free | 10 | 1,000 |
| Starter | 60 | 10,000 |
| Pro | 300 | 100,000 |
| Agency | 1,000 | 1,000,000 |
| Enterprise | Custom | Custom |
Responses: 401 invalid key · 403 missing scope / IP blocked · 429 rate limited.