@octokit/openapi 7.5.0 → 7.6.0

package/generated/github.ae-diff-to-api.github.com.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "7.5.0",
+    "version": "7.6.0",
     "title": "GitHub's official OpenAPI spec + Octokit extension",
     "description": "OpenAPI specs from https://github.com/github/rest-api-description with the 'x-octokit' extension required by the Octokit SDKs",
     "license": {
@@ -1653,6 +1653,129 @@
         }
       }
     },
+    "/app/installations": {
+      "get": {
+        "summary": "List installations for the authenticated app",
+        "description": "You must use a [JWT](https://docs.github.com/github-ae@latest/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.\n\nThe permissions the installation has are included under the `permissions` key.",
+        "tags": [
+          "apps"
+        ],
+        "operationId": "apps/list-installations",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/github-ae@latest/rest/reference/apps#list-installations-for-the-authenticated-app"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/per-page"
+          },
+          {
+            "$ref": "#/components/parameters/page"
+          },
+          {
+            "$ref": "#/components/parameters/since"
+          },
+          {
+            "name": "outdated",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The permissions the installation has are included under the `permissions` key.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/installation"
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/base-installation-items"
+                  }
+                }
+              }
+            },
+            "headers": {
+              "Link": {
+                "$ref": "#/components/headers/link"
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "apps",
+          "subcategory": null
+        },
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
+      }
+    },
+    "/app/installations/{installation_id}": {
+      "get": {
+        "summary": "Get an installation for the authenticated app",
+        "description": "Enables an authenticated GitHub App to find an installation's information using the installation id.\n\nYou must use a [JWT](https://docs.github.com/github-ae@latest/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.",
+        "tags": [
+          "apps"
+        ],
+        "operationId": "apps/get-installation",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/github-ae@latest/rest/reference/apps#get-an-installation-for-the-authenticated-app"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/installation-id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/installation"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/base-installation"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "apps",
+          "subcategory": null
+        },
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
+      }
+    },
     "/app/installations/{installation_id}/access_tokens": {
       "post": {
         "summary": "Create an installation access token for an app",
@@ -1758,6 +1881,163 @@
         }
       }
     },
+    "/applications/{client_id}/token": {
+      "post": {
+        "summary": "Check a token",
+        "description": "OAuth applications can use a special API method for checking OAuth token validity without exceeding the normal rate limits for failed login attempts. Authentication works differently with this particular endpoint. You must use [Basic Authentication](https://docs.github.com/github-ae@latest/rest/overview/other-authentication-methods#basic-authentication) to use this endpoint, where the username is the OAuth application `client_id` and the password is its `client_secret`. Invalid tokens will return `404 NOT FOUND`.",
+        "tags": [
+          "apps"
+        ],
+        "operationId": "apps/check-token",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/github-ae@latest/rest/reference/apps#check-a-token"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/client-id"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "access_token": {
+                    "description": "The access_token of the OAuth application.",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "access_token"
+                ],
+                "type": "object"
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/authorization"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/authorization-with-user"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          },
+          "422": {
+            "$ref": "#/components/responses/validation_failed"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": false,
+          "category": "apps",
+          "subcategory": "oauth-applications"
+        },
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
+      },
+      "patch": {
+        "summary": "Reset a token",
+        "description": "OAuth applications can use this API method to reset a valid OAuth token without end-user involvement. Applications must save the \"token\" property in the response because changes take effect immediately. You must use [Basic Authentication](https://docs.github.com/github-ae@latest/rest/overview/other-authentication-methods#basic-authentication) when accessing this endpoint, using the OAuth application's `client_id` and `client_secret` as the username and password. Invalid tokens will return `404 NOT FOUND`.",
+        "tags": [
+          "apps"
+        ],
+        "operationId": "apps/reset-token",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/github-ae@latest/rest/reference/apps#reset-a-token"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/client-id"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "access_token": {
+                    "description": "The access_token of the OAuth application.",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "access_token"
+                ],
+                "type": "object"
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/authorization"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/authorization-with-user"
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "$ref": "#/components/responses/validation_failed"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": false,
+          "category": "apps",
+          "subcategory": "oauth-applications"
+        },
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
+      }
+    },
     "/applications/{client_id}/tokens/{access_token}": {
       "post": {
         "summary": "Reset an authorization",
@@ -4085,6 +4365,130 @@
         }
       }
     },
