platform-api 3.5.0 → 3.7.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.5.0"}
+    default_headers = {"Accept"=>"application/vnd.heroku+json; version=3", "User-Agent"=>"platform-api/3.7.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]
@@ -196,13 +203,6 @@ module PlatformAPI
       @app_feature_resource ||= AppFeature.new(@client)
     end
 
-    # App formation set describes the combination of process types with their quantities and sizes as well as application process tier
-    #
-    # @return [AppFormationSet]
-    def app_formation_set
-      @app_formation_set_resource ||= AppFormationSet.new(@client)
-    end
-
     # An app setup represents an app on Heroku that is setup using an environment, addons, and scripts described in an app.json manifest file.
     #
     # @return [AppSetup]
@@ -357,7 +357,7 @@ module PlatformAPI
       @formation_resource ||= Formation.new(@client)
     end
 
-    # Identity Providers represent the SAML configuration of an Enterprise Account or Team.
+    # Identity Providers represent the SAML configuration of teams or an Enterprise account
     #
     # @return [IdentityProvider]
     def identity_provider
@@ -686,6 +686,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]
@@ -780,6 +787,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)
@@ -1242,13 +1261,6 @@ module PlatformAPI
     end
   end
 
-  # App formation set describes the combination of process types with their quantities and sizes as well as application process tier
-  class AppFormationSet
-    def initialize(client)
-      @client = client
-    end
-  end
-
   # An app setup represents an app on Heroku that is setup using an environment, addons, and scripts described in an app.json manifest file.
   class AppSetup
     def initialize(client)
@@ -1479,18 +1491,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
 
@@ -1502,9 +1514,9 @@ 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
 
@@ -1543,6 +1555,14 @@ module PlatformAPI
     def delete_cache(app_id_or_app_name)
       @client.build.delete_cache(app_id_or_app_name)
     end
+
+    # Cancel running build.
+    #
+    # @param app_id_or_app_name: unique identifier of app or unique name of app
+    # @param build_id: unique identifier of build
+    def cancel(app_id_or_app_name, build_id)
+      @client.build.cancel(app_id_or_app_name, build_id)
+    end
   end
 
   # A buildpack installation represents a buildpack that will be run against an app.
@@ -1804,34 +1824,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
 
@@ -1864,17 +1884,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
 
@@ -1931,7 +1951,7 @@ module PlatformAPI
     end
   end
 
-  # Identity Providers represent the SAML configuration of an Enterprise Account or Team.
+  # Identity Providers represent the SAML configuration of teams or an Enterprise account
   class IdentityProvider
     def initialize(client)
       @client = client
@@ -2193,7 +2213,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)
@@ -3069,34 +3089,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
 
@@ -3127,33 +3147,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.
@@ -3180,6 +3200,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)
@@ -3416,17 +3450,17 @@ 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, body = {})
-      @client.team.create_in_enterprise_account(enterprise_account_id, body)
+    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
 
@@ -3578,6 +3612,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",
@@ -4173,7 +4259,7 @@ module PlatformAPI
           "description": "Mark an add-on as provisioned for use.",
           "href": "/addons/{(%23%2Fdefinitions%2Fadd-on%2Fdefinitions%2Fidentity)}/actions/provision",
           "method": "POST",
-          "rel": "create",
+          "rel": "update",
           "targetSchema": {
             "$ref": "#/definitions/add-on"
           },
@@ -4183,7 +4269,7 @@ module PlatformAPI
           "description": "Mark an add-on as deprovisioned.",
           "href": "/addons/{(%23%2Fdefinitions%2Fadd-on%2Fdefinitions%2Fidentity)}/actions/deprovision",
           "method": "POST",
-          "rel": "create",
+          "rel": "update",
           "targetSchema": {
             "$ref": "#/definitions/add-on"
           },
@@ -5196,8 +5282,24 @@ module PlatformAPI
       "description": "Add-ons represent add-ons that have been provisioned and attached to one or more apps.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "stability": "production",
-      "strictProperties": true,
       "title": "Heroku Platform API - Add-on",
