Changelog

The portal now documents Helm Core API v2 by default — scoped tokens, OAuth2, webhooks and an MCP server for AI assistants — under the Helm Core OS brand. The v1 docs are still here, one click away in the version menu, at their existing URLs.

• addedFull v2 reference: 913 operations across 66 areas, including Portfolio, each with its scope, MCP tool name, request and response examples, and samples in seven formats including an MCP tools/call.
• addedMCP server guide: connecting Claude, Claude Code, Cursor and VS Code, how tools are generated from the API, and the OAuth sign-in flow.
• addedAuthentication guide with a "which method should I use?" chooser covering static tokens, OAuth2 client credentials and interactive OAuth.
• addedGuides for scopes, requests (pagination, filtering, idempotency, dry runs, jobs), webhooks, and errors and rate limits.
• addedA page for every v2 type, listing the operations that use it.
• addedRate limits guide: per-token budgets, how they are set and counted, headers, 429s, per-operation and OAuth limits, and retry code.
• addedScopes guide: how each check runs, the platform permissions behind all 92 scopes, which scopes organisation tokens can hold, and common scope sets.
• addedVersion menu at the top left; v1 moves its overview to /v1 and keeps every other URL.
• changedRebranded the portal to Helm Core OS: new logo, favicon, colour palette, and copy throughout.
• changedCode samples now read the token from HELM_API_KEY. This is only a naming convention in the samples, so existing environment variables keep working.
• changedPlaceholder descriptions on imported schemas now say "Helm Core".
• fixedRemoved stale code samples for operations that are no longer in the spec.
• fixedSearch now finds API operations by name, path and MCP tool name.
• fixedOperations using the org-content:engage scope now show their scope and MCP tool.

Redesigned developer portal with modern theming, multi-language code samples, and richer endpoint documentation.

• addedLight + dark themes via the new theme toggle in the header.
• addedSix-language code samples on every endpoint example: cURL, TypeScript, Python, PHP, Go, C#.
• addedMethod-tagged operation links in the sidebar.
• addedRight-rail table of contents with scroll-spy.
• changedMigrated from default Tailwind UI Protocol look to a token-driven design system.

Set up the foundation for the redesigned developer portal: tokens, components, dark mode, testing, CI.

• addedCSS-variable token system for light + dark theming.
• addedLighthouse CI on every PR.
• addedVitest + Storybook component testing infrastructure.