Your inbox, read and organized.
The Boss ingests forwarded email over IMAP, classifies and summarizes each message locally with Qwen, embeds it into pgvector for semantic search, and exposes a REST API for opportunities, tasks, people, companies, and the relationships between them.
Typed CRUD
POST, PATCH, DELETE on opportunities, tasks, people, companies, and entity-links. Embeddings and user-scoping are handled for you.
Semantic search
POST /v1/search embeds your query server-side with mxbai-embed-large (1024-dim) and ranks across messages, tasks, people, companies, and opportunities.
Director protocol
Drive real mailbox actions — move, flag, delete, send, forward — by sending [COMMAND] emails from [email protected] to the user’s Outlook.
Raw SQL escape hatch
When no typed endpoint fits: POST /v1/admin/query (admin bearer only). Pair with GET /v1/admin/schema to learn table shapes first.
Authentication
All paths except /health, /openapi.json, /docs, and this page require
Authorization: Bearer <token>. Admin tokens start with tb_; user tokens start
with tb_user_ and are scoped to that user’s rows.
curl -H "Authorization: Bearer $TOKEN" https://code.theboss.ai/v1/opportunities