+      "additionalProperties": false,
+      "required": [
+        "actions",
+        "addon_service",
+        "billing_entity",
+        "app",
+        "billed_price",
+        "config_vars",
+        "created_at",
+        "id",
+        "name",
+        "plan",
+        "provider_id",
+        "state",
+        "updated_at",
+        "web_url"
+      ],
       "type": [
         "object"
       ],
@@ -5362,6 +5464,57 @@ module PlatformAPI
             "null",
             "string"
           ]
+        },
+        "addon_service": {
+          "description": "identity of add-on service",
+          "anyOf": [
+            {
+              "properties": {
+                "id": {
+                  "$ref": "#/definitions/add-on-service/definitions/id"
+                },
+                "name": {
+                  "$ref": "#/definitions/add-on-service/definitions/name"
+                }
+              },
+              "strictProperties": true,
+              "type": [
+                "object"
+              ]
+            },
+            {
+              "$ref": "#/definitions/add-on-service"
+            }
+          ]
+        },
+        "plan": {
+          "description": "identity of add-on plan",
+          "anyOf": [
+            {
+              "properties": {
+                "id": {
+                  "$ref": "#/definitions/plan/definitions/id"
+                },
+                "name": {
+                  "$ref": "#/definitions/plan/definitions/name"
+                }
+              },
+              "strictProperties": true,
+              "type": [
+                "object"
+              ]
+            },
+            {
+              "$ref": "#/definitions/plan"
+            }
+          ]
+        },
+        "provision_message": {
+          "description": "A provision message",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
         }
       },
       "links": [
@@ -5492,6 +5645,9 @@ module PlatformAPI
               "object"
             ]
           },
+          "targetSchema": {
+            "$ref": "#/definitions/add-on"
+          },
           "title": "Update"
         },
         {
@@ -5564,19 +5720,7 @@ module PlatformAPI
           "$ref": "#/definitions/add-on/definitions/actions"
         },
         "addon_service": {
-          "description": "identity of add-on service",
-          "properties": {
-            "id": {
-              "$ref": "#/definitions/add-on-service/definitions/id"
-            },
-            "name": {
-              "$ref": "#/definitions/add-on-service/definitions/name"
-            }
-          },
-          "strictProperties": true,
-          "type": [
-            "object"
-          ]
+          "$ref": "#/definitions/add-on/definitions/addon_service"
         },
         "billing_entity": {
           "description": "billing entity associated with this add-on",
@@ -5663,23 +5807,14 @@ module PlatformAPI
           "$ref": "#/definitions/add-on/definitions/name"
         },
         "plan": {
-          "description": "identity of add-on plan",
-          "properties": {
-            "id": {
-              "$ref": "#/definitions/plan/definitions/id"
-            },
-            "name": {
-              "$ref": "#/definitions/plan/definitions/name"
-            }
-          },
-          "strictProperties": true,
-          "type": [
-            "object"
-          ]
+          "$ref": "#/definitions/add-on/definitions/plan"
         },
         "provider_id": {
           "$ref": "#/definitions/add-on/definitions/provider_id"
         },
+        "provision_message": {
+          "$ref": "#/definitions/add-on/definitions/provision_message"
+        },
         "state": {
           "$ref": "#/definitions/add-on/definitions/state"
         },
@@ -6029,63 +6164,6 @@ module PlatformAPI
         }
       }
     },