+    "/orgs/{org}/installation": {
+      "get": {
+        "summary": "Get an organization installation for the authenticated app",
+        "description": "Enables an authenticated GitHub App to find the organization's installation information.\n\nYou must use a [JWT](https://docs.github.com/github-ae@latest/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.",
+        "tags": [
+          "apps"
+        ],
+        "operationId": "apps/get-org-installation",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/github-ae@latest/rest/reference/apps#get-an-organization-installation-for-the-authenticated-app"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/org"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/installation"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/installation"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": false,
+          "category": "apps",
+          "subcategory": null
+        },
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
+      }
+    },
+    "/orgs/{org}/installations": {
+      "get": {
+        "summary": "List app installations for an organization",
+        "description": "Lists all GitHub Apps in an organization. The installation count includes all GitHub Apps installed on repositories in the organization. You must be an organization owner with `admin:read` scope to use this endpoint.",
+        "tags": [
+          "orgs"
+        ],
+        "operationId": "orgs/list-app-installations",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/github-ae@latest/rest/reference/orgs#list-app-installations-for-an-organization"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/org"
+          },
+          {
+            "$ref": "#/components/parameters/per-page"
+          },
+          {
+            "$ref": "#/components/parameters/page"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "total_count",
+                    "installations"
+                  ],
+                  "properties": {
+                    "total_count": {
+                      "type": "integer"
+                    },
+                    "installations": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/installation"
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/installation-paginated"
+                  }
+                }
+              }
+            },
+            "headers": {
+              "Link": {
+                "$ref": "#/components/headers/link"
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "orgs",
+          "subcategory": null
+        },
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
+      }
+    },
     "/orgs/{org}/issues": {
       "get": {
         "summary": "List organization issues assigned to the authenticated user",
@@ -7300,34 +7704,92 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/full-repository"
+                  "$ref": "#/components/schemas/full-repository"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/full-repository"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/bad_request"
+          },
+          "403": {
+            "$ref": "#/components/responses/forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          },
+          "422": {
+            "$ref": "#/components/responses/validation_failed"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "forks"
+        },
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
+      }
+    },
+    "/repos/{owner}/{repo}/installation": {
+      "get": {
+        "summary": "Get a repository installation for the authenticated app",
+        "description": "Enables an authenticated GitHub App to find the repository's installation information. The installation's account type will be either an organization or a user account, depending which account the repository belongs to.\n\nYou must use a [JWT](https://docs.github.com/github-ae@latest/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.",
+        "tags": [
+          "apps"
+        ],
+        "operationId": "apps/get-repo-installation",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/github-ae@latest/rest/reference/apps#get-a-repository-installation-for-the-authenticated-app"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/installation"
                 },
                 "examples": {
                   "default": {
-                    "$ref": "#/components/examples/full-repository"
+                    "$ref": "#/components/examples/installation"
                   }
                 }
               }
             }
           },
-          "400": {
-            "$ref": "#/components/responses/bad_request"
-          },
-          "403": {
-            "$ref": "#/components/responses/forbidden"
+          "301": {
+            "$ref": "#/components/responses/moved_permanently"
           },
           "404": {
             "$ref": "#/components/responses/not_found"
-          },
-          "422": {
-            "$ref": "#/components/responses/validation_failed"
           }
         },
         "x-github": {
           "githubCloudOnly": false,
-          "enabledForGitHubApps": true,
-          "category": "repos",
-          "subcategory": "forks"
+          "enabledForGitHubApps": false,
+          "category": "apps",
+          "subcategory": null
         },
         "x-octokit": {
           "diff": {
@@ -7446,6 +7908,14 @@
                     ]
                   }
                 }
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example request body",
+                  "value": {
+                    "permissions": "write"
+                  }
+                }
               }
             }
           }
@@ -8068,6 +8538,12 @@
                       "closed"
                     ]
                   },
+                  "state_reason": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "The reason for the current state",
+                    "example": "not_planned"
+                  },
                   "milestone": {
                     "oneOf": [
                       {
@@ -10267,6 +10743,87 @@
         }
       }
     },
