Overseer
The system manager: monitoring, incidents and alerts across the platform.
partRunning the shop48 operationsid overseer
How it sits
A part does one thing, and any other part can call it. The counts and the links below are from the platform's spec and the other services' own descriptions.
What it can do
48 operations in 11 resources, as the spec declares them. Each row is one call; paths are relative to the part.
incidents
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/incidents | List incidents |
| POST | /api/v1/incidents | Create incident |
| GET | /api/v1/incidents/remediation/actions | List available remediation actions |
| GET | /api/v1/incidents/remediation/history | Get remediation history |
| GET | /api/v1/incidents/service/{service} | Get incidents by service |
| GET | /api/v1/incidents/service/{service}/knowledge | Get service knowledge from Scout |
| GET | /api/v1/incidents/{incident_id} | Get incident details |
| POST | /api/v1/incidents/{incident_id}/acknowledge | Acknowledge incident |
| POST | /api/v1/incidents/{incident_id}/close | Close incident without resolution |
| POST | /api/v1/incidents/{incident_id}/diagnose | Diagnose incident with AI |
| POST | /api/v1/incidents/{incident_id}/remediate | Execute remediation action |
| GET | /api/v1/incidents/{incident_id}/remediation/check | Check if remediation is possible |
| POST | /api/v1/incidents/{incident_id}/resolve | Resolve incident |
13 operations
alerts
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/alerts/config | Get alerting configuration |
| PUT | /api/v1/alerts/config/phones | Update alert phone numbers |
| GET | /api/v1/alerts/health | Check SMS availability |
| GET | /api/v1/alerts/incoming | Check for incoming SMS messages |
| POST | /api/v1/alerts/response | Handle incoming SMS response |
| POST | /api/v1/alerts/{incident_id}/resolution | Send resolution notification |
| POST | /api/v1/alerts/{incident_id}/send | Send SMS alert for incident |
7 operations
agents
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/agents/dispatch | Dispatch a monitoring agent |
| GET | /api/v1/agents/status | List all agents |
| GET | /api/v1/agents/status/{agent_type} | Get agent by type |
| GET | /api/v1/agents/types | List available agent types |
| DELETE | /api/v1/agents/{agent_type} | Stop an agent |
5 operations
reports
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/reports/{agent} | List reports for an agent |
| GET | /api/v1/reports/{agent}/latest | Get the latest report |
| GET | /api/v1/reports/{agent}/latest/raw | Get the latest report as raw markdown |
| GET | /api/v1/reports/{agent}/{filename} | Get a specific report |
| GET | /api/v1/reports/{agent}/{filename}/raw | Get a specific report as raw markdown |
5 operations
dependencies
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/dependencies | Get dependency map |
| POST | /api/v1/dependencies | Record a dependency |
| GET | /api/v1/dependencies/health | Get dependency health |
| GET | /api/v1/dependencies/service/{service} | Get dependencies for a service |
4 operations
telemetry
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/telemetry/alerts | Get active alerts |
| POST | /api/v1/telemetry/ingest | Ingest telemetry message |
| GET | /api/v1/telemetry/recent | Get recent telemetry |
| GET | /api/v1/telemetry/summary | Get metrics summary |
4 operations
rulings
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/rulings | List operator rulings (the strike zone) |
| POST | /api/v1/rulings | Rule a fingerprint (suppress noise / watch) |
| DELETE | /api/v1/rulings/{fingerprint} | Remove a ruling |
3 operations
webhooks
| Method | Path | Does |
|---|---|---|
| POST | /webhooks/sms | Receive incoming SMS from SMS |
| POST | /webhooks/sms/cleanup | Cleanup stale conversations |
| GET | /webhooks/sms/conversations | List active SMS conversations |
3 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
2 operations
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
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 cboverseer.
forge-catalog.json, generated Oct 30, 2026