http-api.md

warren HTTP API

This page enumerates every HTTP route registered by warren's Bun.serve router. It's derived directly from the ROUTE_TABLE array in src/server/handlers/index.ts so it can't drift from the running server.

To refresh: bun run gen:docs. To check (CI mode): bun run gen:docs:check.

Total routes: 57.

/agents

Method	Pattern	Handler	Notes
GET	/agents	listAgentsHandler
POST	/agents/refresh	refreshAgentsHandler
GET	/agents/:name	getAgentHandler

/analytics

Method	Pattern	Handler	Notes
GET	/analytics/cost	listCostAnalyticsHandler
GET	/analytics/runs	listRunAnalyticsHandler
GET	/analytics/behavior	listBehaviorAnalyticsHandler

/burrows

Method	Pattern	Handler	Notes
GET	/burrows	listBurrowsHandler
GET	/burrows/:id	getBurrowHandler

/conversations

Method	Pattern	Handler	Notes
GET	/conversations	listConversationsHandler
POST	/conversations	createConversationHandler
GET	/conversations/:id	getConversationHandler
POST	/conversations/:id/messages	postConversationMessageHandler
POST	/conversations/:id/send-off	sendOffConversationHandler
POST	/conversations/:id/re-wake	rewakeConversationHandler

/healthz

Method	Pattern	Handler	Notes
GET	/healthz	healthzHandler

/plan-runs

Method	Pattern	Handler	Notes
GET	/plan-runs	listPlanRunsHandler
POST	/plan-runs	createPlanRunHandler
GET	/plan-runs/:id	getPlanRunHandler
POST	/plan-runs/:id/cancel	cancelPlanRunHandler
GET	/plan-runs/:id/events	streamPlanRunEventsHandler

/plot-plan-runs

Method	Pattern	Handler	Notes
POST	/plot-plan-runs	createPlotPlanRunHandler

/plots

Method	Pattern	Handler	Notes
GET	/plots	listPlotsHandler
POST	/plots	createPlotHandler
GET	/plots/needs-attention/count	needsAttentionCountHandler	Static path — must precede /plots/:id so the param route doesn't swallow needs-attention as an :id.
GET	/plots/:id/summary	getPlotSummaryHandler	Static-suffix path — must precede /plots/:id so the param route doesn't swallow summary as the rest of the id.
GET	/plots/:id	getPlotHandler
POST	/plots/:id/intent	editPlotIntentHandler
POST	/plots/:id/rename	renamePlotHandler
POST	/plots/:id/sync	syncPlotHandler
POST	/plots/:id/status	changePlotStatusHandler
POST	/plots/:id/attachments	attachPlotHandler
POST	/plots/:id/attachments/:ref/merge	mergePlotPrAttachmentHandler	Specific path — must precede /plots/:id/attachments/:ref so the DELETE-by-ref route doesn't swallow <ref>/merge as a ref.
DELETE	/plots/:id/attachments/:ref	detachPlotHandler
POST	/plots/:id/questions/:event_id/answer	answerPlotQuestionHandler

/preview

Method	Pattern	Handler	Notes
GET	/preview/config	previewConfigHandler

/projects

Method	Pattern	Handler	Notes
GET	/projects	listProjectsHandler
POST	/projects	createProjectHandler
GET	/projects/:id/warren-config	getProjectWarrenConfigHandler
GET	/projects/:id/triggers	getProjectTriggersHandler
GET	/projects/:id/seeds/plans	listProjectSeedPlansHandler	Static path — must precede /projects/:id/seeds/:seedId so the param route doesn't swallow plans as a seed id.
GET	/projects/:id/seeds/:seedId	getProjectSeedHandler
POST	/projects/:id/triggers/:triggerId/run	runProjectTriggerHandler
POST	/projects/:id/refresh	refreshProjectHandler
POST	/projects/:id/agents/refresh	refreshProjectAgentsHandler
DELETE	/projects/:id	deleteProjectHandler

/readyz

Method	Pattern	Handler	Notes
GET	/readyz	readyzHandler

/runs

Method	Pattern	Handler	Notes
GET	/runs	listRunsHandler
POST	/runs	createRunHandler
GET	/runs/:id	getRunHandler
GET	/runs/:id/events	streamRunEventsHandler
POST	/runs/:id/steer	steerRunHandler
POST	/runs/:id/cancel	cancelRunHandler
GET	/runs/:id/preview/login	previewLoginHandler
POST	/runs/:id/preview/teardown	previewTeardownHandler

/version

Method	Pattern	Handler	Notes
GET	/version	versionHandler

/workers

Method	Pattern	Handler	Notes
GET	/workers	listWorkersHandler
POST	/workers/:name/drain	drainWorkerHandler