GET /v1/workspaces. List workspaces with needs_review_count and monitor totals.

POST /v1/workspaces. Create a workspace for one product or market.

POST /v1/workspaces/:id/competitors. Add a competitor by homepage URL. Idempotent on duplicate URLs. Returns 409 with active_competitor_id when another discovery is running.

GET /v1/workspaces/:id/competitors. List competitors with discovery_status and nested monitors (includes last_run on each monitor).

GET /v1/competitors/:id. Read one competitor with monitors and discovery fields.

PATCH /v1/competitors/:id. Set cadence or status on all monitors for this competitor.

DELETE /v1/competitors/:id. Permanently removes the competitor, its monitors, snapshots, and changes.

GET /v1/monitors. List monitors in a workspace with health, cadence, and last_run.

GET /v1/monitors/:id. Read one monitor. Pass include for capture or capture_markdown from the latest successful check.

POST /v1/monitors. Add a manual monitor on a specific URL.

PATCH /v1/monitors/:id. Update url, monitor_type, cadence, status, or min_severity. Use status paused to keep history.

DELETE /v1/monitors/:id. Permanently removes the monitor and all its changes and snapshots.

POST /v1/monitors/:id/check. Queue an on-demand check for one monitor.

POST /v1/workspaces/:id/refresh. Queue checks for all active monitors, or one competitor when competitor_id is set.

GET /v1/changes. Cursor-paginated change feed. Response includes meta.counts and max_unreviewed_severity.

GET /v1/changes/:id. Full change detail. Pass include for capture, capture_markdown, or raw_diff evidence.

PATCH /v1/changes/:id. Set review_status to unreviewed, acknowledged, or dismissed.

GET /v1/workspaces/:id/digest. Weekly workspace summary with needs-review items and top opportunities.