Pynmon API Reference

Complete list of HTTP endpoints exposed by the Pynmon monitoring server.

Home

Endpoint	Description
GET /	Dashboard overview with event counters
GET /health	Lightweight health check (JSON)

Broker (/broker/)

Endpoint	Description
GET /broker/	Broker overview
GET /broker/queue	Queue contents
GET /broker/refresh	HTMX partial refresh
POST /broker/purge	Purge all pending invocations

Orchestrator (/orchestrator/)

Endpoint	Description
GET /orchestrator/	Orchestrator overview with status counts
GET /orchestrator/refresh	HTMX partial refresh
POST /orchestrator/auto-purge	Auto-purge orchestrator data

Runners (/runners/)

Endpoint	Description
GET /runners/	Active runners overview
GET /runners/refresh	HTMX partial refresh
GET /runners/{runner_id}	Runner detail
GET /runners/atomic-service/runs/{run_id}	Atomic service run detail
GET /runners/atomic-service/timeline	Atomic service execution timeline

Tasks (/tasks/)

Endpoint	Description
GET /tasks/	List all registered tasks
GET /tasks/refresh	HTMX partial refresh
GET /tasks/{task_id_key}	Task detail with calls and invocations

Invocations (/invocations/)

Endpoint	Description
GET /invocations/	Paginated invocation list with filters
GET /invocations/timeline	SVG timeline visualization
GET /invocations/table	HTMX partial table refresh
GET /invocations/{id}	Invocation detail with history
GET /invocations/{id}/history	Status history (JSON)
GET /invocations/{id}/api	Invocation trigger context (JSON)
GET /invocations/{id}/family-tree	Family tree SVG partial
POST /invocations/{id}/rerun	Re-run the same call

Calls (/calls/)

Endpoint	Description
GET /calls/?call_id_key=	Call detail by query parameter
GET /calls/{call_id_key}	Call detail by path

Workflows (/workflows/)

Endpoint	Description
GET /workflows/	List workflow types
GET /workflows/refresh	HTMX partial refresh
GET /workflows/runs	List all workflow runs
GET /workflows/runs/refresh	HTMX partial refresh
GET /workflows/{type_key}	Workflow type detail
GET /workflows/{type_key}/refresh	HTMX partial refresh
GET /workflows/debug	Debug overview (dev)

State Backend (/state-backend/)

Endpoint	Description
GET /state-backend/	State backend overview
POST /state-backend/purge	Purge all state data

Client Data Store (/client-data-store/)

Endpoint	Description
GET /client-data-store/	Client data store overview
POST /client-data-store/purge	Purge all cached data

Log Explorer (/log-explorer/)

Endpoint	Description
GET /log-explorer/	Log explorer interface

Events (/events/)

• GET /events/: Paginated event list with filters: event_code, start, end, matched, triggered, page, page_size.

• GET /events/{event_id}: Event detail with payload, matched conditions, and triggered invocations.

• GET /events/{event_id}/api: JSON event detail (event + trigger runs) for timeline detail panels and external consumers.

• GET /events/{event_id}/trigger-runs: JSON list of trigger runs that referenced the event.

• GET /events/{event_id}/trace: JSON causal trace — the full chain of invocations, events, and trigger runs reachable from this event.

• GET /events/api/markers: JSON list of event markers for a time window; used by the invocation timeline to overlay event indicators.

• POST /events/auto-purge: Apply the configured retention/capacity policy and remove expired events and trigger runs (returns counters).

Trigger Runs (/trigger-runs/)

• GET /trigger-runs/{trigger_run_id}: Trigger-run detail page with source invocations, related events, and per-participant condition/context data.

• GET /trigger-runs/{trigger_run_id}/api: JSON trigger-run detail with related events and per-participant TriggerCondition/ConditionContext views.

• GET /trigger-runs/condition?condition_id=...: Detail page for a registered trigger condition that can still be resolved by the trigger backend.

• GET /trigger-runs/valid-condition?valid_condition_id=...: Detail page for a valid condition only while that transient value is still retained.

Triggers (/triggers/)

Endpoint	Description
GET /triggers/{trigger_id}	Trigger definition detail

App Switching

Endpoint	Description
GET /switch-app/{app_id}	Switch active app, redirect to /

Global Actions

Endpoint	Description
POST /purge	Purge all data (broker, orchestrator, state backend, client data store)