fix(typescript): .rest.repos.uploadReleaseAsset() requires name parameter. .head.repo property is optional in pull request response type (#423)

Author: octokitbot

.github/workflows/update.yml

@@ -26,6 +26,13 @@ jobs:
 
       # try checking out routes-update branch. Ignore error if it does not exist
       - run: git checkout routes-update || true
+
+      # if event is coming from octokit/types.ts, update @octokit/types to latest version and get OpenAPI version from its package.json
+      # Do the npm install before `npm ci` to avoid ENOTEMPTY error, see:
+      # https://github.com/actions/setup-node/issues/303#issuecomment-885723049
+      - run: npm install @octokit/types@latest
+        if: github.event_name == 'repository_dispatch' && github.event.action == 'octokit/types.ts release'
+
       - run: npm ci
       - run: rm -rf docs/
 
@@ -41,9 +48,6 @@ jobs:
         env:
           VERSION: ${{ github.event.inputs.version }}
 
-      # if event is coming from octokit/types.ts, update @octokit/types to latest version and get OpenAPI version from its package.json
-      - run: npm install @octokit/types@latest
-        if: github.event_name == 'repository_dispatch' && github.event.action == 'octokit/types.ts release'
       - run: node -e "console.log('::set-output name=version::' + require('@octokit/types/package').octokit['openapi-version'])"
         if: github.event_name == 'repository_dispatch' && github.event.action == 'octokit/types.ts release'
         id: openapi_types

docs/repos/uploadReleaseAsset.md

@@ -1,6 +1,6 @@
 ---
 name: Upload a release asset
-example: octokit.rest.repos.uploadReleaseAsset({ owner, repo, release_id, data })
+example: octokit.rest.repos.uploadReleaseAsset({ owner, repo, release_id, name, data })
 route: POST {origin}/repos/{owner}/{repo}/releases/{release_id}/assets{?name,label}
 scope: repos
 type: API method
@@ -33,6 +33,7 @@ octokit.rest.repos.uploadReleaseAsset({
   owner,
   repo,
   release_id,
+  name,
   data,
 });
 ```
@@ -59,7 +60,7 @@ octokit.rest.repos.uploadReleaseAsset({
 release_id parameter
 
 </td></tr>
-<tr><td>name</td><td>no</td><td>
+<tr><td>name</td><td>yes</td><td>
 
 </td></tr>
 <tr><td>label</td><td>no</td><td>

package-lock.json

@@ -24,7 +24,7 @@
   "author": "Gregor Martynus (https://twitter.com/gr2m)",
   "license": "MIT",
   "dependencies": {
-    "@octokit/types": "^6.21.0",
+    "@octokit/types": "^6.21.1",
     "deprecation": "^2.3.1"
   },
   "devDependencies": {

package.json

@@ -47226,7 +47226,7 @@
         "description": "",
         "in": "QUERY",
         "type": "string",
-        "required": false,
+        "required": true,
         "enum": null,
         "allowNull": false,
         "mapToData": null,