+    "/user/installations": {
+      "get": {
+        "summary": "List app installations accessible to the user access token",
+        "description": "Lists installations of your GitHub App that the authenticated user has explicit permission (`:read`, `:write`, or `:admin`) to access.\n\nYou must use a [user-to-server OAuth access token](https://docs.github.com/github-ae@latest/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#identifying-users-on-your-site), created for a user who has authorized your GitHub App, to access this endpoint.\n\nThe authenticated user has explicit permission to access repositories they own, repositories where they are a collaborator, and repositories that they can access through an organization membership.\n\nYou can find the permissions for the installation under the `permissions` key.",
+        "tags": [
+          "apps"
+        ],
+        "operationId": "apps/list-installations-for-authenticated-user",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/github-ae@latest/rest/reference/apps#list-app-installations-accessible-to-the-user-access-token"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/per-page"
+          },
+          {
+            "$ref": "#/components/parameters/page"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "You can find the permissions for the installation under the `permissions` key.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "total_count",
+                    "installations"
+                  ],
+                  "properties": {
+                    "total_count": {
+                      "type": "integer"
+                    },
+                    "installations": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/installation"
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/base-installation-for-auth-user-paginated"
+                  }
+                }
+              }
+            },
+            "headers": {
+              "Link": {
+                "$ref": "#/components/headers/link"
+              }
+            }
+          },
+          "304": {
+            "$ref": "#/components/responses/not_modified"
+          },
+          "401": {
+            "$ref": "#/components/responses/requires_authentication"
+          },
+          "403": {
+            "$ref": "#/components/responses/forbidden"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": false,
+          "category": "apps",
+          "subcategory": "installations"
+        },
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
+      }
+    },
     "/user/installations/{installation_id}/repositories": {
       "get": {
         "summary": "List repositories accessible to the user access token",
@@ -11537,6 +12094,55 @@
         }
       }
     },
+    "/users/{username}/installation": {
+      "get": {
+        "summary": "Get a user installation for the authenticated app",
+        "description": "Enables an authenticated GitHub App to find the user’s installation information.\n\nYou must use a [JWT](https://docs.github.com/github-ae@latest/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.",
+        "tags": [
+          "apps"
+        ],
+        "operationId": "apps/get-user-installation",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/github-ae@latest/rest/reference/apps#get-a-user-installation-for-the-authenticated-app"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/username"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/installation"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/installation"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": false,
+          "category": "apps",
+          "subcategory": null
+        },
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
+      }
+    },
     "/users/{username}/repos": {
       "get": {
         "summary": "List repositories for a user",
@@ -11900,6 +12506,16 @@
           "type": "string"
         }
       },
+      "since": {
+        "name": "since",
+        "description": "Only show notifications updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.",
+        "in": "query",
+        "required": false,
+        "schema": {
+          "type": "string",
+          "format": "date-time"
+        }
+      },
       "installation-id": {
         "name": "installation_id",
         "description": "The unique identifier of the installation.",
@@ -12003,16 +12619,6 @@
           "type": "string"
         }
       },
-      "since": {
-        "name": "since",
-        "description": "Only show notifications updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.",
-        "in": "query",
-        "required": false,
-        "schema": {
-          "type": "string",
-          "format": "date-time"
-        }
-      },
       "all": {
         "name": "all",
         "description": "If `true`, show notifications marked as read.",
@@ -12793,7 +13399,137 @@
           "url",
           "created_at",
           "updated_at",
-          "expires_at"
+          "expires_at"
+        ]
+      },
+      "installation": {
+        "title": "Installation",
+        "description": "Installation",
+        "type": "object",
+        "properties": {
+          "id": {
+            "description": "The ID of the installation.",
+            "type": "integer",
+            "example": 1
+          },
+          "account": {
+            "nullable": true,
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/simple-user"
+              },
+              {
+                "$ref": "#/components/schemas/enterprise"
+              }
+            ]
+          },
+          "repository_selection": {
+            "description": "Describe whether all repositories have been selected or there's a selection involved",
+            "type": "string",
+            "enum": [
+              "all",
+              "selected"
+            ]
+          },
+          "access_tokens_url": {
+            "type": "string",
+            "format": "uri",
+            "example": "https://api.github.com/installations/1/access_tokens"
+          },
+          "repositories_url": {
+            "type": "string",
+            "format": "uri",
+            "example": "https://api.github.com/installation/repositories"
+          },
+          "html_url": {
+            "type": "string",
+            "format": "uri",
+            "example": "https://github.com/organizations/github/settings/installations/1"
+          },
+          "app_id": {
+            "type": "integer",
+            "example": 1
+          },
+          "target_id": {
+            "description": "The ID of the user or organization this token is being scoped to.",
+            "type": "integer"
+          },
+          "target_type": {
+            "type": "string",
+            "example": "Organization"
+          },
+          "permissions": {
+            "$ref": "#/components/schemas/app-permissions"
+          },
+          "events": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "single_file_name": {
+            "type": "string",
+            "example": "config.yaml",
+            "nullable": true
+          },
+          "has_multiple_single_files": {
+            "type": "boolean",
+            "example": true
+          },
+          "single_file_paths": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "example": [
+              "config.yml",
+              ".github/issue_TEMPLATE.md"
+            ]
+          },
+          "app_slug": {
+            "type": "string",
+            "example": "github-actions"
+          },
+          "suspended_by": {
+            "$ref": "#/components/schemas/nullable-simple-user"
+          },
+          "suspended_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "contact_email": {
+            "type": "string",
+            "example": "\"test_13f1e99741e3e004@d7e1eb0bc0a1ba12.com\"",
+            "nullable": true
+          }
+        },
+        "required": [
+          "id",
+          "app_id",
+          "app_slug",
+          "target_id",
+          "target_type",
+          "single_file_name",
+          "repository_selection",
+          "access_tokens_url",
+          "html_url",
+          "repositories_url",
+          "events",
+          "account",
+          "permissions",
+          "created_at",
+          "updated_at",
+          "suspended_by",
+          "suspended_at"
         ]
       },
       "app-permissions": {
@@ -12833,14 +13569,6 @@
               "write"
             ]
           },
