platform-api 3.0.0 → 3.5.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.0.0"}
+    default_headers = {"Accept"=>"application/vnd.heroku+json; version=3", "User-Agent"=>"platform-api/3.5.0"}
     {
       default_headers: default_headers,
       url:             "https://api.heroku.com"
@@ -112,7 +112,7 @@ module PlatformAPI
       @account_resource ||= Account.new(@client)
     end
 
-    # Add-on Actions are lifecycle operations for add-on provisioning and deprovisioning. They allow whitelisted add-on providers to (de)provision add-ons in the background and then report back when (de)provisioning is complete.
+    # Add-on Actions are lifecycle operations for add-on provisioning and deprovisioning. They allow add-on providers to (de)provision add-ons in the background and then report back when (de)provisioning is complete.
     #
     # @return [AddonAction]
     def addon_action
@@ -182,6 +182,13 @@ module PlatformAPI
       @addon_resource ||= Addon.new(@client)
     end
 
+    # Entities that have been allowed to be used by a Team
+    #
+    # @return [AllowedAddonService]
+    def allowed_addon_service
+      @allowed_addon_service_resource ||= AllowedAddonService.new(@client)
+    end
+
     # An app feature represents a Heroku labs capability that can be enabled or disabled for an app on Heroku.
     #
     # @return [AppFeature]
@@ -308,6 +315,13 @@ module PlatformAPI
       @dyno_resource ||= Dyno.new(@client)
     end
 
+    # Usage for an enterprise account at a daily resolution.
+    #
+    # @return [EnterpriseAccountDailyUsage]
+    def enterprise_account_daily_usage
+      @enterprise_account_daily_usage_resource ||= EnterpriseAccountDailyUsage.new(@client)
+    end
+
     # Enterprise account members are users with access to an enterprise account.
     #
     # @return [EnterpriseAccountMember]
@@ -315,18 +329,11 @@ module PlatformAPI
       @enterprise_account_member_resource ||= EnterpriseAccountMember.new(@client)
     end
 
-    # Usage for an enterprise account at a daily resolution.
-    #
-    # @return [EnterpriseAccountUsageDaily]
-    def enterprise_account_usage_daily
-      @enterprise_account_usage_daily_resource ||= EnterpriseAccountUsageDaily.new(@client)
-    end
-
     # Usage for an enterprise account at a monthly resolution.
     #
-    # @return [EnterpriseAccountUsageMonthly]
-    def enterprise_account_usage_monthly
-      @enterprise_account_usage_monthly_resource ||= EnterpriseAccountUsageMonthly.new(@client)
+    # @return [EnterpriseAccountMonthlyUsage]
+    def enterprise_account_monthly_usage
+      @enterprise_account_monthly_usage_resource ||= EnterpriseAccountMonthlyUsage.new(@client)
     end
 
     # Enterprise accounts allow companies to manage their development teams and billing.
@@ -350,7 +357,7 @@ module PlatformAPI
       @formation_resource ||= Formation.new(@client)
     end
 
-    # Identity Providers represent the SAML configuration of an Team.
+    # Identity Providers represent the SAML configuration of an Enterprise Account or Team.
     #
     # @return [IdentityProvider]
     def identity_provider
@@ -630,20 +637,13 @@ module PlatformAPI
       @space_transfer_resource ||= SpaceTransfer.new(@client)
     end
 
-    # A space is an isolated, highly available, secure app execution environments, running in the modern VPC substrate.
+    # A space is an isolated, highly available, secure app execution environment.
     #
     # @return [Space]
     def space
       @space_resource ||= Space.new(@client)
     end
 
-    # [SSL Endpoint](https://devcenter.heroku.com/articles/ssl-endpoint) is a public address serving custom SSL cert for HTTPS traffic to a Heroku app. Note that an app must have the `ssl:endpoint` add-on installed before it can provision an SSL Endpoint using these APIs.
-    #
-    # @return [SSLEndpoint]
-    def ssl_endpoint
-      @ssl_endpoint_resource ||= SSLEndpoint.new(@client)
-    end
-
     # Stacks are the different application execution environments available in the Heroku platform.
     #
     # @return [Stack]
@@ -679,6 +679,13 @@ module PlatformAPI
       @team_app_resource ||= TeamApp.new(@client)
     end
 
+    # Usage for an enterprise team at a daily resolution.
+    #
+    # @return [TeamDailyUsage]
+    def team_daily_usage
+      @team_daily_usage_resource ||= TeamDailyUsage.new(@client)
+    end
+
     # A team feature represents a feature enabled on a team account.
     #
     # @return [TeamFeature]
@@ -707,6 +714,13 @@ module PlatformAPI
       @team_member_resource ||= TeamMember.new(@client)
     end
 
+    # Usage for an enterprise team at a monthly resolution.
+    #
+    # @return [TeamMonthlyUsage]
+    def team_monthly_usage
+      @team_monthly_usage_resource ||= TeamMonthlyUsage.new(@client)
+    end
+
     # Tracks a Team's Preferences
     #
     # @return [TeamPreferences]
@@ -714,27 +728,13 @@ module PlatformAPI
       @team_preferences_resource ||= TeamPreferences.new(@client)
     end
 
-    # A space is an isolated, highly available, secure app execution environments, running in the modern VPC substrate.
+    # A space is an isolated, highly available, secure app execution environment.
     #
     # @return [TeamSpace]
     def team_space
       @team_space_resource ||= TeamSpace.new(@client)
     end
 
-    # Usage for an enterprise team at a daily resolution.
-    #
-    # @return [TeamUsageDaily]
-    def team_usage_daily
-      @team_usage_daily_resource ||= TeamUsageDaily.new(@client)
-    end
-
-    # Usage for an enterprise team at a monthly resolution.
-    #
-    # @return [TeamUsageMonthly]
-    def team_usage_monthly
-      @team_usage_monthly_resource ||= TeamUsageMonthly.new(@client)
-    end
-
     # Teams allow you to manage access to a shared group of applications and other resources.
     #
     # @return [Team]
@@ -776,13 +776,6 @@ module PlatformAPI
     def vpn_connection
       @vpn_connection_resource ||= VpnConnection.new(@client)
     end
-
-    # Entities that have been whitelisted to be used by an Team
-    #
-    # @return [WhitelistedAddonService]
-    def whitelisted_addon_service
-      @whitelisted_addon_service_resource ||= WhitelistedAddonService.new(@client)
-    end
   end
 
   private
@@ -832,7 +825,7 @@ module PlatformAPI
       @client.account.update(body)
     end
 
-    # Delete account. Note that this action cannot be undone.
+    # Delete account. Note that this action cannot be undone. Note: This endpoint requires the HTTP_HEROKU_PASSWORD or HTTP_HEROKU_PASSWORD_BASE64 header be set correctly for the user account.
     def delete()
       @client.account.delete()
     end
@@ -852,7 +845,7 @@ module PlatformAPI
       @client.account.update_by_user(account_email_or_account_id_or_account_self, body)
     end
 
-    # Delete account. Note that this action cannot be undone.
+    # Delete account. Note that this action cannot be undone. Note: This endpoint requires the HTTP_HEROKU_PASSWORD or HTTP_HEROKU_PASSWORD_BASE64 header be set correctly for the user account.
     #
     # @param account_email_or_account_id_or_account_self: unique email address of account or unique identifier of an account or Implicit reference to currently authorized user
     def delete_by_user(account_email_or_account_id_or_account_self)
@@ -860,7 +853,7 @@ module PlatformAPI
     end
   end
 
-  # Add-on Actions are lifecycle operations for add-on provisioning and deprovisioning. They allow whitelisted add-on providers to (de)provision add-ons in the background and then report back when (de)provisioning is complete.
+  # Add-on Actions are lifecycle operations for add-on provisioning and deprovisioning. They allow add-on providers to (de)provision add-ons in the background and then report back when (de)provisioning is complete.
   class AddonAction
     def initialize(client)
       @client = client
@@ -1188,6 +1181,36 @@ module PlatformAPI
     end
   end
 
+  # Entities that have been allowed to be used by a Team
+  class AllowedAddonService
+    def initialize(client)
+      @client = client
+    end
+
+    # List all allowed add-on services 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.allowed_addon_service.list_by_team(team_name_or_team_id)
+    end
+
+    # Allow an Add-on Service
+    #
+    # @param team_name_or_team_id: unique name of team or unique identifier of team
+    # @param body: the object to pass as the request payload
+    def create_by_team(team_name_or_team_id, body = {})
+      @client.allowed_addon_service.create_by_team(team_name_or_team_id, body)
+    end
+
+    # Remove an allowed add-on service
+    #
+    # @param team_name_or_team_id: unique name of team or unique identifier of team
+    # @param allowed_addon_service_id_or_addon_service_name: unique identifier for this allowed add-on service record or unique name of this add-on-service
+    def delete_by_team(team_name_or_team_id, allowed_addon_service_id_or_addon_service_name)
+      @client.allowed_addon_service.delete_by_team(team_name_or_team_id, allowed_addon_service_id_or_addon_service_name)
+    end
+  end
+
   # An app feature represents a Heroku labs capability that can be enabled or disabled for an app on Heroku.
   class AppFeature
     def initialize(client)
@@ -1477,7 +1500,7 @@ module PlatformAPI
       @client = client
     end
 
-    # List existing events.
+    # 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)
@@ -1652,6 +1675,15 @@ module PlatformAPI
       @client.domain.create(app_id_or_app_name, body)
     end
 
+    # Associate an SNI endpoint
+    #
+    # @param app_id_or_app_name: unique identifier of app or unique name of app
+    # @param domain_id_or_domain_hostname: unique identifier of this domain or full hostname
+    # @param body: the object to pass as the request payload
+    def update(app_id_or_app_name, domain_id_or_domain_hostname, body = {})
+      @client.domain.update(app_id_or_app_name, domain_id_or_domain_hostname, body)
+    end
+
     # Delete an existing domain
     #
     # @param app_id_or_app_name: unique identifier of app or unique name of app
@@ -1748,6 +1780,22 @@ module PlatformAPI
     end
   end
 
+  # Usage for an enterprise account at a daily resolution.
+  class EnterpriseAccountDailyUsage
+    def initialize(client)
+      @client = client
+    end
+
+    # Retrieves usage for an enterprise account for a range of days. Start and end dates can be specified as query parameters using the date format YYYY-MM-DD. The enterprise account identifier can be found from the [enterprise account list](https://devcenter.heroku.com/articles/platform-api-reference#enterprise-account-list).
+
+    #
+    # @param enterprise_account_id: unique identifier of the enterprise account
+    # @param body: the object to pass as the request payload
+    def info(enterprise_account_id, body = {})
+      @client.enterprise_account_daily_usage.info(enterprise_account_id, body)
+    end
+  end
+
   # Enterprise account members are users with access to an enterprise account.
   class EnterpriseAccountMember
     def initialize(client)
@@ -1787,31 +1835,19 @@ module PlatformAPI
     end
   end
 
-  # Usage for an enterprise account at a daily resolution.
-  class EnterpriseAccountUsageDaily
-    def initialize(client)
-      @client = client
-    end
-
-    # Retrieves usage for an enterprise account for a range of days. Start and end dates can be specified as query parameters using the date format, YYYY-MM-DD format. For example, '/enterprise-accounts/example-account/usage/daily?start=2019-01-01&end=2019-01-31' specifies all days in January for 2019.
-    #
-    # @param enterprise_account_id: unique identifier of the enterprise account
-    def info(enterprise_account_id)
-      @client.enterprise_account_usage_daily.info(enterprise_account_id)
-    end
-  end
-
   # Usage for an enterprise account at a monthly resolution.
-  class EnterpriseAccountUsageMonthly
+  class EnterpriseAccountMonthlyUsage
     def initialize(client)
       @client = client
     end
 
-    # Retrieves usage for an enterprise account for a range of months. Start and end dates can be specified as query parameters using the date format, YYYY-MM format. For example, '/enterprise-accounts/example-account/usage/monthly?start=2019-01&end=2019-02' specifies usage in January and February for 2019. If no end date is specified, one month of usage is returned.
+    # Retrieves usage for an enterprise account for a range of months. Start and end dates can be specified as query parameters using the date format YYYY-MM. If no end date is specified, one month of usage is returned. The enterprise account identifier can be found from the [enterprise account list](https://devcenter.heroku.com/articles/platform-api-reference#enterprise-account-list).
+
     #
     # @param enterprise_account_id: unique identifier of the enterprise account
-    def info(enterprise_account_id)
-      @client.enterprise_account_usage_monthly.info(enterprise_account_id)
+    # @param body: the object to pass as the request payload
+    def info(enterprise_account_id, body = {})
+      @client.enterprise_account_monthly_usage.info(enterprise_account_id, body)
     end
   end
 
@@ -1895,7 +1931,7 @@ module PlatformAPI
     end
   end
 
-  # Identity Providers represent the SAML configuration of an Team.
+  # Identity Providers represent the SAML configuration of an Enterprise Account or Team.
   class IdentityProvider
     def initialize(client)
       @client = client
@@ -2346,9 +2382,9 @@ module PlatformAPI
 
     # List latest builds for each app in a pipeline
     #
-    # @param pipeline_id_or_pipeline_name: unique identifier of pipeline or name of pipeline
-    def list(pipeline_id_or_pipeline_name)
-      @client.pipeline_build.list(pipeline_id_or_pipeline_name)
+    # @param pipeline_id: unique identifier of pipeline
+    def list(pipeline_id)
+      @client.pipeline_build.list(pipeline_id)
     end
   end
 
@@ -2451,9 +2487,9 @@ module PlatformAPI
 
     # List latest slug releases for each app in a pipeline
     #
-    # @param pipeline_id_or_pipeline_name: unique identifier of pipeline or name of pipeline
-    def list(pipeline_id_or_pipeline_name)
-      @client.pipeline_deployment.list(pipeline_id_or_pipeline_name)
+    # @param pipeline_id: unique identifier of pipeline
+    def list(pipeline_id)
+      @client.pipeline_deployment.list(pipeline_id)
     end
   end
 
@@ -2500,9 +2536,9 @@ module PlatformAPI
 
     # List latest releases for each app in a pipeline
     #
-    # @param pipeline_id_or_pipeline_name: unique identifier of pipeline or name of pipeline
-    def list(pipeline_id_or_pipeline_name)
-      @client.pipeline_release.list(pipeline_id_or_pipeline_name)
+    # @param pipeline_id: unique identifier of pipeline
+    def list(pipeline_id)
+      @client.pipeline_release.list(pipeline_id)
     end
   end
 
@@ -2514,9 +2550,9 @@ module PlatformAPI
 
     # The stack for a given pipeline, used for CI and Review Apps that have no stack defined in app.json.
     #
-    # @param pipeline_id_or_pipeline_name: unique identifier of pipeline or name of pipeline
-    def default_stack(pipeline_id_or_pipeline_name)
-      @client.pipeline_stack.default_stack(pipeline_id_or_pipeline_name)
+    # @param pipeline_id: unique identifier of pipeline
+    def default_stack(pipeline_id)
+      @client.pipeline_stack.default_stack(pipeline_id)
     end
   end
 
@@ -2943,7 +2979,7 @@ module PlatformAPI
     end
   end
 
-  # A space is an isolated, highly available, secure app execution environments, running in the modern VPC substrate.
+  # A space is an isolated, highly available, secure app execution environment.
   class Space
     def initialize(client)
       @client = client
@@ -2984,53 +3020,6 @@ module PlatformAPI
     end
   end
 
-  # [SSL Endpoint](https://devcenter.heroku.com/articles/ssl-endpoint) is a public address serving custom SSL cert for HTTPS traffic to a Heroku app. Note that an app must have the `ssl:endpoint` add-on installed before it can provision an SSL Endpoint using these APIs.
-  class SSLEndpoint
-    def initialize(client)
-      @client = client
-    end
-
-    # Create a new SSL endpoint.
-    #
-    # @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(app_id_or_app_name, body = {})
-      @client.ssl_endpoint.create(app_id_or_app_name, body)
-    end
-
-    # Delete existing SSL endpoint.
-    #
-    # @param app_id_or_app_name: unique identifier of app or unique name of app
-    # @param ssl_endpoint_id_or_ssl_endpoint_name: unique identifier of this SSL endpoint or unique name for SSL endpoint
-    def delete(app_id_or_app_name, ssl_endpoint_id_or_ssl_endpoint_name)
-      @client.ssl_endpoint.delete(app_id_or_app_name, ssl_endpoint_id_or_ssl_endpoint_name)
-    end
-
-    # Info for existing SSL endpoint.
-    #
-    # @param app_id_or_app_name: unique identifier of app or unique name of app
-    # @param ssl_endpoint_id_or_ssl_endpoint_name: unique identifier of this SSL endpoint or unique name for SSL endpoint
-    def info(app_id_or_app_name, ssl_endpoint_id_or_ssl_endpoint_name)
-      @client.ssl_endpoint.info(app_id_or_app_name, ssl_endpoint_id_or_ssl_endpoint_name)
-    end
-
-    # List existing SSL endpoints.
-    #
-    # @param app_id_or_app_name: unique identifier of app or unique name of app
-    def list(app_id_or_app_name)
-      @client.ssl_endpoint.list(app_id_or_app_name)
-    end
-
-    # Update an existing SSL endpoint.
-    #
-    # @param app_id_or_app_name: unique identifier of app or unique name of app
-    # @param ssl_endpoint_id_or_ssl_endpoint_name: unique identifier of this SSL endpoint or unique name for SSL endpoint
-    # @param body: the object to pass as the request payload
-    def update(app_id_or_app_name, ssl_endpoint_id_or_ssl_endpoint_name, body = {})
-      @client.ssl_endpoint.update(app_id_or_app_name, ssl_endpoint_id_or_ssl_endpoint_name, body)
-    end
-  end
-
   # Stacks are the different application execution environments available in the Heroku platform.
   class Stack
     def initialize(client)
@@ -3175,6 +3164,22 @@ module PlatformAPI
     end
   end
 
+  # Usage for an enterprise team at a daily resolution.
+  class TeamDailyUsage
+    def initialize(client)
+      @client = client
+    end
+
+    # Retrieves usage for an enterprise team for a range of days. Start and end dates can be specified as query parameters using the date format YYYY-MM-DD. The team identifier can be found from the [team list endpoint](https://devcenter.heroku.com/articles/platform-api-reference#team-list).
+
+    #
+    # @param team_id: unique identifier of team
+    # @param body: the object to pass as the request payload
+    def info(team_id, body = {})
+      @client.team_daily_usage.info(team_id, body)
+    end
+  end
+
   # A team feature represents a feature enabled on a team account.
   class TeamFeature
     def initialize(client)
@@ -3317,6 +3322,22 @@ module PlatformAPI
     end
   end
 
+  # Usage for an enterprise team at a monthly resolution.
+  class TeamMonthlyUsage
+    def initialize(client)
+      @client = client
+    end
+
+    # Retrieves usage for an enterprise team for a range of months. Start and end dates can be specified as query parameters using the date, YYYY-MM. If no end date is specified, one month of usage is returned. The team identifier can be found from the [team list endpoint](https://devcenter.heroku.com/articles/platform-api-reference#team-list).
+
+    #
+    # @param team_id: unique identifier of team
+    # @param body: the object to pass as the request payload
+    def info(team_id, body = {})
+      @client.team_monthly_usage.info(team_id, body)
+    end
+  end
+
   # Tracks a Team's Preferences
   class TeamPreferences
     def initialize(client)
@@ -3339,7 +3360,7 @@ module PlatformAPI
     end
   end
 
-  # A space is an isolated, highly available, secure app execution environments, running in the modern VPC substrate.
+  # A space is an isolated, highly available, secure app execution environment.
   class TeamSpace
     def initialize(client)
       @client = client
@@ -3353,34 +3374,6 @@ module PlatformAPI
     end
   end
 
-  # Usage for an enterprise team at a daily resolution.
-  class TeamUsageDaily
-    def initialize(client)
-      @client = client
-    end
-
-    # Retrieves usage for an enterprise team for a range of days. Start and end dates can be specified as query parameters using the date format, YYYY-MM-DD format. For example, '/teams/example-team/usage?start=2019-01-01&end=2019-01-31' specifies all days in January for 2019.
-    #
-    # @param team_id: unique identifier of team
-    def info(team_id)
-      @client.team_usage_daily.info(team_id)
-    end
-  end
-
-  # Usage for an enterprise team at a monthly resolution.
-  class TeamUsageMonthly
-    def initialize(client)
-      @client = client
-    end
-
-    # Retrieves usage for an enterprise team for a range of months. Start and end dates can be specified as query parameters using the date format, YYYY-MM format. For example, '/teams/example-team/usage?start=2019-01&end=2019-02' specifies usage in January and February for 2019. If no end date is specified, one month of usage is returned.
-    #
-    # @param team_id: unique identifier of team
-    def info(team_id)
-      @client.team_usage_monthly.info(team_id)
-    end
-  end
-
   # Teams allow you to manage access to a shared group of applications and other resources.
   class Team
     def initialize(client)
@@ -3567,35 +3560,14 @@ module PlatformAPI
     def info(space_id_or_space_name, vpn_connection_id_or_vpn_connection_name)
       @client.vpn_connection.info(space_id_or_space_name, vpn_connection_id_or_vpn_connection_name)
     end
-  end
-
-  # Entities that have been whitelisted to be used by an Team
-  class WhitelistedAddonService
-    def initialize(client)
-      @client = client
-    end
-
-    # List all whitelisted Add-on Services for an 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.whitelisted_addon_service.list_by_team(team_name_or_team_id)
-    end
 
-    # Whitelist an Add-on Service
+    # Update a VPN connection in a private space.
     #
-    # @param team_name_or_team_id: unique name of team or unique identifier of team
+    # @param space_id_or_space_name: unique identifier of space or unique name of space
+    # @param vpn_connection_id_or_vpn_connection_name: VPN ID or VPN Name
     # @param body: the object to pass as the request payload
-    def create_by_team(team_name_or_team_id, body = {})
-      @client.whitelisted_addon_service.create_by_team(team_name_or_team_id, body)
-    end
-
-    # Remove a whitelisted entity
-    #
-    # @param team_name_or_team_id: unique name of team or unique identifier of team
-    # @param whitelisted_addon_service_id_or_addon_service_name: unique identifier for this whitelisting entity or unique name of this add-on-service
-    def delete_by_team(team_name_or_team_id, whitelisted_addon_service_id_or_addon_service_name)
-      @client.whitelisted_addon_service.delete_by_team(team_name_or_team_id, whitelisted_addon_service_id_or_addon_service_name)
+    def update(space_id_or_space_name, vpn_connection_id_or_vpn_connection_name, body = {})
+      @client.vpn_connection.update(space_id_or_space_name, vpn_connection_id_or_vpn_connection_name, body)
     end
   end
 
@@ -3830,6 +3802,15 @@ module PlatformAPI
             "string"
           ]
         },
