The API root

GET /api/v1 (and /api/v1/) is the API's front door: an agent that starts there, with no account, learns what this forge is and where everything else lives. HEAD answers too. It is public, read-only and small (src/http/api_root.ts).

curl -i https://forge.example/api/v1
{
  "name": "forge",
  "version": "0.7.480",
  "commit": "1bda42c9…",
  "openapi": "https://forge.example/contract/openapi.json",
  "mcp": "https://forge.example/mcp",
  "oauth": "https://forge.example/.well-known/oauth-protected-resource",
  "llms": "https://forge.example/llms.txt",
  "here": "https://forge.example/api/v1/here"
}

the build is unstamped.

/llms.txt mentions the root in its API line. The operation is described in the OpenAPI document and on /api (the API reference).

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs