platform-api 3.6.0 → 3.8.0

data/lib/platform-api/client.rb

@@ -83,7 +83,7 @@ module PlatformAPI
 
   # Get the default options.
   def self.default_options
-    default_headers = {"Accept"=>"application/vnd.heroku+json; version=3", "User-Agent"=>"platform-api/3.6.0"}
+    default_headers = {"Accept"=>"application/vnd.heroku+json; version=3", "User-Agent"=>"platform-api/3.8.0"}
     {
       default_headers: default_headers,
       url:             "https://api.heroku.com"
@@ -98,6 +98,13 @@ module PlatformAPI
       @client = client
     end
 
+    # A Heroku account becomes delinquent due to non-payment. We [suspend and delete](https://help.heroku.com/EREVRILX/what-happens-if-i-have-unpaid-heroku-invoices) delinquent accounts if their invoices remain unpaid.
+    #
+    # @return [AccountDelinquency]
+    def account_delinquency
+      @account_delinquency_resource ||= AccountDelinquency.new(@client)
+    end
+
     # An account feature represents a Heroku labs capability that can be enabled or disabled for an account on Heroku.
     #
     # @return [AccountFeature]
@@ -252,7 +259,7 @@ module PlatformAPI
       @audit_trail_event_resource ||= AuditTrailEvent.new(@client)
     end
 
-    # A build represents the process of transforming a code tarball into a slug
+    # A build represents the process of transforming a code tarball into build artifacts
     #
     # @return [Build]
     def build
@@ -350,7 +357,14 @@ module PlatformAPI
       @formation_resource ||= Formation.new(@client)
     end
 
-    # Identity Providers represent the SAML configuration of an Enterprise Account or Team.
+    # A generation represents a version of the Heroku platform that includes the app execution environment, routing, telemetry, and build systems.
+    #
+    # @return [Generation]
+    def generation
+      @generation_resource ||= Generation.new(@client)
+    end
+
+    # Identity Providers represent the SAML configuration of teams or an Enterprise account
     #
     # @return [IdentityProvider]
     def identity_provider
@@ -427,11 +441,11 @@ module PlatformAPI
       @oauth_token_resource ||= OauthToken.new(@client)
     end
 
-    # An outbound-ruleset is a collection of rules that specify what hosts Dynos are allowed to communicate with. 
+    # An OCI (Open Container Initiative) image is a standardized format for packaging and distributing containerized applications, ready to run on the platform.
     #
-    # @return [OutboundRuleset]
-    def outbound_ruleset
-      @outbound_ruleset_resource ||= OutboundRuleset.new(@client)
+    # @return [OciImage]
+    def oci_image
+      @oci_image_resource ||= OciImage.new(@client)
     end
 
     # A password reset represents a in-process password reset attempt.
@@ -462,14 +476,14 @@ module PlatformAPI
       @permission_entity_resource ||= PermissionEntity.new(@client)
     end
 
-    # Information about latest builds of apps in a pipeline.
+    # Information about the latest builds of apps in a pipeline. A build represents the process of transforming code into build artifacts.
     #
     # @return [PipelineBuild]
     def pipeline_build
       @pipeline_build_resource ||= PipelineBuild.new(@client)
     end
 
-    # Pipeline Config Vars allow you to manage the configuration information provided to a pipeline.
+    # Pipeline config vars in Heroku CI and review apps used to manage the configuration information for a pipeline.
     #
     # @return [PipelineConfigVar]
     def pipeline_config_var
@@ -483,7 +497,7 @@ module PlatformAPI
       @pipeline_coupling_resource ||= PipelineCoupling.new(@client)
     end
 
-    # Information about latest deployments of apps in a pipeline.
+    # Information about the latest deployment of each app in a pipeline. A deployment is the process of moving the build artifacts to a target environment.
     #
     # @return [PipelineDeployment]
     def pipeline_deployment
@@ -504,7 +518,7 @@ module PlatformAPI
       @pipeline_promotion_resource ||= PipelinePromotion.new(@client)
     end
 
-    # Information about latest releases of apps in a pipeline.
+    # Information about the latest release of each app in a pipeline. A release makes a deployment available to end-users.
     #
     # @return [PipelineRelease]
     def pipeline_release
@@ -679,6 +693,13 @@ module PlatformAPI
       @team_daily_usage_resource ||= TeamDailyUsage.new(@client)
     end
 
+    # A Heroku team becomes delinquent due to non-payment. We [suspend and delete](https://help.heroku.com/EREVRILX/what-happens-if-i-have-unpaid-heroku-invoices) delinquent teams if their invoices remain unpaid.
+    #
+    # @return [TeamDelinquency]
+    def team_delinquency
+      @team_delinquency_resource ||= TeamDelinquency.new(@client)
+    end
+
     # A team feature represents a feature enabled on a team account.
     #
     # @return [TeamFeature]
@@ -735,6 +756,13 @@ module PlatformAPI
       @team_resource ||= Team.new(@client)
     end
 
+    # A telemetry drain forwards OpenTelemetry traces, metrics, and logs to your own consumer. For Fir-generation apps only.
+    #
+    # @return [TelemetryDrain]
+    def telemetry_drain
+      @telemetry_drain_resource ||= TelemetryDrain.new(@client)
+    end
+
     # A single test case belonging to a test run
     #
     # @return [TestCase]
@@ -773,6 +801,18 @@ module PlatformAPI
 
   private
 
+  # A Heroku account becomes delinquent due to non-payment. We [suspend and delete](https://help.heroku.com/EREVRILX/what-happens-if-i-have-unpaid-heroku-invoices) delinquent accounts if their invoices remain unpaid.
+  class AccountDelinquency
+    def initialize(client)
+      @client = client
+    end
+
+    # Account delinquency information.
+    def info()
+      @client.account_delinquency.info()
+    end
+  end
+
   # An account feature represents a Heroku labs capability that can be enabled or disabled for an account on Heroku.
   class AccountFeature
     def initialize(client)
@@ -1465,18 +1505,18 @@ module PlatformAPI
 
     # Get archive for a single month.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
     # @param archive_year: year of the archive
     # @param archive_month: month of the archive
-    def info(enterprise_account_id, archive_year, archive_month)
-      @client.archive.info(enterprise_account_id, archive_year, archive_month)
+    def info(enterprise_account_id_or_enterprise_account_name, archive_year, archive_month)
+      @client.archive.info(enterprise_account_id_or_enterprise_account_name, archive_year, archive_month)
     end
 
     # List existing archives.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
-    def list(enterprise_account_id)
-      @client.archive.list(enterprise_account_id)
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
+    def list(enterprise_account_id_or_enterprise_account_name)
+      @client.archive.list(enterprise_account_id_or_enterprise_account_name)
     end
   end
 
@@ -1488,13 +1528,13 @@ module PlatformAPI
 
     # List existing events. Returns all events for one day, defaulting to current day. Order, actor, action, and type, and day query params can be specified as query parameters. For example, '/enterprise-accounts/:id/events?order=desc&actor=user@example.com&action=create&type=app&day=2020-09-30' would return events in descending order and only return app created events by the user with user@example.com email address.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
-    def list(enterprise_account_id)
-      @client.audit_trail_event.list(enterprise_account_id)
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
+    def list(enterprise_account_id_or_enterprise_account_name)
+      @client.audit_trail_event.list(enterprise_account_id_or_enterprise_account_name)
     end
   end
 
-  # A build represents the process of transforming a code tarball into a slug
+  # A build represents the process of transforming a code tarball into build artifacts
   class Build
     def initialize(client)
       @client = client
@@ -1710,7 +1750,7 @@ module PlatformAPI
 
     # Info for existing dyno size.
     #
-    # @param dyno_size_id_or_dyno_size_name: unique identifier of this dyno size or the name of this dyno-size
+    # @param dyno_size_id_or_dyno_size_name: unique identifier of the dyno size or name of the dyno size
     def info(dyno_size_id_or_dyno_size_name)
       @client.dyno_size.info(dyno_size_id_or_dyno_size_name)
     end
@@ -1719,6 +1759,13 @@ module PlatformAPI
     def list()
       @client.dyno_size.list()
     end
+
+    # List available dyno sizes for an app
+    #
+    # @param app_id_or_app_name: unique identifier of app or unique name of app
+    def list_app_dyno_sizes(app_id_or_app_name)
+      @client.dyno_size.list_app_dyno_sizes(app_id_or_app_name)
+    end
   end
 
   # Dynos encapsulate running processes of an app on Heroku. Detailed information about dyno sizes can be found at: [https://devcenter.heroku.com/articles/dyno-types](https://devcenter.heroku.com/articles/dyno-types).
@@ -1743,6 +1790,14 @@ module PlatformAPI
       @client.dyno.restart(app_id_or_app_name, dyno_id_or_dyno_name)
     end
 
+    # Restart dynos of a given formation type.
+    #
+    # @param app_id_or_app_name: unique identifier of app or unique name of app
+    # @param dyno_formation_type: the formation type of this process on this dyno
+    def restart_formation(app_id_or_app_name, dyno_formation_type)
+      @client.dyno.restart_formation(app_id_or_app_name, dyno_formation_type)
+    end
+
     # Restart all dynos.
     #
     # @param app_id_or_app_name: unique identifier of app or unique name of app
@@ -1758,6 +1813,14 @@ module PlatformAPI
       @client.dyno.stop(app_id_or_app_name, dyno_id_or_dyno_name)
     end
 
+    # Stop dynos of a given formation type.
+    #
+    # @param app_id_or_app_name: unique identifier of app or unique name of app
+    # @param dyno_formation_type: the formation type of this process on this dyno
+    def stop_formation(app_id_or_app_name, dyno_formation_type)
+      @client.dyno.stop_formation(app_id_or_app_name, dyno_formation_type)
+    end
+
     # Info for existing dyno.
     #
     # @param app_id_or_app_name: unique identifier of app or unique name of app
@@ -1798,34 +1861,34 @@ module PlatformAPI
 
     # List members in an enterprise account.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
-    def list(enterprise_account_id)
-      @client.enterprise_account_member.list(enterprise_account_id)
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
+    def list(enterprise_account_id_or_enterprise_account_name)
+      @client.enterprise_account_member.list(enterprise_account_id_or_enterprise_account_name)
     end
 
     # Create a member in an enterprise account.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
     # @param body: the object to pass as the request payload
-    def create(enterprise_account_id, body = {})
-      @client.enterprise_account_member.create(enterprise_account_id, body)
+    def create(enterprise_account_id_or_enterprise_account_name, body = {})
+      @client.enterprise_account_member.create(enterprise_account_id_or_enterprise_account_name, body)
     end
 
     # Update a member in an enterprise account.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
     # @param account_email_or_account_id: unique email address of account or unique identifier of an account
     # @param body: the object to pass as the request payload
-    def update(enterprise_account_id, account_email_or_account_id, body = {})
-      @client.enterprise_account_member.update(enterprise_account_id, account_email_or_account_id, body)
+    def update(enterprise_account_id_or_enterprise_account_name, account_email_or_account_id, body = {})
+      @client.enterprise_account_member.update(enterprise_account_id_or_enterprise_account_name, account_email_or_account_id, body)
     end
 
     # delete a member in an enterprise account.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
     # @param account_email_or_account_id: unique email address of account or unique identifier of an account
-    def delete(enterprise_account_id, account_email_or_account_id)
-      @client.enterprise_account_member.delete(enterprise_account_id, account_email_or_account_id)
+    def delete(enterprise_account_id_or_enterprise_account_name, account_email_or_account_id)
+      @client.enterprise_account_member.delete(enterprise_account_id_or_enterprise_account_name, account_email_or_account_id)
     end
   end
 
@@ -1858,17 +1921,17 @@ module PlatformAPI
 
     # Information about an enterprise account.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
-    def info(enterprise_account_id)
-      @client.enterprise_account.info(enterprise_account_id)
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
+    def info(enterprise_account_id_or_enterprise_account_name)
+      @client.enterprise_account.info(enterprise_account_id_or_enterprise_account_name)
     end
 
     # Update enterprise account properties
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
     # @param body: the object to pass as the request payload
-    def update(enterprise_account_id, body = {})
-      @client.enterprise_account.update(enterprise_account_id, body)
+    def update(enterprise_account_id_or_enterprise_account_name, body = {})
+      @client.enterprise_account.update(enterprise_account_id_or_enterprise_account_name, body)
     end
   end
 
@@ -1925,7 +1988,33 @@ module PlatformAPI
     end
   end
 
-  # Identity Providers represent the SAML configuration of an Enterprise Account or Team.
+  # A generation represents a version of the Heroku platform that includes the app execution environment, routing, telemetry, and build systems.
+  class Generation
+    def initialize(client)
+      @client = client
+    end
+
+    # Info for generation.
+    #
+    # @param stack_name_or_stack_id: unique name of stack or unique identifier of stack
+    def info(stack_name_or_stack_id)
+      @client.generation.info(stack_name_or_stack_id)
+    end
+
+    # List available generations.
+    def list()
+      @client.generation.list()
+    end
+
+    # List available generations for a team.
+    #
+    # @param team_name_or_team_id: unique name of team or unique identifier of team
+    def list_by_team(team_name_or_team_id)
+      @client.generation.list_by_team(team_name_or_team_id)
+    end
+  end
+
+  # Identity Providers represent the SAML configuration of teams or an Enterprise account
   class IdentityProvider
     def initialize(client)
       @client = client
@@ -2154,6 +2243,14 @@ module PlatformAPI
       @client.oauth_authorization.info(oauth_authorization_id)
     end
 
+    # Update an existing OAuth authorization.
+    #
+    # @param oauth_authorization_id: unique identifier of OAuth authorization
+    # @param body: the object to pass as the request payload
+    def update(oauth_authorization_id, body = {})
+      @client.oauth_authorization.update(oauth_authorization_id, body)
+    end
+
     # List OAuth authorizations.
     def list()
       @client.oauth_authorization.list()
@@ -2187,7 +2284,7 @@ module PlatformAPI
       @client.oauth_client.delete(oauth_client_id)
     end
 
-    # Info for an OAuth client
+    # Info for an OAuth client. The output for unauthenticated requests excludes the `secret` parameter.
     #
     # @param oauth_client_id: unique identifier of this OAuth client
     def info(oauth_client_id)
@@ -2243,40 +2340,26 @@ module PlatformAPI
     end
   end
 
-  # An outbound-ruleset is a collection of rules that specify what hosts Dynos are allowed to communicate with. 
-  class OutboundRuleset
+  # An OCI (Open Container Initiative) image is a standardized format for packaging and distributing containerized applications, ready to run on the platform.
+  class OciImage
     def initialize(client)
       @client = client
     end
 
-    # Current outbound ruleset for a space
+    # Info for the OCI images of an app, filtered by identifier.
     #
-    # @param space_id_or_space_name: unique identifier of space or unique name of space
-    def current(space_id_or_space_name)
-      @client.outbound_ruleset.current(space_id_or_space_name)
-    end
-
-    # Info on an existing Outbound Ruleset
-    #
-    # @param space_id_or_space_name: unique identifier of space or unique name of space
-    # @param outbound_ruleset_id: unique identifier of an outbound-ruleset
-    def info(space_id_or_space_name, outbound_ruleset_id)
-      @client.outbound_ruleset.info(space_id_or_space_name, outbound_ruleset_id)
-    end
-
-    # List all Outbound Rulesets for a space
-    #
-    # @param space_id_or_space_name: unique identifier of space or unique name of space
-    def list(space_id_or_space_name)
-      @client.outbound_ruleset.list(space_id_or_space_name)
+    # @param app_id_or_app_name: unique identifier of app or unique name of app
+    # @param oci_image_id_or_oci_image_digest: unique identifier of the OCI image or unique identifier representing the content of the OCI image
+    def info(app_id_or_app_name, oci_image_id_or_oci_image_digest)
+      @client.oci_image.info(app_id_or_app_name, oci_image_id_or_oci_image_digest)
     end
 
-    # Create a new outbound ruleset
+    # Create an new OCI image of an app
     #
-    # @param space_id_or_space_name: unique identifier of space or unique name of space
+    # @param app_id_or_app_name: unique identifier of app or unique name of app
     # @param body: the object to pass as the request payload
-    def create(space_id_or_space_name, body = {})
-      @client.outbound_ruleset.create(space_id_or_space_name, body)
+    def create(app_id_or_app_name, body = {})
+      @client.oci_image.create(app_id_or_app_name, body)
     end
   end
 
@@ -2368,7 +2451,7 @@ module PlatformAPI
     end
   end
 
-  # Information about latest builds of apps in a pipeline.
+  # Information about the latest builds of apps in a pipeline. A build represents the process of transforming code into build artifacts.
   class PipelineBuild
     def initialize(client)
       @client = client
@@ -2382,7 +2465,7 @@ module PlatformAPI
     end
   end
 
-  # Pipeline Config Vars allow you to manage the configuration information provided to a pipeline.
+  # Pipeline config vars in Heroku CI and review apps used to manage the configuration information for a pipeline.
   class PipelineConfigVar
     def initialize(client)
       @client = client
@@ -2473,13 +2556,13 @@ module PlatformAPI
     end
   end
 
-  # Information about latest deployments of apps in a pipeline.
+  # Information about the latest deployment of each app in a pipeline. A deployment is the process of moving the build artifacts to a target environment.
   class PipelineDeployment
     def initialize(client)
       @client = client
     end
 
-    # List latest slug releases for each app in a pipeline
+    # List latest deployments for each app in a pipeline. A deployment is a release that changed your source slug, container image, or Heroku processes.
     #
     # @param pipeline_id: unique identifier of pipeline
     def list(pipeline_id)
@@ -2522,7 +2605,7 @@ module PlatformAPI
     end
   end
 
-  # Information about latest releases of apps in a pipeline.
+  # Information about the latest release of each app in a pipeline. A release makes a deployment available to end-users.
   class PipelineRelease
     def initialize(client)
       @client = client
@@ -3031,6 +3114,13 @@ module PlatformAPI
     def list()
       @client.stack.list()
     end
+
+    # List available app stacks for an app.
+    #
+    # @param app_id_or_app_name: unique identifier of app or unique name of app
+    def list_by_app(app_id_or_app_name)
+      @client.stack.list_by_app(app_id_or_app_name)
+    end
   end
 
   # 
@@ -3063,34 +3153,34 @@ module PlatformAPI
 
     # Delete an existing collaborator from a team app.
     #
-    # @param app_name: unique name of app
+    # @param team_app_identity: 
     # @param collaborator_email: invited email address of collaborator
-    def delete(app_name, collaborator_email)
-      @client.team_app_collaborator.delete(app_name, collaborator_email)
+    def delete(team_app_identity, collaborator_email)
+      @client.team_app_collaborator.delete(team_app_identity, collaborator_email)
     end
 
     # Info for a collaborator on a team app.
     #
-    # @param app_name: unique name of app
+    # @param team_app_identity: 
     # @param collaborator_email: invited email address of collaborator
-    def info(app_name, collaborator_email)
-      @client.team_app_collaborator.info(app_name, collaborator_email)
+    def info(team_app_identity, collaborator_email)
+      @client.team_app_collaborator.info(team_app_identity, collaborator_email)
     end
 
     # Update an existing collaborator from a team app.
     #
-    # @param app_name: unique name of app
+    # @param team_app_identity: 
     # @param collaborator_email: invited email address of collaborator
     # @param body: the object to pass as the request payload
-    def update(app_name, collaborator_email, body = {})
-      @client.team_app_collaborator.update(app_name, collaborator_email, body)
+    def update(team_app_identity, collaborator_email, body = {})
+      @client.team_app_collaborator.update(team_app_identity, collaborator_email, body)
     end
 
     # List collaborators on a team app.
     #
-    # @param app_name: unique name of app
-    def list(app_name)
-      @client.team_app_collaborator.list(app_name)
+    # @param team_app_identity: 
+    def list(team_app_identity)
+      @client.team_app_collaborator.list(team_app_identity)
     end
   end
 
@@ -3121,33 +3211,33 @@ module PlatformAPI
 
     # Info for a team app.
     #
-    # @param app_name: unique name of app
-    def info(app_name)
-      @client.team_app.info(app_name)
+    # @param team_app_identity: 
+    def info(team_app_identity)
+      @client.team_app.info(team_app_identity)
     end
 
     # Lock or unlock a team app.
     #
-    # @param app_name: unique name of app
+    # @param team_app_identity: 
     # @param body: the object to pass as the request payload
-    def update_locked(app_name, body = {})
-      @client.team_app.update_locked(app_name, body)
+    def update_locked(team_app_identity, body = {})
+      @client.team_app.update_locked(team_app_identity, body)
     end
 
     # Transfer an existing team app to another Heroku account.
     #
-    # @param app_name: unique name of app
+    # @param team_app_identity: 
     # @param body: the object to pass as the request payload
-    def transfer_to_account(app_name, body = {})
-      @client.team_app.transfer_to_account(app_name, body)
+    def transfer_to_account(team_app_identity, body = {})
+      @client.team_app.transfer_to_account(team_app_identity, body)
     end
 
     # Transfer an existing team app to another team.
     #
-    # @param app_name: unique name of app
+    # @param team_app_identity: 
     # @param body: the object to pass as the request payload
-    def transfer_to_team(app_name, body = {})
-      @client.team_app.transfer_to_team(app_name, body)
+    def transfer_to_team(team_app_identity, body = {})
+      @client.team_app.transfer_to_team(team_app_identity, body)
     end
 
     # List team apps.
@@ -3174,6 +3264,20 @@ module PlatformAPI
     end
   end
 
+  # A Heroku team becomes delinquent due to non-payment. We [suspend and delete](https://help.heroku.com/EREVRILX/what-happens-if-i-have-unpaid-heroku-invoices) delinquent teams if their invoices remain unpaid.
+  class TeamDelinquency
+    def initialize(client)
+      @client = client
+    end
+
+    # Team delinquency information.
+    #
+    # @param team_name_or_team_id: unique name of team or unique identifier of team
+    def info(team_name_or_team_id)
+      @client.team_delinquency.info(team_name_or_team_id)
+    end
+  end
+
   # A team feature represents a feature enabled on a team account.
   class TeamFeature
     def initialize(client)
@@ -3410,17 +3514,67 @@ module PlatformAPI
 
     # List teams for an enterprise account.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
-    def list_by_enterprise_account(enterprise_account_id)
-      @client.team.list_by_enterprise_account(enterprise_account_id)
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
+    def list_by_enterprise_account(enterprise_account_id_or_enterprise_account_name)
+      @client.team.list_by_enterprise_account(enterprise_account_id_or_enterprise_account_name)
     end
 
     # Create a team in an enterprise account.
     #
-    # @param enterprise_account_id: unique identifier of the enterprise account
+    # @param enterprise_account_id_or_enterprise_account_name: unique identifier of the enterprise account or unique name of the enterprise account
+    # @param body: the object to pass as the request payload
+    def create_in_enterprise_account(enterprise_account_id_or_enterprise_account_name, body = {})
+      @client.team.create_in_enterprise_account(enterprise_account_id_or_enterprise_account_name, body)
+    end
+  end
+
+  # A telemetry drain forwards OpenTelemetry traces, metrics, and logs to your own consumer. For Fir-generation apps only.
+  class TelemetryDrain
+    def initialize(client)
+      @client = client
+    end
+
+    # Create a telemetry drain.
+    #
+    # @param body: the object to pass as the request payload
+    def create(body = {})
+      @client.telemetry_drain.create(body)
+    end
+
+    # List telemetry drains for an app.
+    #
+    # @param app_id_or_app_name: unique identifier of app or unique name of app
+    def list_by_app(app_id_or_app_name)
+      @client.telemetry_drain.list_by_app(app_id_or_app_name)
+    end
+
+    # List telemetry drains for a space.
+    #
+    # @param space_id_or_space_name: unique identifier of space or unique name of space
+    def list_by_space(space_id_or_space_name)
+      @client.telemetry_drain.list_by_space(space_id_or_space_name)
+    end
+
+    # Update a telemetry drain.
+    #
+    # @param telemetry_drain_id: unique identifier of telemetry drain
     # @param body: the object to pass as the request payload
-    def create_in_enterprise_account(enterprise_account_id, body = {})
-      @client.team.create_in_enterprise_account(enterprise_account_id, body)
+    def update(telemetry_drain_id, body = {})
+      @client.telemetry_drain.update(telemetry_drain_id, body)
+    end
+
+    # Delete a telemetry drain.
+    #
+    # @param telemetry_drain_id: unique identifier of telemetry drain
+    def delete(telemetry_drain_id)
+      @client.telemetry_drain.delete(telemetry_drain_id)
+    end
+
+    # Info for a telemetry drain.
+    #
+    # @param telemetry_drain_id: unique identifier of telemetry drain
+    def info(telemetry_drain_id)
+      @client.telemetry_drain.info(telemetry_drain_id)
     end
   end
 
@@ -3572,6 +3726,58 @@ module PlatformAPI
     "object"
   ],
   "definitions": {
+    "account-delinquency": {
+      "description": "A Heroku account becomes delinquent due to non-payment. We [suspend and delete](https://help.heroku.com/EREVRILX/what-happens-if-i-have-unpaid-heroku-invoices) delinquent accounts if their invoices remain unpaid.",
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "stability": "development",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Account Delinquency",
+      "type": [
+        "object"
+      ],
+      "definitions": {
+        "scheduled_suspension_time": {
+          "description": "scheduled time of when we will suspend your account due to delinquency",
+          "example": "2024-01-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "scheduled_deletion_time": {
+          "description": "scheduled time of when we will delete your account due to delinquency",
+          "example": "2024-01-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "links": [
+        {
+          "description": "Account delinquency information.",
+          "href": "/account/delinquency",
+          "method": "GET",
+          "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/account-delinquency"
+          },
+          "title": "Info"
+        }
+      ],
+      "properties": {
+        "scheduled_suspension_time": {
+          "$ref": "#/definitions/account-delinquency/definitions/scheduled_suspension_time"
+        },
+        "scheduled_deletion_time": {
+          "$ref": "#/definitions/account-delinquency/definitions/scheduled_deletion_time"
+        }
+      }
+    },
     "account-feature": {
       "description": "An account feature represents a Heroku labs capability that can be enabled or disabled for an account on Heroku.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
@@ -4863,6 +5069,27 @@ module PlatformAPI
           "type": [
             "string"
           ]
+        },
+        "supported_generations": {
+          "description": "generations supported by this add-on",
+          "readonly": true,
+          "type": [
+            "array"
+          ],
+          "items": {
+            "type": [
+              "object"
+            ],
+            "properties": {
+              "name": {
+                "$ref": "#/definitions/generation/definitions/name",
+                "example": "cedar"
+              },
+              "id": {
+                "$ref": "#/definitions/generation/definitions/id"
+              }
+            }
+          }
         }
       },
       "links": [
@@ -4919,6 +5146,9 @@ module PlatformAPI
         },
         "updated_at": {
           "$ref": "#/definitions/add-on-service/definitions/updated_at"
+        },
+        "supported_generations": {
+          "$ref": "#/definitions/add-on-service/definitions/supported_generations"
         }
       }
     },