+        "country_of_residence": {
+          "description": "country where account owner resides",
+          "example": "United States",
+          "readOnly": false,
+          "type": [
+            "string",
+            "null"
+          ]
+        },
         "email": {
           "description": "unique email address of account",
           "example": "username@example.com",
@@ -4001,7 +3982,7 @@ module PlatformAPI
           "title": "Update"
         },
         {
-          "description": "Delete account. Note that this action cannot be undone.",
+          "description": "Delete account. Note that this action cannot be undone. Note: This endpoint requires the HTTP_HEROKU_PASSWORD or HTTP_HEROKU_PASSWORD_BASE64 header be set correctly for the user account.",
           "href": "/account",
           "method": "DELETE",
           "rel": "destroy",
@@ -4047,7 +4028,7 @@ module PlatformAPI
           "title": "Update By User"
         },
         {
-          "description": "Delete account. Note that this action cannot be undone.",
+          "description": "Delete account. Note that this action cannot be undone. Note: This endpoint requires the HTTP_HEROKU_PASSWORD or HTTP_HEROKU_PASSWORD_BASE64 header be set correctly for the user account.",
           "href": "/users/{(%23%2Fdefinitions%2Faccount%2Fdefinitions%2Fidentity)}",
           "method": "DELETE",
           "rel": "destroy",
@@ -4078,10 +4059,14 @@ module PlatformAPI
         },
         "identity_provider": {
           "description": "Identity Provider details for federated users.",
+          "strictProperties": true,
           "properties": {
             "id": {
               "$ref": "#/definitions/identity-provider/definitions/id"
             },
+            "name": {
+              "$ref": "#/definitions/identity-provider/definitions/name"
+            },
             "team": {
               "type": [
                 "object"
@@ -4103,46 +4088,7 @@ module PlatformAPI
               }
             },
             "owner": {
-              "description": "entity that owns this identity provider",
-              "properties": {
-                "id": {
-                  "description": "unique identifier of the owner",
-                  "example": "01234567-89ab-cdef-0123-456789abcdef",
-                  "format": "uuid",
-                  "readOnly": true,
-                  "type": [
-                    "string"
-                  ]
-                },
-                "name": {
-                  "description": "name of the owner",
-                  "example": "acme",
-                  "readOnly": true,
-                  "type": [
-                    "string"
-                  ]
-                },
-                "type": {
-                  "description": "type of the owner",
-                  "enum": [
-                    "team",
-                    "enterprise-account"
-                  ],
-                  "example": "team",
-                  "readOnly": true,
-                  "type": [
-                    "string"
-                  ]
-                }
-              },
-              "readOnly": false,
-              "required": [
-                "id",
-                "type"
-              ],
-              "type": [
-                "object"
-              ]
+              "$ref": "#/definitions/identity-provider/definitions/owner"
             }
           },
           "type": [
@@ -4174,6 +4120,9 @@ module PlatformAPI
         "verified": {
           "$ref": "#/definitions/account/definitions/verified"
         },
+        "country_of_residence": {
+          "$ref": "#/definitions/account/definitions/country_of_residence"
+        },
         "default_organization": {
           "description": "team selected by default",
           "properties": {
@@ -4209,7 +4158,7 @@ module PlatformAPI
       }
     },
     "add-on-action": {
-      "description": "Add-on Actions are lifecycle operations for add-on provisioning and deprovisioning. They allow whitelisted add-on providers to (de)provision add-ons in the background and then report back when (de)provisioning is complete.",
+      "description": "Add-on Actions are lifecycle operations for add-on provisioning and deprovisioning. They allow add-on providers to (de)provision add-ons in the background and then report back when (de)provisioning is complete.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "stability": "development",
       "strictProperties": true,
@@ -5742,18 +5691,18 @@ module PlatformAPI
         }
       }
     },
