Mission Control API
Every Mission Control endpoint — the public contract for building your own command-center view. All endpoints are workspace-scoped (the active workspace is resolved from the session); writes require admin.
Base path: /bb-tasks/api/mission. All responses are JSON { success, … }. GET reads are open to any authenticated member; POST writes require an admin. Send/receive cookies (same-origin) just like the rest of the OpenBook API.
Overview & board
| Method · path | Returns / body |
|---|---|
GET /summary | { agents_total, agents_active, tasks_total, tasks_open, columns, online } — header counts. |
GET /agents | { agents: [{ id, name, role, level, status, reports_to_agent_id, … }] } — status derived from live runs. |
GET /board | { columns: { inbox, assigned, in_progress, review, done }, order } — each a list of task cards { id, title, description, column, agent_id, tags, status, … }. |
GET /feed?limit= | { activities: [{ actor_name, verb, summary, object_kind, object_id, created_at }] } — newest first. |
Tasks
| Method · path | Body |
|---|---|
POST /tasks/create | { title, input?, column?, agent_id?, tags? } → { id }. Defaults to the Inbox column. |
POST /tasks/move | { id, column } — column ∈ inbox|assigned|in_progress|review|done. Persists to the task's metadata + logs activity. |
POST /tasks/assign | { id, agent_id } (null to unassign) → logs activity. |
POST /tasks/tag | { id, tags: string[] } → { tags }. |
Comments & activity
| Method · path | Body / query |
|---|---|
GET /comments?task_id= | Thread for a task (omit task_id for the squad channel). { comments: [...] }. |
POST /comments/create | { body, task_id?, author_kind?, author_id?, author_name? }. @AgentName / @all in the body create notifications + a feed entry. |
POST /activity | { verb, object_kind?, object_id?, object_label?, summary?, actor_name? } — append a custom feed event (agents/integrations log here). |
Documents
| Method · path | Body / query |
|---|---|
GET /documents?task_id=&with_content= | List docs (metadata only unless with_content=true). |
GET /documents/get?id= | One document with full content. |
POST /documents/save | { id?, title, content, doc_type?, task_id? } → { id } (omit id to create). |
POST /documents/delete | { id }. |
Notifications & org
| Method · path | Body / query |
|---|---|
GET /notifications?recipient_kind=&recipient_id=&unread= | Filterable inbox { notifications: [...] }. |
POST /notifications/read | { ids: number[] } → { updated }. |
GET /org | { edges, agents } — the org chart + agent roster. |
POST /org/save | { agent_id, reports_to_agent_id?, title?, level? } — upsert one org node. |