-    "app-formation-set": {
-      "description": "App formation set describes the combination of process types with their quantities and sizes as well as application process tier",
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "stability": "development",
-      "strictProperties": true,
-      "title": "Heroku Platform API - Application Formation Set",
-      "type": [
-        "object"
-      ],
-      "properties": {
-        "description": {
-          "description": "a string representation of the formation set",
-          "example": "web@2:Standard-2X worker@3:Performance-M",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "process_tier": {
-          "description": "application process tier",
-          "enum": [
-            "production",
-            "free",
-            "hobby",
-            "private"
-          ],
-          "example": "production",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "app": {
-          "description": "app being described by the formation-set",
-          "properties": {
-            "name": {
-              "$ref": "#/definitions/app/definitions/name"
-            },
-            "id": {
-              "$ref": "#/definitions/app/definitions/id"
-            }
-          },
-          "type": [
-            "object"
-          ]
-        },
-        "updated_at": {
-          "description": "last time fomation-set was updated",
-          "example": "2012-01-01T12:00:00Z",
-          "format": "date-time",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        }
-      }
-    },
     "app-setup": {
       "description": "An app setup represents an app on Heroku that is setup using an environment, addons, and scripts described in an app.json manifest file.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
@@ -7413,9 +7491,10 @@ module PlatformAPI
           "description": "web URL of app",
           "example": "https://example.herokuapp.com/",
           "format": "uri",
-          "pattern": "^https?://[a-z][a-z0-9-]{3,30}\\.herokuapp\\.com/$",
+          "pattern": "^https?://[a-z][a-z0-9-]{3,43}\\.herokuapp\\.com/$",
           "readOnly": true,
           "type": [
+            "null",
             "string"
           ]
         },
@@ -8068,7 +8147,15 @@ module PlatformAPI
       "description": "A build represents the process of transforming a code tarball into a slug",
       "title": "Heroku Build API - Build",
       "stability": "production",
-      "strictProperties": true,
+      "strictProperties": false,
+      "required": [
+        "created_at",
+        "id",
+        "source_blob",
+        "status",
+        "updated_at",
+        "user"
+      ],
       "type": [
         "object"
       ],
@@ -8191,6 +8278,15 @@ module PlatformAPI
                 "string",
                 "null"
               ]
+            },
+            "version_description": {
+              "description": "Version description of the gzipped tarball.",
+              "example": "* Fake User: Change session key",
+              "readOnly": true,
+              "type": [
+                "string",
+                "null"
+              ]
             }
           },
           "strictProperties": true,
@@ -8200,7 +8296,7 @@ module PlatformAPI
         },
         "stack": {
           "description": "stack of build",
-          "example": "heroku-16",
+          "example": "heroku-22",
           "readOnly": true,
           "type": [
             "string"
@@ -8291,6 +8387,16 @@ module PlatformAPI
           "method": "DELETE",
           "rel": "empty",
           "title": "Delete cache"
+        },
+        {
+          "description": "Cancel running build.",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/builds/{(%23%2Fdefinitions%2Fbuild%2Fdefinitions%2Fidentity)}",
+          "method": "DELETE",
+          "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/build"
+          },
+          "title": "Cancel"
         }
       ],
       "properties": {
@@ -9235,7 +9341,7 @@ module PlatformAPI
         },
         "name": {
           "description": "the name of this dyno-size",
-          "example": "free",
+          "example": "eco",
           "readOnly": true,
           "type": [
             "string"
@@ -9268,13 +9374,22 @@ module PlatformAPI
           }
         },
         "dyno_units": {
-          "description": "unit of consumption for Heroku Enterprise customers",
+          "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,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
         "private_space_only": {
           "description": "whether this dyno can only be provisioned in a private space",
           "example": false,
@@ -9324,6 +9439,9 @@ module PlatformAPI
         "dyno_units": {
           "$ref": "#/definitions/dyno-size/definitions/dyno_units"
         },
+        "precise_dyno_units": {
+          "$ref": "#/definitions/dyno-size/definitions/precise_dyno_units"
+        },
         "id": {
           "$ref": "#/definitions/dyno-size/definitions/id"
         },
@@ -9439,7 +9557,7 @@ module PlatformAPI
           ]
         },
         "size": {
-          "description": "dyno size (default: \"standard-1X\")",
+          "description": "dyno size",
           "example": "standard-1X",
           "readOnly": false,
           "type": [
@@ -10341,6 +10459,9 @@ module PlatformAPI
           "anyOf": [
             {
               "$ref": "#/definitions/enterprise-account/definitions/id"
+            },
+            {
+              "$ref": "#/definitions/enterprise-account/definitions/name"
             }
           ]
         },
@@ -10423,6 +10544,9 @@ module PlatformAPI
           "href": "/enterprise-accounts/{(%23%2Fdefinitions%2Fenterprise-account%2Fdefinitions%2Fidentity)}",
           "method": "GET",
           "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/enterprise-account"
+          },
           "title": "Info"
         },
         {
@@ -10588,7 +10712,7 @@ module PlatformAPI
           ]
         },
         "size": {
-          "description": "dyno size (default: \"standard-1X\")",
+          "description": "dyno size",
           "example": "standard-1X",
           "readOnly": false,
           "type": [
@@ -10762,7 +10886,7 @@ module PlatformAPI
       }
     },
     "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,