-          "organization_custom_roles": {
-            "type": "string",
-            "description": "The level of permission to grant the access token for custom roles management.",
-            "enum": [
-              "read",
-              "write"
-            ]
-          },
           "deployments": {
             "type": "string",
             "description": "The level of permission to grant the access token for deployments and deployment statuses.",
@@ -19010,6 +19738,74 @@
           "url"
         ]
       },
+      "enterprise": {
+        "title": "Enterprise",
+        "description": "An enterprise account",
+        "type": "object",
+        "properties": {
+          "description": {
+            "description": "A short description of the enterprise.",
+            "type": "string",
+            "nullable": true
+          },
+          "html_url": {
+            "type": "string",
+            "format": "uri",
+            "example": "https://github.com/enterprises/octo-business"
+          },
+          "website_url": {
+            "description": "The enterprise's website URL.",
+            "type": "string",
+            "nullable": true,
+            "format": "uri"
+          },
+          "id": {
+            "description": "Unique identifier of the enterprise",
+            "example": 42,
+            "type": "integer"
+          },
+          "node_id": {
+            "type": "string",
+            "example": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5"
+          },
+          "name": {
+            "description": "The name of the enterprise.",
+            "type": "string",
+            "example": "Octo Business"
+          },
+          "slug": {
+            "description": "The slug url identifier for the enterprise.",
+            "type": "string",
+            "example": "octo-business"
+          },
+          "created_at": {
+            "type": "string",
+            "nullable": true,
+            "format": "date-time",
+            "example": "2019-01-26T19:01:12Z"
+          },
+          "updated_at": {
+            "type": "string",
+            "nullable": true,
+            "format": "date-time",
+            "example": "2019-01-26T19:14:43Z"
+          },
+          "avatar_url": {
+            "type": "string",
+            "format": "uri"
+          }
+        },
+        "required": [
+          "id",
+          "node_id",
+          "name",
+          "slug",
+          "html_url",
+          "created_at",
+          "updated_at",
+          "avatar_url"
+        ]
+      },
       "basic-error": {
         "title": "Basic Error",
         "description": "Basic Error",
@@ -22212,6 +23008,112 @@
           "fingerprint": ""
         }
       },
+      "base-installation-items": {
+        "value": [
+          {
+            "id": 1,
+            "account": {
+              "login": "octocat",
+              "id": 1,
+              "node_id": "MDQ6VXNlcjE=",
+              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+              "gravatar_id": "",
+              "url": "https://api.github.com/users/octocat",
+              "html_url": "https://github.com/octocat",
+              "followers_url": "https://api.github.com/users/octocat/followers",
+              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+              "organizations_url": "https://api.github.com/users/octocat/orgs",
+              "repos_url": "https://api.github.com/users/octocat/repos",
+              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+              "received_events_url": "https://api.github.com/users/octocat/received_events",
+              "type": "User",
+              "site_admin": false
+            },
+            "access_tokens_url": "https://api.github.com/installations/1/access_tokens",
+            "repositories_url": "https://api.github.com/installation/repositories",
+            "html_url": "https://github.com/organizations/github/settings/installations/1",
+            "app_id": 1,
+            "target_id": 1,
+            "target_type": "Organization",
+            "permissions": {
+              "checks": "write",
+              "metadata": "read",
+              "contents": "read"
+            },
+            "events": [
+              "push",
+              "pull_request"
+            ],
+            "single_file_name": "config.yaml",
+            "has_multiple_single_files": true,
+            "single_file_paths": [
+              "config.yml",
+              ".github/issue_TEMPLATE.md"
+            ],
+            "repository_selection": "selected",
+            "created_at": "2017-07-08T16:18:44-04:00",
+            "updated_at": "2017-07-08T16:18:44-04:00",
+            "app_slug": "github-actions",
+            "suspended_at": null,
+            "suspended_by": null
+          }
+        ]
+      },
+      "base-installation": {
+        "value": {
+          "id": 1,
+          "account": {
+            "login": "octocat",
+            "id": 1,
+            "node_id": "MDQ6VXNlcjE=",
+            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+            "gravatar_id": "",
+            "url": "https://api.github.com/users/octocat",
+            "html_url": "https://github.com/octocat",
+            "followers_url": "https://api.github.com/users/octocat/followers",
+            "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+            "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+            "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+            "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+            "organizations_url": "https://api.github.com/users/octocat/orgs",
+            "repos_url": "https://api.github.com/users/octocat/repos",
+            "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+            "received_events_url": "https://api.github.com/users/octocat/received_events",
+            "type": "User",
+            "site_admin": false
+          },
+          "access_tokens_url": "https://api.github.com/installations/1/access_tokens",
+          "repositories_url": "https://api.github.com/installation/repositories",
+          "html_url": "https://github.com/organizations/github/settings/installations/1",
+          "app_id": 1,
+          "target_id": 1,
+          "target_type": "Organization",
+          "permissions": {
+            "checks": "write",
+            "metadata": "read",
+            "contents": "read"
+          },
+          "events": [
+            "push",
+            "pull_request"
+          ],
+          "single_file_name": "config.yaml",
+          "has_multiple_single_files": true,
+          "single_file_paths": [
+            "config.yml",
+            ".github/issue_TEMPLATE.md"
+          ],
+          "repository_selection": "selected",
+          "created_at": "2017-07-08T16:18:44-04:00",
+          "updated_at": "2017-07-08T16:18:44-04:00",
+          "app_slug": "github-actions",
+          "suspended_at": null,
+          "suspended_by": null
+        }
+      },
       "installation-token": {
         "value": {
           "token": "ghs_16C7e42F292c6912E7710c838347Ae178B4a",
@@ -23541,6 +24443,116 @@
           ]
         }
       },
