> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bossmode.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# API Introduction

> The BossMode Pro API gives you programmatic access to everything the consigliere can do. All endpoints require an operator token.

<Warning>🚧 Expanding soon — full API Reference documentation is in progress.</Warning>

## Base URL

```
https://bossmode.ing/api/pro
```

## Authentication

All API requests require your operator token in the `x-bossmode-token` header:

```bash theme={null}
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
  https://bossmode.ing/api/pro/context
```

See [Authentication](/api/authentication) for token management details.

## Response format

All responses are JSON. Successful responses have HTTP status 2xx. Errors return a standard error shape:

```json theme={null}
{
  "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.