Hive
The autonomous-agent control plane: watches the platform, ranks what needs attention, and pauses at an operator's gate before touching production.
glueRunning the shop45 operationsid hive
How it sits
Glue chains parts together and keeps the result running. The counts and the links below are from the platform's spec and the other services' own descriptions.
What it can do
45 operations in 15 resources, as the spec declares them. Each row is one call; paths are relative to the part.
flows
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/flows | List flow runs |
| POST | /api/v1/flows | Start a flow run |
| POST | /api/v1/flows/compile | Compile a flow spec to a Workflow script |
| GET | /api/v1/flows/contracts | Available agent-stage contracts |
| GET | /api/v1/flows/library | Canonical flows you can start by name |
| GET | /api/v1/flows/outcomes | Flow outcomes — the Execute→Analyze learning ledger |
| GET | /api/v1/flows/outcomes/scope-hint | Cluster hint for an incoming item (Analyze got smarter) |
| GET | /api/v1/flows/{run_id} | A flow run |
| POST | /api/v1/flows/{run_id}/agent | Supply a suspended agent step's output + continue |
| GET | /api/v1/flows/{run_id}/compile | Compile this run's flow to a Workflow script |
| GET | /api/v1/flows/{run_id}/diagram | The run's Waggle diagram (mermaid) |
| POST | /api/v1/flows/{run_id}/gate | Operator gate — approve / deny / hold a suspended flow |
12 operations
broker
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/broker/leases | Credential lease ledger (read-only) |
| POST | /api/v1/broker/leases | Request a credential lease (enters the operator gate) |
| POST | /api/v1/broker/leases/{lease_id}/approve | Operator gate — approve + grant a requested lease |
| POST | /api/v1/broker/leases/{lease_id}/deny | Operator gate — deny a requested lease |
| GET | /api/v1/broker/status | Credential broker mode |
| POST | /api/v1/broker/sweep | Reap expired leases (Cron tick) |
6 operations
mailbox
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/mailbox | The mailbox |
| POST | /api/v1/mailbox/sync | Fold the current digest into the mailbox |
| GET | /api/v1/mailbox/{item_id}/triage | The structured work-item for a doc-drop |
| POST | /api/v1/mailbox/{item_id}/triage | Attach a structured triage to a doc-drop work-item |
| POST | /api/v1/mailbox/{item_id}/{action} | Transition a mailbox item |
5 operations
triage
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/triage | Triaged work-items (roadmap input) |
| POST | /api/v1/triage/autonomous | Autonomously triage pending work-requests, then notify the rest |
| GET | /api/v1/triage/mode | Triage autonomy mode (plan | live) |
| POST | /api/v1/triage/notify-pending | Detect untriaged work-requests and ping the operator (Cron tick) |
4 operations
work-items
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/work-items/{work_item_id}/approve | Operator gate — approve a work-item's fork |
| POST | /api/v1/work-items/{work_item_id}/dispatch | Record handoff to the fork delivery |
| POST | /api/v1/work-items/{work_item_id}/done | Mark a work-item delivered |
| POST | /api/v1/work-items/{work_item_id}/hold | Park a work-item (not now) |
4 operations
rulings
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/rulings | List operator rulings |
| POST | /api/v1/rulings | Rule on a fingerprint |
| DELETE | /api/v1/rulings/{fingerprint} | Clear a ruling |
3 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
2 operations
signals
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/signals | Live fleet signals (read-only) |
| GET | /api/v1/signals/sources | Registered intake sources |
2 operations
build
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/build | Which commit this process is running |
1 operation
digest
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/digest | Collapsed, ranked digest (read-only) |
1 operation
hello
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/hello | Hello world |
1 operation
mint
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/mint | File an app-mint request |
1 operation
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
1 operation
roadmap
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/roadmap | The LoomDSL roadmap (work-items across triages) |
1 operation
status
| Method | Path | Does |
|---|---|---|
| GET | /status | Service status overview |
1 operation
All the partsRunning the shopThe platform's own id for this service is cbhive.
forge-catalog.json, generated Oct 30, 2026