Additive, compatible updates increment the minor version. Breaking request or response changes require a new major contract and migration guidance.
Know what changed before you upgrade.
Read documentation and public-contract changes, compatibility notes, and the limitations that remain visible by design.
Public developer experience rebuild.
- New
Route-based Start, Concepts, Guides, API, SDKs & Widgets, Widget Studio, Operations, and Release notes.
- New
Instant public documentation search with ⌘ K / Ctrl K and keyboard navigation.
- New
Rendered OpenAPI operation reference with request fields, response codes, examples, scopes, and behaviors.
- Changed
Academy now contains full lesson bodies, three tracks, device-local progress, practical checklists, and a twelve-question Foundations assessment.
- Security
Credential codes use higher-entropy public identifiers; registry records carry status, revocation, exam version, credential version, and consent evidence.
Published examples now match the implementation.
POST /eventsDocuments 201 for a new award and 200 for an idempotent repeat.
POST /returnsUses required returnAmountMinor; removes the incorrect amountMinor and client-selected programId.
GET /members/{externalId}Documents member consent, program profiles, qualification points, and account balance states.
All operationsDocuments scopes, media and payload errors, request IDs, rate limits, and environment headers.
Visible by design.
- No official JavaScript, iOS, or Android SDK is published.
- Widget Studio is a schema-driven local-draft preview, not a hosted production widget runtime.
- The public API does not expose cross-program point conversion.
- Academy practical labs are self-checked; the Foundations credential validates the knowledge assessment, not an observed production implementation.
- Academy progress is a device-local preference and does not sync across browsers.
- The public certification endpoint does not provide account-based identity assurance.
Contracts change with evidence.
The current 0.1 schema is explicitly unstable. Every export must retain its schema version.
Credentials retain the exam and credential version used at issue time. Revocation changes status, not history.