@@ -7309,6 +7539,32 @@ module PlatformAPI
             "string"
           ]
         },
+        "generation": {
+          "description": "Generation of the Heroku platform for this app",
+          "readOnly": true,
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "id": {
+              "description": "unique identifier of the generation of the Heroku platform for this app",
+              "example": "01234567-89ab-cdef-0123-456789abcdef",
+              "format": "uuid",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            },
+            "name": {
+              "description": "unique name of the generation of the Heroku platform for this app",
+              "example": "cedar",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            }
+          }
+        },
         "git_url": {
           "description": "git repo URL of app",
           "example": "https://git.heroku.com/example.git",
@@ -7597,6 +7853,9 @@ module PlatformAPI
         "created_at": {
           "$ref": "#/definitions/app/definitions/created_at"
         },
+        "generation": {
+          "$ref": "#/definitions/app/definitions/generation"
+        },
         "git_url": {
           "$ref": "#/definitions/app/definitions/git_url"
         },
@@ -8052,7 +8311,7 @@ module PlatformAPI
     },
     "build": {
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "description": "A build represents the process of transforming a code tarball into a slug",
+      "description": "A build represents the process of transforming a code tarball into build artifacts",
       "title": "Heroku Build API - Build",
       "stability": "production",
       "strictProperties": false,
@@ -8069,7 +8328,7 @@ module PlatformAPI
       ],
       "definitions": {
         "buildpacks": {
-          "description": "buildpacks executed for this build, in order",
+          "description": "buildpacks executed for this build, in order (only applicable to Cedar-generation apps)",
           "type": [
             "array",
             "null"
@@ -8339,7 +8598,7 @@ module PlatformAPI
           "$ref": "#/definitions/build/definitions/release"
         },
         "slug": {
-          "description": "slug created by this build",
+          "description": "slug created by this build (only applicable for Cedar-generation apps)",
           "properties": {
             "id": {
               "$ref": "#/definitions/slug/definitions/id"
@@ -9204,6 +9463,14 @@ module PlatformAPI
         "object"
       ],
       "definitions": {
+        "architecture": {
+          "description": "CPU architecture of this dyno size",
+          "example": "amd64",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
         "compute": {
           "description": "minimum vCPUs, non-dedicated may get more depending on load",
           "example": 1,
@@ -9220,8 +9487,34 @@ module PlatformAPI
             "boolean"
           ]
         },
+        "generation": {
+          "description": "Generation of the Heroku platform for this dyno size",
+          "readOnly": true,
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "id": {
+              "description": "unique identifier of the generation of the Heroku platform for this dyno size",
+              "example": "01234567-89ab-cdef-0123-456789abcdef",
+              "format": "uuid",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            },
+            "name": {
+              "description": "unique name of the generation of the Heroku platform for this dyno size",
+              "example": "cedar",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            }
+          }
+        },
         "id": {
-          "description": "unique identifier of this dyno size",
+          "description": "unique identifier of the dyno size",
           "example": "01234567-89ab-cdef-0123-456789abcdef",
           "format": "uuid",
           "readOnly": true,
@@ -9248,7 +9541,7 @@ module PlatformAPI
           ]
         },
         "name": {
-          "description": "the name of this dyno-size",
+          "description": "name of the dyno size",
           "example": "eco",
           "readOnly": true,
           "type": [
@@ -9281,15 +9574,6 @@ module PlatformAPI
             }
           }
         },
-        "dyno_units": {
-          "deprecated": true,
-          "description": "deprecated. See precise_dyno_units instead",
-          "example": 0,
-          "readOnly": true,
-          "type": [
-            "integer"
-          ]
-        },
         "precise_dyno_units": {
           "description": "unit of consumption for Heroku Enterprise customers to 2 decimal places",
           "example": 0.28,
@@ -9332,9 +9616,24 @@ module PlatformAPI
             ]
           },
           "title": "List"
+        },
+        {
+          "description": "List available dyno sizes for an app",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/available-dyno-sizes",
+          "method": "GET",
+          "rel": "available-app-dynos",
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/dyno-size"
+            }
+          },
+          "title": "List App Dyno Sizes"
         }
       ],
       "properties": {
+        "architecture": {
+          "$ref": "#/definitions/dyno-size/definitions/architecture"
+        },
         "compute": {
           "$ref": "#/definitions/dyno-size/definitions/compute"
         },
@@ -9344,12 +9643,12 @@ module PlatformAPI
         "dedicated": {
           "$ref": "#/definitions/dyno-size/definitions/dedicated"
         },
-        "dyno_units": {
-          "$ref": "#/definitions/dyno-size/definitions/dyno_units"
-        },
         "precise_dyno_units": {
           "$ref": "#/definitions/dyno-size/definitions/precise_dyno_units"
         },
+        "generation": {
+          "$ref": "#/definitions/dyno-size/definitions/generation"
+        },
         "id": {
           "$ref": "#/definitions/dyno-size/definitions/id"
         },
@@ -9455,6 +9754,14 @@ module PlatformAPI
             "string"
           ]
         },
