platform-api 3.0.0 → 3.5.0

data/schema.json

@@ -228,6 +228,15 @@
             "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",
@@ -399,7 +408,7 @@
           "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",
@@ -445,7 +454,7 @@
           "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",
@@ -476,10 +485,14 @@
         },
         "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"
@@ -501,46 +514,7 @@
               }
             },
             "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": [
@@ -572,6 +546,9 @@
         "verified": {
           "$ref": "#/definitions/account/definitions/verified"
         },
+        "country_of_residence": {
+          "$ref": "#/definitions/account/definitions/country_of_residence"
+        },
         "default_organization": {
           "description": "team selected by default",
           "properties": {
@@ -607,7 +584,7 @@
       }
     },
     "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,
@@ -2140,6 +2117,157 @@
         }
       }
     },
+    "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": "prototype",
+      "strictProperties": true,
+      "title": "Heroku Platform API - Allowed Add-on Service",
+      "type": [
+        "object"
+      ],
+      "definitions": {
+        "added_at": {
+          "description": "when the add-on service was allowed",
+          "example": "2012-01-01T12:00:00Z",
+          "format": "date-time",
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
+        "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": [
+            "object"
+          ]
+        },
+        "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",
@@ -3743,6 +3871,15 @@
               },
               "stack": {
                 "$ref": "#/definitions/stack/definitions/identity"
+              },
+              "feature_flags": {
+                "description": "unique name of app feature",
+                "type": [
+                  "array"
+                ],
+                "items": {
+                  "$ref": "#/definitions/app-feature/definitions/name"
+                }
               }
             },
             "type": [
@@ -4028,7 +4165,7 @@
       "$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"
@@ -4047,12 +4184,24 @@
         },
         "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": {
@@ -4135,7 +4284,7 @@
       "$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"
@@ -4149,13 +4298,6 @@
             "string"
           ]
         },
-        "identity": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/audit-trail-event/definitions/id"
-            }
-          ]
-        },
         "type": {
           "description": "type of event",
           "readOnly": true,
@@ -4304,7 +4446,7 @@
       },
       "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",
@@ -5309,6 +5451,13 @@
           "type": [
             "string"
           ]
+        },
+        "sni_endpoint": {
+          "description": "null or unique identifier or name for SNI endpoint",
+          "type": [
+            "null",
+            "string"
+          ]
         }
       },
       "links": [
@@ -5321,10 +5470,14 @@
             "properties": {
               "hostname": {
                 "$ref": "#/definitions/domain/definitions/hostname"
+              },
+              "sni_endpoint": {
+                "$ref": "#/definitions/domain/definitions/sni_endpoint"
               }
             },
             "required": [
-              "hostname"
+              "hostname",
+              "sni_endpoint"
             ],
             "type": [
               "object"
@@ -5335,6 +5488,29 @@
           },
           "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)}",
@@ -5412,6 +5588,21 @@
         },
         "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"
+          ]
         }
       }
     },
@@ -5881,44 +6072,242 @@
         }
       }
     },
-    "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": {
-        "id": {
-          "description": "unique identifier of the member",
-          "example": "01234567-89ab-cdef-0123-456789abcdef",
-          "format": "uuid",
+        "addons": {
+          "description": "total add-on credits used",
+          "example": 250.0,
           "readOnly": true,
           "type": [
-            "string"
-          ]
-        },
-        "identity": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/enterprise-account-member/definitions/id"
-            }
+            "number"
           ]
         },
-        "permission": {
-          "description": "permission in the enterprise account",
-          "enum": [
-            "view",
-            "create",
-            "manage",
-            "billing"
-          ],
-          "example": "view",
+        "data": {
+          "description": "total add-on credits used for first party add-ons",
+          "example": 34.89,
           "readOnly": true,
           "type": [
-            "string"
+            "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"
+          ]
+        },
+        "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": {
@@ -6134,171 +6523,7 @@
         }
       }
     },
-    "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",
@@ -6381,18 +6606,52 @@
           "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"
@@ -6402,7 +6661,7 @@
       ],
       "properties": {
         "addons": {
-          "$ref": "#/definitions/enterprise-account-usage-monthly/definitions/addons"
+          "$ref": "#/definitions/enterprise-account-monthly-usage/definitions/addons"
         },
         "teams": {
           "description": "usage by team",
@@ -6415,7 +6674,7 @@
             ],
             "properties": {
               "addons": {
-                "$ref": "#/definitions/team-usage-monthly/definitions/addons"
+                "$ref": "#/definitions/team-monthly-usage/definitions/addons"
               },
               "apps": {
                 "description": "app usage in the team",
@@ -6423,56 +6682,56 @@
                   "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"
         }
       }
     },