+      "installation": {
+        "value": {
+          "id": 1,
+          "account": {
+            "login": "github",
+            "id": 1,
+            "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+            "avatar_url": "https://github.com/images/error/hubot_happy.gif",
+            "gravatar_id": "",
+            "url": "https://api.github.com/orgs/github",
+            "html_url": "https://github.com/github",
+            "followers_url": "https://api.github.com/users/github/followers",
+            "following_url": "https://api.github.com/users/github/following{/other_user}",
+            "gists_url": "https://api.github.com/users/github/gists{/gist_id}",
+            "starred_url": "https://api.github.com/users/github/starred{/owner}{/repo}",
+            "subscriptions_url": "https://api.github.com/users/github/subscriptions",
+            "organizations_url": "https://api.github.com/users/github/orgs",
+            "repos_url": "https://api.github.com/orgs/github/repos",
+            "events_url": "https://api.github.com/orgs/github/events",
+            "received_events_url": "https://api.github.com/users/github/received_events",
+            "type": "Organization",
+            "site_admin": false
+          },
+          "repository_selection": "all",
+          "access_tokens_url": "https://api.github.com/installations/1/access_tokens",
+          "repositories_url": "https://api.github.com/installation/repositories",
+          "html_url": "https://github.com/organizations/github/settings/installations/1",
+          "app_id": 1,
+          "target_id": 1,
+          "target_type": "Organization",
+          "permissions": {
+            "checks": "write",
+            "metadata": "read",
+            "contents": "read"
+          },
+          "events": [
+            "push",
+            "pull_request"
+          ],
+          "created_at": "2018-02-09T20:51:14Z",
+          "updated_at": "2018-02-09T20:51:14Z",
+          "single_file_name": "config.yml",
+          "has_multiple_single_files": true,
+          "single_file_paths": [
+            "config.yml",
+            ".github/issue_TEMPLATE.md"
+          ],
+          "app_slug": "github-actions",
+          "suspended_at": null,
+          "suspended_by": null
+        }
+      },
+      "installation-paginated": {
+        "value": {
+          "total_count": 1,
+          "installations": [
+            {
+              "id": 25381,
+              "account": {
+                "login": "octo-org",
+                "id": 6811672,
+                "node_id": "MDEyOk9yZ2FuaXphdGlvbjY4MTE2NzI=",
+                "avatar_url": "https://avatars3.githubusercontent.com/u/6811672?v=4",
+                "gravatar_id": "",
+                "url": "https://api.github.com/users/octo-org",
+                "html_url": "https://github.com/octo-org",
+                "followers_url": "https://api.github.com/users/octo-org/followers",
+                "following_url": "https://api.github.com/users/octo-org/following{/other_user}",
+                "gists_url": "https://api.github.com/users/octo-org/gists{/gist_id}",
+                "starred_url": "https://api.github.com/users/octo-org/starred{/owner}{/repo}",
+                "subscriptions_url": "https://api.github.com/users/octo-org/subscriptions",
+                "organizations_url": "https://api.github.com/users/octo-org/orgs",
+                "repos_url": "https://api.github.com/users/octo-org/repos",
+                "events_url": "https://api.github.com/users/octo-org/events{/privacy}",
+                "received_events_url": "https://api.github.com/users/octo-org/received_events",
+                "type": "Organization",
+                "site_admin": false
+              },
+              "repository_selection": "selected",
+              "access_tokens_url": "https://api.github.com/app/installations/25381/access_tokens",
+              "repositories_url": "https://api.github.com/installation/repositories",
+              "html_url": "https://github.com/organizations/octo-org/settings/installations/25381",
+              "app_id": 2218,
+              "target_id": 6811672,
+              "target_type": "Organization",
+              "permissions": {
+                "deployments": "write",
+                "metadata": "read",
+                "pull_requests": "read",
+                "statuses": "read"
+              },
+              "events": [
+                "deployment",
+                "deployment_status"
+              ],
+              "created_at": "2017-05-16T08:47:09.000-07:00",
+              "updated_at": "2017-06-06T11:23:23.000-07:00",
+              "single_file_name": "config.yml",
+              "has_multiple_single_files": true,
+              "single_file_paths": [
+                "config.yml",
+                ".github/issue_TEMPLATE.md"
+              ],
+              "app_slug": "github-actions",
+              "suspended_at": null,
+              "suspended_by": null
+            }
+          ]
+        }
+      },
       "migration-with-short-org-items": {
         "value": [
           {
@@ -28438,7 +29450,8 @@
               "type": "User",
               "site_admin": false
             },
-            "author_association": "COLLABORATOR"
+            "author_association": "COLLABORATOR",
+            "state_reason": "completed"
           }
         ]
       },