+        "formation_type": {
+          "description": "the formation type of this process on this dyno",
+          "example": "run",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
         "force_no_tty": {
           "description": "force an attached one-off dyno to not run in a tty",
           "example": null,
@@ -9465,7 +9772,7 @@ module PlatformAPI
           ]
         },
         "size": {
-          "description": "dyno size (default: \"standard-1X\")",
+          "description": "dyno size",
           "example": "standard-1X",
           "readOnly": false,
           "type": [
@@ -9562,8 +9869,8 @@ module PlatformAPI
           "title": "Restart"
         },
         {
-          "description": "Restart all dynos.",
-          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/dynos",
+          "description": "Restart dynos of a given formation type.",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/formations/{(%23%2Fdefinitions%2Fdyno%2Fdefinitions%2Fformation_type)}",
           "method": "DELETE",
           "rel": "empty",
           "targetSchema": {
@@ -9572,7 +9879,20 @@ module PlatformAPI
               "object"
             ]
           },
-          "title": "Restart all"
+          "title": "Restart formation"
+        },
+        {
+          "description": "Restart all dynos.",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/dynos",
+          "method": "DELETE",
+          "rel": "empty",
+          "targetSchema": {
+            "additionalProperties": false,
+            "type": [
+              "object"
+            ]
+          },
+          "title": "Restart all"
         },
         {
           "description": "Stop dyno.",
@@ -9587,6 +9907,19 @@ module PlatformAPI
           },
           "title": "Stop"
         },
