Skip to main content
Released API changes appear here. Product and website changes are on the Heyrafiki changelog.
PublishedSDKs
Public SDK betas and research tools
Published the JavaScript, Python, Go and Rust SDK public betas through their standard registries, joining the existing .NET beta. See SDKs for version-pinned install commands and source repositories.Added the Affective Dynamics guide and the public Heyrafiki Lab.
DocumentedReference
API surface map
Documented the complete API overview as eight resource areas and 31 released operations. The generated endpoint reference and public API definition remain the operation-level authorities.
AddedEvidence
Research evidence paths
Added a research and evidence guide connecting public statements to the OpenAPI definition, Assurance Graph, synthetic fixtures, deterministic runners and stated limitations.Added the Assurance Graph comparative protocol, manuscript, prior-art search record and independent reviewer packet.Documented First Light v2 as reproducible synthetic conformance evidence. It does not establish clinical validity or population effectiveness.
ChangedSandbox
MCP 2026-07-28
Changed the remote MCP server to the 2026-07-28 protocol version, including stateless discovery, per-request capability metadata, transport header validation and structured completion results.Added private cache hints for server/discover and tools/list. See MCP server for the connection requirements.
AddedChanged
Pre-authorization decisions
Added POST /v1/preauthorizations/{preauthorization_id}/decisions for payer decisions. Approval reserves the Benefit. Denial leaves it available.Added preauthorization.requested, preauthorization.approved, preauthorization.denied and preauthorization.expired Webhook events.Changed POST /v1/preauthorizations to open a request without reserving the Benefit. Payer decisions require benefits:decide.
Added
Practitioner profiles and availability
Added sandbox Practitioner retrieval at GET /v1/practitioners/{practitioner_id}.Added recurring weekly hours at GET /v1/practitioners/{practitioner_id}/availability.
Added
Bookings, Sessions and Benefits
Added idempotent Booking creation, plus Booking and Session list and retrieval endpoints.Added Benefit eligibility checks and pre-authorization requests for Sandbox projects.
Added
Claims and remittances
Added Claim submission, information requests, evidence resubmission and line-level adjudication.Added remittance creation, allocation, reconciliation and Claim settlement.
Added
Webhooks
Added Webhook endpoint registration, signed delivery, bounded retries and test events.Added Claim, remittance and pre-authorization events. See Webhooks for the event catalogue.
AddedSandbox
MCP Sandbox access
Added thirteen read-only tools for Practitioner, Booking, Session, Benefit, Claim and remittance data.The MCP server validates OAuth resource indicators and project scopes on every request. See MCP server.
Added
Sandbox API
Added authenticated API discovery at GET /v1.Added synthetic Practitioner listings for sandbox projects at GET /v1/practitioners.Added environment-scoped secret keys, stable error envelopes and per-key rate-limit headers.Published the OpenAPI definition used by the generated endpoint reference.
Last modified on August 24, 2026

Related topics

VersioningTesting