@@ -28598,7 +29611,8 @@
             "type": "User",
             "site_admin": false
           },
-          "author_association": "COLLABORATOR"
+          "author_association": "COLLABORATOR",
+          "state_reason": "completed"
         }
       },
       "issue-event-items": {
@@ -28766,7 +29780,8 @@
               "closed_at": null,
               "created_at": "2011-04-22T13:33:48Z",
               "updated_at": "2011-04-22T13:33:48Z",
-              "author_association": "COLLABORATOR"
+              "author_association": "COLLABORATOR",
+              "state_reason": "completed"
             }
           }
         ]
@@ -28975,7 +29990,8 @@
             "closed_at": null,
             "created_at": "2011-04-22T13:33:48Z",
             "updated_at": "2011-04-22T13:33:48Z",
-            "author_association": "COLLABORATOR"
+            "author_association": "COLLABORATOR",
+            "state_reason": "completed"
           }
         }
       },
@@ -30410,7 +31426,8 @@
               "body": "...",
               "score": 1,
               "locked": true,
-              "author_association": "COLLABORATOR"
+              "author_association": "COLLABORATOR",
+              "state_reason": "completed"
             }
           ]
         }
@@ -30742,6 +31759,113 @@
           "raw_key": "\"-----BEGIN PGP PUBLIC KEY BLOCK-----\\nVersion: GnuPG v2\\n\\nmQENBFayYZ0BCAC4hScoJXXpyR+MXGcrBxElqw3FzCVvkViuyeko+Jp76QJhg8kr\\nucRTxbnOoHfda/FmilEa/wxf9ch5/PSrrL26FxEoPHhJolp8fnIDLQeITn94NYdB\\nZtnnEKslpPrG97qSUWIchvyqCPtvOb8+8fWvGx9K/ZWcEEdh1X8+WFR2jMENMeoX\\nwxHWQoPnS7LpX/85/M7VUcJxvDVfv+eHsnQupmE5bGarKNih0oMe3LbdN3qA5PTz\\nSCm6Iudar1VsQ+xTz08ymL7t4pnEtLguQ7EyatFHCjxNblv5RzxoL0tDgN3HqoDz\\nc7TEA+q4RtDQl9amcvQ95emnXmZ974u7UkYdABEBAAG0HlNvbWUgVXNlciA8c29t\\nZXVzZXJAZ21haWwuY29tPokBOAQTAQIAIgUCVrJhnQIbAwYLCQgHAwIGFQgCCQoL\\nBBYCAwECHgECF4AACgkQMmLv8lug0nAViQgArWjI55+7p48URr2z9Jvak+yrBTx1\\nzkufltQAnHTJkq+Kl9dySSmTnOop8o3rE4++IOpYV5Y36PkKf9EZMk4n1RQiDPKE\\nAFtRVTkRaoWzOir9KQXJPfhKrl01j/QzY+utfiMvUoBJZ9ybq8Pa885SljW9lbaX\\nIYw+hl8ZdJ2KStvGrEyfQvRyq3aN5c9TV//4BdGnwx7Qabq/U+G18lizG6f/yq15\\ned7t0KELaCfeKPvytp4VE9/z/Ksah/h3+Qilx07/oG2Ae5kC1bEC9coD/ogPUhbv\\nb2bsBIoY9E9YwsLoif2lU+o1t76zLgUktuNscRRUKobW028H1zuFS/XQhrkBDQRW\\nsmGdAQgApnyyv3i144OLYy0O4UKQxd3e10Y3WpDwfnGIBefAI1m7RxnUxBag/DsU\\n7gi9qLEC4VHSfq4eiNfr1LJOyCL2edTgCWFgBhVjbXjZe6YAOrAnhxwCErnN0Y7N\\n6s8wVh9fObSOyf8ZE6G7JeKpcq9Q6gd/KxagfD48a1v+fyRHpyQc6J9pUEmtrDJ7\\nBjmsd2VWzLBvNWdHyxDNtZweIaqIO9VUYYpr1mtTliNBOZLUelmgrt7HBRcJpWMA\\nS8muVVbuP5MK0trLBq/JB8qUH3zRzB/PhMgzmkIfjEK1VYDWm4E8DYyTWEJcHqkb\\neqFsNjrIlwPaA122BWC6gUOPwwH+oQARAQABiQEfBBgBAgAJBQJWsmGdAhsMAAoJ\\nEDJi7/JboNJwAyAIALd4xcdmGbZD98gScJzqwzkOMcO8zFHqHNvJ42xIFvGny7c0\\n1Rx7iyrdypOby5AxE+viQcjG4rpLZW/xKYBNGrCfDyQO7511I0v8x20EICMlMfD/\\nNrWQCzesEPcUlKTP07d+sFyP8AyseOidbzY/92CpskTgdSBjY/ntLSaoknl/fjJE\\nQM8OkPqU7IraO1Jzzdnm20d5PZL9+PIwIWdSTedU/vBMTJyNcoqvSfKf1wNC66XP\\nhqfYgXJE564AdWZKA3C0IyCqiv+LHwxLnUHio1a4/r91C8KPzxs6tGxRDjXLd7ms\\nuYFGWymiUGOE/giHlcxdYcHzwLnPDliMQOLiTkK5AQ0EVuxMygEIAOD+bW1cDTmE\\nBxh5JECoqeHuwgl6DlLhnubWPkQ4ZeRzBRAsFcEJQlwlJjrzFDicL+lnm6Qq4tt0\\n560TwHdf15/AKTZIZu7H25axvGNzgeaUkJEJdYAq9zTKWwX7wKyzBszi485nQg97\\nMfAqwhMpDW0Qqf8+7Ug+WEmfBSGv9uL3aQC6WEeIsHfri0n0n8v4XgwhfShXguxO\\nCsOztEsuW7WWKW9P4TngKKv4lCHdPlV6FwxeMzODBJvc2fkHVHnqc0PqszJ5xcF8\\n6gZCpMM027SbpeYWCAD5zwJyYP9ntfO1p2HjnQ1dZaP9FeNcO7uIV1Lnd1eGCu6I\\nsrVp5k1f3isAEQEAAYkCPgQYAQIACQUCVuxMygIbAgEpCRAyYu/yW6DScMBdIAQZ\\nAQIABgUCVuxMygAKCRCKohN4dhq2b4tcCACHxmOHVXNpu47OvUGYQydLgMACUlXN\\nlj+HfE0VReqShxdDmpasAY9IRpuMB2RsGK8GbNP+4SlOlAiPf5SMhS7nZNkNDgQQ\\naZ3HFpgrFmFwmE10BKT4iQtoxELLM57z0qGOAfTsEjWFQa4sF+6IHAQR/ptkdkkI\\nBUEXiMnAwVwBysLIJiLO8qdjB6qp52QkT074JVrwywT/P+DkMfC2k4r/AfEbf6eF\\ndmPDuPk6KD87+hJZsSa5MaMUBQVvRO/mgEkhJRITVu58eWGaBOcQJ8gqurhCqM5P\\nDfUA4TJ7wiqM6sS764vV1rOioTTXkszzhClQqET7hPVnVQjenYgv0EZHNyQH/1f1\\n/CYqvV1vFjM9vJjMbxXsATCkZe6wvBVKD8vLsJAr8N+onKQz+4OPc3kmKq7aESu3\\nCi/iuie5KKVwnuNhr9AzT61vEkKxwHcVFEvHB77F6ZAAInhRvjzmQbD2dlPLLQCC\\nqDj71ODSSAPTEmUy6969bgD9PfWei7kNkBIx7s3eBv8yzytSc2EcuUgopqFazquw\\nFs1+tqGHjBvQfTo6bqbJjp/9Ci2pvde3ElV2rAgUlb3lqXyXjRDqrXosh5GcRPQj\\nK8Nhj1BNhnrCVskE4BP0LYbOHuzgm86uXwGCFsY+w2VOsSm16Jx5GHyG5S5WU3+D\\nIts/HFYRLiFgDLmTlxo=\\n=+OzK\\n-----END PGP PUBLIC KEY BLOCK-----\""
         }
       },