+        {
+          "description": "Stop dynos of a given formation type.",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/formations/{(%23%2Fdefinitions%2Fdyno%2Fdefinitions%2Fformation_type)}/actions/stop",
+          "method": "POST",
+          "rel": "empty",
+          "targetSchema": {
+            "additionalProperties": false,
+            "type": [
+              "object"
+            ]
+          },
+          "title": "Stop formation"
+        },
         {
           "description": "Info for existing dyno.",
           "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/dynos/{(%23%2Fdefinitions%2Fdyno%2Fdefinitions%2Fidentity)}",
@@ -10142,7 +10475,7 @@ module PlatformAPI
           ]
         },
         "connect": {
-          "description": "average connect rows synced",
+          "description": "max connect rows synced",
           "example": 15000,
           "readOnly": true,
           "type": [
@@ -10367,6 +10700,9 @@ module PlatformAPI
           "anyOf": [
             {
               "$ref": "#/definitions/enterprise-account/definitions/id"
+            },
+            {
+              "$ref": "#/definitions/enterprise-account/definitions/name"
             }
           ]
         },
@@ -10589,6 +10925,50 @@ module PlatformAPI
             "string"
           ]
         },
+        "dyno_size": {
+          "description": "dyno size",
+          "example": {
+            "id": "01234567-89ab-cdef-0123-456789abcdef"
+          },
+          "oneOf": [
+            {
+              "required": [
+                "id"
+              ]
+            },
+            {
+              "required": [
+                "name"
+              ]
+            }
+          ],
+          "properties": {
+            "id": {
+              "description": "unique identifier of the dyno size",
+              "example": "01234567-89ab-cdef-0123-456789abcdef",
+              "format": "uuid",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            },
+            "name": {
+              "description": "name of the dyno size",
+              "example": "Standard-1X",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            }
+          },
+          "readOnly": false,
+          "required": [
+            "id"
+          ],
+          "type": [
+            "object"
+          ]
+        },
         "id": {
           "description": "unique identifier of this process type",
           "example": "01234567-89ab-cdef-0123-456789abcdef",
@@ -10617,7 +10997,8 @@ module PlatformAPI
           ]
         },
         "size": {
-          "description": "dyno size (default: \"standard-1X\")",
+          "deprecated": true,
+          "description": "deprecated, refer to 'dyno_size' instead",
           "example": "standard-1X",
           "readOnly": false,
           "type": [
@@ -10646,12 +11027,12 @@ module PlatformAPI
           "additionalProperties": false,
           "description": "Properties to update a process type",
           "properties": {
+            "dyno_size": {
+              "$ref": "#/definitions/formation/definitions/dyno_size"
+            },
             "quantity": {
               "$ref": "#/definitions/formation/definitions/quantity"
             },
-            "size": {
-              "$ref": "#/definitions/formation/definitions/size"
-            },
             "type": {
               "$ref": "#/definitions/formation/definitions/type"
             }
@@ -10705,7 +11086,7 @@ module PlatformAPI
                 "items": {
                   "$ref": "#/definitions/formation/definitions/update"
                 },
-                "description": "Array with formation updates. Each element must have \"type\", the id or name of the process type to be updated, and can optionally update its \"quantity\" or \"size\"."
+                "description": "Array with formation updates. Each element must have \"type\", the id or name of the process type to be updated, and can optionally update its \"quantity\" or \"dyno_size\"."
               }
             },
             "required": [
@@ -10732,11 +11113,11 @@ module PlatformAPI
           "rel": "update",
           "schema": {
             "properties": {
+              "dyno_size": {
+                "$ref": "#/definitions/formation/definitions/dyno_size"
+              },
               "quantity": {
                 "$ref": "#/definitions/formation/definitions/quantity"
-              },
-              "size": {
-                "$ref": "#/definitions/formation/definitions/size"
               }
             },
             "type": [
@@ -10773,6 +11154,20 @@ module PlatformAPI
         "created_at": {
           "$ref": "#/definitions/formation/definitions/created_at"
         },
+        "dyno_size": {
+          "description": "dyno size",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/dyno-size/definitions/id"
+            },
+            "name": {
+              "$ref": "#/definitions/dyno-size/definitions/name"
+            }
+          },
+          "type": [
+            "object"
+          ]
+        },
         "id": {
           "$ref": "#/definitions/formation/definitions/id"
         },
@@ -10790,8 +11185,121 @@ module PlatformAPI
         }
       }
     },