@@ -6511,6 +6770,25 @@
             }
           ]
         },
+        "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",
@@ -6613,27 +6891,7 @@
           "$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"
         }
       }
     },
@@ -6930,7 +7188,7 @@
       }
     },
     "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,
@@ -6973,6 +7231,13 @@
             "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",
@@ -9515,7 +9780,7 @@
       "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": {
@@ -9865,7 +10130,7 @@
       "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": {
@@ -10214,7 +10479,7 @@
       "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": {
@@ -10241,7 +10506,7 @@
       "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": {
@@ -10550,11 +10815,11 @@
           "targetSchema": {
             "items": {
               "$ref": "#/definitions/pipeline"
-            }
+            },
+            "type": [
+              "array"
+            ]
           },
-          "type": [
-            "array"
-          ],
           "title": "List"
         }
       ],
@@ -12122,7 +12387,7 @@
               "size": 2048,
               "stack": {
                 "id": "01234567-89ab-cdef-0123-456789abcdef",
-                "name": "cedar-14"
+                "name": "heroku-18"
               },
               "updated_at": "2012-01-01T12:00:00Z"
             }
@@ -12252,17 +12517,21 @@
         "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"
@@ -12277,6 +12546,33 @@
             "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",
@@ -12296,6 +12592,12 @@
             }
           ]
         },
+        "issuer": {
+          "readOnly": true,
+          "type": [
+            "string"
+          ]
+        },
         "name": {
           "description": "unique name for SNI endpoint",
           "example": "example",
@@ -12313,6 +12615,25 @@
             "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",
@@ -12418,9 +12739,6 @@
         "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"
         },
@@ -12432,6 +12750,65 @@
         },
         "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"
+              ]
+            }
+          }
         }
       }
     },
@@ -12790,7 +13167,10 @@
                 "string"
               ]
             }
-          }
+          },
+          "type": [
+            "object"
+          ]
         },
         "formation": {
           "description": "formations for application",
@@ -12912,7 +13292,7 @@
       ]
     },
     "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,
@@ -12988,6 +13368,13 @@
             "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",
@@ -13059,333 +13446,117 @@
           "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"
         }
       }
     },
@@ -13437,7 +13608,7 @@
         },
         "name": {
           "description": "unique name of stack",
-          "example": "cedar-14",
+          "example": "heroku-18",
           "readOnly": true,
           "type": [
             "string"
@@ -14074,8 +14245,195 @@
         "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"
         }
       }
     },
@@ -14961,266 +15319,7 @@
         }
       }
     },
-    "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",
@@ -15245,19 +15344,19 @@
           ],
           "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"
             }
           }
         },
@@ -15326,18 +15425,52 @@
           "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"
@@ -15347,7 +15480,7 @@
       ],
       "properties": {
         "addons": {
-          "$ref": "#/definitions/team-usage-monthly/definitions/addons"
+          "$ref": "#/definitions/team-monthly-usage/definitions/addons"
         },
         "apps": {
           "description": "app usage in the team",
@@ -15355,35 +15488,141 @@
             "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.",
@@ -15463,12 +15702,11 @@
             "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"
             }
           }
         },
@@ -16962,159 +17200,31 @@
             "$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": {
@@ -17154,6 +17264,9 @@
     "add-on": {
       "$ref": "#/definitions/add-on"
     },
+    "allowed-add-on-service": {
+      "$ref": "#/definitions/allowed-add-on-service"
+    },
     "app-feature": {
       "$ref": "#/definitions/app-feature"
     },
@@ -17208,14 +17321,14 @@
     "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"
@@ -17349,9 +17462,6 @@
     "space": {
       "$ref": "#/definitions/space"
     },
-    "ssl-endpoint": {
-      "$ref": "#/definitions/ssl-endpoint"
-    },
     "stack": {
       "$ref": "#/definitions/stack"
     },
@@ -17367,6 +17477,9 @@
     "team-app": {
       "$ref": "#/definitions/team-app"
     },
+    "team-daily-usage": {
+      "$ref": "#/definitions/team-daily-usage"
+    },
     "team-feature": {
       "$ref": "#/definitions/team-feature"
     },
@@ -17379,18 +17492,15 @@
     "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"
     },
@@ -17408,9 +17518,6 @@
     },
     "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.",