-    "app-feature": {
-      "description": "An app feature represents a Heroku labs capability that can be enabled or disabled for an app on Heroku.",
+    "allowed-add-on-service": {
+      "description": "Entities that have been allowed to be used by a Team",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "stability": "production",
+      "stability": "prototype",
       "strictProperties": true,
-      "title": "Heroku Platform API - App Feature",
+      "title": "Heroku Platform API - Allowed Add-on Service",
       "type": [
         "object"
       ],
       "definitions": {
-        "created_at": {
-          "description": "when app feature was created",
+        "added_at": {
+          "description": "when the add-on service was allowed",
           "example": "2012-01-01T12:00:00Z",
           "format": "date-time",
           "readOnly": true,
@@ -5761,19 +5710,170 @@ module PlatformAPI
             "string"
           ]
         },
-        "description": {
-          "description": "description of app feature",
-          "example": "Causes app to example.",
+        "added_by": {
+          "description": "the user which allowed the add-on service",
+          "properties": {
+            "email": {
+              "$ref": "#/definitions/account/definitions/email",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "id": {
+              "$ref": "#/definitions/account/definitions/id",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
           "readOnly": true,
           "type": [
-            "string"
+            "object"
           ]
         },
-        "doc_url": {
-          "description": "documentation URL of app feature",
-          "example": "http://devcenter.heroku.com/articles/example",
-          "readOnly": true,
-          "type": [
+        "addon_service": {
+          "description": "the add-on service allowed for use",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/add-on-service/definitions/id"
+            },
+            "name": {
+              "$ref": "#/definitions/add-on-service/definitions/name"
+            },
+            "human_name": {
+              "$ref": "#/definitions/add-on-service/definitions/human_name"
+            }
+          },
+          "readOnly": true,
+          "type": [
+            "object"
+          ]
+        },
+        "id": {
+          "description": "unique identifier for this allowed add-on service record",
+          "example": "01234567-89ab-cdef-0123-456789abcdef",
+          "format": "uuid",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "identity": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/allowed-add-on-service/definitions/id"
+            },
+            {
+              "$ref": "#/definitions/add-on-service/definitions/name"
+            }
+          ]
+        }
+      },
+      "links": [
+        {
+          "description": "List all allowed add-on services for a team",
+          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/allowed-addon-services",
+          "method": "GET",
+          "rel": "instances",
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/allowed-add-on-service"
+            },
+            "type": [
+              "array"
+            ]
+          },
+          "title": "List By Team"
+        },
+        {
+          "description": "Allow an Add-on Service",
+          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/allowed-addon-services",
+          "method": "POST",
+          "rel": "create",
+          "schema": {
+            "type": [
+              "object"
+            ],
+            "properties": {
+              "addon_service": {
+                "description": "name of the add-on service to allow",
+                "example": "heroku-postgresql",
+                "type": [
+                  "string"
+                ]
+              }
+            }
+          },
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/allowed-add-on-service"
+            },
+            "type": [
+              "array"
+            ]
+          },
+          "title": "Create By Team"
+        },
+        {
+          "description": "Remove an allowed add-on service",
+          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/allowed-addon-services/{(%23%2Fdefinitions%2Fallowed-add-on-service%2Fdefinitions%2Fidentity)}",
+          "method": "DELETE",
+          "rel": "destroy",
+          "targetSchema": {
+            "$ref": "#/definitions/allowed-add-on-service"
+          },
+          "title": "Delete By Team"
+        }
+      ],
+      "properties": {
+        "added_at": {
+          "$ref": "#/definitions/allowed-add-on-service/definitions/added_at"
+        },
+        "added_by": {
+          "$ref": "#/definitions/allowed-add-on-service/definitions/added_by"
+        },
+        "addon_service": {
+          "$ref": "#/definitions/allowed-add-on-service/definitions/addon_service"
+        },
+        "id": {
+          "$ref": "#/definitions/allowed-add-on-service/definitions/id"
+        }
+      }
+    },
+    "app-feature": {
+      "description": "An app feature represents a Heroku labs capability that can be enabled or disabled for an app on Heroku.",
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "stability": "production",
+      "strictProperties": true,
+      "title": "Heroku Platform API - App Feature",
+      "type": [
+        "object"
+      ],
+      "definitions": {
+        "created_at": {
+          "description": "when app feature was created",
+          "example": "2012-01-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "description": {
+          "description": "description of app feature",
+          "example": "Causes app to example.",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "doc_url": {
+          "description": "documentation URL of app feature",
+          "example": "http://devcenter.heroku.com/articles/example",
+          "readOnly": true,
+          "type": [
             "string"
           ]
         },
@@ -7345,6 +7445,15 @@ module PlatformAPI
               },
               "stack": {
                 "$ref": "#/definitions/stack/definitions/identity"
+              },
+              "feature_flags": {
+                "description": "unique name of app feature",
+                "type": [
+                  "array"
+                ],
+                "items": {
+                  "$ref": "#/definitions/app-feature/definitions/name"
+                }
               }
             },
             "type": [
@@ -7630,7 +7739,7 @@ module PlatformAPI
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "title": "Heroku Platform API - Audit Trail Archive",
       "description": "An audit trail archive represents a monthly json zipped file containing events",
-      "stability": "development",
+      "stability": "production",
       "strictProperties": true,
       "type": [
         "object"
@@ -7649,12 +7758,24 @@ module PlatformAPI
         },
         "month": {
           "description": "month of the archive",
-          "example": 10,
+          "enum": [
+            "01",
+            "02",
+            "03",
+            "04",
+            "05",
+            "06",
+            "07",
+            "08",
+            "09",
+            "10",
+            "11",
+            "12"
+          ],
+          "example": "10",
           "readOnly": true,
-          "minimum": 1,
-          "maximum": 12,
           "type": [
-            "integer"
+            "string"
           ]
         },
         "year": {
@@ -7737,7 +7858,7 @@ module PlatformAPI
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "title": "Heroku Platform API - Audit Trail Event",
       "description": "An audit trail event represents some action on the platform",
-      "stability": "development",
+      "stability": "production",
       "strictProperties": true,
       "type": [
         "object"
@@ -7751,13 +7872,6 @@ module PlatformAPI
             "string"
           ]
         },
-        "identity": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/audit-trail-event/definitions/id"
-            }
-          ]
-        },
         "type": {
           "description": "type of event",
           "readOnly": true,
@@ -7906,7 +8020,7 @@ module PlatformAPI
       },
       "links": [
         {
-          "description": "List existing events.",
+          "description": "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.",
           "href": "/enterprise-accounts/{(%23%2Fdefinitions%2Fenterprise-account%2Fdefinitions%2Fidentity)}/events",
           "method": "GET",
           "rel": "instances",
@@ -8911,6 +9025,13 @@ module PlatformAPI
           "type": [
             "string"
           ]
+        },
+        "sni_endpoint": {
+          "description": "null or unique identifier or name for SNI endpoint",
+          "type": [
+            "null",
+            "string"
+          ]
         }
       },
       "links": [
@@ -8923,10 +9044,14 @@ module PlatformAPI
             "properties": {
               "hostname": {
                 "$ref": "#/definitions/domain/definitions/hostname"
+              },
+              "sni_endpoint": {
+                "$ref": "#/definitions/domain/definitions/sni_endpoint"
               }
             },
             "required": [
-              "hostname"
+              "hostname",
+              "sni_endpoint"
             ],
             "type": [
               "object"
@@ -8937,6 +9062,29 @@ module PlatformAPI
           },
           "title": "Create"
         },
+        {
+          "description": "Associate an SNI endpoint",
+          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/domains/{(%23%2Fdefinitions%2Fdomain%2Fdefinitions%2Fidentity)}",
+          "method": "PATCH",
+          "rel": "update",
+          "schema": {
+            "properties": {
+              "sni_endpoint": {
+                "$ref": "#/definitions/domain/definitions/sni_endpoint"
+              }
+            },
+            "required": [
+              "sni_endpoint"
+            ],
+            "type": [
+              "object"
+            ]
+          },
+          "targetSchema": {
+            "$ref": "#/definitions/domain"
+          },
+          "title": "Update"
+        },
         {
           "description": "Delete an existing domain",
           "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/domains/{(%23%2Fdefinitions%2Fdomain%2Fdefinitions%2Fidentity)}",
@@ -9014,6 +9162,21 @@ module PlatformAPI
         },
         "status": {
           "$ref": "#/definitions/domain/definitions/status"
+        },
+        "sni_endpoint": {
+          "description": "sni endpoint the domain is associated with",
+          "properties": {
+            "name": {
+              "$ref": "#/definitions/sni-endpoint/definitions/name"
+            },
+            "id": {
+              "$ref": "#/definitions/sni-endpoint/definitions/id"
+            }
+          },
+          "type": [
+            "null",
+            "object"
+          ]
         }
       }
     },
@@ -9483,18 +9646,51 @@ module PlatformAPI
         }
       }
     },
