API documentation
V-Sum exposes HTTP APIs for the public site, operator console, and automation. Most routes under /api require an authenticated operator session (Google OAuth for staff).
Discovery
- — /developers — developer hub (MCP, OpenAPI, SDKs, rate limits)
- — https://api.v-sum.com — public read-only Data API (JSON; no auth)
- — https://api.v-sum.com/spec.json — OpenAPI for the public Data API
- — /.well-known/api-catalog — RFC 9727 API catalog (linkset)
- — /openapi.json — OpenAPI for v-sum.com forms and operator routes
- — /.well-known/oauth-protected-resource — OAuth protected resource metadata (RFC 9728)
- — /.well-known/openid-configuration — OpenID Provider metadata (Google)
- — /.well-known/agent-skills/index.json — Agent skills index
Public endpoints
- — Public Data API — briefings, events, people, companies, interviews (see
spec.jsonon that host) - — GET /api/health — health check (JSON)
- — Forms and webhooks documented per route; see OpenAPI and repository docs for detail.