Platform API updates for Fir, the next generation of Heroku
Change effective on 09 December 2024
We made the following changes to the Heroku Platform API to enable Fir, the next generation of the Heroku platform. While there are no breaking changes, not all resources or parameters are applicable to both Cedar and Fir generations. See Heroku Generations for more info about our generations.
New Resources
- Generation: This new resource exposes actions to get info about our generations.
- OCI Image: This new resource exposes actions for working with OCI (Open Container Initiative) images for Fir apps, which use Cloud Native Buildpacks (CNBs).
- Telemetry Drain: This new resource exposes actions for working with telemetry drains.
Endpoint Changes
- App: We added the
generationattribute to return the generation info for an app. - Add-on Service: We added the
supported_generationsattribute to return an array of the generations supported by an add-on service. - Dyno Size: We added the
architectureandgenerationattributes to return the CPU architecture and generation info for a dyno size. - Pipeline: We added the
generationattribute to return the generation info for a pipeline. - Release Create: We added the
oci_imageparameter for apps that use CNBs (cnb). You can continue to use theslugparameter for apps that use classic buildpacks. - Space: We added the
generationattribute to return the generation info for the space. - Space Create: You can now optionally pass
generationas a parameter. The default generation iscedar.