-    "enterprise-account-member": {
+    "enterprise-account-daily-usage": {
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "description": "Enterprise account members are users with access to an enterprise account.",
+      "description": "Usage for an enterprise account at a daily resolution.",
       "stability": "development",
       "strictProperties": true,
-      "title": "Heroku Platform API - Enterprise Account Member",
+      "title": "Heroku Platform API - Enterprise Account Daily Usage",
       "type": [
         "object"
       ],
       "definitions": {
+        "addons": {
+          "description": "total add-on credits used",
+          "example": 250.0,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
+        "data": {
+          "description": "total add-on credits used for first party add-ons",
+          "example": 34.89,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
+        "date": {
+          "description": "date of the usage",
+          "example": "2019-01-01",
+          "format": "date",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "dynos": {
+          "description": "dynos used",
+          "example": 1.548,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
         "id": {
-          "description": "unique identifier of the member",
+          "description": "enterprise account identifier",
           "example": "01234567-89ab-cdef-0123-456789abcdef",
           "format": "uuid",
           "readOnly": true,
@@ -9502,32 +9698,197 @@ module PlatformAPI
             "string"
           ]
         },
-        "identity": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/enterprise-account-member/definitions/id"
-            }
+        "name": {
+          "description": "name of the enterprise account",
+          "example": "example-co",
+          "readOnly": true,
+          "type": [
+            "string"
           ]
         },
-        "permission": {
-          "description": "permission in the enterprise account",
-          "enum": [
-            "view",
-            "create",
-            "manage",
-            "billing"
-          ],
-          "example": "view",
+        "partner": {
+          "description": "total add-on credits used for third party add-ons",
+          "example": 12.34,
           "readOnly": true,
           "type": [
-            "string"
+            "number"
           ]
         },
-        "permissions": {
-          "description": "permissions for enterprise account",
-          "example": [
-            "view"
-          ],
+        "space": {
+          "description": "space credits used",
+          "example": 1.548,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
+        "start_date": {
+          "description": "range start date",
+          "example": "2019-01-25",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "end_date": {
+          "description": "range end date",
+          "example": "2019-02-25",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        }
+      },
+      "links": [
+        {
+          "description": "Retrieves usage for an enterprise account for a range of days. Start and end dates can be specified as query parameters using the date format YYYY-MM-DD. The enterprise account identifier can be found from the [enterprise account list](https://devcenter.heroku.com/articles/platform-api-reference#enterprise-account-list).\n",
+          "href": "/enterprise-accounts/{(%23%2Fdefinitions%2Fenterprise-account%2Fdefinitions%2Fid)}/usage/daily",
+          "method": "GET",
+          "rel": "instances",
+          "title": "Info",
+          "schema": {
+            "properties": {
+              "start": {
+                "$ref": "#/definitions/enterprise-account-daily-usage/definitions/start_date"
+              },
+              "end": {
+                "$ref": "#/definitions/enterprise-account-daily-usage/definitions/end_date"
+              }
+            },
+            "required": [
+              "start"
+            ],
+            "type": [
+              "object"
+            ]
+          },
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/enterprise-account-daily-usage"
+            },
+            "type": [
+              "array"
+            ]
+          }
+        }
+      ],
+      "properties": {
+        "addons": {
+          "$ref": "#/definitions/enterprise-account-daily-usage/definitions/addons"
+        },
+        "teams": {
+          "description": "usage by team",
+          "type": [
+            "array"
+          ],
+          "items": {
+            "type": [
+              "object"
+            ],
+            "properties": {
+              "addons": {
+                "$ref": "#/definitions/team-daily-usage/definitions/addons"
+              },
+              "apps": {
+                "description": "app usage in the team",
+                "type": [
+                  "array"
+                ],
+                "items": {
+                  "$ref": "#/definitions/team-daily-usage/definitions/app_usage_daily"
+                }
+              },
+              "data": {
+                "$ref": "#/definitions/team-daily-usage/definitions/data"
+              },
+              "dynos": {
+                "$ref": "#/definitions/team-daily-usage/definitions/dynos"
+              },
+              "id": {
+                "$ref": "#/definitions/team-daily-usage/definitions/id"
+              },
+              "name": {
+                "$ref": "#/definitions/team-daily-usage/definitions/name"
+              },
+              "partner": {
+                "$ref": "#/definitions/team-daily-usage/definitions/partner"
+              },
+              "space": {
+                "$ref": "#/definitions/team-daily-usage/definitions/space"
+              }
+            }
+          }
+        },
+        "data": {
+          "$ref": "#/definitions/enterprise-account-daily-usage/definitions/data"
+        },
+        "date": {
+          "$ref": "#/definitions/enterprise-account-daily-usage/definitions/date"
+        },
+        "dynos": {
+          "$ref": "#/definitions/enterprise-account-daily-usage/definitions/dynos"
+        },
+        "id": {
+          "$ref": "#/definitions/enterprise-account-daily-usage/definitions/id"
+        },
+        "name": {
+          "$ref": "#/definitions/enterprise-account-daily-usage/definitions/name"
+        },
+        "partner": {
+          "$ref": "#/definitions/enterprise-account-daily-usage/definitions/partner"
+        },
+        "space": {
+          "$ref": "#/definitions/enterprise-account-daily-usage/definitions/space"
+        }
+      }
+    },
+    "enterprise-account-member": {
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "description": "Enterprise account members are users with access to an enterprise account.",
+      "stability": "development",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Enterprise Account Member",
+      "type": [
+        "object"
+      ],
+      "definitions": {
+        "id": {
+          "description": "unique identifier of the member",
+          "example": "01234567-89ab-cdef-0123-456789abcdef",
+          "format": "uuid",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "identity": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/enterprise-account-member/definitions/id"
+            }
+          ]
+        },
+        "permission": {
+          "description": "permission in the enterprise account",
+          "enum": [
+            "view",
+            "create",
+            "manage",
+            "billing"
+          ],
+          "example": "view",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "permissions": {
+          "description": "permissions for enterprise account",
+          "example": [
+            "view"
+          ],
           "readOnly": true,
           "type": [
             "array"
@@ -9736,171 +10097,7 @@ module PlatformAPI
         }
       }
     },
-    "enterprise-account-usage-daily": {
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "description": "Usage for an enterprise account at a daily resolution.",
-      "stability": "development",
-      "strictProperties": true,
-      "title": "Heroku Platform API - Enterprise Account Daily Usage",
-      "type": [
-        "object"
-      ],
-      "definitions": {
-        "addons": {
-          "description": "total add-on credits used",
-          "example": 250.0,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        },
-        "data": {
-          "description": "total add-on credits used for first party add-ons",
-          "example": 34.89,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        },
-        "date": {
-          "description": "date of the usage",
-          "example": "2019-01-01",
-          "format": "date",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "dynos": {
-          "description": "dynos used",
-          "example": 1.548,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        },
-        "id": {
-          "description": "enterprise account identifier",
-          "example": "01234567-89ab-cdef-0123-456789abcdef",
-          "format": "uuid",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "name": {
-          "description": "name of the enterprise account",
-          "example": "example-co",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "partner": {
-          "description": "total add-on credits used for third party add-ons",
-          "example": 12.34,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        },
-        "space": {
-          "description": "space credits used",
-          "example": 1.548,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        }
-      },
-      "links": [
-        {
-          "description": "Retrieves usage for an enterprise account for a range of days. Start and end dates can be specified as query parameters using the date format, YYYY-MM-DD format. For example, '/enterprise-accounts/example-account/usage/daily?start=2019-01-01&end=2019-01-31' specifies all days in January for 2019.",
-          "href": "/enterprise-accounts/{(%23%2Fdefinitions%2Fenterprise-account%2Fdefinitions%2Fid)}/usage/daily",
-          "method": "GET",
-          "title": "Info",
-          "rel": "instances",
-          "targetSchema": {
-            "items": {
-              "$ref": "#/definitions/enterprise-account-usage-daily"
-            },
-            "type": [
-              "array"
-            ]
-          }
-        }
-      ],
-      "properties": {
-        "addons": {
-          "$ref": "#/definitions/enterprise-account-usage-daily/definitions/addons"
-        },
-        "teams": {
-          "description": "usage by team",
-          "type": [
-            "array"
-          ],
-          "items": {
-            "type": [
-              "object"
-            ],
-            "properties": {
-              "addons": {
-                "$ref": "#/definitions/team-usage-daily/definitions/addons"
-              },
-              "apps": {
-                "description": "app usage in the team",
-                "type": [
-                  "array"
-                ],
-                "items": {
-                  "$ref": "#/definitions/team-usage-daily/definitions/app_usage_daily"
-                }
-              },
-              "data": {
-                "$ref": "#/definitions/team-usage-daily/definitions/data"
-              },
-              "dynos": {
-                "$ref": "#/definitions/team-usage-daily/definitions/dynos"
-              },
-              "id": {
-                "$ref": "#/definitions/team-usage-daily/definitions/id"
-              },
-              "name": {
-                "$ref": "#/definitions/team-usage-daily/definitions/name"
-              },
-              "partner": {
-                "$ref": "#/definitions/team-usage-daily/definitions/partner"
-              },
-              "space": {
-                "$ref": "#/definitions/team-usage-daily/definitions/space"
-              }
-            }
-          }
-        },
-        "data": {
-          "$ref": "#/definitions/enterprise-account-usage-daily/definitions/data"
-        },
-        "date": {
-          "$ref": "#/definitions/enterprise-account-usage-daily/definitions/date"
-        },
-        "dynos": {
-          "$ref": "#/definitions/enterprise-account-usage-daily/definitions/dynos"
-        },
-        "id": {
-          "$ref": "#/definitions/enterprise-account-usage-daily/definitions/id"
-        },
-        "name": {
-          "$ref": "#/definitions/enterprise-account-usage-daily/definitions/name"
-        },
-        "partner": {
-          "$ref": "#/definitions/enterprise-account-usage-daily/definitions/partner"
-        },
-        "space": {
-          "$ref": "#/definitions/enterprise-account-usage-daily/definitions/space"
-        }
-      }
-    },
-    "enterprise-account-usage-monthly": {
+    "enterprise-account-monthly-usage": {
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "description": "Usage for an enterprise account at a monthly resolution.",
       "stability": "development",
@@ -9983,18 +10180,52 @@ module PlatformAPI
           "type": [
             "number"
           ]
+        },
+        "start_date": {
+          "description": "range start date",
+          "example": "2019-01",
+          "pattern": "^[0-9]{4}-[0-9]{2}$",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "end_date": {
+          "description": "range end date",
+          "example": "2019-02",
+          "pattern": "^[0-9]{4}-[0-9]{2}$",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
         }
       },
       "links": [
         {
-          "description": "Retrieves usage for an enterprise account for a range of months. Start and end dates can be specified as query parameters using the date format, YYYY-MM format. For example, '/enterprise-accounts/example-account/usage/monthly?start=2019-01&end=2019-02' specifies usage in January and February for 2019. If no end date is specified, one month of usage is returned.",
+          "description": "Retrieves usage for an enterprise account for a range of months. Start and end dates can be specified as query parameters using the date format YYYY-MM. If no end date is specified, one month of usage is returned. The enterprise account identifier can be found from the [enterprise account list](https://devcenter.heroku.com/articles/platform-api-reference#enterprise-account-list).\n",
           "href": "/enterprise-accounts/{(%23%2Fdefinitions%2Fenterprise-account%2Fdefinitions%2Fid)}/usage/monthly",
           "method": "GET",
           "rel": "instances",
           "title": "Info",
+          "schema": {
+            "properties": {
+              "start": {
+                "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/start_date"
+              },
+              "end": {
+                "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/end_date"
+              }
+            },
+            "required": [
+              "start"
+            ],
+            "type": [
+              "object"
+            ]
+          },
           "targetSchema": {
             "items": {
-              "$ref": "#/definitions/enterprise-account-usage-monthly"
+              "$ref": "#/definitions/enterprise-account-monthly-usage"
             },
             "type": [
               "array"
@@ -10004,7 +10235,7 @@ module PlatformAPI
       ],
       "properties": {
         "addons": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/addons"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/addons"
         },
         "teams": {
           "description": "usage by team",
@@ -10017,7 +10248,7 @@ module PlatformAPI
             ],
             "properties": {
               "addons": {
-                "$ref": "#/definitions/team-usage-monthly/definitions/addons"
+                "$ref": "#/definitions/team-monthly-usage/definitions/addons"
               },
               "apps": {
                 "description": "app usage in the team",
@@ -10025,56 +10256,56 @@ module PlatformAPI
                   "array"
                 ],
                 "items": {
-                  "$ref": "#/definitions/team-usage-monthly/definitions/app_usage_monthly"
+                  "$ref": "#/definitions/team-monthly-usage/definitions/app_usage_monthly"
                 }
               },
               "connect": {
-                "$ref": "#/definitions/team-usage-monthly/definitions/connect"
+                "$ref": "#/definitions/team-monthly-usage/definitions/connect"
               },
               "data": {
-                "$ref": "#/definitions/team-usage-monthly/definitions/data"
+                "$ref": "#/definitions/team-monthly-usage/definitions/data"
               },
               "dynos": {
-                "$ref": "#/definitions/team-usage-monthly/definitions/dynos"
+                "$ref": "#/definitions/team-monthly-usage/definitions/dynos"
               },
               "id": {
-                "$ref": "#/definitions/team-usage-monthly/definitions/id"
+                "$ref": "#/definitions/team-monthly-usage/definitions/id"
               },
               "name": {
-                "$ref": "#/definitions/team-usage-monthly/definitions/name"
+                "$ref": "#/definitions/team-monthly-usage/definitions/name"
               },
               "partner": {
-                "$ref": "#/definitions/team-usage-monthly/definitions/partner"
+                "$ref": "#/definitions/team-monthly-usage/definitions/partner"
               },
               "space": {
-                "$ref": "#/definitions/team-usage-monthly/definitions/space"
+                "$ref": "#/definitions/team-monthly-usage/definitions/space"
               }
             }
           }
         },
         "connect": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/connect"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/connect"
         },
         "data": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/data"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/data"
         },
         "dynos": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/dynos"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/dynos"
         },
         "id": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/id"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/id"
         },
         "month": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/month"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/month"
         },
         "name": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/name"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/name"
         },
         "partner": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/partner"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/partner"
         },
         "space": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/space"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/space"
         }
       }
     },
