Skip to main content
🚧 Expanding soon — full API Reference documentation is in progress.

​
Base URL

https://bossmode.ing/api/pro

​
Authentication

All API requests require your operator token in the x-bossmode-token header: 
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
  https://bossmode.ing/api/pro/context
See Authentication for token management details.

​
Response format

All responses are JSON. Successful responses have HTTP status 2xx. Errors return a standard error shape: 
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired token",
    "status": 401
  }
}

​
Rate limits

TierRequests/minuteRequests/day
Free10100
Pro12010,000
EnterpriseUnlimitedUnlimited
Rate limit headers are included on every response: 
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1713000060

​
Core endpoints

EndpointDescription
GET /contextFull operational context — the single call that returns everything
POST /directivesIssue a new directive to the consigliere
GET /approvalsList pending approval gates
POST /approvals/{id}/approveApprove a queued move
POST /approvals/{id}/rejectReject with feedback
GET /reports/dailyRetrieve the current or historical Daily Report
GET /agentsList all active capo agents and their status
POST /guardian/kill-switchHalt all autonomous operations
GET /standing-ordersList active standing orders
POST /standing-ordersCreate a new standing order

​
Versioning

The API is currently at v1. The version is not in the URL path — it’s determined by your SDK version or specified via header for breaking changes: 
X-BossMode-API-Version: 2026-04

​
SDKs

Official SDKs:
  • Node.js / TypeScript — npm i @acelabs/bossmode-sdk
  • MCP server — npm i -g @acelabs/bossmode-mcp-server
  • CLI — npm i -g @acelabs/bossmode-cli
Community SDKs are not yet available. If you build one, open a PR on GitHub.