@@ -11265,6 +11389,9 @@ module PlatformAPI
           "href": "/account/invoice-address",
           "method": "GET",
           "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/invoice-address"
+          },
           "title": "info"
         },
         {
@@ -11303,6 +11430,9 @@ module PlatformAPI
             "type": [
               "object"
             ]
+          },
+          "targetSchema": {
+            "$ref": "#/definitions/invoice-address"
           }
         }
       ],
@@ -11643,7 +11773,11 @@ module PlatformAPI
           "description": "add-on that created the drain",
           "example": {
             "id": "01234567-89ab-cdef-0123-456789abcdef",
-            "name": "singing-swiftly-1242"
+            "name": "singing-swiftly-1242",
+            "app": {
+              "id": "01234567-89ab-cdef-0123-456789abcdef",
+              "name": "example"
+            }
           },
           "properties": {
             "id": {
@@ -11651,6 +11785,21 @@ module PlatformAPI
             },
             "name": {
               "$ref": "#/definitions/add-on/definitions/name"
+            },
+            "app": {
+              "description": "billing application associated with this add-on",
+              "type": [
+                "object"
+              ],
+              "properties": {
+                "id": {
+                  "$ref": "#/definitions/app/definitions/id"
+                },
+                "name": {
+                  "$ref": "#/definitions/app/definitions/name"
+                }
+              },
+              "strictProperties": true
             }
           },
           "readOnly": true,
@@ -11659,6 +11808,27 @@ module PlatformAPI
             "null"
           ]
         },
+        "app": {
+          "description": "application that is attached to this drain",
+          "example": {
+            "id": "01234567-89ab-cdef-0123-456789abcdef",
+            "name": "example"
+          },
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/app/definitions/id"
+            },
+            "name": {
+              "$ref": "#/definitions/app/definitions/name"
+            }
+          },
+          "strictProperties": true,
+          "readOnly": true,
+          "type": [
+            "object",
+            "null"
+          ]
+        },
         "created_at": {
           "description": "when log drain was created",
           "example": "2012-01-01T12:00:00Z",
@@ -11825,6 +11995,9 @@ module PlatformAPI
         "addon": {
           "$ref": "#/definitions/log-drain/definitions/addon"
         },
+        "app": {
+          "$ref": "#/definitions/log-drain/definitions/app"
+        },
         "created_at": {
           "$ref": "#/definitions/log-drain/definitions/created_at"
         },
@@ -12344,7 +12517,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",
@@ -12526,7 +12699,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"
@@ -12724,9 +12897,11 @@ module PlatformAPI
     "outbound-ruleset": {
       "description": "An outbound-ruleset is a collection of rules that specify what hosts Dynos are allowed to communicate with. ",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "stability": "prototype",
+      "stability": "deprecation",
       "strictProperties": true,
       "title": "Heroku Platform API - Outbound Ruleset",
+      "deprecated_at": "2024-04-30",
+      "deactivate_on": "2024-06-03",
       "type": [
         "object"
       ],
@@ -12957,10 +13132,16 @@ module PlatformAPI
                 "$ref": "#/definitions/account/definitions/email"
               }
             },
+            "required": [
+              "email"
+            ],
             "type": [
               "object"
             ]
           },
+          "targetSchema": {
+            "$ref": "#/definitions/password-reset"
+          },
           "title": "Reset Password"
         },
         {
@@ -12977,10 +13158,17 @@ module PlatformAPI
                 "$ref": "#/definitions/password-reset/definitions/password_confirmation"
               }
             },
+            "required": [
+              "password",
+              "password_confirmation"
+            ],
             "type": [
               "object"
             ]
           },
+          "targetSchema": {
+            "$ref": "#/definitions/password-reset"
+          },
           "title": "Complete Reset Password"
         }
       ],