@@ -10113,6 +10344,25 @@ module PlatformAPI
             }
           ]
         },
+        "identity_provider": {
+          "description": "Identity Provider associated with the Enterprise Account",
+          "strictProperties": true,
+          "type": [
+            "null",
+            "object"
+          ],
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/identity-provider/definitions/id"
+            },
+            "name": {
+              "$ref": "#/definitions/identity-provider/definitions/name"
+            },
+            "owner": {
+              "$ref": "#/definitions/identity-provider/definitions/owner"
+            }
+          }
+        },
         "name": {
           "description": "unique name of the enterprise account",
           "example": "example",
@@ -10215,27 +10465,7 @@ module PlatformAPI
           "$ref": "#/definitions/enterprise-account/definitions/trial"
         },
         "identity_provider": {
-          "description": "Identity Provider associated with the Enterprise Account",
-          "strictProperties": true,
-          "type": [
-            "null",
-            "object"
-          ],
-          "properties": {
-            "id": {
-              "$ref": "#/definitions/identity-provider/definitions/id"
-            },
-            "name": {
-              "description": "user-friendly unique identifier for this identity provider",
-              "example": "acme-sso",
-              "type": [
-                "string"
-              ]
-            },
-            "owner": {
-              "$ref": "#/definitions/identity-provider/definitions/owner"
-            }
-          }
+          "$ref": "#/definitions/enterprise-account/definitions/identity_provider"
         }
       }
     },
@@ -10532,7 +10762,7 @@ module PlatformAPI
       }
     },
     "identity-provider": {
-      "description": "Identity Providers represent the SAML configuration of an Team.",
+      "description": "Identity Providers represent the SAML configuration of an Enterprise Account or Team.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "stability": "production",
       "strictProperties": true,
@@ -10575,6 +10805,13 @@ module PlatformAPI
             "string"
           ]
         },
+        "name": {
+          "description": "user-friendly unique identifier for this identity provider",
+          "example": "acme-sso",
+          "type": [
+            "string"
+          ]
+        },
         "slo_target_url": {
           "description": "single log out URL for this identity provider",
           "example": "https://example.com/idp/logout",
@@ -13118,7 +13355,7 @@ module PlatformAPI
       "links": [
         {
           "description": "List latest builds for each app in a pipeline",
-          "href": "/pipelines/{(%23%2Fdefinitions%2Fpipeline%2Fdefinitions%2Fidentity)}/latest-builds",
+          "href": "/pipelines/{(%23%2Fdefinitions%2Fpipeline%2Fdefinitions%2Fid)}/latest-builds",
           "method": "GET",
           "rel": "instances",
           "targetSchema": {
@@ -13468,7 +13705,7 @@ module PlatformAPI
       "links": [
         {
           "description": "List latest slug releases for each app in a pipeline",
-          "href": "/pipelines/{(%23%2Fdefinitions%2Fpipeline%2Fdefinitions%2Fidentity)}/latest-deployments",
+          "href": "/pipelines/{(%23%2Fdefinitions%2Fpipeline%2Fdefinitions%2Fid)}/latest-deployments",
           "method": "GET",
           "rel": "instances",
           "targetSchema": {
@@ -13817,7 +14054,7 @@ module PlatformAPI
       "links": [
         {
           "description": "List latest releases for each app in a pipeline",
-          "href": "/pipelines/{(%23%2Fdefinitions%2Fpipeline%2Fdefinitions%2Fidentity)}/latest-releases",
+          "href": "/pipelines/{(%23%2Fdefinitions%2Fpipeline%2Fdefinitions%2Fid)}/latest-releases",
           "method": "GET",
           "rel": "instances",
           "targetSchema": {
@@ -13844,7 +14081,7 @@ module PlatformAPI
       "links": [
         {
           "description": "The stack for a given pipeline, used for CI and Review Apps that have no stack defined in app.json.",
-          "href": "/pipelines/{(%23%2Fdefinitions%2Fpipeline%2Fdefinitions%2Fidentity)}/pipeline-stack",
+          "href": "/pipelines/{(%23%2Fdefinitions%2Fpipeline%2Fdefinitions%2Fid)}/pipeline-stack",
           "method": "GET",
           "rel": "self",
           "targetSchema": {
@@ -14154,11 +14391,11 @@ module PlatformAPI
           "targetSchema": {
             "items": {
               "$ref": "#/definitions/pipeline"
-            }
+            },
+            "type": [
+              "array"
+            ]
           },
-          "type": [
-            "array"
-          ],
           "title": "List"
         }
       ],
@@ -15727,7 +15964,7 @@ module PlatformAPI
               "size": 2048,
               "stack": {
                 "id": "01234567-89ab-cdef-0123-456789abcdef",
-                "name": "cedar-14"
+                "name": "heroku-18"
               },
               "updated_at": "2012-01-01T12:00:00Z"
             }
@@ -15857,17 +16094,21 @@ module PlatformAPI
         "object"
       ],
       "definitions": {
-        "certificate_chain": {
-          "description": "raw contents of the public certificate chain (eg: .crt or .pem file)",
-          "example": "-----BEGIN CERTIFICATE----- ...",
-          "readOnly": false,
+        "ca_signed?": {
+          "readOnly": true,
           "type": [
-            "string"
+            "boolean"
           ]
         },
-        "cname": {
-          "description": "deprecated; refer to GET /apps/:id/domains for valid CNAMEs for this app",
-          "example": "example.herokussl.com",
+        "cert_domains": {
+          "readOnly": true,
+          "type": [
+            "array"
+          ]
+        },
+        "certificate_chain": {
+          "description": "raw contents of the public certificate chain (eg: .crt or .pem file)",
+          "example": "-----BEGIN CERTIFICATE----- ...",
           "readOnly": false,
           "type": [
             "string"
@@ -15882,6 +16123,33 @@ module PlatformAPI
             "string"
           ]
         },
+        "domains": {
+          "description": "domains associated with this SSL certificate",
+          "type": [
+            "array"
+          ],
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/domain/definitions/id"
+          }
+        },
+        "display_name": {
+          "description": "unique name for SSL certificate",
+          "example": "example",
+          "pattern": "^[a-z][a-z0-9-]{2,29}$",
+          "readOnly": false,
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "expires_at": {
+          "readOnly": true,
+          "format": "date-time",
+          "type": [
+            "string"
+          ]
+        },
         "id": {
           "description": "unique identifier of this SNI endpoint",
           "example": "01234567-89ab-cdef-0123-456789abcdef",
@@ -15901,6 +16169,12 @@ module PlatformAPI
             }
           ]
         },
+        "issuer": {
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
         "name": {
           "description": "unique name for SNI endpoint",
           "example": "example",
@@ -15918,6 +16192,25 @@ module PlatformAPI
             "string"
           ]
         },
+        "self_signed?": {
+          "readOnly": true,
+          "type": [
+            "boolean"
+          ]
+        },
+        "starts_at": {
+          "readOnly": true,
+          "format": "date-time",
+          "type": [
+            "string"
+          ]
+        },
+        "subject": {
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
         "updated_at": {
           "description": "when SNI endpoint was updated",
           "example": "2012-01-01T12:00:00Z",
@@ -16023,9 +16316,6 @@ module PlatformAPI
         "certificate_chain": {
           "$ref": "#/definitions/sni-endpoint/definitions/certificate_chain"
         },
-        "cname": {
-          "$ref": "#/definitions/sni-endpoint/definitions/cname"
-        },
         "created_at": {
           "$ref": "#/definitions/sni-endpoint/definitions/created_at"
         },
@@ -16037,6 +16327,65 @@ module PlatformAPI
         },
         "updated_at": {
           "$ref": "#/definitions/sni-endpoint/definitions/updated_at"
+        },
+        "display_name": {
+          "$ref": "#/definitions/sni-endpoint/definitions/display_name"
+        },
+        "domains": {
+          "$ref": "#/definitions/sni-endpoint/definitions/domains"
+        },
+        "app": {
+          "description": "application that this SSL certificate is on",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/app/definitions/id"
+            },
+            "name": {
+              "$ref": "#/definitions/app/definitions/name"
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "object"
+          ]
+        },
+        "ssl_cert": {
+          "description": "certificate provided by this endpoint",
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "ca_signed?": {
+              "$ref": "#/definitions/sni-endpoint/definitions/ca_signed?"
+            },
+            "cert_domains": {
+              "$ref": "#/definitions/sni-endpoint/definitions/cert_domains"
+            },
+            "expires_at": {
+              "$ref": "#/definitions/sni-endpoint/definitions/expires_at"
+            },
+            "issuer": {
+              "$ref": "#/definitions/sni-endpoint/definitions/issuer"
+            },
+            "self_signed?": {
+              "$ref": "#/definitions/sni-endpoint/definitions/self_signed?"
+            },
+            "starts_at": {
+              "$ref": "#/definitions/sni-endpoint/definitions/starts_at"
+            },
+            "subject": {
+              "$ref": "#/definitions/sni-endpoint/definitions/subject"
+            },
+            "id": {
+              "description": "unique identifier of this SSL certificate",
+              "example": "01234567-89ab-cdef-0123-456789abcdef",
+              "format": "uuid",
+              "readOnly": true,
+              "type": [
+                "string"
+              ]
+            }
+          }
         }
       }
     },
@@ -16395,7 +16744,10 @@ module PlatformAPI
                 "string"
               ]
             }
-          }
+          },
+          "type": [
+            "object"
+          ]
         },
         "formation": {
           "description": "formations for application",
@@ -16517,7 +16869,7 @@ module PlatformAPI
       ]
     },
     "space": {
-      "description": "A space is an isolated, highly available, secure app execution environments, running in the modern VPC substrate.",
+      "description": "A space is an isolated, highly available, secure app execution environment.",
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "stability": "prototype",
       "strictProperties": true,
@@ -16593,6 +16945,13 @@ module PlatformAPI
             "string"
           ]
         },
