heroku 9.3.3-beta.0 → 9.4.0

package/oclif.manifest.json

@@ -298,6 +298,7 @@
       "aliases": [],
       "args": {
         "email": {
+          "description": "email address of the team member",
           "name": "email",
           "required": true
         }
@@ -439,6 +440,7 @@
       "aliases": [],
       "args": {
         "email": {
+          "description": "email address of the team member",
           "name": "email",
           "required": true
         }
@@ -488,122 +490,125 @@
         "update.js"
       ]
     },
-    "addons:attach": {
+    "apps:create": {
       "aliases": [],
       "args": {
-        "addon_name": {
-          "name": "addon_name",
-          "required": true
+        "app": {
+          "description": "name of app to create",
+          "name": "app",
+          "required": false
         }
       },
-      "description": "attach an existing add-on resource to an app",
+      "description": "creates a new app",
+      "examples": [
+        "$ heroku apps:create\nCreating app... done, stack is heroku-24\nhttps://floating-dragon-42.heroku.com/ | https://git.heroku.com/floating-dragon-42.git\n\n# or just\n$ heroku create\n\n# use a heroku.yml manifest file\n$ heroku apps:create --manifest\n\n# specify a buildpack\n$ heroku apps:create --buildpack https://github.com/some/buildpack.git\n\n# specify a name\n$ heroku apps:create example\n\n# create a staging app\n$ heroku apps:create example-staging --remote staging\n\n# create an app in the eu region\n$ heroku apps:create --region eu"
+      ],
       "flags": {
-        "as": {
-          "description": "name for add-on attachment",
-          "name": "as",
+        "app": {
+          "hidden": true,
+          "name": "app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "credential": {
-          "description": "credential name for scoped access to Heroku Postgres",
-          "name": "credential",
+        "addons": {
+          "description": "comma-delimited list of addons to install",
+          "name": "addons",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "confirm": {
-          "description": "overwrite existing add-on attachment with same name",
-          "name": "confirm",
+        "buildpack": {
+          "char": "b",
+          "description": "buildpack url to use for this app",
+          "name": "buildpack",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "manifest": {
+          "char": "m",
+          "description": "use heroku.yml settings for this app",
+          "hidden": true,
+          "name": "manifest",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-remote": {
+          "char": "n",
+          "description": "do not create a git remote",
+          "name": "no-remote",
+          "allowNo": false,
+          "type": "boolean"
         },
         "remote": {
           "char": "r",
-          "description": "git remote of app to use",
+          "description": "the git remote to create, default \"heroku\"",
           "name": "remote",
+          "default": "heroku",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:attach",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "addons",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "addons",
-        "attach.js"
-      ]
-    },
-    "addons:create": {
-      "aliases": [],
-      "args": {
-        "service:plan": {
-          "name": "service:plan",
-          "required": true
-        }
-      },
-      "description": "Create a new add-on resource.\n\nIn order to add additional config items, please place them at the end of the command after a double-dash (--).\n",
-      "examples": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
-      "flags": {
-        "name": {
-          "description": "name for the add-on resource",
-          "name": "name",
+        },
+        "stack": {
+          "char": "s",
+          "description": "the stack to create the app on",
+          "name": "stack",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "as": {
-          "description": "name for the initial add-on attachment",
-          "name": "as",
+        "space": {
+          "description": "the private space to create the app in",
+          "name": "space",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "confirm": {
-          "description": "overwrite existing config vars or existing add-on attachments",
-          "name": "confirm",
+        "region": {
+          "description": "specify region for the app to run in",
+          "name": "region",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "description": "watch add-on creation status and exit when complete",
-          "name": "wait",
+        "internal-routing": {
+          "description": "private space-only. create as an Internal Web App that is only routable in the local network.",
+          "hidden": true,
+          "name": "internal-routing",
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
+        "features": {
+          "hidden": true,
+          "name": "features",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
+        "kernel": {
+          "hidden": true,
+          "name": "kernel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "locked": {
+          "hidden": true,
+          "name": "locked",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "team": {
+          "char": "t",
+          "description": "team to use",
+          "name": "team",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -611,56 +616,31 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [
-        "addons:add"
+        "create"
       ],
-      "id": "addons:create",
+      "id": "apps:create",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": false,
-      "topic": "addons",
-      "example": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
+      "strict": true,
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
+        "apps",
         "create.js"
       ]
     },
-    "addons:destroy": {
+    "apps:destroy": {
       "aliases": [],
       "args": {
-        "addonName": {
-          "name": "addonName",
-          "required": true
+        "app": {
+          "hidden": true,
+          "name": "app"
         }
       },
-      "description": "permanently destroy an add-on resource",
-      "examples": [
-        "addons:destroy [ADDON]... [flags]"
-      ],
+      "description": "permanently destroy an app",
       "flags": {
-        "force": {
-          "char": "f",
-          "description": "allow destruction even if connected to other apps",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "confirm": {
-          "char": "c",
-          "name": "confirm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "description": "watch add-on destruction status and exit when complete",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -676,35 +656,38 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "confirm": {
+          "char": "c",
+          "name": "confirm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [
-        "addons:remove"
+        "destroy",
+        "apps:delete"
       ],
-      "id": "addons:destroy",
+      "id": "apps:destroy",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": false,
-      "topic": "addons",
+      "strict": true,
+      "help": "This will also destroy all add-ons on the app.",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
+        "apps",
         "destroy.js"
       ]
     },
-    "addons:detach": {
+    "apps:errors": {
       "aliases": [],
-      "args": {
-        "attachment_name": {
-          "name": "attachment_name",
-          "required": true
-        }
-      },
-      "description": "detach an existing add-on resource from an app",
+      "args": {},
+      "description": "view app errors",
       "flags": {
         "app": {
           "char": "a",
@@ -722,40 +705,136 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "json": {
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "hours": {
+          "description": "number of hours to look back (default 24)",
+          "name": "hours",
+          "default": "24",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "router": {
+          "description": "show only router errors",
+          "name": "router",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dyno": {
+          "description": "show only dyno errors",
+          "name": "dyno",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apps:errors",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "apps",
+        "errors.js"
+      ]
+    },
+    "apps": {
+      "aliases": [],
+      "args": {},
+      "description": "list your apps",
+      "examples": [
+        "$ heroku apps"
+      ],
+      "flags": {
+        "all": {
+          "char": "A",
+          "description": "include apps in all teams",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "char": "j",
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "space": {
+          "char": "s",
+          "description": "filter by space",
+          "name": "space",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "personal": {
+          "char": "p",
+          "description": "list apps in personal account when a default team is set",
+          "name": "personal",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "internal-routing": {
+          "char": "i",
+          "description": "filter to Internal Web Apps",
+          "hidden": true,
+          "name": "internal-routing",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "team": {
+          "char": "t",
+          "description": "team to use",
+          "name": "team",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:detach",
+      "hiddenAliases": [
+        "list",
+        "apps:list"
+      ],
+      "id": "apps",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "detach.js"
+        "apps",
+        "index.js"
       ]
     },
-    "addons:docs": {
+    "apps:info": {
       "aliases": [],
       "args": {
-        "addon": {
-          "name": "addon",
-          "required": true
+        "app": {
+          "hidden": true,
+          "name": "app"
         }
       },
-      "description": "open an add-on's Dev Center documentation in your browser",
+      "description": "show detailed app information",
+      "examples": [
+        "$ heroku apps:info",
+        "$ heroku apps:info --shell"
+      ],
       "flags": {
-        "show-url": {
-          "description": "show URL, do not open browser",
-          "name": "show-url",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -771,50 +850,60 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "shell": {
+          "char": "s",
+          "description": "output more shell friendly key/value pairs",
+          "name": "shell",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "extended": {
+          "char": "x",
+          "hidden": true,
+          "name": "extended",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "char": "j",
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:docs",
+      "hiddenAliases": [
+        "info"
+      ],
+      "id": "apps:info",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
+      "help": "$ heroku apps:info\n=== example\nGit URL:   https://git.heroku.com/example.git\nRepo Size: 5M\n...\n\n$ heroku apps:info --shell\ngit_url=https://git.heroku.com/example.git\nrepo_size=5000000\n...",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "docs.js"
+        "apps",
+        "info.js"
       ]
     },
-    "addons": {
-      "aliases": [],
-      "args": {},
-      "description": "Lists your add-ons and attachments.\n\n  The default filter applied depends on whether you are in a Heroku app\n  directory. If so, the --app flag is implied. If not, the default of --all\n  is implied. Explicitly providing either flag overrides the default\n  behavior.\n  ",
-      "examples": [
-        "$ heroku addons --all",
-        "$ heroku addons --app acme-inc-www"
+    "apps:join": {
+      "aliases": [
+        "join"
       ],
+      "args": {},
+      "description": "add yourself to a team app",
       "flags": {
-        "all": {
-          "char": "A",
-          "description": "show add-ons and attachments for all accessible apps",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "json": {
-          "description": "return add-ons in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -830,35 +919,33 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons",
+      "id": "apps:join",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "usage": "addons [--all|--app APP]",
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "index.js"
+        "apps",
+        "join.js"
       ]
     },
-    "addons:info": {
-      "aliases": [],
-      "args": {
-        "addon": {
-          "name": "addon",
-          "required": true
-        }
-      },
-      "description": "show detailed add-on resource and attachment information",
+    "apps:leave": {
+      "aliases": [
+        "leave"
+      ],
+      "args": {},
+      "description": "remove yourself from a team app",
+      "examples": "heroku apps:leave -a APP",
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -874,41 +961,33 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:info",
+      "id": "apps:leave",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "usage": "addons:info ADDON",
-      "topic": "addons",
+      "topic": "apps",
+      "example": "heroku apps:leave -a APP",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "info.js"
+        "apps",
+        "leave.js"
       ]
     },
-    "addons:open": {
-      "aliases": [],
-      "args": {
-        "addon": {
-          "name": "addon",
-          "required": true
-        }
-      },
-      "description": "open an add-on's dashboard in your browser",
+    "apps:lock": {
+      "aliases": [
+        "lock"
+      ],
+      "args": {},
+      "description": "prevent team members from joining an app",
       "flags": {
-        "show-url": {
-          "description": "show URL, do not open browser",
-          "name": "show-url",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -924,133 +1003,90 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:open",
+      "id": "apps:lock",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "open.js"
+        "apps",
+        "lock.js"
       ]
     },
-    "addons:plans": {
+    "apps:open": {
       "aliases": [],
       "args": {
-        "service": {
-          "name": "service",
-          "required": true
+        "path": {
+          "description": "base URL path of app",
+          "name": "path",
+          "required": false
         }
       },
-      "description": "list all available plans for an add-on service",
+      "description": "open the app in a web browser",
+      "examples": [
+        "$ heroku open -a myapp",
+        "$ heroku open -a myapp /foo"
+      ],
       "flags": {
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:plans",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "addons",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "addons",
-        "plans.js"
-      ]
-    },
-    "addons:rename": {
-      "aliases": [],
-      "args": {
-        "addon_name": {
-          "name": "addon_name",
-          "required": true
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "new_name": {
-          "name": "new_name",
-          "required": true
-        }
-      },
-      "description": "rename an add-on",
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:rename",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "addons",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "addons",
-        "rename.js"
-      ]
-    },
-    "addons:services": {
-      "aliases": [],
-      "args": {},
-      "description": "list all available add-on services",
-      "flags": {
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:services",
+      "hiddenAliases": [
+        "open"
+      ],
+      "id": "apps:open",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "services.js"
+        "apps",
+        "open.js"
       ]
     },
-    "addons:upgrade": {
-      "aliases": [
-        "addons:downgrade"
-      ],
+    "apps:rename": {
+      "aliases": [],
       "args": {
-        "addon": {
-          "name": "addon",
+        "newname": {
+          "description": "new unique name of the app",
+          "name": "newname",
           "required": true
-        },
-        "plan": {
-          "name": "plan"
         }
       },
-      "description": "change add-on plan.\n  See available plans with `heroku addons:plans SERVICE`.\n\n  Note that `heroku addons:upgrade` and `heroku addons:downgrade` are the same.  Either one can be used to change an add-on plan up or down.\n\n  https://devcenter.heroku.com/articles/managing-add-ons\n  ",
+      "description": "rename an app",
       "examples": [
-        "Upgrade an add-on by service name:\n$ heroku addons:upgrade heroku-redis:premium-2\n\nUpgrade a specific add-on:\n$ heroku addons:upgrade swimming-briskly-123 heroku-redis:premium-2"
+        "$ heroku apps:rename --app oldname newname"
       ],
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1065,36 +1101,52 @@
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:upgrade",
+      "hiddenAliases": [
+        "rename"
+      ],
+      "id": "apps:rename",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "help": "This will locally update the git remote if it is set to the old app.",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "upgrade.js"
+        "apps",
+        "rename.js"
       ]
     },
-    "addons:wait": {
+    "apps:transfer": {
       "aliases": [],
       "args": {
-        "addon": {
-          "name": "addon"
+        "recipient": {
+          "description": "user or team to transfer applications to",
+          "name": "recipient",
+          "required": true
         }
       },
-      "description": "show provisioning status of the add-ons on the app",
+      "description": "transfer applications to another user or team",
+      "examples": [
+        "$ heroku apps:transfer collaborator@example.com\nTransferring example to collaborator@example.com... done\n\n$ heroku apps:transfer acme-widgets\nTransferring example to acme-widgets... done\n\n$ heroku apps:transfer --bulk acme-widgets\n..."
+      ],
       "flags": {
-        "wait-interval": {
-          "description": "how frequently to poll in seconds",
-          "name": "wait-interval",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "locked": {
+          "char": "l",
+          "description": "lock the app upon transfer",
+          "name": "locked",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "bulk": {
+          "description": "transfer applications in bulk",
+          "name": "bulk",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         },
         "app": {
           "char": "a",
@@ -1111,223 +1163,178 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "confirm": {
+          "char": "c",
+          "hidden": true,
+          "name": "confirm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:wait",
+      "id": "apps:transfer",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "wait.js"
+        "apps",
+        "transfer.js"
       ]
     },
-    "apps:create": {
-      "aliases": [],
-      "args": {
-        "app": {
-          "description": "name of app to create",
-          "name": "app",
-          "required": false
-        }
-      },
-      "description": "creates a new app",
-      "examples": [
-        "$ heroku apps:create\nCreating app... done, stack is heroku-24\nhttps://floating-dragon-42.heroku.com/ | https://git.heroku.com/floating-dragon-42.git\n\n# or just\n$ heroku create\n\n# use a heroku.yml manifest file\n$ heroku apps:create --manifest\n\n# specify a buildpack\n$ heroku apps:create --buildpack https://github.com/some/buildpack.git\n\n# specify a name\n$ heroku apps:create example\n\n# create a staging app\n$ heroku apps:create example-staging --remote staging\n\n# create an app in the eu region\n$ heroku apps:create --region eu"
+    "apps:unlock": {
+      "aliases": [
+        "unlock"
       ],
+      "args": {},
+      "description": "unlock an app so any team member can join",
       "flags": {
         "app": {
-          "hidden": true,
+          "char": "a",
+          "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "addons": {
-          "description": "comma-delimited list of addons to install",
-          "name": "addons",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "buildpack": {
-          "char": "b",
-          "description": "buildpack url to use for this app",
-          "name": "buildpack",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "manifest": {
-          "char": "m",
-          "description": "use heroku.yml settings for this app",
-          "hidden": true,
-          "name": "manifest",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-remote": {
-          "char": "n",
-          "description": "do not create a git remote",
-          "name": "no-remote",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "remote": {
           "char": "r",
-          "description": "the git remote to create, default \"heroku\"",
+          "description": "git remote of app to use",
           "name": "remote",
-          "default": "heroku",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stack": {
-          "char": "s",
-          "description": "the stack to create the app on",
-          "name": "stack",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "space": {
-          "description": "the private space to create the app in",
-          "name": "space",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apps:unlock",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "apps",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "apps",
+        "unlock.js"
+      ]
+    },
+    "addons:attach": {
+      "aliases": [],
+      "args": {
+        "addon_name": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon_name",
+          "required": true
+        }
+      },
+      "description": "attach an existing add-on resource to an app",
+      "flags": {
+        "as": {
+          "description": "name for add-on attachment",
+          "name": "as",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "region": {
-          "description": "specify region for the app to run in",
-          "name": "region",
+        "credential": {
+          "description": "credential name for scoped access to Heroku Postgres",
+          "name": "credential",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "internal-routing": {
-          "description": "private space-only. create as an Internal Web App that is only routable in the local network.",
-          "hidden": true,
-          "name": "internal-routing",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "features": {
-          "hidden": true,
-          "name": "features",
+        "confirm": {
+          "description": "overwrite existing add-on attachment with same name",
+          "name": "confirm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "kernel": {
-          "hidden": true,
-          "name": "kernel",
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "locked": {
-          "hidden": true,
-          "name": "locked",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "team": {
-          "char": "t",
-          "description": "team to use",
-          "name": "team",
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "create"
-      ],
-      "id": "apps:create",
+      "hiddenAliases": [],
+      "id": "addons:attach",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "create.js"
+        "addons",
+        "attach.js"
       ]
     },
-    "apps:destroy": {
+    "addons:create": {
       "aliases": [],
       "args": {
-        "app": {
-          "hidden": true,
-          "name": "app"
+        "service:plan": {
+          "description": "unique identifier or unique name of the add-on service plan",
+          "name": "service:plan",
+          "required": true
         }
       },
-      "description": "permanently destroy an app",
+      "description": "Create a new add-on resource.\n\nIn order to add additional config items, please place them at the end of the command after a double-dash (--).\n",
+      "examples": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
       "flags": {
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
+        "name": {
+          "description": "name for the add-on resource",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
+        "as": {
+          "description": "name for the initial add-on attachment",
+          "name": "as",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "confirm": {
-          "char": "c",
+          "description": "overwrite existing config vars or existing add-on attachments",
           "name": "confirm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "destroy",
-        "apps:delete"
-      ],
-      "id": "apps:destroy",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "help": "This will also destroy all add-ons on the app.",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "apps",
-        "destroy.js"
-      ]
-    },
-    "apps:errors": {
-      "aliases": [],
-      "args": {},
-      "description": "view app errors",
-      "flags": {
+        },
+        "wait": {
+          "description": "watch add-on creation status and exit when complete",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -1344,98 +1351,73 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "hours": {
-          "description": "number of hours to look back (default 24)",
-          "name": "hours",
-          "default": "24",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "router": {
-          "description": "show only router errors",
-          "name": "router",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dyno": {
-          "description": "show only dyno errors",
-          "name": "dyno",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "apps:errors",
+      "hiddenAliases": [
+        "addons:add"
+      ],
+      "id": "addons:create",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
+      "topic": "addons",
+      "example": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "errors.js"
+        "addons",
+        "create.js"
       ]
     },
-    "apps": {
+    "addons:destroy": {
       "aliases": [],
-      "args": {},
-      "description": "list your apps",
+      "args": {
+        "addonName": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addonName",
+          "required": true
+        }
+      },
+      "description": "permanently destroy an add-on resource",
       "examples": [
-        "$ heroku apps"
+        "addons:destroy [ADDON]... [flags]"
       ],
       "flags": {
-        "all": {
-          "char": "A",
-          "description": "include apps in all teams",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "json": {
-          "char": "j",
-          "description": "output in json format",
-          "name": "json",
+        "force": {
+          "char": "f",
+          "description": "allow destruction even if connected to other apps",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         },
-        "space": {
-          "char": "s",
-          "description": "filter by space",
-          "name": "space",
+        "confirm": {
+          "char": "c",
+          "name": "confirm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "personal": {
-          "char": "p",
-          "description": "list apps in personal account when a default team is set",
-          "name": "personal",
+        "wait": {
+          "description": "watch add-on destruction status and exit when complete",
+          "name": "wait",
           "allowNo": false,
           "type": "boolean"
         },
-        "internal-routing": {
-          "char": "i",
-          "description": "filter to Internal Web Apps",
-          "hidden": true,
-          "name": "internal-routing",
-          "allowNo": false,
-          "type": "boolean"
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "team": {
-          "char": "t",
-          "description": "team to use",
-          "name": "team",
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1443,41 +1425,38 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [
-        "list",
-        "apps:list"
+        "addons:remove"
       ],
-      "id": "apps",
+      "id": "addons:destroy",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": true,
-      "topic": "apps",
+      "strict": false,
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "index.js"
+        "addons",
+        "destroy.js"
       ]
     },
-    "apps:info": {
+    "addons:detach": {
       "aliases": [],
       "args": {
-        "app": {
-          "hidden": true,
-          "name": "app"
+        "attachment_name": {
+          "description": "unique identifier of the add-on attachment",
+          "name": "attachment_name",
+          "required": true
         }
       },
-      "description": "show detailed app information",
-      "examples": [
-        "$ heroku apps:info",
-        "$ heroku apps:info --shell"
-      ],
+      "description": "detach an existing add-on resource from an app",
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1489,60 +1468,45 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "shell": {
-          "char": "s",
-          "description": "output more shell friendly key/value pairs",
-          "name": "shell",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "extended": {
-          "char": "x",
-          "hidden": true,
-          "name": "extended",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "json": {
-          "char": "j",
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "info"
-      ],
-      "id": "apps:info",
+      "hiddenAliases": [],
+      "id": "addons:detach",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
-      "help": "$ heroku apps:info\n=== example\nGit URL:   https://git.heroku.com/example.git\nRepo Size: 5M\n...\n\n$ heroku apps:info --shell\ngit_url=https://git.heroku.com/example.git\nrepo_size=5000000\n...",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "info.js"
+        "addons",
+        "detach.js"
       ]
     },
-    "apps:join": {
-      "aliases": [
-        "join"
-      ],
-      "args": {},
-      "description": "add yourself to a team app",
+    "addons:docs": {
+      "aliases": [],
+      "args": {
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon",
+          "required": true
+        }
+      },
+      "description": "open an add-on's Dev Center documentation in your browser",
       "flags": {
+        "show-url": {
+          "description": "show URL, do not open browser",
+          "name": "show-url",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1558,33 +1522,46 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:join",
+      "id": "addons:docs",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "join.js"
+        "addons",
+        "docs.js"
       ]
     },
-    "apps:leave": {
-      "aliases": [
-        "leave"
-      ],
+    "addons": {
+      "aliases": [],
       "args": {},
-      "description": "remove yourself from a team app",
-      "examples": "heroku apps:leave -a APP",
+      "description": "Lists your add-ons and attachments.\n\n  The default filter applied depends on whether you are in a Heroku app\n  directory. If so, the --app flag is implied. If not, the default of --all\n  is implied. Explicitly providing either flag overrides the default\n  behavior.\n  ",
+      "examples": [
+        "$ heroku addons --all",
+        "$ heroku addons --app acme-inc-www"
+      ],
       "flags": {
+        "all": {
+          "char": "A",
+          "description": "show add-ons and attachments for all accessible apps",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "return add-ons in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1600,33 +1577,36 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:leave",
+      "id": "addons",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
-      "example": "heroku apps:leave -a APP",
+      "usage": "addons [--all|--app APP]",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "leave.js"
+        "addons",
+        "index.js"
       ]
     },
-    "apps:lock": {
-      "aliases": [
-        "lock"
-      ],
-      "args": {},
-      "description": "prevent team members from joining an app",
+    "addons:info": {
+      "aliases": [],
+      "args": {
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon",
+          "required": true
+        }
+      },
+      "description": "show detailed add-on resource and attachment information",
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1642,39 +1622,42 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:lock",
+      "id": "addons:info",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "usage": "addons:info ADDON",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "lock.js"
+        "addons",
+        "info.js"
       ]
     },
-    "apps:open": {
+    "addons:open": {
       "aliases": [],
       "args": {
-        "path": {
-          "name": "path",
-          "required": false
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon",
+          "required": true
         }
       },
-      "description": "open the app in a web browser",
-      "examples": [
-        "$ heroku open -a myapp",
-        "$ heroku open -a myapp /foo"
-      ],
+      "description": "open an add-on's dashboard in your browser",
       "flags": {
+        "show-url": {
+          "description": "show URL, do not open browser",
+          "name": "show-url",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1689,102 +1672,135 @@
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "open"
-      ],
-      "id": "apps:open",
+      "hiddenAliases": [],
+      "id": "addons:open",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
+        "addons",
         "open.js"
       ]
     },
-    "apps:rename": {
+    "addons:plans": {
       "aliases": [],
       "args": {
-        "newname": {
-          "name": "newname",
+        "service": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "service",
           "required": true
         }
       },
-      "description": "rename an app",
-      "examples": [
-        "$ heroku apps:rename --app oldname newname"
-      ],
+      "description": "list all available plans for an add-on service",
       "flags": {
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "json": {
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "addons:plans",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "addons",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "addons",
+        "plans.js"
+      ]
+    },
+    "addons:rename": {
+      "aliases": [],
+      "args": {
+        "addon_name": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon_name",
+          "required": true
         },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "new_name": {
+          "description": "new globally unique name of the add-on",
+          "name": "new_name",
+          "required": true
         }
       },
+      "description": "rename an add-on",
+      "flags": {},
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "rename"
-      ],
-      "id": "apps:rename",
+      "hiddenAliases": [],
+      "id": "addons:rename",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "help": "This will locally update the git remote if it is set to the old app.",
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
+        "addons",
         "rename.js"
       ]
     },
-    "apps:transfer": {
+    "addons:services": {
       "aliases": [],
+      "args": {},
+      "description": "list all available add-on services",
+      "flags": {
+        "json": {
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "addons:services",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "addons",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "addons",
+        "services.js"
+      ]
+    },
+    "addons:upgrade": {
+      "aliases": [
+        "addons:downgrade"
+      ],
       "args": {
-        "recipient": {
-          "description": "user or team to transfer applications to",
-          "name": "recipient",
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon",
           "required": true
+        },
+        "plan": {
+          "description": "unique identifier or name of the plan",
+          "name": "plan"
         }
       },
-      "description": "transfer applications to another user or team",
+      "description": "change add-on plan.\n  See available plans with `heroku addons:plans SERVICE`.\n\n  Note that `heroku addons:upgrade` and `heroku addons:downgrade` are the same.  Either one can be used to change an add-on plan up or down.\n\n  https://devcenter.heroku.com/articles/managing-add-ons\n  ",
       "examples": [
-        "$ heroku apps:transfer collaborator@example.com\nTransferring example to collaborator@example.com... done\n\n$ heroku apps:transfer acme-widgets\nTransferring example to acme-widgets... done\n\n$ heroku apps:transfer --bulk acme-widgets\n..."
+        "Upgrade an add-on by service name:\n$ heroku addons:upgrade heroku-redis:premium-2\n\nUpgrade a specific add-on:\n$ heroku addons:upgrade swimming-briskly-123 heroku-redis:premium-2"
       ],
       "flags": {
-        "locked": {
-          "char": "l",
-          "description": "lock the app upon transfer",
-          "name": "locked",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "bulk": {
-          "description": "transfer applications in bulk",
-          "name": "bulk",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -1800,44 +1816,45 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "confirm": {
-          "char": "c",
-          "hidden": true,
-          "name": "confirm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:transfer",
+      "id": "addons:upgrade",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "transfer.js"
+        "addons",
+        "upgrade.js"
       ]
     },
-    "apps:unlock": {
-      "aliases": [
-        "unlock"
-      ],
-      "args": {},
-      "description": "unlock an app so any team member can join",
+    "addons:wait": {
+      "aliases": [],
+      "args": {
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon"
+        }
+      },
+      "description": "show provisioning status of the add-ons on the app",
       "flags": {
+        "wait-interval": {
+          "description": "how frequently to poll in seconds",
+          "name": "wait-interval",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1853,18 +1870,18 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:unlock",
+      "id": "addons:wait",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "unlock.js"
+        "addons",
+        "wait.js"
       ]
     },
     "auth:login": {
@@ -2089,6 +2106,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2125,6 +2143,7 @@
       ],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2153,6 +2172,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2178,6 +2198,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2719,10 +2740,12 @@
       "aliases": [],
       "args": {
         "CRT": {
+          "description": "absolute path of the certificate file on disk",
           "name": "CRT",
           "required": true
         },
         "KEY": {
+          "description": "absolute path of the key file on disk",
           "name": "KEY",
           "required": true
         }
@@ -2770,6 +2793,7 @@
       "aliases": [],
       "args": {
         "domain": {
+          "description": "domain name to generate",
           "name": "domain",
           "required": true
         }
@@ -3029,10 +3053,12 @@
       "aliases": [],
       "args": {
         "CRT": {
+          "description": "absolute path of the certificate file on disk",
           "name": "CRT",
           "required": true
         },
         "KEY": {
+          "description": "absolute path of the key file on disk",
           "name": "KEY",
           "required": true
         }
@@ -3215,6 +3241,7 @@
       "aliases": [],
       "args": {
         "test-run": {
+          "description": "auto-incremented test run number",
           "name": "test-run",
           "required": true
         }
@@ -3416,6 +3443,7 @@
       "aliases": [],
       "args": {
         "number": {
+          "description": "auto-incremented test run number",
           "name": "number",
           "required": false
         }
@@ -3519,10 +3547,12 @@
       "aliases": [],
       "args": {
         "name": {
+          "description": "name of the OAuth client",
           "name": "name",
           "required": true
         },
         "redirect_uri": {
+          "description": "redirect URL of the OAuth client",
           "name": "redirect_uri",
           "required": true
         }
@@ -3566,6 +3596,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3619,6 +3650,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3662,6 +3694,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3702,6 +3735,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3795,6 +3829,7 @@
       "aliases": [],
       "args": {
         "KEY": {
+          "description": "key name of the config var value",
           "name": "KEY",
           "required": true
         }
@@ -4333,6 +4368,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4578,6 +4614,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4631,6 +4668,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4684,6 +4722,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4745,6 +4784,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname"
         }
       },
@@ -4794,6 +4834,7 @@
       "aliases": [],
       "args": {
         "url": {
+          "description": "URL of the log drain",
           "name": "url",
           "required": true
         }
@@ -4888,6 +4929,7 @@
       "aliases": [],
       "args": {
         "url": {
+          "description": "URL of the log drain",
           "name": "url",
           "required": true
         }
@@ -4933,6 +4975,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the app feature",
           "name": "feature",
           "required": true
         }
@@ -4976,6 +5019,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the app feature",
           "name": "feature",
           "required": true
         }
@@ -5063,6 +5107,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the app feature",
           "name": "feature",
           "required": true
         }
@@ -5158,6 +5203,7 @@
       "aliases": [],
       "args": {
         "command": {
+          "description": "command name of the git credentials",
           "name": "command",
           "required": true
         }
@@ -5223,6 +5269,7 @@
       "aliases": [],
       "args": {
         "key": {
+          "description": "absolute path to the key located on disk. If omitted, we use the default rsa key.",
           "name": "key"
         }
       },
@@ -5318,6 +5365,7 @@
       "aliases": [],
       "args": {
         "key": {
+          "description": "email address of the user",
           "name": "key",
           "required": true
         }
@@ -5345,6 +5393,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the account feature",
           "name": "feature",
           "required": true
         }
@@ -5394,6 +5443,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the account feature",
           "name": "feature",
           "required": true
         }
@@ -5484,6 +5534,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the account feature",
           "name": "feature",
           "required": true
         }
@@ -5537,6 +5588,7 @@
       ],
       "args": {
         "processname": {
+          "description": "name of the process",
           "name": "processname",
           "required": false
         }
@@ -5782,6 +5834,7 @@
       "aliases": [],
       "args": {
         "email": {
+          "description": "email address of the team member",
           "name": "email",
           "required": true
         }
@@ -6078,6 +6131,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6121,6 +6175,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6164,10 +6219,12 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "config var exposed to the owning app containing the source database URL",
           "name": "source",
           "required": true
         },
         "target": {
+          "description": "config var exposed to the owning app containing the target database URL",
           "name": "target",
           "required": true
         }
@@ -6230,6 +6287,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6273,6 +6331,7 @@
       "aliases": [],
       "args": {
         "DATABASE|REPORT_ID": {
+          "description": "config var exposed to the owning app containing the database URL or the report ID",
           "name": "DATABASE|REPORT_ID"
         }
       },
@@ -6324,6 +6383,7 @@
       ],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use all databases.",
           "name": "database"
         }
       },
@@ -6367,10 +6427,12 @@
       "aliases": [],
       "args": {
         "pid": {
+          "description": "ID of the process",
           "name": "pid",
           "required": true
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6420,6 +6482,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6463,6 +6526,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6513,6 +6577,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6577,6 +6642,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         }
@@ -6627,6 +6693,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6678,6 +6745,7 @@
       ],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6743,10 +6811,12 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "source",
           "required": true
         },
         "target": {
+          "description": "PostgreSQL connection string for the target database",
           "name": "target",
           "required": true
         }
@@ -6802,10 +6872,12 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "PostgreSQL connection string for the source database",
           "name": "source",
           "required": true
         },
         "target": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "target",
           "required": true
         }
@@ -6861,6 +6933,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6919,6 +6992,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         }
@@ -6970,6 +7044,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -7028,6 +7103,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -7071,6 +7147,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use all databases.",
           "name": "database"
         }
       },
@@ -7787,6 +7864,7 @@
       ],
       "args": {
         "dyno": {
+          "description": "ID of the dyno",
           "name": "dyno",
           "required": false
         }
@@ -7889,6 +7967,7 @@
       ],
       "args": {
         "dyno": {
+          "description": "ID of the dyno",
           "name": "dyno",
           "required": true
         }
@@ -8050,6 +8129,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8104,6 +8184,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8156,6 +8237,7 @@
       ],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8206,6 +8288,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8258,6 +8341,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8326,6 +8410,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8378,6 +8463,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8422,6 +8508,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8472,6 +8559,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8524,6 +8612,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8582,6 +8671,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8698,6 +8788,7 @@
       "aliases": [],
       "args": {
         "release": {
+          "description": "ID of the release. If omitted, we use the last release ID.",
           "name": "release"
         }
       },
@@ -8754,6 +8845,7 @@
       "aliases": [],
       "args": {
         "release": {
+          "description": "ID of the release. If omitted, we use the last release ID.",
           "name": "release"
         }
       },
@@ -8797,6 +8889,7 @@
       "aliases": [],
       "args": {
         "release": {
+          "description": "ID of the release. If omitted, we use the last release ID.",
           "name": "release"
         }
       },
@@ -9215,6 +9308,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth session",
           "name": "id",
           "required": true
         }
@@ -9933,6 +10027,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook",
           "name": "id",
           "required": true
         }
@@ -10045,6 +10140,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook",
           "name": "id",
           "required": true
         }
@@ -10294,6 +10390,7 @@
       "aliases": [],
       "args": {
         "stack": {
+          "description": "unique name or identifier of the stack",
           "name": "stack",
           "required": true
         }
@@ -10602,6 +10699,7 @@
       "aliases": [],
       "args": {
         "key": {
+          "description": "name of the config var key",
           "name": "key",
           "required": true
         }
@@ -10833,6 +10931,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last unfinished backup ID.",
           "name": "backup_id"
         }
       },
@@ -10877,6 +10976,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -10933,6 +11033,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup",
           "name": "backup_id",
           "required": true
         }
@@ -10988,6 +11089,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last backup ID.",
           "name": "backup_id"
         }
       },
@@ -11124,6 +11226,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last backup ID.",
           "name": "backup_id"
         }
       },
@@ -11168,13 +11271,23 @@
       "aliases": [],
       "args": {
         "backup": {
+          "description": "URL or backup ID from another app",
           "name": "backup"
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
       "description": "restore a backup (default latest) to a database",
+      "examples": [
+        "# Basic Restore from Backup ID\n$ heroku pg:backups:restore b101 DATABASE_URL --app my-heroku-app\n",
+        "# Restore from Another App\n$ heroku pg:backups:restore example-app::b101 DATABASE_URL --app my-heroku-app\n",
+        "# Restore from a Public URL\n$ heroku pg:backups:restore 'https://s3.amazonaws.com/my-bucket/mydb.dump' DATABASE_URL --app my-heroku-app\n",
+        "# Verbose Output\n$ heroku pg:backups:restore b101 DATABASE_URL --app my-heroku-app --verbose\n",
+        "# Restore with Confirmation Prompt\n$ heroku pg:backups:restore b101 DATABASE_URL --app my-heroku-app --confirm my-heroku-app\n",
+        "# Restore with a Specific Database Name\n$ heroku pg:backups:restore b101 HEROKU_POSTGRESQL_PINK --app my-heroku-app\n"
+      ],
       "flags": {
         "wait-interval": {
           "name": "wait-interval",
@@ -11243,6 +11356,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11335,6 +11449,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use a random database attached to the app.",
           "name": "database"
         }
       },
@@ -11379,6 +11494,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last backup ID.",
           "name": "backup_id"
         }
       },
@@ -11423,6 +11539,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11477,6 +11594,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11530,6 +11648,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11592,6 +11711,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11645,6 +11765,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11719,6 +11840,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11772,10 +11894,12 @@
       "aliases": [],
       "args": {
         "remote": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "remote",
           "required": true
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         }
@@ -11828,10 +11952,12 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         },
         "link": {
+          "description": "name of the linked data store",
           "name": "link",
           "required": true
         }
@@ -11886,6 +12012,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11930,6 +12057,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11974,6 +12102,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12024,10 +12153,12 @@
       "aliases": [],
       "args": {
         "window": {
+          "description": "timestamp of the maintenance window",
           "name": "window",
           "required": true
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12074,9 +12205,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if execution plans of queries will be logged for future connections",
           "name": "value"
         }
       },
@@ -12121,9 +12254,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if data replication slot details get logged",
           "name": "value"
         }
       },
@@ -12167,6 +12302,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12211,9 +12347,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if database login attempts get logged",
           "name": "value"
         }
       },
@@ -12257,9 +12395,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if a message gets logged when a session waits longer than the deadlock_timeout to acquire a lock",
           "name": "value"
         }
       },
@@ -12303,9 +12443,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "milliseconds to wait for a statement to complete before logging it",
           "name": "value"
         }
       },
@@ -12349,6 +12491,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
@@ -12401,9 +12544,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "type of SQL statements to log\n<options: none|ddl|mod|all>",
           "name": "value",
           "options": [
             "none",
@@ -12453,9 +12598,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "function type to track\n<options: none|pl|all>",
           "name": "value",
           "options": [
             "none",
@@ -12654,6 +12801,7 @@
       ],
       "args": {
         "url": {
+          "description": "URL to replace the log drain with",
           "name": "url",
           "required": true
         }
@@ -12886,6 +13034,7 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "IP address in CIDR notation",
           "name": "source",
           "required": true
         }
@@ -12979,6 +13128,7 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "IP address in CIDR notation",
           "name": "source",
           "required": true
         }
@@ -13438,6 +13588,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook event",
           "name": "id",
           "required": true
         }
@@ -13543,6 +13694,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook event",
           "name": "id",
           "required": true
         }
@@ -13598,9 +13750,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if execution plans get logged",
           "name": "value"
         }
       },
@@ -13645,9 +13799,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if the database has buffer statistics enabled",
           "name": "value"
         }
       },
@@ -13692,9 +13848,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "format of the log output\n<options: text|json|yaml|xml>",
           "name": "value",
           "options": [
             "text",
@@ -13745,9 +13903,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "minimum duration in milliseconds for queries before logging execution plans. A value of -1 disables it. A value of 0 logs all query execution plans.",
           "name": "value"
         }
       },
@@ -13792,9 +13952,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if execution plan logs include nested statements",
           "name": "value"
         }
       },
@@ -13839,9 +14001,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if the database has trigger execution statistics enabled",
           "name": "value"
         }
       },
@@ -13886,9 +14050,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if the database has verbose execution plan logging enabled",
           "name": "value"
         }
       },
@@ -13930,5 +14096,5 @@
       ]
     }
   },
-  "version": "9.3.3-beta.0"
+  "version": "9.4.0"
 }