+      "base-installation-for-auth-user-paginated": {
+        "value": {
+          "total_count": 2,
+          "installations": [
+            {
+              "id": 1,
+              "account": {
+                "login": "octocat",
+                "id": 1,
+                "node_id": "MDQ6VXNlcjE=",
+                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                "gravatar_id": "",
+                "url": "https://api.github.com/users/octocat",
+                "html_url": "https://github.com/octocat",
+                "followers_url": "https://api.github.com/users/octocat/followers",
+                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+                "organizations_url": "https://api.github.com/users/octocat/orgs",
+                "repos_url": "https://api.github.com/users/octocat/repos",
+                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+                "received_events_url": "https://api.github.com/users/octocat/received_events",
+                "type": "User",
+                "site_admin": false
+              },
+              "access_tokens_url": "https://api.github.com/installations/1/access_tokens",
+              "repositories_url": "https://api.github.com/installation/repositories",
+              "html_url": "https://github.com/organizations/github/settings/installations/1",
+              "app_id": 1,
+              "target_id": 1,
+              "target_type": "Organization",
+              "permissions": {
+                "checks": "write",
+                "metadata": "read",
+                "contents": "read"
+              },
+              "events": [
+                "push",
+                "pull_request"
+              ],
+              "single_file_name": "config.yaml",
+              "has_multiple_single_files": true,
+              "single_file_paths": [
+                "config.yml",
+                ".github/issue_TEMPLATE.md"
+              ],
+              "repository_selection": "all",
+              "created_at": "2017-07-08T16:18:44-04:00",
+              "updated_at": "2017-07-08T16:18:44-04:00",
+              "app_slug": "github-actions",
+              "suspended_at": null,
+              "suspended_by": null
+            },
+            {
+              "id": 3,
+              "account": {
+                "login": "octocat",
+                "id": 2,
+                "node_id": "MDQ6VXNlcjE=",
+                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                "gravatar_id": "",
+                "url": "https://api.github.com/users/octocat",
+                "html_url": "https://github.com/octocat",
+                "followers_url": "https://api.github.com/users/octocat/followers",
+                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+                "organizations_url": "https://api.github.com/users/octocat/orgs",
+                "repos_url": "https://api.github.com/users/octocat/repos",
+                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+                "received_events_url": "https://api.github.com/users/octocat/received_events",
+                "type": "User",
+                "site_admin": false
+              },
+              "access_tokens_url": "https://api.github.com/installations/1/access_tokens",
+              "repositories_url": "https://api.github.com/installation/repositories",
+              "html_url": "https://github.com/organizations/github/settings/installations/1",
+              "app_id": 1,
+              "target_id": 1,
+              "target_type": "Organization",
+              "permissions": {
+                "checks": "write",
+                "metadata": "read",
+                "contents": "read"
+              },
+              "events": [
+                "push",
+                "pull_request"
+              ],
+              "single_file_name": "config.yaml",
+              "has_multiple_single_files": true,
+              "single_file_paths": [
+                "config.yml",
+                ".github/issue_TEMPLATE.md"
+              ],
+              "repository_selection": "all",
+              "created_at": "2017-07-08T16:18:44-04:00",
+              "updated_at": "2017-07-08T16:18:44-04:00",
+              "app_slug": "github-actions",
+              "suspended_at": null,
+              "suspended_by": null
+            }
+          ]
+        }
+      },
       "migration-items": {
         "value": [
           {
@@ -31493,8 +32617,8 @@
       }
     },
     "responses": {
-      "requires_authentication": {
-        "description": "Requires authentication",
+      "not_found": {
+        "description": "Resource not found",
         "content": {
           "application/json": {
             "schema": {
@@ -31503,8 +32627,8 @@
           }
         }
       },
-      "forbidden": {
-        "description": "Forbidden",
+      "requires_authentication": {
+        "description": "Requires authentication",
         "content": {
           "application/json": {
             "schema": {
@@ -31513,8 +32637,8 @@
           }
         }
       },
-      "not_found": {
-        "description": "Resource not found",
+      "forbidden": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
             "schema": {