# BOSS Public API

> Tenant-scoped BOSS developer API. Coding agents must treat OpenAPI and these Markdown pages as authoritative. Never invent endpoints, fields, or scopes.

API version: v1
Generated: 2026-09-07T09:04:44+00:00

## Machine-readable assets

- [OpenAPI JSON](https://pieceofmind.coreware.app/openapi.json)
- [OpenAPI YAML](https://pieceofmind.coreware.app/openapi.yaml)
- [Full documentation](https://pieceofmind.coreware.app/llms-full.txt)
- [AI instructions](https://pieceofmind.coreware.app/docs/ai/instructions.md)
- [MCP server](https://pieceofmind.coreware.app/docs/mcp)

## Guides

- [Overview](https://pieceofmind.coreware.app/docs/overview.md)
- [Authentication](https://pieceofmind.coreware.app/docs/authentication.md)
- [API conventions](https://pieceofmind.coreware.app/docs/conventions.md)
- [Pagination](https://pieceofmind.coreware.app/docs/pagination.md)
- [Errors](https://pieceofmind.coreware.app/docs/errors.md)
- [Rate limits](https://pieceofmind.coreware.app/docs/rate-limits.md)
- [Idempotency](https://pieceofmind.coreware.app/docs/idempotency.md)
- [Webhooks](https://pieceofmind.coreware.app/docs/webhooks.md)
- [Changelog](https://pieceofmind.coreware.app/docs/changelog.md)
- [Knowledge Studio](https://pieceofmind.coreware.app/docs/knowledge.md)
- [Build with AI](https://pieceofmind.coreware.app/docs/ai.md)
- [AI Quickstart](https://pieceofmind.coreware.app/docs/ai/quickstart.md)
- [BOSS API Instructions for Coding Agents](https://pieceofmind.coreware.app/docs/ai/instructions.md)
- [Use the BOSS API with Cursor](https://pieceofmind.coreware.app/docs/ai/cursor.md)
- [Claude Code / AGENTS.md](https://pieceofmind.coreware.app/docs/ai/agents-md.md)
- [GitHub Copilot](https://pieceofmind.coreware.app/docs/ai/copilot.md)
- [Other AI agents](https://pieceofmind.coreware.app/docs/ai/other.md)
- [BOSS MCP Server](https://pieceofmind.coreware.app/docs/ai/mcp.md)
- [Prompt library](https://pieceofmind.coreware.app/docs/ai/prompts.md)
- [Integration recipes](https://pieceofmind.coreware.app/docs/ai/recipes.md)
- [Contacts](https://pieceofmind.coreware.app/docs/api/contacts.md)
- [Sales](https://pieceofmind.coreware.app/docs/api/sales.md)
- [Offerings](https://pieceofmind.coreware.app/docs/api/offerings.md)
- [Scheduling](https://pieceofmind.coreware.app/docs/api/scheduling.md)
- [Facilities](https://pieceofmind.coreware.app/docs/api/facilities.md)
- [Subscriptions](https://pieceofmind.coreware.app/docs/api/subscriptions.md)
- [Memberships](https://pieceofmind.coreware.app/docs/api/memberships.md)
- [Products](https://pieceofmind.coreware.app/docs/api/products.md)
- [Invoices](https://pieceofmind.coreware.app/docs/api/invoices.md)
- [Service](https://pieceofmind.coreware.app/docs/api/service.md)
- [Knowledge](https://pieceofmind.coreware.app/docs/api/knowledge.md)
- [Widget](https://pieceofmind.coreware.app/docs/api/widget.md)

## Rules for coding agents

- Consult the current OpenAPI specification before generating API calls.
- Use only documented v1 paths under `/api/public/v1`.
- Authenticate with `Authorization: Bearer cw_live_...`.
- Never place API tokens in browser or client-side code.
- Knowledge Studio routes require a `knowledge:*` token scope and the primary tenant.