API

Pulse GTM Agents exposes a small local JSON API. The frontend uses the same routes documented here.

Health

GET /api/health

Returns service status.

GET /api/workspace

Returns the latest run, runs, profile, sources, opportunities, feedback events, and playbook memory.

POST /api/runs
Content-Type: application/json

{ "url": "https://useclearbit.com" }

Creates a completed local research run using deterministic source adapters and opportunity templates.

GET /api/runs/:id

Returns a single run by ID.

GET /api/opportunities?q=&type=all&status=all

Filters opportunities by query, type, and review status.

POST /api/opportunities/:id/:action
Content-Type: application/json

{ "note": "Reviewed in local workspace" }

Supported actions:

Each action updates the opportunity, creates a feedback event, and writes a memory rule.

POST /api/reset

Resets data/state.json to the default seed state.