API Introduction

🚧 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

Tier	Requests/minute	Requests/day
Free	10	100
Pro	120	10,000
Enterprise	Unlimited	Unlimited

Rate limit headers are included on every response:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1713000060

Core endpoints

Endpoint	Description
`GET /context`	Full operational context — the single call that returns everything
`POST /directives`	Issue a new directive to the consigliere
`GET /approvals`	List pending approval gates
`POST /approvals/{id}/approve`	Approve a queued move
`POST /approvals/{id}/reject`	Reject with feedback
`GET /reports/daily`	Retrieve the current or historical Daily Report
`GET /agents`	List all active capo agents and their status
`POST /guardian/kill-switch`	Halt all autonomous operations
`GET /standing-orders`	List active standing orders
`POST /standing-orders`	Create 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 @bossmode/sdk
MCP server — npm i -g @bossmode/mcp-server
CLI — npm i -g @bossmode/cli

Community SDKs are not yet available. If you build one, open a PR on GitHub.

Getting Started

Headless

Business Packs

Trust Intelligence

Governance

Daily Report

API Reference

Self-Hosting

Integrations

Agent Deployer

Base URL

Authentication

Response format

Rate limits

Core endpoints

Versioning

SDKs

​Base URL

​Authentication

​Response format

​Rate limits

​Core endpoints

​Versioning

​SDKs

Base URL

Authentication

Response format

Rate limits

Core endpoints

Versioning

SDKs