http-api.md

title	HTTP API

AUTO-GENERATED by bun run docs:api. Do not edit by hand — regenerate after changing route definitions in src/api/*.ts.

Summary

• 94 HTTP routes across 40 path groups
• 17 routes carry a resolved one-line description

Each row links to the route definition as path:line so jumping from this index to the source is a click. Routes are defined as { method, path, handler } literals in src/api/*.ts and collected by src/api/index.ts.

/.well-known

Method	Path	Source	Description
GET	/.well-known/agent-card.json	src/api/agent-card.ts:45	—
GET	/.well-known/agent.json	src/api/agent-card.ts:47	Legacy path — keep for agents that still resolve /.well-known/agent.json

/a2a

Method	Path	Source	Description
POST	/a2a	src/api/a2a-server.ts:457	—

/api/a2a

Method	Path	Source	Description
POST	/api/a2a/callback/:taskId	src/api/a2a-callback.ts:26	—
POST	/api/a2a/chat	src/api/ava-tools.ts:348	multi-turn conversation with an agent over the bus.
POST	/api/a2a/delegate	src/api/ava-tools.ts:349	fire-and-forget task dispatch to an agent.
POST	/api/a2a/input	src/api/human-input.ts:115	—
POST	/api/a2a/probe	src/api/agents-crud.ts:105	—
GET	/api/a2a/task/:correlationId	src/api/ava-tools.ts:350	correlationId — fetch the result of a dispatch that a chat caller stopped awaiting (timed out).

/api/a2a-endpoints

Method	Path	Source	Description
POST	/api/a2a-endpoints	src/api/agents-crud.ts:245	A2A endpoints — control-plane-managed remote agents (agents.d/)
PUT	/api/a2a-endpoints/:name	src/api/agents-crud.ts:266	—
DELETE	/api/a2a-endpoints/:name	src/api/agents-crud.ts:286	—

/api/agent

Method	Path	Source	Description
POST	/api/agent/ask-human	src/api/human-input.ts:62	—

/api/agents

Method	Path	Source	Description
GET	/api/agents	src/api/operations.ts:310	—
POST	/api/agents	src/api/agents-crud.ts:181	—
GET	/api/agents/:name	src/api/agents-crud.ts:144	—
PUT	/api/agents/:name	src/api/agents-crud.ts:211	—
DELETE	/api/agents/:name	src/api/agents-crud.ts:229	—
GET	/api/agents/runtime	src/api/agents-runtime.ts:127	—
POST	/api/agents/test	src/api/agents-crud.ts:162	—

/api/board

Method	Path	Source	Description
POST	/api/board/features/create	src/api/board.ts:151	—
GET	/api/board/features/list	src/api/board.ts:150	—
POST	/api/board/features/update	src/api/board.ts:152	—

/api/branch-drift

Method	Path	Source	Description
GET	/api/branch-drift	src/api/github.ts:711	—

/api/branch-protection

Method	Path	Source	Description
GET	/api/branch-protection	src/api/github.ts:712	—

/api/bus

Method	Path	Source	Description
GET	/api/bus/history	src/api/bus-history.ts:25	—
GET	/api/bus/topology	src/api/bus-topology.ts:66	—

/api/ceremonies

Method	Path	Source	Description
GET	/api/ceremonies	src/api/operations.ts:311	—
POST	/api/ceremonies/:id/delete	src/api/operations.ts:315	—
POST	/api/ceremonies/:id/run	src/api/operations.ts:313	—
POST	/api/ceremonies/:id/update	src/api/operations.ts:314	—
POST	/api/ceremonies/create	src/api/operations.ts:312	—

/api/channels

Method	Path	Source	Description
GET	/api/channels	src/api/operations.ts:317	—

/api/ci-health

Method	Path	Source	Description
GET	/api/ci-health	src/api/github.ts:709	—

/api/clawpatch

Method	Path	Source	Description
POST	/api/clawpatch/review	src/api/clawpatch.ts:249	—

/api/confidence-summaries

Method	Path	Source	Description
GET	/api/confidence-summaries	src/api/observability.ts:70	Returns an array of ConfidenceSummary records with calibration metrics (avgConfidence, avgConfidenceOnSuccess/Failure, highConfFailures count).

/api/control-plane

Method	Path	Source	Description
GET	/api/control-plane/state	src/api/control-plane.ts:40	—

/api/cost-summaries

Method	Path	Source	Description
GET	/api/cost-summaries	src/api/observability.ts:69	Returns an array of CostSummary records.

/api/discord

Method	Path	Source	Description
GET	/api/discord/channels	src/api/discord.ts:62	—
POST	/api/discord/channels/create	src/api/discord.ts:84	—
POST	/api/discord/channels/delete	src/api/discord.ts:122	—
GET	/api/discord/members	src/api/discord.ts:205	—
POST	/api/discord/progress	src/api/discord.ts:316	—
POST	/api/discord/react	src/api/discord.ts:291	—
POST	/api/discord/send	src/api/discord.ts:173	—
GET	/api/discord/server-stats	src/api/discord.ts:38	—
GET	/api/discord/webhooks	src/api/discord.ts:228	—
POST	/api/discord/webhooks/create	src/api/discord.ts:253	—

/api/github

Method	Path	Source	Description
POST	/api/github/issues	src/api/github.ts:715	—

/api/github-issues

Method	Path	Source	Description
GET	/api/github-issues	src/api/github.ts:713	—

/api/google

Method	Path	Source	Description
GET	/api/google/calendar/event/:eventId	src/api/google.ts:344	Calendar: event detail
GET	/api/google/calendar/upcoming	src/api/google.ts:295	Calendar: upcoming events
POST	/api/google/gmail/draft	src/api/google.ts:197	Drafts go to Drafts folder.
GET	/api/google/gmail/list-unread	src/api/google.ts:111	Gmail: list unread
GET	/api/google/gmail/search	src/api/google.ts:136	Gmail: search
GET	/api/google/gmail/thread/:threadId	src/api/google.ts:163	Gmail: get full thread

/api/hitl

Method	Path	Source	Description
GET	/api/hitl/pending	src/api/operations.ts:318	—

/api/incidents

Method	Path	Source	Description
GET	/api/incidents	src/api/incidents.ts:131	—
POST	/api/incidents	src/api/incidents.ts:133	—
POST	/api/incidents/:id/resolve	src/api/incidents.ts:134	—

/api/linear

Method	Path	Source	Description
GET	/api/linear/issues	src/api/linear.ts:91	—
POST	/api/linear/issues	src/api/linear.ts:147	—
POST	/api/linear/issues/:id/comment	src/api/linear.ts:185	—
GET	/api/linear/issues/:idOrKey	src/api/linear.ts:131	—
GET	/api/linear/issues/search	src/api/linear.ts:114	—
GET	/api/linear/oauth/callback	src/api/linear-oauth.ts:67	—
GET	/api/linear/oauth/start	src/api/linear-oauth.ts:47	—
GET	/api/linear/oauth/status	src/api/linear-oauth.ts:97	—
GET	/api/linear/teams	src/api/linear.ts:82	—

/api/mailbox

Method	Path	Source	Description
GET	/api/mailbox/:contextId	src/api/mailbox.ts:20	—
POST	/api/mailbox/:contextId	src/api/mailbox.ts:35	—

/api/mcp-servers

Method	Path	Source	Description
GET	/api/mcp-servers	src/api/mcp-crud.ts:142	—
POST	/api/mcp-servers	src/api/mcp-crud.ts:169	—
GET	/api/mcp-servers/:name	src/api/mcp-crud.ts:150	—
PUT	/api/mcp-servers/:name	src/api/mcp-crud.ts:195	—
DELETE	/api/mcp-servers/:name	src/api/mcp-crud.ts:215	—
POST	/api/mcp-servers/test	src/api/mcp-crud.ts:126	—

/api/onboard

Method	Path	Source	Description
POST	/api/onboard	src/api/operations.ts:308	—

/api/operator

Method	Path	Source	Description
POST	/api/operator/message	src/api/operator.ts:89	—

/api/pr

Method	Path	Source	Description
POST	/api/pr/inspect	src/api/pr-inspector.ts:541	—

/api/pr-pipeline

Method	Path	Source	Description
GET	/api/pr-pipeline	src/api/github.ts:710	—

/api/projects

Method	Path	Source	Description
GET	/api/projects	src/api/operations.ts:309	—

/api/recent-activity

Method	Path	Source	Description
GET	/api/recent-activity	src/api/github.ts:714	What shipped recently across the fleet — published releases (with their curated notes) + substantive merged PRs in a trailing window (default 24h, ?hours= 1..168).

/api/research

Method	Path	Source	Description
POST	/api/research/ingest	src/api/research.ts:45	—
POST	/api/research/search	src/api/research.ts:28	—
GET	/api/research/stats	src/api/research.ts:71	—

/api/security-summary

Method	Path	Source	Description
GET	/api/security-summary	src/api/incidents.ts:132	—

/api/skills

Method	Path	Source	Description
GET	/api/skills/:agentName	src/api/operations.ts:316	—

/health

Method	Path	Source	Description
GET	/health	src/api/operations.ts:304	—

/metrics

Method	Path	Source	Description
GET	/metrics	src/api/operations.ts:306	—

/publish

Method	Path	Source	Description
POST	/publish	src/api/operations.ts:307	—

/ready

Method	Path	Source	Description
GET	/ready	src/api/operations.ts:305	Readiness probe (#795).

/v1

Method	Path	Source	Description
POST	/v1/chat/completions	src/api/openai-compat.ts:292	the meat.
GET	/v1/models	src/api/openai-compat.ts:291	advertise every fleet skill as a model.