@@ -13210,14 +13398,20 @@ module PlatformAPI
           "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/peerings/{(%23%2Fdefinitions%2Fpeering%2Fdefinitions%2Fpcx_id)}/actions/accept",
           "method": "POST",
           "rel": "empty",
-          "title": "Accept"
+          "title": "Accept",
+          "targetSchema": {
+            "$ref": "#/definitions/peering"
+          }
         },
         {
           "description": "Destroy an active peering connection with a private space.",
           "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/peerings/{(%23%2Fdefinitions%2Fpeering%2Fdefinitions%2Fpcx_id)}",
           "rel": "empty",
           "method": "DELETE",
-          "title": "Destroy"
+          "title": "Destroy",
+          "targetSchema": {
+            "$ref": "#/definitions/peering"
+          }
         },
         {
           "description": "Fetch information for existing peering connection",
@@ -14843,12 +15037,14 @@ module PlatformAPI
                 "ap-southeast-1",
                 "ap-southeast-2",
                 "eu-central-1",
+                "eu-west-2",
                 "ap-northeast-2",
                 "ap-northeast-1",
                 "us-east-1",
                 "sa-east-1",
                 "us-west-1",
-                "us-west-2"
+                "us-west-2",
+                "ca-central-1"
               ]
             }
           },
@@ -16871,7 +17067,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": [
@@ -17534,11 +17730,7 @@ module PlatformAPI
           ]
         },
         "identity": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/app/definitions/name"
-            }
-          ]
+          "$ref": "#/definitions/app/definitions/name"
         },
         "internal_routing": {
           "default": false,
@@ -17604,6 +17796,9 @@ module PlatformAPI
               "object"
             ]
           },
+          "targetSchema": {
+            "$ref": "#/definitions/team-app"
+          },
           "title": "Create"
         },
         {
@@ -17611,6 +17806,9 @@ module PlatformAPI
           "href": "/teams/apps/{(%23%2Fdefinitions%2Fteam-app%2Fdefinitions%2Fidentity)}",
           "method": "GET",
           "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/team-app"
+          },
           "title": "Info"
         },
         {
@@ -18014,6 +18212,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",
@@ -18269,6 +18519,9 @@ module PlatformAPI
             "type": [
               "object"
             ]
+          },
+          "targetSchema": {
+            "$ref": "#/definitions/team-invitation"
           }
         },
         {
@@ -18276,7 +18529,10 @@ module PlatformAPI
           "title": "Revoke",
           "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/invitations/{(%23%2Fdefinitions%2Fteam-invitation%2Fdefinitions%2Fidentity)}",
           "method": "DELETE",
-          "rel": "self"
+          "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/team-invitation"
+          }
         },
         {
           "description": "Get an invitation by its token",
@@ -18671,7 +18927,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": [
@@ -19484,6 +19740,9 @@ module PlatformAPI
           "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}",
           "method": "GET",
           "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/team"
+          },
           "title": "Info"
         },
         {
@@ -20751,6 +21010,9 @@ module PlatformAPI
           "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/vpn-connections/{(%23%2Fdefinitions%2Fvpn-connection%2Fdefinitions%2Fidentity)}",
           "rel": "empty",
           "method": "DELETE",
+          "targetSchema": {
+            "$ref": "#/definitions/vpn-connection"
+          },
           "title": "Destroy"
         },
         {
@@ -20805,6 +21067,9 @@ module PlatformAPI
     }
   },
   "properties": {
+    "account-delinquency": {
+      "$ref": "#/definitions/account-delinquency"
+    },
     "account-feature": {
       "$ref": "#/definitions/account-feature"
     },
@@ -20847,9 +21112,6 @@ module PlatformAPI
     "app-feature": {
       "$ref": "#/definitions/app-feature"
     },
-    "app-formation-set": {
-      "$ref": "#/definitions/app-formation-set"
-    },
     "app-setup": {
       "$ref": "#/definitions/app-setup"
     },
@@ -21057,6 +21319,9 @@ module PlatformAPI
     "team-daily-usage": {
       "$ref": "#/definitions/team-daily-usage"
     },
+    "team-delinquency": {
+      "$ref": "#/definitions/team-delinquency"
+    },
     "team-feature": {
       "$ref": "#/definitions/team-feature"
     },