Updates to Heroku API Compatibility Policy
Change effective on 16 February 2026
Summary
We are updating our API Compatibility Policy to streamline how we deliver new features and maintain the stability of the Heroku Platform APIs. These changes allow us to transition resources more efficiently from Prototype to Production, ensuring you get access to the latest platform capabilities sooner.
What’s Changing?
- Updated Disruptive Change Policy for Production Resources. To ensure the Heroku Platform remains agile and can evolve alongside the broader Salesforce ecosystem, we are adjusting the notice period for disruptive changes to Production resources.
- Old Policy: Disruptive changes may not occur; instead, a new major API version must be developed.
- New Policy: Disruptive changes may be made to Production resources with a three-month advance notice via the Changelog.
This change allows us to improve existing endpoints without the overhead of versioning the entire API, ensuring a more cohesive experience for developers using Heroku alongside other Salesforce products.
2. Resources Maturity Lifecycle
As part of this policy change, we will be moving several resources from Prototype to Development and from Development to Production. This shift represents our commitment to the long-term stability of the tools you rely on, while giving us the flexibility to refine them as the underlying technology evolves.
Impact
- Existing Integrations: No immediate action is required. Any future disruptive changes will be announced here in the Changelog in compliance with the policy.
- Resource Stability: You will notice more API resources reaching “Production” status, backed by our 12-month deprecation guarantee.