+        "log_drain_url": {
+          "description": "URL to which all apps will drain logs. Only settable during space creation and enables direct logging. Must use HTTPS.",
+          "example": "https://example.com/logs",
+          "type": [
+            "string"
+          ]
+        },
         "cidr": {
           "description": "The RFC-1918 CIDR the Private Space will use. It must be a /16 in 10.0.0.0/8, 172.16.0.0/12 or 192.168.0.0/16",
           "example": "172.20.20.30/16",
@@ -16664,333 +17023,117 @@ module PlatformAPI
           "method": "DELETE",
           "rel": "destroy",
           "targetSchema": {
-            "$ref": "#/definitions/space"
-          },
-          "title": "Delete"
-        },
-        {
-          "description": "Create a new space.",
-          "href": "/spaces",
-          "method": "POST",
-          "rel": "create",
-          "schema": {
-            "properties": {
-              "name": {
-                "$ref": "#/definitions/space/definitions/name"
-              },
-              "team": {
-                "$ref": "#/definitions/team/definitions/name"
-              },
-              "region": {
-                "$ref": "#/definitions/region/definitions/identity"
-              },
-              "shield": {
-                "$ref": "#/definitions/space/definitions/shield"
-              },
-              "cidr": {
-                "$ref": "#/definitions/space/definitions/cidr"
-              },
-              "data_cidr": {
-                "$ref": "#/definitions/space/definitions/data_cidr"
-              }
-            },
-            "required": [
-              "name",
-              "team"
-            ],
-            "type": [
-              "object"
-            ]
-          },
-          "targetSchema": {
-            "$ref": "#/definitions/space"
-          },
-          "title": "Create"
-        }
-      ],
-      "properties": {
-        "created_at": {
-          "$ref": "#/definitions/space/definitions/created_at"
-        },
-        "id": {
-          "$ref": "#/definitions/space/definitions/id"
-        },
-        "name": {
-          "$ref": "#/definitions/space/definitions/name"
-        },
-        "organization": {
-          "description": "organization that owns this space",
-          "properties": {
-            "name": {
-              "$ref": "#/definitions/team/definitions/name"
-            }
-          },
-          "type": [
-            "object"
-          ]
-        },
-        "team": {
-          "description": "team that owns this space",
-          "properties": {
-            "id": {
-              "$ref": "#/definitions/team/definitions/id"
-            },
-            "name": {
-              "$ref": "#/definitions/team/definitions/name"
-            }
-          },
-          "type": [
-            "object"
-          ]
-        },
-        "region": {
-          "description": "identity of space region",
-          "properties": {
-            "id": {
-              "$ref": "#/definitions/region/definitions/id"
-            },
-            "name": {
-              "$ref": "#/definitions/region/definitions/name"
-            }
-          },
-          "strictProperties": true,
-          "type": [
-            "object"
-          ]
-        },
-        "shield": {
-          "$ref": "#/definitions/space/definitions/shield"
-        },
-        "state": {
-          "$ref": "#/definitions/space/definitions/state"
-        },
-        "updated_at": {
-          "$ref": "#/definitions/space/definitions/updated_at"
-        },
-        "cidr": {
-          "$ref": "#/definitions/space/definitions/cidr"
-        },
-        "data_cidr": {
-          "$ref": "#/definitions/space/definitions/data_cidr"
-        }
-      }
-    },
-    "ssl-endpoint": {
-      "description": "[SSL Endpoint](https://devcenter.heroku.com/articles/ssl-endpoint) is a public address serving custom SSL cert for HTTPS traffic to a Heroku app. Note that an app must have the `ssl:endpoint` add-on installed before it can provision an SSL Endpoint using these APIs.",
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "title": "Heroku Platform API - SSL Endpoint",
-      "stability": "production",
-      "strictProperties": true,
-      "type": [
-        "object"
-      ],
-      "definitions": {
-        "certificate_chain": {
-          "description": "raw contents of the public certificate chain (eg: .crt or .pem file)",
-          "example": "-----BEGIN CERTIFICATE----- ...",
-          "readOnly": false,
-          "type": [
-            "string"
-          ]
-        },
-        "cname": {
-          "description": "canonical name record, the address to point a domain at",
-          "example": "example.herokussl.com",
-          "readOnly": false,
-          "type": [
-            "string"
-          ]
-        },
-        "created_at": {
-          "description": "when endpoint was created",
-          "example": "2012-01-01T12:00:00Z",
-          "format": "date-time",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "id": {
-          "description": "unique identifier of this SSL endpoint",
-          "example": "01234567-89ab-cdef-0123-456789abcdef",
-          "format": "uuid",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "identity": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/ssl-endpoint/definitions/id"
-            },
-            {
-              "$ref": "#/definitions/ssl-endpoint/definitions/name"
-            }
-          ]
-        },
-        "name": {
-          "description": "unique name for SSL endpoint",
-          "example": "example",
-          "pattern": "^[a-z][a-z0-9-]{2,29}$",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "preprocess": {
-          "default": true,
-          "description": "allow Heroku to modify an uploaded public certificate chain if deemed advantageous by adding missing intermediaries, stripping unnecessary ones, etc.",
-          "example": true,
-          "readOnly": false,
-          "type": [
-            "boolean"
-          ]
-        },
-        "private_key": {
-          "description": "contents of the private key (eg .key file)",
-          "example": "-----BEGIN RSA PRIVATE KEY----- ...",
-          "readOnly": false,
-          "type": [
-            "string"
-          ]
-        },
-        "updated_at": {
-          "description": "when endpoint was updated",
-          "example": "2012-01-01T12:00:00Z",
-          "format": "date-time",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        }
-      },
-      "links": [
-        {
-          "description": "Create a new SSL endpoint.",
-          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/ssl-endpoints",
-          "method": "POST",
-          "rel": "create",
-          "schema": {
-            "properties": {
-              "certificate_chain": {
-                "$ref": "#/definitions/ssl-endpoint/definitions/certificate_chain"
-              },
-              "preprocess": {
-                "$ref": "#/definitions/ssl-endpoint/definitions/preprocess"
-              },
-              "private_key": {
-                "$ref": "#/definitions/ssl-endpoint/definitions/private_key"
-              }
-            },
-            "required": [
-              "certificate_chain",
-              "private_key"
-            ],
-            "type": [
-              "object"
-            ]
-          },
-          "targetSchema": {
-            "$ref": "#/definitions/ssl-endpoint"
-          },
-          "title": "Create"
-        },
-        {
-          "description": "Delete existing SSL endpoint.",
-          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/ssl-endpoints/{(%23%2Fdefinitions%2Fssl-endpoint%2Fdefinitions%2Fidentity)}",
-          "method": "DELETE",
-          "rel": "destroy",
-          "targetSchema": {
-            "$ref": "#/definitions/ssl-endpoint"
-          },
-          "title": "Delete"
-        },
-        {
-          "description": "Info for existing SSL endpoint.",
-          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/ssl-endpoints/{(%23%2Fdefinitions%2Fssl-endpoint%2Fdefinitions%2Fidentity)}",
-          "method": "GET",
-          "rel": "self",
-          "targetSchema": {
-            "$ref": "#/definitions/ssl-endpoint"
-          },
-          "title": "Info"
-        },
-        {
-          "description": "List existing SSL endpoints.",
-          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/ssl-endpoints",
-          "method": "GET",
-          "rel": "instances",
-          "targetSchema": {
-            "items": {
-              "$ref": "#/definitions/ssl-endpoint"
-            },
-            "type": [
-              "array"
-            ]
+            "$ref": "#/definitions/space"
           },
-          "title": "List"
+          "title": "Delete"
         },
         {
-          "description": "Update an existing SSL endpoint.",
-          "href": "/apps/{(%23%2Fdefinitions%2Fapp%2Fdefinitions%2Fidentity)}/ssl-endpoints/{(%23%2Fdefinitions%2Fssl-endpoint%2Fdefinitions%2Fidentity)}",
-          "method": "PATCH",
-          "rel": "update",
+          "description": "Create a new space.",
+          "href": "/spaces",
+          "method": "POST",
+          "rel": "create",
           "schema": {
             "properties": {
-              "certificate_chain": {
-                "$ref": "#/definitions/ssl-endpoint/definitions/certificate_chain"
+              "name": {
+                "$ref": "#/definitions/space/definitions/name"
               },
-              "preprocess": {
-                "$ref": "#/definitions/ssl-endpoint/definitions/preprocess"
+              "team": {
+                "$ref": "#/definitions/team/definitions/name"
               },
-              "private_key": {
-                "$ref": "#/definitions/ssl-endpoint/definitions/private_key"
+              "region": {
+                "$ref": "#/definitions/region/definitions/identity"
+              },
+              "shield": {
+                "$ref": "#/definitions/space/definitions/shield"
+              },
+              "cidr": {
+                "$ref": "#/definitions/space/definitions/cidr"
+              },
+              "data_cidr": {
+                "$ref": "#/definitions/space/definitions/data_cidr"
+              },
+              "log_drain_url": {
+                "$ref": "#/definitions/space/definitions/log_drain_url"
               }
             },
+            "required": [
+              "name",
+              "team"
+            ],
             "type": [
               "object"
             ]
           },
           "targetSchema": {
-            "$ref": "#/definitions/ssl-endpoint"
+            "$ref": "#/definitions/space"
           },
-          "title": "Update"
+          "title": "Create"
         }
       ],
       "properties": {
-        "app": {
-          "description": "application associated with this ssl-endpoint",
+        "created_at": {
+          "$ref": "#/definitions/space/definitions/created_at"
+        },
+        "id": {
+          "$ref": "#/definitions/space/definitions/id"
+        },
+        "name": {
+          "$ref": "#/definitions/space/definitions/name"
+        },
+        "organization": {
+          "description": "organization that owns this space",
+          "properties": {
+            "name": {
+              "$ref": "#/definitions/team/definitions/name"
+            }
+          },
           "type": [
             "object"
-          ],
+          ]
+        },
+        "team": {
+          "description": "team that owns this space",
           "properties": {
             "id": {
-              "$ref": "#/definitions/app/definitions/id"
+              "$ref": "#/definitions/team/definitions/id"
             },
             "name": {
-              "$ref": "#/definitions/app/definitions/name"
+              "$ref": "#/definitions/team/definitions/name"
             }
           },
-          "strictProperties": true
+          "type": [
+            "object"
+          ]
         },
-        "certificate_chain": {
-          "$ref": "#/definitions/ssl-endpoint/definitions/certificate_chain"
+        "region": {
+          "description": "identity of space region",
+          "properties": {
+            "id": {
+              "$ref": "#/definitions/region/definitions/id"
+            },
+            "name": {
+              "$ref": "#/definitions/region/definitions/name"
+            }
+          },
+          "strictProperties": true,
+          "type": [
+            "object"
+          ]
         },
-        "cname": {
-          "$ref": "#/definitions/ssl-endpoint/definitions/cname"
+        "shield": {
+          "$ref": "#/definitions/space/definitions/shield"
         },
-        "created_at": {
-          "$ref": "#/definitions/ssl-endpoint/definitions/created_at"
+        "state": {
+          "$ref": "#/definitions/space/definitions/state"
         },
-        "id": {
-          "$ref": "#/definitions/ssl-endpoint/definitions/id"
+        "updated_at": {
+          "$ref": "#/definitions/space/definitions/updated_at"
         },
-        "name": {
-          "$ref": "#/definitions/ssl-endpoint/definitions/name"
+        "cidr": {
+          "$ref": "#/definitions/space/definitions/cidr"
         },
-        "updated_at": {
-          "$ref": "#/definitions/ssl-endpoint/definitions/updated_at"
+        "data_cidr": {
+          "$ref": "#/definitions/space/definitions/data_cidr"
         }
       }
     },
@@ -17042,7 +17185,7 @@ module PlatformAPI
         },
         "name": {
           "description": "unique name of stack",
-          "example": "cedar-14",
+          "example": "heroku-18",
           "readOnly": true,
           "type": [
             "string"
@@ -17679,8 +17822,195 @@ module PlatformAPI
         "updated_at": {
           "$ref": "#/definitions/app/definitions/updated_at"
         },
-        "web_url": {
-          "$ref": "#/definitions/app/definitions/web_url"
+        "web_url": {
+          "$ref": "#/definitions/app/definitions/web_url"
+        }
+      }
+    },
+    "team-daily-usage": {
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "description": "Usage for an enterprise team at a daily resolution.",
+      "stability": "development",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Team Daily Usage",
+      "type": [
+        "object"
+      ],
+      "definitions": {
+        "addons": {
+          "description": "total add-on credits used",
+          "example": 250.0,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
+        "app_usage_daily": {
+          "description": "Usage for an app at a daily resolution.",
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "addons": {
+              "$ref": "#/definitions/team-daily-usage/definitions/addons"
+            },
+            "app_name": {
+              "$ref": "#/definitions/app/definitions/name"
+            },
+            "data": {
+              "$ref": "#/definitions/team-daily-usage/definitions/data"
+            },
+            "dynos": {
+              "$ref": "#/definitions/team-daily-usage/definitions/dynos"
+            },
+            "partner": {
+              "$ref": "#/definitions/team-daily-usage/definitions/partner"
+            }
+          }
+        },
+        "data": {
+          "description": "total add-on credits used for first party add-ons",
+          "example": 34.89,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
+        "date": {
+          "description": "date of the usage",
+          "example": "2019-01-01",
+          "format": "date",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "dynos": {
+          "description": "dynos used",
+          "example": 1.548,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
+        "id": {
+          "description": "team identifier",
+          "example": "01234567-89ab-cdef-0123-456789abcdef",
+          "format": "uuid",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "name": {
+          "description": "name of the team",
+          "example": "ops",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "partner": {
+          "description": "total add-on credits used for third party add-ons",
+          "example": 12.34,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
+        "space": {
+          "description": "space credits used",
+          "example": 1.548,
+          "readOnly": true,
+          "type": [
+            "number"
+          ]
+        },
+        "start_date": {
+          "description": "range start date",
+          "example": "2019-01-25",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "end_date": {
+          "description": "range end date",
+          "example": "2019-02-25",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        }
+      },
+      "links": [
+        {
+          "description": "Retrieves usage for an enterprise team for a range of days. Start and end dates can be specified as query parameters using the date format YYYY-MM-DD. The team identifier can be found from the [team list endpoint](https://devcenter.heroku.com/articles/platform-api-reference#team-list).\n",
+          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fid)}/usage/daily",
+          "method": "GET",
+          "title": "Info",
+          "schema": {
+            "properties": {
+              "start": {
+                "$ref": "#/definitions/team-daily-usage/definitions/start_date"
+              },
+              "end": {
+                "$ref": "#/definitions/team-daily-usage/definitions/end_date"
+              }
+            },
+            "required": [
+              "start"
+            ],
+            "type": [
+              "object"
+            ]
+          },
+          "rel": "instances",
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/team-daily-usage"
+            },
+            "type": [
+              "array"
+            ]
+          }
+        }
+      ],
+      "properties": {
+        "addons": {
+          "$ref": "#/definitions/team-daily-usage/definitions/addons"
+        },
+        "apps": {
+          "description": "app usage in the team",
+          "type": [
+            "array"
+          ],
+          "items": {
+            "$ref": "#/definitions/team-daily-usage/definitions/app_usage_daily"
+          }
+        },
+        "data": {
+          "$ref": "#/definitions/team-daily-usage/definitions/data"
+        },
+        "date": {
+          "$ref": "#/definitions/team-daily-usage/definitions/date"
+        },
+        "dynos": {
+          "$ref": "#/definitions/team-daily-usage/definitions/dynos"
+        },
+        "id": {
+          "$ref": "#/definitions/team-daily-usage/definitions/id"
+        },
+        "name": {
+          "$ref": "#/definitions/team-daily-usage/definitions/name"
+        },
+        "partner": {
+          "$ref": "#/definitions/team-daily-usage/definitions/partner"
+        },
+        "space": {
+          "$ref": "#/definitions/team-daily-usage/definitions/space"
         }
       }
     },
@@ -18566,266 +18896,7 @@ module PlatformAPI
         }
       }
     },
-    "team-preferences": {
-      "description": "Tracks a Team's Preferences",
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "stability": "development",
-      "strictProperties": true,
-      "title": "Heroku Platform API - Team Preferences",
-      "type": [
-        "object"
-      ],
-      "definitions": {
-        "default-permission": {
-          "description": "The default permission used when adding new members to the team",
-          "example": "member",
-          "readOnly": false,
-          "enum": [
-            "admin",
-            "member",
-            "viewer",
-            null
-          ],
-          "type": [
-            "null",
-            "string"
-          ]
-        },
-        "identity": {
-          "$ref": "#/definitions/team/definitions/identity"
-        },
-        "whitelisting-enabled": {
-          "description": "Whether whitelisting rules should be applied to add-on installations",
-          "example": true,
-          "readOnly": false,
-          "type": [
-            "boolean",
-            "null"
-          ]
-        }
-      },
-      "links": [
-        {
-          "description": "Retrieve Team Preferences",
-          "href": "/teams/{(%23%2Fdefinitions%2Fteam-preferences%2Fdefinitions%2Fidentity)}/preferences",
-          "method": "GET",
-          "rel": "self",
-          "targetSchema": {
-            "$ref": "#/definitions/team-preferences"
-          },
-          "title": "List"
-        },
-        {
-          "description": "Update Team Preferences",
-          "href": "/teams/{(%23%2Fdefinitions%2Fteam-preferences%2Fdefinitions%2Fidentity)}/preferences",
-          "method": "PATCH",
-          "rel": "update",
-          "schema": {
-            "type": [
-              "object"
-            ],
-            "properties": {
-              "whitelisting-enabled": {
-                "$ref": "#/definitions/team-preferences/definitions/whitelisting-enabled"
-              }
-            }
-          },
-          "targetSchema": {
-            "$ref": "#/definitions/team-preferences"
-          },
-          "title": "Update"
-        }
-      ],
-      "properties": {
-        "default-permission": {
-          "$ref": "#/definitions/team-preferences/definitions/default-permission"
-        },
-        "whitelisting-enabled": {
-          "$ref": "#/definitions/team-preferences/definitions/whitelisting-enabled"
-        }
-      }
-    },
-    "team-space": {
-      "description": "A space is an isolated, highly available, secure app execution environments, running in the modern VPC substrate.",
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "stability": "prototype",
-      "strictProperties": true,
-      "title": "Heroku Platform API - Space",
-      "type": [
-        "object"
-      ],
-      "links": [
-        {
-          "description": "List spaces owned by the team",
-          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/spaces",
-          "method": "GET",
-          "rel": "instances",
-          "targetSchema": {
-            "items": {
-              "$ref": "#/definitions/space"
-            },
-            "type": [
-              "array"
-            ]
-          },
-          "title": "List"
-        }
-      ]
-    },
-    "team-usage-daily": {
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "description": "Usage for an enterprise team at a daily resolution.",
-      "stability": "development",
-      "strictProperties": true,
-      "title": "Heroku Platform API - Team Daily Usage",
-      "type": [
-        "object"
-      ],
-      "definitions": {
-        "addons": {
-          "description": "total add-on credits used",
-          "example": 250.0,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        },
-        "app_usage_daily": {
-          "description": "Usage for an app at a daily resolution.",
-          "type": [
-            "object"
-          ],
-          "properties": {
-            "addons": {
-              "$ref": "#/definitions/team-usage-daily/definitions/addons"
-            },
-            "app_name": {
-              "$ref": "#/definitions/app/definitions/name"
-            },
-            "data": {
-              "$ref": "#/definitions/team-usage-daily/definitions/data"
-            },
-            "dynos": {
-              "$ref": "#/definitions/team-usage-daily/definitions/dynos"
-            },
-            "partner": {
-              "$ref": "#/definitions/team-usage-daily/definitions/partner"
-            }
-          }
-        },
-        "data": {
-          "description": "total add-on credits used for first party add-ons",
-          "example": 34.89,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        },
-        "date": {
-          "description": "date of the usage",
-          "example": "2019-01-01",
-          "format": "date",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "dynos": {
-          "description": "dynos used",
-          "example": 1.548,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        },
-        "id": {
-          "description": "team identifier",
-          "example": "01234567-89ab-cdef-0123-456789abcdef",
-          "format": "uuid",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "name": {
-          "description": "name of the team",
-          "example": "ops",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "partner": {
-          "description": "total add-on credits used for third party add-ons",
-          "example": 12.34,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        },
-        "space": {
-          "description": "space credits used",
-          "example": 1.548,
-          "readOnly": true,
-          "type": [
-            "number"
-          ]
-        }
-      },
-      "links": [
-        {
-          "description": "Retrieves usage for an enterprise team for a range of days. Start and end dates can be specified as query parameters using the date format, YYYY-MM-DD format. For example, '/teams/example-team/usage?start=2019-01-01&end=2019-01-31' specifies all days in January for 2019.",
-          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fid)}/usage/daily",
-          "method": "GET",
-          "title": "Info",
-          "rel": "instances",
-          "targetSchema": {
-            "items": {
-              "$ref": "#/definitions/team-usage-daily"
-            },
-            "type": [
-              "array"
-            ]
-          }
-        }
-      ],
-      "properties": {
-        "addons": {
-          "$ref": "#/definitions/team-usage-daily/definitions/addons"
-        },
-        "apps": {
-          "description": "app usage in the team",
-          "type": [
-            "array"
-          ],
-          "items": {
-            "$ref": "#/definitions/team-usage-daily/definitions/app_usage_daily"
-          }
-        },
-        "data": {
-          "$ref": "#/definitions/team-usage-daily/definitions/data"
-        },
-        "date": {
-          "$ref": "#/definitions/team-usage-daily/definitions/date"
-        },
-        "dynos": {
-          "$ref": "#/definitions/team-usage-daily/definitions/dynos"
-        },
-        "id": {
-          "$ref": "#/definitions/team-usage-daily/definitions/id"
-        },
-        "name": {
-          "$ref": "#/definitions/team-usage-daily/definitions/name"
-        },
-        "partner": {
-          "$ref": "#/definitions/team-usage-daily/definitions/partner"
-        },
-        "space": {
-          "$ref": "#/definitions/team-usage-daily/definitions/space"
-        }
-      }
-    },
-    "team-usage-monthly": {
+    "team-monthly-usage": {
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "description": "Usage for an enterprise team at a monthly resolution.",
       "stability": "development",
@@ -18850,19 +18921,19 @@ module PlatformAPI
           ],
           "properties": {
             "addons": {
-              "$ref": "#/definitions/team-usage-monthly/definitions/addons"
+              "$ref": "#/definitions/team-monthly-usage/definitions/addons"
             },
             "app_name": {
               "$ref": "#/definitions/app/definitions/name"
             },
             "data": {
-              "$ref": "#/definitions/team-usage-monthly/definitions/data"
+              "$ref": "#/definitions/team-monthly-usage/definitions/data"
             },
             "dynos": {
-              "$ref": "#/definitions/team-usage-monthly/definitions/dynos"
+              "$ref": "#/definitions/team-monthly-usage/definitions/dynos"
             },
             "partner": {
-              "$ref": "#/definitions/team-usage-monthly/definitions/partner"
+              "$ref": "#/definitions/team-monthly-usage/definitions/partner"
             }
           }
         },
@@ -18931,18 +19002,52 @@ module PlatformAPI
           "type": [
             "number"
           ]
+        },
+        "start_date": {
+          "description": "range start date",
+          "example": "2019-01",
+          "pattern": "^[0-9]{4}-[0-9]{2}$",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "end_date": {
+          "description": "range end date",
+          "example": "2019-02",
+          "pattern": "^[0-9]{4}-[0-9]{2}$",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
         }
       },
       "links": [
         {
-          "description": "Retrieves usage for an enterprise team for a range of months. Start and end dates can be specified as query parameters using the date format, YYYY-MM format. For example, '/teams/example-team/usage?start=2019-01&end=2019-02' specifies usage in January and February for 2019. If no end date is specified, one month of usage is returned.",
+          "description": "Retrieves usage for an enterprise team for a range of months. Start and end dates can be specified as query parameters using the date, YYYY-MM. If no end date is specified, one month of usage is returned. The team identifier can be found from the [team list endpoint](https://devcenter.heroku.com/articles/platform-api-reference#team-list).\n",
           "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fid)}/usage/monthly",
           "method": "GET",
+          "title": "Info",
+          "schema": {
+            "properties": {
+              "start": {
+                "$ref": "#/definitions/team-monthly-usage/definitions/start_date"
+              },
+              "end": {
+                "$ref": "#/definitions/team-monthly-usage/definitions/end_date"
+              }
+            },
+            "required": [
+              "start"
+            ],
+            "type": [
+              "object"
+            ]
+          },
           "rel": "instances",
-          "title": "Info",
           "targetSchema": {
             "items": {
-              "$ref": "#/definitions/team-usage-monthly"
+              "$ref": "#/definitions/team-monthly-usage"
             },
             "type": [
               "array"
@@ -18952,7 +19057,7 @@ module PlatformAPI
       ],
       "properties": {
         "addons": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/addons"
+          "$ref": "#/definitions/team-monthly-usage/definitions/addons"
         },
         "apps": {
           "description": "app usage in the team",
@@ -18960,35 +19065,141 @@ module PlatformAPI
             "array"
           ],
           "items": {
-            "$ref": "#/definitions/team-usage-monthly/definitions/app_usage_monthly"
+            "$ref": "#/definitions/team-monthly-usage/definitions/app_usage_monthly"
           }
         },
         "connect": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/connect"
+          "$ref": "#/definitions/team-monthly-usage/definitions/connect"
         },
         "data": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/data"
+          "$ref": "#/definitions/team-monthly-usage/definitions/data"
         },
         "dynos": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/dynos"
+          "$ref": "#/definitions/team-monthly-usage/definitions/dynos"
         },
         "id": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/id"
+          "$ref": "#/definitions/team-monthly-usage/definitions/id"
         },
         "month": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/month"
+          "$ref": "#/definitions/team-monthly-usage/definitions/month"
         },
         "name": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/name"
+          "$ref": "#/definitions/team-monthly-usage/definitions/name"
         },
         "partner": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/partner"
+          "$ref": "#/definitions/team-monthly-usage/definitions/partner"
         },
         "space": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/space"
+          "$ref": "#/definitions/team-monthly-usage/definitions/space"
+        }
+      }
+    },
+    "team-preferences": {
+      "description": "Tracks a Team's Preferences",
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "stability": "development",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Team Preferences",
+      "type": [
+        "object"
+      ],
+      "definitions": {
+        "default-permission": {
+          "description": "The default permission used when adding new members to the team",
+          "example": "member",
+          "readOnly": false,
+          "enum": [
+            "admin",
+            "member",
+            "viewer",
+            null
+          ],
+          "type": [
+            "null",
+            "string"
+          ]
+        },
+        "identity": {
+          "$ref": "#/definitions/team/definitions/identity"
+        },
+        "addons-controls": {
+          "description": "Whether add-on service rules should be applied to add-on installations",
+          "example": true,
+          "readOnly": false,
+          "type": [
+            "boolean",
+            "null"
+          ]
+        }
+      },
+      "links": [
+        {
+          "description": "Retrieve Team Preferences",
+          "href": "/teams/{(%23%2Fdefinitions%2Fteam-preferences%2Fdefinitions%2Fidentity)}/preferences",
+          "method": "GET",
+          "rel": "self",
+          "targetSchema": {
+            "$ref": "#/definitions/team-preferences"
+          },
+          "title": "List"
+        },
+        {
+          "description": "Update Team Preferences",
+          "href": "/teams/{(%23%2Fdefinitions%2Fteam-preferences%2Fdefinitions%2Fidentity)}/preferences",
+          "method": "PATCH",
+          "rel": "update",
+          "schema": {
+            "type": [
+              "object"
+            ],
+            "properties": {
+              "addons-controls": {
+                "$ref": "#/definitions/team-preferences/definitions/addons-controls"
+              }
+            }
+          },
+          "targetSchema": {
+            "$ref": "#/definitions/team-preferences"
+          },
+          "title": "Update"
+        }
+      ],
+      "properties": {
+        "default-permission": {
+          "$ref": "#/definitions/team-preferences/definitions/default-permission"
+        },
+        "addons-controls": {
+          "$ref": "#/definitions/team-preferences/definitions/addons-controls"
         }
       }
     },
+    "team-space": {
+      "description": "A space is an isolated, highly available, secure app execution environment.",
+      "$schema": "http://json-schema.org/draft-04/hyper-schema",
+      "stability": "prototype",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Team Space",
+      "type": [
+        "object"
+      ],
+      "links": [
+        {
+          "description": "List spaces owned by the team",
+          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/spaces",
+          "method": "GET",
+          "rel": "instances",
+          "targetSchema": {
+            "items": {
+              "$ref": "#/definitions/space"
+            },
+            "type": [
+              "array"
+            ]
+          },
+          "title": "List"
+        }
+      ]
+    },
     "team": {
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "description": "Teams allow you to manage access to a shared group of applications and other resources.",
@@ -19068,12 +19279,11 @@ module PlatformAPI
             "id": {
               "$ref": "#/definitions/identity-provider/definitions/id"
             },
-            "slug": {
-              "description": "user-friendly unique identifier for this identity provider",
-              "example": "acme-sso",
-              "type": [
-                "string"
-              ]
+            "name": {
+              "$ref": "#/definitions/identity-provider/definitions/name"
+            },
+            "owner": {
+              "$ref": "#/definitions/identity-provider/definitions/owner"
             }
           }
         },
@@ -20567,159 +20777,31 @@ module PlatformAPI
             "$ref": "#/definitions/vpn-connection"
           },
           "title": "Info"