+    "generation": {
+      "description": "A generation represents a version of the Heroku platform that includes the app execution environment, routing, telemetry, and build systems.",
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "stability": "prototype",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Generation",
+      "type": [
+        "object"
+      ],
+      "definitions": {
+        "created_at": {
+          "description": "when generation was created",
+          "example": "2024-12-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "id": {
+          "description": "unique identifier of generation",
+          "example": "01234567-89ab-cdef-0123-456789abcdef",
+          "format": "uuid",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "identity": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/generation/definitions/name"
+            },
+            {
+              "$ref": "#/definitions/generation/definitions/id"
+            }
+          ]
+        },
+        "name": {
+          "description": "unique name of generation",
+          "example": "fir",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "updated_at": {
+          "description": "when generation was updated",
+          "example": "2024-12-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        }
+      },
+      "links": [
+        {
+          "description": "Info for generation.",
+          "href": "/generations/{(%23%2Fdefinitions%2Fstack%2Fdefinitions%2Fidentity)}",
+          "method": "GET",
+          "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/generation"
+          },
+          "title": "Info"
+        },
+        {
+          "description": "List available generations.",
+          "href": "/generations",
+          "method": "GET",
+          "rel": "instances",
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/generation"
+            },
+            "type": [
+              "array"
+            ]
+          },
+          "title": "List"
+        },
+        {
+          "description": "List available generations for a team.",
+          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/available-generations",
+          "method": "GET",
+          "rel": "instances",
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/generation"
+            },
+            "type": [
+              "array"
+            ]
+          },
+          "title": "List by Team"
+        }
+      ],
+      "properties": {
+        "created_at": {
+          "$ref": "#/definitions/generation/definitions/created_at"
+        },
+        "id": {
+          "$ref": "#/definitions/generation/definitions/id"
+        },
+        "name": {
+          "$ref": "#/definitions/generation/definitions/name"
+        },
+        "updated_at": {
+          "$ref": "#/definitions/generation/definitions/updated_at"
+        }
+      }
+    },
     "identity-provider": {
-      "description": "Identity Providers represent the SAML configuration of an Enterprise Account or Team.",
+      "description": "Identity Providers represent the SAML configuration of teams or an Enterprise account",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "stability": "production",
       "strictProperties": true,
@@ -11154,6 +11662,9 @@ module PlatformAPI
           "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/inbound-ruleset",
           "method": "PUT",
           "rel": "create",
+          "targetSchema": {
+            "$ref": "#/definitions/inbound-ruleset"
+          },
           "schema": {
             "type": [
               "object"
@@ -11939,9 +12450,17 @@ module PlatformAPI
             "string"
           ]
         },
-        "dyno": {
-          "description": "dyno to limit results to",
-          "example": "web.1",
+        "dyno_name": {
+          "description": "dyno name to limit results to",
+          "example": "'web.1' (Cedar-generation) or 'web-1234abcde-123ab' (Fir-generation)",
+          "readOnly": false,
+          "type": [
+            "string"
+          ]
+        },
+        "type": {
+          "description": "process type to limit results to",
+          "example": "web",
           "readOnly": false,
           "type": [
             "string"
@@ -12013,8 +12532,11 @@ module PlatformAPI
           "rel": "create",
           "schema": {
             "properties": {
-              "dyno": {
-                "$ref": "#/definitions/log-session/definitions/dyno"
+              "dyno_name": {
+                "$ref": "#/definitions/log-session/definitions/dyno_name"
+              },
+              "type": {
+                "$ref": "#/definitions/log-session/definitions/type"
               },
               "lines": {
                 "$ref": "#/definitions/log-session/definitions/lines"
@@ -12172,6 +12694,43 @@ module PlatformAPI
           },
           "title": "Info"
         },
+        {
+          "description": "Update an existing OAuth authorization.",
+          "href": "/oauth/authorizations/{(%23%2Fdefinitions%2Foauth-authorization%2Fdefinitions%2Fidentity)}",
+          "method": "PATCH",
+          "rel": "update",
+          "targetSchema": {
+            "$ref": "#/definitions/oauth-authorization"
+          },
+          "schema": {
+            "properties": {
+              "description": {
+                "$ref": "#/definitions/oauth-authorization/definitions/description"
+              },
+              "client": {
+                "type": [
+                  "object"
+                ],
+                "description": "identifier of the client that obtained this authorization",
+                "properties": {
+                  "id": {
+                    "$ref": "#/definitions/oauth-client/definitions/id"
+                  },
+                  "secret": {
+                    "$ref": "#/definitions/oauth-client/definitions/secret"
+                  }
+                }
+              }
+            },
+            "required": [
+              "client"
+            ],
+            "type": [
+              "object"
+            ]
+          },
+          "title": "Update"
+        },
         {
           "description": "List OAuth authorizations.",
           "href": "/oauth/authorizations",
@@ -12238,6 +12797,9 @@ module PlatformAPI
         "created_at": {
           "$ref": "#/definitions/oauth-authorization/definitions/created_at"
         },
+        "description": {
+          "$ref": "#/definitions/oauth-authorization/definitions/description"
+        },
         "grant": {
           "description": "this authorization's grant",
           "properties": {
@@ -12282,6 +12844,19 @@ module PlatformAPI
         "scope": {
           "$ref": "#/definitions/oauth-authorization/definitions/scope"
         },
+        "session": {
+          "description": "this authorization's session",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/oauth-token/definitions/id"
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "null",
+            "object"
+          ]
+        },
         "updated_at": {
           "$ref": "#/definitions/oauth-authorization/definitions/updated_at"
         },
@@ -12422,7 +12997,7 @@ module PlatformAPI
           "title": "Delete"
         },
         {
-          "description": "Info for an OAuth client",
+          "description": "Info for an OAuth client. The output for unauthenticated requests excludes the `secret` parameter.",
           "href": "/oauth/clients/{(%23%2Fdefinitions%2Foauth-client%2Fdefinitions%2Fidentity)}",
           "method": "GET",
           "rel": "self",
@@ -12604,7 +13179,7 @@ module PlatformAPI
         },
         "token": {
           "description": "contents of the token to be used for authorization",
-          "example": "01234567-89ab-cdef-0123-456789abcdef",
+          "example": "HRKU-01234567-89ab-cdef-0123-456789abcdef",
           "readOnly": true,
           "type": [
             "string"
@@ -12799,36 +13374,18 @@ module PlatformAPI
         }
       }
     },
-    "outbound-ruleset": {
-      "description": "An outbound-ruleset is a collection of rules that specify what hosts Dynos are allowed to communicate with. ",
+    "oci-image": {
+      "description": "An OCI (Open Container Initiative) image is a standardized format for packaging and distributing containerized applications, ready to run on the platform.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "stability": "prototype",
       "strictProperties": true,
-      "title": "Heroku Platform API - Outbound Ruleset",
+      "title": "Heroku Platform API - OCI Image",
       "type": [
         "object"
       ],
       "definitions": {
-        "target": {
-          "description": "is the target destination in CIDR notation",
-          "example": "1.1.1.1/1",
-          "pattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$",
-          "readOnly": false,
-          "type": [
-            "string"
-          ]
-        },
-        "created_at": {
-          "description": "when outbound-ruleset was created",
-          "example": "2012-01-01T12:00:00Z",
-          "format": "date-time",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
         "id": {
-          "description": "unique identifier of an outbound-ruleset",
+          "description": "unique identifier of the OCI image",
           "example": "01234567-89ab-cdef-0123-456789abcdef",
           "format": "uuid",
           "readOnly": true,
@@ -12836,146 +13393,336 @@ module PlatformAPI
             "string"
           ]
         },
-        "port": {
-          "description": "an endpoint of communication in an operating system.",
-          "example": 80,
+        "digest": {
+          "description": "unique identifier representing the content of the OCI image",
+          "example": "sha256:dc14ae5fbc1e7230e0a782bf216fb46500e210631703bcc6bab8acf2c6a23f42",
           "readOnly": false,
           "type": [
-            "integer"
+            "string"
           ]
         },
-        "protocol": {
-          "description": "formal standards and policies comprised of rules, procedures and formats that define communication between two or more devices over a network",
-          "example": "tcp",
+        "architecture": {
+          "description": "build architecture for OCI image",
+          "example": "arm64",
           "readOnly": false,
           "type": [
-            "string"
+            "string",
+            "null"
           ]
         },
         "identity": {
           "anyOf": [
             {
-              "$ref": "#/definitions/outbound-ruleset/definitions/id"
+              "$ref": "#/definitions/oci-image/definitions/id"
+            },
+            {
+              "$ref": "#/definitions/oci-image/definitions/digest"
             }
           ]
         },
-        "rule": {
-          "description": "the combination of an IP address in CIDR notation, a from_port, to_port and protocol.",
+        "base_image_name": {
+          "description": "name of the image used for the base layers of the OCI image",
+          "example": "heroku/heroku:22-cnb",
+          "readOnly": false,
           "type": [
-            "object"
-          ],
-          "properties": {
-            "target": {
-              "$ref": "#/definitions/outbound-ruleset/definitions/target"
-            },
-            "from_port": {
-              "$ref": "#/definitions/outbound-ruleset/definitions/port"
-            },
-            "to_port": {
-              "$ref": "#/definitions/outbound-ruleset/definitions/port"
-            },
-            "protocol": {
-              "$ref": "#/definitions/outbound-ruleset/definitions/protocol"
+            "string"
+          ]
+        },
+        "base_top_layer": {
+          "description": "the digest of the top most layer of the base image.",
+          "example": "sha256:ea36ae5fbc1e7230e0a782bf216fb46500e210382703baa6bab8acf2c6a23f78",
+          "readOnly": false,
+          "type": [
+            "string"
+          ]
+        },
+        "commit": {
+          "description": "identification of the code in your version control system (eg: SHA of the git HEAD)",
+          "example": "60883d9e8947a57e04dc9124f25df004866a2051",
+          "readOnly": false,
+          "type": [
+            "string"
+          ]
+        },
+        "commit_description": {
+          "description": "an optional description of the provided commit",
+          "example": "fixed a bug with API documentation",
+          "readOnly": false,
+          "type": [
+            "string"
+          ]
+        },
+        "image_repo": {
+          "description": "name of the image registry repository used for storage",
+          "example": "d7ba1ace-b396-4691-968c-37ae53153426/builds",
+          "readOnly": false,
+          "type": [
+            "string"
+          ]
+        },
+        "process_type": {
+          "description": "process type information such as names and commands",
+          "readOnly": false,
+          "properties": {
+            "name": {
+              "description": "name of the process type",
+              "example": "web",
+              "type": [
+                "string"
+              ]
+            },
+            "display_cmd": {
+              "description": "the detailed command used for display purposes",
+              "example": "bundle exec puma -p $PORT",
+              "type": [
+                "string"
+              ]
+            },
+            "command": {
+              "description": "the command that will be executed",
+              "example": "/cnb/process/web",
+              "type": [
+                "string"
+              ]
+            },
+            "working_dir": {
+              "description": "working directory",
+              "example": "/worspace/webapp",
+              "type": [
+                "string"
+              ]
+            },
+            "default": {
+              "description": "true if it is the default process type",
+              "example": true,
+              "type": [
+                "boolean",
+                "null"
+              ]
             }
           },
-          "required": [
-            "target",
-            "from_port",
-            "to_port",
-            "protocol"
+          "example": {
+            "name": "web",
+            "display_cmd": "bundle exec puma -p $PORT",
+            "command": "/cnb/process/web",
+            "working_dir": "/workspace/webapp",
+            "default": true
+          },
+          "type": [
+            "object"
           ]
-        }
-      },
-      "links": [
-        {
-          "description": "Current outbound ruleset for a space",
-          "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/outbound-ruleset",
-          "method": "GET",
-          "rel": "self",
-          "targetSchema": {
-            "$ref": "#/definitions/outbound-ruleset"
+        },
+        "process_types": {
+          "description": "process types of the OCI image",
+          "patternProperties": {
+            "^[-\\w]{1,128}$": {
+              "$ref": "#/definitions/oci-image/definitions/process_type"
+            }
           },
-          "title": "Current"
+          "example": {
+            "web": {
+              "name": "web",
+              "display_cmd": "bundle exec puma -p $PORT",
+              "command": "/cnb/process/web",
+              "working_dir": "/workspace/webapp",
+              "default": true
+            }
+          },
+          "type": [
+            "object"
+          ]
         },
-        {
-          "description": "Info on an existing Outbound Ruleset",
-          "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/outbound-rulesets/{(%23%2Fdefinitions%2Foutbound-ruleset%2Fdefinitions%2Fidentity)}",
-          "method": "GET",
-          "rel": "self",
-          "targetSchema": {
-            "$ref": "#/definitions/outbound-ruleset"
+        "buildpack": {
+          "description": "set of executables that inspects app source code and creates a plan to build and run your image",
+          "readOnly": false,
+          "properties": {
+            "id": {
+              "description": "identifier of the buildpack",
+              "example": "heroku/ruby",
+              "type": [
+                "string"
+              ]
+            },
+            "version": {
+              "description": "version of the buildpack",
+              "example": "2.0.0",
+              "type": [
+                "string"
+              ]
+            },
+            "homepage": {
+              "description": "homepage of the buildpack",
+              "example": "https://github.com/heroku/buildpacks-ruby",
+              "type": [
+                "string"
+              ]
+            }
           },
-          "title": "Info"
+          "example": {
+            "id": "heroku/ruby",
+            "version": "2.0.0",
+            "homepage": "https://github.com/heroku/buildpacks-ruby"
+          },
+          "type": [
+            "object"
+          ]
+        },
+        "buildpacks": {
+          "description": "buildpacks of the OCI image",
+          "items": {
+            "$ref": "#/definitions/oci-image/definitions/buildpack"
+          },
+          "type": [
+            "array"
+          ]
+        },
+        "stack": {
+          "description": "stack associated to the OCI image",
+          "readOnly": false,
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/stack/definitions/id",
+              "example": "ba46bf09-7bd1-42fd-90df-a1a9a93eb4a2"
+            },
+            "name": {
+              "$ref": "#/definitions/stack/definitions/name",
+              "example": "cnb"
+            }
+          },
+          "type": [
+            "object"
+          ]
         },
+        "created_at": {
+          "description": "when the OCI image was created",
+          "example": "2012-01-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "updated_at": {
+          "description": "when the OCI image was updated",
+          "example": "2012-01-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        }
+      },
+      "links": [
         {
-          "description": "List all Outbound Rulesets for a space",
-          "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/outbound-rulesets",
+          "description": "Info for the OCI images of an app, filtered by identifier.",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/oci-images/{(%23%2Fdefinitions%2Foci-image%2Fdefinitions%2Fidentity)}",
           "method": "GET",
-          "rel": "instances",
+          "rel": "self",
           "targetSchema": {
             "items": {
-              "$ref": "#/definitions/outbound-ruleset"
+              "$ref": "#/definitions/oci-image"
             },
             "type": [
               "array"
             ]
           },
-          "title": "List"
+          "title": "Info"
         },
         {
-          "description": "Create a new outbound ruleset",
-          "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/outbound-ruleset",
-          "method": "PUT",
+          "description": "Create an new OCI image of an app",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/oci-images",
+          "method": "POST",
           "rel": "create",
           "schema": {
-            "type": [
-              "object"
-            ],
             "properties": {
-              "rules": {
-                "type": [
-                  "array"
-                ],
-                "items": {
-                  "$ref": "#/definitions/outbound-ruleset/definitions/rule"
-                }
+              "architecture": {
+                "$ref": "#/definitions/oci-image/definitions/architecture"
+              },
+              "base_image_name": {
+                "$ref": "#/definitions/oci-image/definitions/base_image_name"
+              },
+              "base_top_layer": {
+                "$ref": "#/definitions/oci-image/definitions/base_top_layer"
+              },
+              "commit": {
+                "$ref": "#/definitions/oci-image/definitions/commit"
+              },
+              "commit_description": {
+                "$ref": "#/definitions/oci-image/definitions/commit_description"
+              },
+              "image_repo": {
+                "$ref": "#/definitions/oci-image/definitions/image_repo"
+              },
+              "digest": {
+                "$ref": "#/definitions/oci-image/definitions/digest"
+              },
+              "stack": {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/stack/definitions/name",
+                    "example": "cnb"
+                  },
+                  {
+                    "$ref": "#/definitions/stack/definitions/id"
+                  }
+                ]
+              },
+              "process_types": {
+                "$ref": "#/definitions/oci-image/definitions/process_types"
+              },
+              "buildpacks": {
+                "$ref": "#/definitions/oci-image/definitions/buildpacks"
               }
-            }
+            },
+            "type": [
+              "object"
+            ]
+          },
+          "targetSchema": {
+            "$ref": "#/definitions/oci-image"
           },
           "title": "Create"
         }
       ],
       "properties": {
         "id": {
-          "$ref": "#/definitions/outbound-ruleset/definitions/id"
+          "$ref": "#/definitions/oci-image/definitions/id"
         },
-        "space": {
-          "description": "identity of space",
-          "properties": {
-            "id": {
-              "$ref": "#/definitions/space/definitions/id"
-            },
-            "name": {
-              "$ref": "#/definitions/space/definitions/name"
-            }
-          },
-          "type": [
-            "object"
-          ]
+        "base_image_name": {
+          "$ref": "#/definitions/oci-image/definitions/base_image_name"
+        },
+        "base_top_layer": {
+          "$ref": "#/definitions/oci-image/definitions/base_top_layer"
+        },
+        "commit": {
+          "$ref": "#/definitions/oci-image/definitions/commit"
+        },
+        "commit_description": {
+          "$ref": "#/definitions/oci-image/definitions/commit_description"
+        },
+        "image_repo": {
+          "$ref": "#/definitions/oci-image/definitions/image_repo"
+        },
+        "digest": {
+          "$ref": "#/definitions/oci-image/definitions/digest"
+        },
+        "stack": {
+          "$ref": "#/definitions/oci-image/definitions/stack"
+        },
+        "process_types": {
+          "$ref": "#/definitions/oci-image/definitions/process_types"
+        },
+        "buildpacks": {
+          "$ref": "#/definitions/oci-image/definitions/buildpacks"
         },
         "created_at": {
-          "$ref": "#/definitions/outbound-ruleset/definitions/created_at"
+          "$ref": "#/definitions/oci-image/definitions/created_at"
         },
-        "rules": {
-          "type": [
-            "array"
-          ],
-          "items": {
-            "$ref": "#/definitions/outbound-ruleset/definitions/rule"
-          }
+        "updated_at": {
+          "$ref": "#/definitions/oci-image/definitions/updated_at"
         },
-        "created_by": {
-          "$ref": "#/definitions/account/definitions/email"
+        "architecture": {
+          "$ref": "#/definitions/oci-image/definitions/architecture"
         }
       }
     },
@@ -13439,7 +14186,7 @@ module PlatformAPI
       }
     },
     "pipeline-build": {
-      "description": "Information about latest builds of apps in a pipeline.",
+      "description": "Information about the latest builds of apps in a pipeline. A build represents the process of transforming code into build artifacts.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "stability": "production",
       "strictProperties": true,
@@ -13449,6 +14196,131 @@ module PlatformAPI
       ],
       "definitions": {
       },
+      "properties": {
+        "app": {
+          "description": "app that the build belongs to",
+          "properties": {
+            "id": {
+              "description": "unique identifier of the app",
+              "$ref": "#/definitions/app/definitions/id"
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "object"
+          ]
+        },
+        "buildpacks": {
+          "$ref": "#/definitions/build/definitions/buildpacks"
+        },
+        "created_at": {
+          "description": "when the build was created",
+          "$ref": "#/definitions/build/definitions/created_at"
+        },
+        "id": {
+          "description": "unique identifier of the build",
+          "$ref": "#/definitions/build/definitions/id"
+        },
+        "output_stream_url": {
+          "description": "streaming URL of the build process output",
+          "$ref": "#/definitions/build/definitions/output_stream_url"
+        },
+        "source_blob": {
+          "description": "location of gzipped tarball of source code used to create build",
+          "properties": {
+            "checksum": {
+              "description": "an optional checksum of the gzipped tarball for verifying its integrity",
+              "example": "SHA256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+              "readOnly": true,
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "url": {
+              "description": "URL where gzipped tar archive of source code for build was downloaded.",
+              "example": "https://example.com/source.tgz?token=xyz",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            },
+            "version": {
+              "description": "version of the gzipped tarball",
+              "example": "v1.3.0",
+              "readOnly": true,
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "version_description": {
+              "description": "version description of the gzipped tarball",
+              "example": "* Fake User: Change session key",
+              "readOnly": true,
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "object"
+          ]
+        },
+        "release": {
+          "properties": {
+            "id": {
+              "description": "unique identifier of the release",
+              "$ref": "#/definitions/release/definitions/id"
+            }
+          },
+          "$ref": "#/definitions/build/definitions/release"
+        },
+        "slug": {
+          "description": "slug created by this build",
+          "properties": {
+            "id": {
+              "description": "unique identifier of the slug",
+              "$ref": "#/definitions/slug/definitions/id"
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "stack": {
+          "description": "stack of the build",
+          "example": "heroku-24",
+          "$ref": "#/definitions/build/definitions/stack"
+        },
+        "status": {
+          "description": "status of the build",
+          "$ref": "#/definitions/build/definitions/status"
+        },
+        "updated_at": {
+          "description": "when the build was updated",
+          "$ref": "#/definitions/build/definitions/updated_at"
+        },
+        "user": {
+          "description": "user that started the build",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/account/definitions/id"
+            },
+            "email": {
+              "$ref": "#/definitions/account/definitions/email"
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "object"
+          ]
+        }
+      },
       "links": [
         {
           "description": "List latest builds for each app in a pipeline",
@@ -13457,7 +14329,7 @@ module PlatformAPI
           "rel": "instances",
           "targetSchema": {
             "items": {
-              "$ref": "#/definitions/build"
+              "$ref": "#/definitions/pipeline-build"
             },
             "type": [
               "array"
@@ -13468,7 +14340,7 @@ module PlatformAPI
       ]
     },
     "pipeline-config-var": {
-      "description": "Pipeline Config Vars allow you to manage the configuration information provided to a pipeline.",
+      "description": "Pipeline config vars in Heroku CI and review apps used to manage the configuration information for a pipeline.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "stability": "production",
       "strictProperties": true,
@@ -13497,6 +14369,17 @@ module PlatformAPI
           ]
         }
       },
+      "properties": {
+        "[\"NAME\"]: [\"value\"]": {
+          "type": [
+            "object"
+          ],
+          "description": "user-defined config var name and value",
+          "example": {
+            "FOO": "bar"
+          }
+        }
+      },
       "links": [
         {
           "description": "Get config-vars for a pipeline stage.",
@@ -13753,9 +14636,73 @@ module PlatformAPI
       ],
       "properties": {
         "app": {
-          "description": "app involved in the pipeline coupling",
+          "description": "app involved in the pipeline coupling",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/app/definitions/id"
+            }
+          },
+          "type": [
+            "object"
+          ]
+        },
+        "created_at": {
+          "$ref": "#/definitions/pipeline-coupling/definitions/created_at"
+        },
+        "id": {
+          "$ref": "#/definitions/pipeline-coupling/definitions/id"
+        },
+        "pipeline": {
+          "description": "pipeline involved in the coupling",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/pipeline/definitions/id"
+            }
+          },
+          "type": [
+            "object"
+          ]
+        },
+        "stage": {
+          "$ref": "#/definitions/pipeline-coupling/definitions/stage"
+        },
+        "updated_at": {
+          "$ref": "#/definitions/pipeline-coupling/definitions/updated_at"
+        }
+      }
+    },
+    "pipeline-deployment": {
+      "description": "Information about the latest deployment of each app in a pipeline. A deployment is the process of moving the build artifacts to a target environment.",
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "stability": "production",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Pipeline Deployment",
+      "type": [
+        "object"
+      ],
+      "$ref": "#/definitions/release",
+      "properties": {
+        "addon_plan_names": {
+          "description": "add-on plans installed on the app for this deployment",
+          "type": [
+            "array"
+          ],
+          "items": {
+            "$ref": "#/definitions/plan/definitions/name"
+          }
+        },
+        "artifacts": {
+          "$ref": "#/definitions/release/definitions/artifact"
+        },
+        "app": {
+          "description": "app involved in the deployment",
           "properties": {
+            "name": {
+              "description": "unique name of the app",
+              "$ref": "#/definitions/app/definitions/name"
+            },
             "id": {
+              "description": "unique identifier of the app",
               "$ref": "#/definitions/app/definitions/id"
             }
           },
@@ -13764,44 +14711,74 @@ module PlatformAPI
           ]
         },
         "created_at": {
-          "$ref": "#/definitions/pipeline-coupling/definitions/created_at"
+          "description": "when the deployment was created",
+          "$ref": "#/definitions/release/definitions/created_at"
+        },
+        "description": {
+          "description": "description of changes in this deployment",
+          "$ref": "#/definitions/release/definitions/description"
         },
         "id": {
-          "$ref": "#/definitions/pipeline-coupling/definitions/id"
+          "description": "unique identifier of the deployment",
+          "$ref": "#/definitions/release/definitions/id"
         },
-        "pipeline": {
-          "description": "pipeline involved in the coupling",
+        "updated_at": {
+          "description": "when the deployment was updated",
+          "$ref": "#/definitions/release/definitions/updated_at"
+        },
+        "slug": {
+          "description": "slug running in this deployment",
           "properties": {
             "id": {
-              "$ref": "#/definitions/pipeline/definitions/id"
+              "description": "unique identifier of the slug",
+              "$ref": "#/definitions/slug/definitions/id"
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "status": {
+          "description": "current status of the deployment",
+          "$ref": "#/definitions/release/definitions/status"
+        },
+        "user": {
+          "description": "user that created the deployment",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/account/definitions/id"
+            },
+            "email": {
+              "$ref": "#/definitions/account/definitions/email"
             }
           },
+          "strictProperties": true,
           "type": [
             "object"
           ]
         },
-        "stage": {
-          "$ref": "#/definitions/pipeline-coupling/definitions/stage"
+        "version": {
+          "description": "unique version assigned to the deployment",
+          "$ref": "#/definitions/release/definitions/version"
         },
-        "updated_at": {
-          "$ref": "#/definitions/pipeline-coupling/definitions/updated_at"
+        "current": {
+          "description": "indicates if this deployment is the current one for the app",
+          "$ref": "#/definitions/release/definitions/current"
+        },
+        "output_stream_url": {
+          "description": "streaming URL for the release command output",
+          "$ref": "#/definitions/release/definitions/output_stream_url"
+        },
+        "eligible_for_rollback": {
+          "description": "indicates if this deployment is eligible for rollback",
+          "$ref": "#/definitions/release/definitions/eligible_for_rollback"
         }
-      }
-    },
-    "pipeline-deployment": {
-      "description": "Information about latest deployments of apps in a pipeline.",
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "stability": "production",
-      "strictProperties": true,
-      "title": "Heroku Platform API - Pipeline Deployment",
-      "type": [
-        "object"
-      ],
-      "definitions": {
       },
       "links": [
         {
-          "description": "List latest slug releases for each app in a pipeline",
+          "description": "List latest deployments for each app in a pipeline. A deployment is a release that changed your source slug, container image, or Heroku processes.",
           "href": "/pipelines/{(%23%2Fdefinitions%2Fpipeline%2Fdefinitions%2Fid)}/latest-deployments",
           "method": "GET",
           "rel": "instances",
@@ -14138,7 +15115,7 @@ module PlatformAPI
       }
     },
     "pipeline-release": {
-      "description": "Information about latest releases of apps in a pipeline.",
+      "description": "Information about the latest release of each app in a pipeline. A release makes a deployment available to end-users.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "stability": "production",
       "strictProperties": true,
@@ -14146,7 +15123,96 @@ module PlatformAPI
       "type": [
         "object"
       ],
-      "definitions": {
+      "properties": {
+        "addon_plan_names": {
+          "description": "add-on plans installed on the app for this release",
+          "type": [
+            "array"
+          ],
+          "items": {
+            "$ref": "#/definitions/plan/definitions/name"
+          }
+        },
+        "artifacts": {
+          "$ref": "#/definitions/release/definitions/artifact"
+        },
+        "app": {
+          "description": "app involved in the release",
+          "properties": {
+            "name": {
+              "description": "unique name of the app",
+              "$ref": "#/definitions/app/definitions/name"
+            },
+            "id": {
+              "description": "unique identifier of the app",
+              "$ref": "#/definitions/app/definitions/id"
+            }
+          },
+          "type": [
+            "object"
+          ]
+        },
+        "created_at": {
+          "description": "when the release was created",
+          "$ref": "#/definitions/release/definitions/created_at"
+        },
+        "description": {
+          "$ref": "#/definitions/release/definitions/description"
+        },
+        "id": {
+          "description": "unique identifier of the release",
+          "$ref": "#/definitions/release/definitions/id"
+        },
+        "updated_at": {
+          "description": "when the release was updated",
+          "$ref": "#/definitions/release/definitions/updated_at"
+        },
+        "slug": {
+          "description": "slug running in the release",
+          "properties": {
+            "id": {
+              "description": "unique identifier of the slug",
+              "$ref": "#/definitions/slug/definitions/id"
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "status": {
+          "$ref": "#/definitions/release/definitions/status"
+        },
+        "user": {
+          "description": "user that created the release",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/account/definitions/id"
+            },
+            "email": {
+              "$ref": "#/definitions/account/definitions/email"
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "object"
+          ]
+        },
+        "version": {
+          "$ref": "#/definitions/release/definitions/version"
+        },
+        "current": {
+          "description": "indicates if this release is the current one for the app",
+          "$ref": "#/definitions/release/definitions/current"
+        },
+        "output_stream_url": {
+          "description": "streaming URL of the build process output",
+          "$ref": "#/definitions/release/definitions/output_stream_url"
+        },
+        "eligible_for_rollback": {
+          "$ref": "#/definitions/release/definitions/eligible_for_rollback"
+        }
       },
       "links": [
         {
@@ -14406,6 +15472,49 @@ module PlatformAPI
           "type": [
             "string"
           ]
+        },
+        "generation": {
+          "description": "the generation of the Heroku platform for this pipeline",
+          "definitions": {
+            "id": {
+              "description": "unique identifier of the generation of the Heroku platform for this pipeline",
+              "example": "01234567-89ab-cdef-0123-456789abcdef",
+              "format": "uuid",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            },
+            "identity": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/pipeline/definitions/generation/definitions/id"
+                },
+                {
+                  "$ref": "#/definitions/pipeline/definitions/generation/definitions/name"
+                }
+              ]
+            },
+            "name": {
+              "description": "unique name of the generation of the Heroku platform for this pipeline",
+              "example": "cedar",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            }
+          },
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/pipeline/definitions/generation/definitions/id"
+            },
+            "name": {
+              "$ref": "#/definitions/pipeline/definitions/generation/definitions/name"
+            }
+          },
+          "type": [
+            "object"
+          ]
         }
       },
       "links": [
@@ -14511,6 +15620,9 @@ module PlatformAPI
         },
         "updated_at": {
           "$ref": "#/definitions/pipeline/definitions/updated_at"
+        },
+        "generation": {
+          "$ref": "#/definitions/pipeline/definitions/generation"
         }
       }
     },
@@ -15030,6 +16142,32 @@ module PlatformAPI
         "object"
       ],
       "definitions": {
+        "artifact": {
+          "description": "a build artifact for the release",
+          "properties": {
+            "type": {
+              "description": "type of artifact",
+              "example": "slug",
+              "type": [
+                "string"
+              ]
+            },
+            "id": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/slug/definitions/id"
+                },
+                {
+                  "$ref": "#/definitions/oci-image/definitions/id"
+                }
+              ]
+            }
+          },
+          "readOnly": true,
+          "type": [
+            "object"
+          ]
+        },
         "created_at": {
           "description": "when release was created",
           "example": "2012-01-01T12:00:00Z",
@@ -15112,6 +16250,14 @@ module PlatformAPI
             "string",
             "null"
           ]
+        },
+        "eligible_for_rollback": {
+          "description": "indicates if this release is eligible for rollback",
+          "example": true,
+          "readOnly": true,
+          "type": [
+            "boolean"
+          ]
         }
       },
       "links": [
@@ -15150,6 +16296,9 @@ module PlatformAPI
               "description": {
                 "$ref": "#/definitions/release/definitions/description"
               },
+              "oci_image": {
+                "$ref": "#/definitions/oci-image/definitions/identity"
+              },
               "slug": {
                 "$ref": "#/definitions/slug/definitions/identity"
               }
@@ -15200,6 +16349,15 @@ module PlatformAPI
             "$ref": "#/definitions/plan/definitions/name"
           }
         },
+        "artifacts": {
+          "description": "build artifacts for the release",
+          "type": [
+            "array"
+          ],
+          "items": {
+            "$ref": "#/definitions/release/definitions/artifact"
+          }
+        },
         "app": {
           "description": "app involved in the release",
           "properties": {
@@ -15265,6 +16423,9 @@ module PlatformAPI
         },
         "output_stream_url": {
           "$ref": "#/definitions/release/definitions/output_stream_url"
+        },
+        "eligible_for_rollback": {
+          "$ref": "#/definitions/release/definitions/eligible_for_rollback"
         }
       }
     },
@@ -16970,7 +18131,7 @@ module PlatformAPI
     "space": {
       "description": "A space is an isolated, highly available, secure app execution environment.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "stability": "prototype",
+      "stability": "production",
       "strictProperties": true,
       "title": "Heroku Platform API - Space",
       "type": [
@@ -17068,6 +18229,32 @@ module PlatformAPI
           "type": [
             "string"
           ]
+        },
+        "generation": {
+          "description": "Generation of the Heroku platform for this space",
+          "readOnly": true,
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "id": {
+              "description": "unique identifier of the generation of the Heroku platform for this space",
+              "example": "01234567-89ab-cdef-0123-456789abcdef",
+              "format": "uuid",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            },
+            "name": {
+              "description": "unique name of the generation of the Heroku platform for this space",
+              "example": "cedar",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            }
+          }
         }
       },
       "links": [
@@ -17153,6 +18340,14 @@ module PlatformAPI
               },
               "log_drain_url": {
                 "$ref": "#/definitions/space/definitions/log_drain_url"
+              },
+              "generation": {
+                "description": "unique name of the generation of the Heroku platform for this space",
+                "example": "cedar",
+                "readOnly": true,
+                "type": [
+                  "string"
+                ]
               }
             },
             "required": [
@@ -17233,6 +18428,9 @@ module PlatformAPI
         },
         "data_cidr": {
           "$ref": "#/definitions/space/definitions/data_cidr"
+        },
+        "generation": {
+          "$ref": "#/definitions/space/definitions/generation"
         }
       }
     },
@@ -17333,6 +18531,21 @@ module PlatformAPI
             ]
           },
           "title": "List"
+        },
+        {
+          "description": "List available app stacks for an app.",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/available-stacks",
+          "method": "GET",
+          "rel": "instances",
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/stack"
+            },
+            "type": [
+              "array"
+            ]
+          },
+          "title": "List by App"
         }
       ],
       "properties": {
@@ -17632,12 +18845,8 @@ module PlatformAPI
             "boolean"
           ]
         },