-        }
-      ]
-    },
-    "whitelisted-add-on-service": {
-      "description": "Entities that have been whitelisted to be used by an Team",
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "stability": "prototype",
-      "strictProperties": true,
-      "title": "Heroku Platform API - Whitelisted Entity",
-      "type": [
-        "object"
-      ],
-      "definitions": {
-        "added_at": {
-          "description": "when the add-on service was whitelisted",
-          "example": "2012-01-01T12:00:00Z",
-          "format": "date-time",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "added_by": {
-          "description": "the user which whitelisted the Add-on Service",
-          "properties": {
-            "email": {
-              "$ref": "#/definitions/account/definitions/email",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "id": {
-              "$ref": "#/definitions/account/definitions/id",
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "readOnly": true,
-          "type": [
-            "object"
-          ]
-        },
-        "addon_service": {
-          "description": "the Add-on Service whitelisted for use",
-          "properties": {
-            "id": {
-              "$ref": "#/definitions/add-on-service/definitions/id"
-            },
-            "name": {
-              "$ref": "#/definitions/add-on-service/definitions/name"
-            },
-            "human_name": {
-              "$ref": "#/definitions/add-on-service/definitions/human_name"
-            }
-          },
-          "readOnly": true,
-          "type": [
-            "object"
-          ]
-        },
-        "id": {
-          "description": "unique identifier for this whitelisting entity",
-          "example": "01234567-89ab-cdef-0123-456789abcdef",
-          "format": "uuid",
-          "readOnly": true,
-          "type": [
-            "string"
-          ]
-        },
-        "identity": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/whitelisted-add-on-service/definitions/id"
-            },
-            {
-              "$ref": "#/definitions/add-on-service/definitions/name"
-            }
-          ]
-        }
-      },
-      "links": [
-        {
-          "description": "List all whitelisted Add-on Services for an Team",
-          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/whitelisted-addon-services",
-          "method": "GET",
-          "rel": "instances",
-          "targetSchema": {
-            "items": {
-              "$ref": "#/definitions/whitelisted-add-on-service"
-            },
-            "type": [
-              "array"
-            ]
-          },
-          "title": "List By Team"
         },
         {
-          "description": "Whitelist an Add-on Service",
-          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/whitelisted-addon-services",
-          "method": "POST",
-          "rel": "create",
+          "description": "Update a VPN connection in a private space.",
+          "href": "/spaces/{(%23%2Fdefinitions%2Fspace%2Fdefinitions%2Fidentity)}/vpn-connections/{(%23%2Fdefinitions%2Fvpn-connection%2Fdefinitions%2Fidentity)}",
+          "rel": "update",
           "schema": {
-            "type": [
-              "object"
-            ],
             "properties": {
-              "addon_service": {
-                "description": "name of the Add-on to whitelist",
-                "example": "heroku-postgresql",
-                "type": [
-                  "string"
-                ]
+              "routable_cidrs": {
+                "$ref": "#/definitions/vpn-connection/definitions/routable_cidrs"
               }
-            }
-          },
-          "targetSchema": {
-            "items": {
-              "$ref": "#/definitions/whitelisted-add-on-service"
             },
+            "required": [
+              "routable_cidrs"
+            ],
             "type": [
-              "array"
+              "object"
             ]
           },
-          "title": "Create By Team"
-        },
-        {
-          "description": "Remove a whitelisted entity",
-          "href": "/teams/{(%23%2Fdefinitions%2Fteam%2Fdefinitions%2Fidentity)}/whitelisted-addon-services/{(%23%2Fdefinitions%2Fwhitelisted-add-on-service%2Fdefinitions%2Fidentity)}",
-          "method": "DELETE",
-          "rel": "destroy",
           "targetSchema": {
-            "$ref": "#/definitions/whitelisted-add-on-service"
+            "$ref": "#/definitions/vpn-connection"
           },
-          "title": "Delete By Team"
-        }
-      ],
-      "properties": {
-        "added_at": {
-          "$ref": "#/definitions/whitelisted-add-on-service/definitions/added_at"
-        },
-        "added_by": {
-          "$ref": "#/definitions/whitelisted-add-on-service/definitions/added_by"
-        },
-        "addon_service": {
-          "$ref": "#/definitions/whitelisted-add-on-service/definitions/addon_service"
-        },
-        "id": {
-          "$ref": "#/definitions/whitelisted-add-on-service/definitions/id"
+          "method": "PATCH",
+          "title": "Update"
         }
-      }
+      ]
     }
   },
   "properties": {
@@ -20759,6 +20841,9 @@ module PlatformAPI
     "add-on": {
       "$ref": "#/definitions/add-on"
     },
+    "allowed-add-on-service": {
+      "$ref": "#/definitions/allowed-add-on-service"
+    },
     "app-feature": {
       "$ref": "#/definitions/app-feature"
     },
@@ -20813,14 +20898,14 @@ module PlatformAPI
     "dyno": {
       "$ref": "#/definitions/dyno"
     },
+    "enterprise-account-daily-usage": {
+      "$ref": "#/definitions/enterprise-account-daily-usage"
+    },
     "enterprise-account-member": {
       "$ref": "#/definitions/enterprise-account-member"
     },
-    "enterprise-account-usage-daily": {
-      "$ref": "#/definitions/enterprise-account-usage-daily"
-    },
-    "enterprise-account-usage-monthly": {
-      "$ref": "#/definitions/enterprise-account-usage-monthly"
+    "enterprise-account-monthly-usage": {
+      "$ref": "#/definitions/enterprise-account-monthly-usage"
     },
     "enterprise-account": {
       "$ref": "#/definitions/enterprise-account"
@@ -20954,9 +21039,6 @@ module PlatformAPI
     "space": {
       "$ref": "#/definitions/space"
     },
-    "ssl-endpoint": {
-      "$ref": "#/definitions/ssl-endpoint"
-    },
     "stack": {
       "$ref": "#/definitions/stack"
     },
@@ -20972,6 +21054,9 @@ module PlatformAPI
     "team-app": {
       "$ref": "#/definitions/team-app"
     },
+    "team-daily-usage": {
+      "$ref": "#/definitions/team-daily-usage"
+    },
     "team-feature": {
       "$ref": "#/definitions/team-feature"
     },
@@ -20984,18 +21069,15 @@ module PlatformAPI
     "team-member": {
       "$ref": "#/definitions/team-member"
     },
+    "team-monthly-usage": {
+      "$ref": "#/definitions/team-monthly-usage"
+    },
     "team-preferences": {
       "$ref": "#/definitions/team-preferences"
     },
     "team-space": {
       "$ref": "#/definitions/team-space"
     },
-    "team-usage-daily": {
-      "$ref": "#/definitions/team-usage-daily"
-    },
-    "team-usage-monthly": {
-      "$ref": "#/definitions/team-usage-monthly"
-    },
     "team": {
       "$ref": "#/definitions/team"
     },
@@ -21013,9 +21095,6 @@ module PlatformAPI
     },
     "vpn-connection": {
       "$ref": "#/definitions/vpn-connection"
-    },
-    "whitelisted-add-on-service": {
-      "$ref": "#/definitions/whitelisted-add-on-service"
     }
   },
   "description": "The platform API empowers developers to automate, extend and combine Heroku with other services.",