-        "identity": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/app/definitions/name"
-            }
-          ]
+        "identity": {
+          "$ref": "#/definitions/app/definitions/name"
         },
         "internal_routing": {
           "default": false,
@@ -18119,6 +19328,58 @@ module PlatformAPI
         }
       }
     },
+    "team-delinquency": {
+      "description": "A Heroku team becomes delinquent due to non-payment. We [suspend and delete](https://help.heroku.com/EREVRILX/what-happens-if-i-have-unpaid-heroku-invoices) delinquent teams if their invoices remain unpaid.",
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "stability": "development",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Team Delinquency",
+      "type": [
+        "object"
+      ],
+      "definitions": {
+        "scheduled_suspension_time": {
+          "description": "scheduled time of when we will suspend your team due to delinquency",
+          "example": "2024-01-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "scheduled_deletion_time": {
+          "description": "scheduled time of when we will delete your team due to delinquency",
+          "example": "2024-01-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "links": [
+        {
+          "description": "Team delinquency information.",
+          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/delinquency",
+          "method": "GET",
+          "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/team-delinquency"
+          },
+          "title": "Info"
+        }
+      ],
+      "properties": {
+        "scheduled_suspension_time": {
+          "$ref": "#/definitions/team-delinquency/definitions/scheduled_suspension_time"
+        },
+        "scheduled_deletion_time": {
+          "$ref": "#/definitions/team-delinquency/definitions/scheduled_deletion_time"
+        }
+      }
+    },
     "team-feature": {
       "description": "A team feature represents a feature enabled on a team account.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
@@ -18782,7 +20043,7 @@ module PlatformAPI
           ]
         },
         "two_factor_authentication": {
-          "description": "whether the Enterprise team member has two factor authentication enabled",
+          "description": "whether the team member has two factor authentication enabled",
           "example": true,
           "readOnly": true,
           "type": [
@@ -19049,7 +20310,7 @@ module PlatformAPI
           }
         },
         "connect": {
-          "description": "average connect rows synced",
+          "description": "max connect rows synced",
           "example": 15000,
           "readOnly": true,
           "type": [
@@ -19779,6 +21040,310 @@ module PlatformAPI
         }
       }
     },
+    "telemetry-drain": {
+      "description": "A telemetry drain forwards OpenTelemetry traces, metrics, and logs to your own consumer. For Fir-generation apps only.",
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "stability": "prototype",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Telemetry Drain",
+      "type": [
+        "object"
+      ],
+      "definitions": {
+        "id": {
+          "description": "unique identifier of telemetry drain",
+          "example": "01234567-89ab-cdef-0123-456789abcdef",
+          "format": "uuid",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "identity": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/telemetry-drain/definitions/id"
+            }
+          ]
+        },
+        "created_at": {
+          "description": "when the telemetry drain was created",
+          "example": "2024-12-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "updated_at": {
+          "description": "when telemetry drain was last updated",
+          "example": "2012-01-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "signal": {
+          "description": "OpenTelemetry signal to be sent to the telemetry drain",
+          "readOnly": true,
+          "example": "traces",
+          "type": [
+            "string"
+          ],
+          "enum": [
+            "traces",
+            "metrics",
+            "logs"
+          ]
+        },
+        "signals": {
+          "description": "OpenTelemetry signals to send to telemetry drain",
+          "example": [
+            "traces",
+            "metrics"
+          ],
+          "readOnly": false,
+          "minItems": 1,
+          "uniqueItems": true,
+          "type": [
+            "array"
+          ],
+          "items": {
+            "$ref": "#/definitions/telemetry-drain/definitions/signal"
+          }
+        },
+        "exporter_type": {
+          "description": "the transport type to be used for your OpenTelemetry consumer",
+          "readOnly": true,
+          "example": "otlphttp",
+          "type": [
+            "string"
+          ],
+          "enum": [
+            "otlphttp",
+            "otlp"
+          ]
+        },
+        "exporter_endpoint": {
+          "description": "URI of your OpenTelemetry consumer",
+          "readOnly": false,
+          "example": "https://api.otelproduct.example/consumer",
+          "maxLength": 1000,
+          "type": [
+            "string"
+          ]
+        },
+        "exporter_headers": {
+          "description": "JSON headers to send to your OpenTelemetry consumer",
+          "readOnly": false,
+          "example": {
+            "API-Key": "example_api_key_012345",
+            "Environment": "production"
+          },
+          "default": {
+          },
+          "additionalProperties": false,
+          "maxItems": 20,
+          "patternProperties": {
+            "^[A-Za-z0-9\\-_]{1,100}$": {
+              "maxLength": 1000,
+              "type": [
+                "string"
+              ]
+            }
+          },
+          "type": [
+            "object"
+          ]
+        },
+        "exporter": {
+          "description": "OpenTelemetry exporter configuration",
+          "readOnly": false,
+          "additionalProperties": false,
+          "properties": {
+            "type": {
+              "$ref": "#/definitions/telemetry-drain/definitions/exporter_type"
+            },
+            "endpoint": {
+              "$ref": "#/definitions/telemetry-drain/definitions/exporter_endpoint"
+            },
+            "headers": {
+              "$ref": "#/definitions/telemetry-drain/definitions/exporter_headers"
+            }
+          },
+          "required": [
+            "type",
+            "endpoint"
+          ],
+          "type": [
+            "object"
+          ]
+        },
+        "owner": {
+          "description": "entity that owns this telemetry drain",
+          "properties": {
+            "id": {
+              "description": "unique identifier of owner",
+              "example": "01234567-89ab-cdef-0123-456789abcdef",
+              "format": "uuid",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            },
+            "type": {
+              "description": "type of owner",
+              "enum": [
+                "app",
+                "space"
+              ],
+              "example": "app",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            }
+          },
+          "readOnly": false,
+          "required": [
+            "id",
+            "type"
+          ],
+          "type": [
+            "object"
+          ]
+        }
+      },
+      "links": [
+        {
+          "description": "Create a telemetry drain.",
+          "href": "/telemetry-drains",
+          "method": "POST",
+          "rel": "create",
+          "schema": {
+            "additionalProperties": false,
+            "properties": {
+              "owner": {
+                "$ref": "#/definitions/telemetry-drain/definitions/owner"
+              },
+              "signals": {
+                "$ref": "#/definitions/telemetry-drain/definitions/signals"
+              },
+              "exporter": {
+                "$ref": "#/definitions/telemetry-drain/definitions/exporter"
+              }
+            },
+            "required": [
+              "owner",
+              "signals",
+              "exporter"
+            ],
+            "type": [
+              "object"
+            ]
+          },
+          "targetSchema": {
+            "$ref": "#/definitions/telemetry-drain"
+          },
+          "title": "Create"
+        },
+        {
+          "description": "List telemetry drains for an app.",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/telemetry-drains",
+          "method": "GET",
+          "rel": "instances",
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/telemetry-drain"
+            },
+            "type": [
+              "array"
+            ]
+          },
+          "title": "List by App"
+        },
+        {
+          "description": "List telemetry drains for a space.",
+          "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/telemetry-drains",
+          "method": "GET",
+          "rel": "instances",
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/telemetry-drain"
+            },
+            "type": [
+              "array"
+            ]
+          },
+          "title": "List by Space"
+        },
+        {
+          "description": "Update a telemetry drain.",
+          "href": "/telemetry-drains/{(%23%2Fdefinitions%2Ftelemetry-drain%2Fdefinitions%2Fidentity)}",
+          "method": "PATCH",
+          "rel": "update",
+          "schema": {
+            "additionalProperties": false,
+            "properties": {
+              "signals": {
+                "$ref": "#/definitions/telemetry-drain/definitions/signals"
+              },
+              "exporter": {
+                "$ref": "#/definitions/telemetry-drain/definitions/exporter"
+              }
+            },
+            "type": [
+              "object"
+            ]
+          },
+          "targetSchema": {
+            "$ref": "#/definitions/telemetry-drain"
+          },
+          "title": "Update"
+        },
+        {
+          "description": "Delete a telemetry drain.",
+          "href": "/telemetry-drains/{(%23%2Fdefinitions%2Ftelemetry-drain%2Fdefinitions%2Fidentity)}",
+          "method": "DELETE",
+          "rel": "destroy",
+          "targetSchema": {
+            "$ref": "#/definitions/telemetry-drain"
+          },
+          "title": "Delete"
+        },
+        {
+          "description": "Info for a telemetry drain.",
+          "href": "/telemetry-drains/{(%23%2Fdefinitions%2Ftelemetry-drain%2Fdefinitions%2Fidentity)}",
+          "method": "GET",
+          "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/telemetry-drain"
+          },
+          "title": "Info"
+        }
+      ],
+      "properties": {
+        "created_at": {
+          "$ref": "#/definitions/telemetry-drain/definitions/created_at"
+        },
+        "id": {
+          "$ref": "#/definitions/telemetry-drain/definitions/id"
+        },
+        "owner": {
+          "$ref": "#/definitions/telemetry-drain/definitions/owner"
+        },
+        "signals": {
+          "$ref": "#/definitions/telemetry-drain/definitions/signals"
+        },
+        "exporter": {
+          "$ref": "#/definitions/telemetry-drain/definitions/exporter"
+        },
+        "updated_at": {
+          "$ref": "#/definitions/telemetry-drain/definitions/updated_at"
+        }
+      }
+    },
     "test-case": {
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "title": "Test Case",
@@ -20922,6 +22487,9 @@ module PlatformAPI
     }
   },
   "properties": {
+    "account-delinquency": {
+      "$ref": "#/definitions/account-delinquency"
+    },
     "account-feature": {
       "$ref": "#/definitions/account-feature"
     },
@@ -21030,6 +22598,9 @@ module PlatformAPI
     "formation": {
       "$ref": "#/definitions/formation"
     },
+    "generation": {
+      "$ref": "#/definitions/generation"
+    },
     "identity-provider": {
       "$ref": "#/definitions/identity-provider"
     },
@@ -21063,8 +22634,8 @@ module PlatformAPI
     "oauth-token": {
       "$ref": "#/definitions/oauth-token"
     },
-    "outbound-ruleset": {
-      "$ref": "#/definitions/outbound-ruleset"
+    "oci-image": {
+      "$ref": "#/definitions/oci-image"
     },
     "password-reset": {
       "$ref": "#/definitions/password-reset"
@@ -21171,6 +22742,9 @@ module PlatformAPI
     "team-daily-usage": {
       "$ref": "#/definitions/team-daily-usage"
     },
+    "team-delinquency": {
+      "$ref": "#/definitions/team-delinquency"
+    },
     "team-feature": {
       "$ref": "#/definitions/team-feature"
     },
@@ -21195,6 +22769,9 @@ module PlatformAPI
     "team": {
       "$ref": "#/definitions/team"
     },
+    "telemetry-drain": {
+      "$ref": "#/definitions/telemetry-drain"
+    },
     "test-case": {
       "$ref": "#/definitions/test-case"
     },