diff --git a/cache/api.github.com.deref.json b/cache/api.github.com.deref.json index 4b2a56f8c..eb334ce7e 100644 --- a/cache/api.github.com.deref.json +++ b/cache/api.github.com.deref.json @@ -5501,8 +5501,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -15896,8 +15897,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -17183,8 +17185,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -24043,8 +24046,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -36657,8 +36661,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -39129,8 +39134,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -44973,8 +44979,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -47725,8 +47732,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -49948,8 +49956,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -51182,6 +51191,155 @@ "name": { "description": "The name of the custom role.", "type": "string" + }, + "description": { + "description": "A short description about who this role is for or what permissions it grants.", + "type": "string", + "nullable": true + }, + "base_role": { + "type": "string", + "description": "The system role from which this role inherits permissions.", + "enum": [ + "read", + "triage", + "write", + "maintain" + ] + }, + "permissions": { + "description": "A list of additional permissions included in this role.", + "type": "array", + "items": { + "type": "string" + } + }, + "organization": { + "title": "Simple User", + "description": "Simple User", + "type": "object", + "properties": { + "name": { + "nullable": true, + "type": "string" + }, + "email": { + "nullable": true, + "type": "string" + }, + "login": { + "type": "string", + "example": "octocat" + }, + "id": { + "type": "integer", + "example": 1 + }, + "node_id": { + "type": "string", + "example": "MDQ6VXNlcjE=" + }, + "avatar_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/images/error/octocat_happy.gif" + }, + "gravatar_id": { + "type": "string", + "example": "41d064eb2195891e12d0413f63227ea7", + "nullable": true + }, + "url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat" + }, + "html_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/octocat" + }, + "followers_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/followers" + }, + "following_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/following{/other_user}" + }, + "gists_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/gists{/gist_id}" + }, + "starred_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/starred{/owner}{/repo}" + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/subscriptions" + }, + "organizations_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/orgs" + }, + "repos_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/repos" + }, + "events_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/events{/privacy}" + }, + "received_events_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/received_events" + }, + "type": { + "type": "string", + "example": "User" + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "example": "\"2020-07-09T00:17:55Z\"" + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" } }, "required": [ @@ -51199,11 +51357,70 @@ "custom_roles": [ { "id": 8030, - "name": "Developer" + "name": "Security Engineer", + "description": "Able to contribute code and maintain the security pipeline", + "base_role": "maintain", + "permissions": [ + "delete_alerts_code_scanning" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:20:11Z" }, { "id": 8031, - "name": "Designer" + "name": "Community manager", + "description": "Able to handle all the community interactions without being able to contribute code", + "base_role": "read", + "permissions": [ + "mark_as_duplicate", + "manage_settings_pages", + "manage_settings_wiki", + "set_social_preview", + "edit_repo_metadata", + "toggle_discussion_comment_minimize" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-05T12:01:11Z", + "updated_at": "2022-07-05T12:20:11Z" } ] } @@ -53958,8 +54175,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -56985,8 +57203,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -59539,8 +59758,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -60826,8 +61046,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -64126,8 +64347,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -68468,8 +68690,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -69574,186 +69797,1046 @@ } } } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": false, - "category": "codespaces", - "subcategory": "organizations" - } - } - }, - "/orgs/{org}/credential-authorizations": { - "get": { - "summary": "List SAML SSO authorizations for an organization", - "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `read:org` scope can list all credential authorizations for an organization that uses SAML single sign-on (SSO). The credentials are either personal access tokens or SSH keys that organization members have authorized for the organization. For more information, see [About authentication with SAML single sign-on](https://docs.github.com/en/articles/about-authentication-with-saml-single-sign-on).", - "tags": [ - "orgs" - ], - "operationId": "orgs/list-saml-sso-authorizations", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/orgs#list-saml-sso-authorizations-for-an-organization" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "per_page", - "description": "The number of results per page (max 100).", - "in": "query", - "schema": { - "type": "integer", - "default": 30 - } - }, - { - "name": "page", - "description": "Page token", - "in": "query", - "schema": { - "type": "integer" - } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": false, + "category": "codespaces", + "subcategory": "organizations" + } + } + }, + "/orgs/{org}/credential-authorizations": { + "get": { + "summary": "List SAML SSO authorizations for an organization", + "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `read:org` scope can list all credential authorizations for an organization that uses SAML single sign-on (SSO). The credentials are either personal access tokens or SSH keys that organization members have authorized for the organization. For more information, see [About authentication with SAML single sign-on](https://docs.github.com/en/articles/about-authentication-with-saml-single-sign-on).", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-saml-sso-authorizations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-saml-sso-authorizations-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100).", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "Page token", + "in": "query", + "schema": { + "type": "integer" + } + }, + { + "name": "login", + "description": "Limits the list of credentials authorizations for an organization to a specific login", + "in": "query", + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Credential Authorization", + "description": "Credential Authorization", + "type": "object", + "properties": { + "login": { + "type": "string", + "example": "monalisa", + "description": "User login that owns the underlying credential." + }, + "credential_id": { + "type": "integer", + "example": 1, + "description": "Unique identifier for the credential." + }, + "credential_type": { + "type": "string", + "example": "SSH Key", + "description": "Human-readable description of the credential type." + }, + "token_last_eight": { + "type": "string", + "example": "12345678", + "description": "Last eight characters of the credential. Only included in responses with credential_type of personal access token." + }, + "credential_authorized_at": { + "type": "string", + "format": "date-time", + "example": "2011-01-26T19:06:43Z", + "description": "Date when the credential was authorized for use." + }, + "scopes": { + "type": "array", + "example": [ + "user", + "repo" + ], + "description": "List of oauth scopes the token has been granted.", + "items": { + "type": "string" + } + }, + "fingerprint": { + "type": "string", + "example": "jklmnop12345678", + "description": "Unique string to distinguish the credential. Only included in responses with credential_type of SSH Key." + }, + "credential_accessed_at": { + "type": "string", + "format": "date-time", + "example": "2011-01-26T19:06:43Z", + "description": "Date when the credential was last accessed. May be null if it was never accessed", + "nullable": true + }, + "authorized_credential_id": { + "type": "integer", + "nullable": true, + "example": 12345678 + }, + "authorized_credential_title": { + "type": "string", + "nullable": true, + "example": "my ssh key", + "description": "The title given to the ssh key. This will only be present when the credential is an ssh key." + }, + "authorized_credential_note": { + "type": "string", + "nullable": true, + "example": "my token", + "description": "The note given to the token. This will only be present when the credential is a token." + }, + "authorized_credential_expires_at": { + "type": "string", + "format": "date-time", + "nullable": true, + "description": "The expiry for the token. This will only be present when the credential is a token." + } + }, + "required": [ + "login", + "credential_id", + "credential_type", + "credential_authorized_at", + "credential_accessed_at", + "authorized_credential_id" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "login": "octocat", + "credential_id": 161195, + "credential_type": "personal access token", + "token_last_eight": "71c3fc11", + "credential_authorized_at": "2011-01-26T19:06:43Z", + "authorized_credential_expires_at": "2011-02-25T19:06:43Z", + "scopes": [ + "user", + "repo" + ] + }, + { + "login": "hubot", + "credential_id": 161196, + "credential_type": "personal access token", + "token_last_eight": "Ae178B4a", + "credential_authorized_at": "2019-03-29T19:06:43Z", + "authorized_credential_expires_at": "2019-04-28T19:06:43Z", + "scopes": [ + "repo" + ] + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": null + } + } + }, + "/orgs/{org}/credential-authorizations/{credential_id}": { + "delete": { + "summary": "Remove a SAML SSO authorization for an organization", + "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `admin:org` scope can remove a credential authorization for an organization that uses SAML SSO. Once you remove someone's credential authorization, they will need to create a new personal access token or SSH key and authorize it for the organization they want to access.", + "tags": [ + "orgs" + ], + "operationId": "orgs/remove-saml-sso-authorization", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#remove-a-saml-sso-authorization-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "credential_id", + "in": "path", + "required": true, + "schema": { + "type": "integer" + } + } + ], + "responses": { + "204": { + "description": "Response" + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": null + } + } + }, + "/orgs/{org}/custom_roles": { + "post": { + "summary": "Create a custom role", + "description": "**Note**: This operation is in beta and is subject to change.\n\nCreates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information on custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/create-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#create-a-custom-role" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the custom role." + }, + "description": { + "type": "string", + "description": "A short description about the intended usage of this role or what permissions it grants." + }, + "base_role": { + "type": "string", + "enum": [ + "read", + "triage", + "write", + "maintain" + ], + "description": "The system role from which this role inherits permissions." + }, + "permissions": { + "type": "array", + "description": "A list of additional permissions included in this role.", + "items": { + "type": "string" + } + } + }, + "required": [ + "name", + "base_role", + "permissions" + ] + }, + "examples": { + "default": { + "value": { + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label" + ] + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Organization Custom Repository Role", + "description": "Custom repository roles created by organization administrators", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the custom role.", + "type": "integer" + }, + "name": { + "description": "The name of the custom role.", + "type": "string" + }, + "description": { + "description": "A short description about who this role is for or what permissions it grants.", + "type": "string", + "nullable": true + }, + "base_role": { + "type": "string", + "description": "The system role from which this role inherits permissions.", + "enum": [ + "read", + "triage", + "write", + "maintain" + ] + }, + "permissions": { + "description": "A list of additional permissions included in this role.", + "type": "array", + "items": { + "type": "string" + } + }, + "organization": { + "title": "Simple User", + "description": "Simple User", + "type": "object", + "properties": { + "name": { + "nullable": true, + "type": "string" + }, + "email": { + "nullable": true, + "type": "string" + }, + "login": { + "type": "string", + "example": "octocat" + }, + "id": { + "type": "integer", + "example": 1 + }, + "node_id": { + "type": "string", + "example": "MDQ6VXNlcjE=" + }, + "avatar_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/images/error/octocat_happy.gif" + }, + "gravatar_id": { + "type": "string", + "example": "41d064eb2195891e12d0413f63227ea7", + "nullable": true + }, + "url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat" + }, + "html_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/octocat" + }, + "followers_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/followers" + }, + "following_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/following{/other_user}" + }, + "gists_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/gists{/gist_id}" + }, + "starred_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/starred{/owner}{/repo}" + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/subscriptions" + }, + "organizations_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/orgs" + }, + "repos_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/repos" + }, + "events_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/events{/privacy}" + }, + "received_events_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/received_events" + }, + "type": { + "type": "string", + "example": "User" + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "example": "\"2020-07-09T00:17:55Z\"" + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "name" + ] + }, + "examples": { + "default": { + "value": { + "id": 8030, + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:19:11Z" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "422": { + "description": "Validation failed", + "content": { + "application/json": { + "schema": { + "title": "Validation Error", + "description": "Validation Error", + "type": "object", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "required": [ + "code" + ], + "properties": { + "resource": { + "type": "string" + }, + "field": { + "type": "string" + }, + "message": { + "type": "string" + }, + "code": { + "type": "string" + }, + "index": { + "type": "integer" + }, + "value": { + "oneOf": [ + { + "type": "string", + "nullable": true + }, + { + "type": "integer", + "nullable": true + }, + { + "type": "array", + "nullable": true, + "items": { + "type": "string" + } + } + ] + } + } + } + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "custom-roles" + } + } + }, + "/orgs/{org}/custom_roles/{role_id}": { + "patch": { + "summary": "Update a custom role", + "description": "**Note**: This operation is in beta and subject to change.\n\nUpdates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/update-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#update-a-custom-role" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "role_id", + "description": "The unique identifier of the role.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the custom role." + }, + "description": { + "type": "string", + "description": "A short description about who this role is for or what permissions it grants." + }, + "base_role": { + "type": "string", + "enum": [ + "read", + "triage", + "write", + "maintain" + ], + "description": "The system role from which this role inherits permissions." + }, + "permissions": { + "type": "array", + "description": "A list of additional permissions included in this role. If specified, these permissions will replace any currently set on the role.", + "items": { + "type": "string" + } + } + } + }, + "examples": { + "default": { + "value": { + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label", + "remove_label" + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Organization Custom Repository Role", + "description": "Custom repository roles created by organization administrators", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the custom role.", + "type": "integer" + }, + "name": { + "description": "The name of the custom role.", + "type": "string" + }, + "description": { + "description": "A short description about who this role is for or what permissions it grants.", + "type": "string", + "nullable": true + }, + "base_role": { + "type": "string", + "description": "The system role from which this role inherits permissions.", + "enum": [ + "read", + "triage", + "write", + "maintain" + ] + }, + "permissions": { + "description": "A list of additional permissions included in this role.", + "type": "array", + "items": { + "type": "string" + } + }, + "organization": { + "title": "Simple User", + "description": "Simple User", + "type": "object", + "properties": { + "name": { + "nullable": true, + "type": "string" + }, + "email": { + "nullable": true, + "type": "string" + }, + "login": { + "type": "string", + "example": "octocat" + }, + "id": { + "type": "integer", + "example": 1 + }, + "node_id": { + "type": "string", + "example": "MDQ6VXNlcjE=" + }, + "avatar_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/images/error/octocat_happy.gif" + }, + "gravatar_id": { + "type": "string", + "example": "41d064eb2195891e12d0413f63227ea7", + "nullable": true + }, + "url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat" + }, + "html_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/octocat" + }, + "followers_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/followers" + }, + "following_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/following{/other_user}" + }, + "gists_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/gists{/gist_id}" + }, + "starred_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/starred{/owner}{/repo}" + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/subscriptions" + }, + "organizations_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/orgs" + }, + "repos_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/repos" + }, + "events_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/events{/privacy}" + }, + "received_events_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/received_events" + }, + "type": { + "type": "string", + "example": "User" + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "example": "\"2020-07-09T00:17:55Z\"" + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "name" + ] + }, + "examples": { + "default": { + "value": { + "id": 8030, + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label", + "remove_label" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:19:11Z" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } }, - { - "name": "login", - "description": "Limits the list of credentials authorizations for an organization to a specific login", - "in": "query", - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "Response", + "422": { + "description": "Validation failed", "content": { "application/json": { "schema": { - "type": "array", - "items": { - "title": "Credential Authorization", - "description": "Credential Authorization", - "type": "object", - "properties": { - "login": { - "type": "string", - "example": "monalisa", - "description": "User login that owns the underlying credential." - }, - "credential_id": { - "type": "integer", - "example": 1, - "description": "Unique identifier for the credential." - }, - "credential_type": { - "type": "string", - "example": "SSH Key", - "description": "Human-readable description of the credential type." - }, - "token_last_eight": { - "type": "string", - "example": "12345678", - "description": "Last eight characters of the credential. Only included in responses with credential_type of personal access token." - }, - "credential_authorized_at": { - "type": "string", - "format": "date-time", - "example": "2011-01-26T19:06:43Z", - "description": "Date when the credential was authorized for use." - }, - "scopes": { - "type": "array", - "example": [ - "user", - "repo" + "title": "Validation Error", + "description": "Validation Error", + "type": "object", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "required": [ + "code" ], - "description": "List of oauth scopes the token has been granted.", - "items": { - "type": "string" + "properties": { + "resource": { + "type": "string" + }, + "field": { + "type": "string" + }, + "message": { + "type": "string" + }, + "code": { + "type": "string" + }, + "index": { + "type": "integer" + }, + "value": { + "oneOf": [ + { + "type": "string", + "nullable": true + }, + { + "type": "integer", + "nullable": true + }, + { + "type": "array", + "nullable": true, + "items": { + "type": "string" + } + } + ] + } } - }, - "fingerprint": { - "type": "string", - "example": "jklmnop12345678", - "description": "Unique string to distinguish the credential. Only included in responses with credential_type of SSH Key." - }, - "credential_accessed_at": { - "type": "string", - "format": "date-time", - "example": "2011-01-26T19:06:43Z", - "description": "Date when the credential was last accessed. May be null if it was never accessed", - "nullable": true - }, - "authorized_credential_id": { - "type": "integer", - "nullable": true, - "example": 12345678 - }, - "authorized_credential_title": { - "type": "string", - "nullable": true, - "example": "my ssh key", - "description": "The title given to the ssh key. This will only be present when the credential is an ssh key." - }, - "authorized_credential_note": { - "type": "string", - "nullable": true, - "example": "my token", - "description": "The note given to the token. This will only be present when the credential is a token." - }, - "authorized_credential_expires_at": { - "type": "string", - "format": "date-time", - "nullable": true, - "description": "The expiry for the token. This will only be present when the credential is a token." } - }, - "required": [ - "login", - "credential_id", - "credential_type", - "credential_authorized_at", - "credential_accessed_at", - "authorized_credential_id" - ] - } - }, - "examples": { - "default": { - "value": [ - { - "login": "octocat", - "credential_id": 161195, - "credential_type": "personal access token", - "token_last_eight": "71c3fc11", - "credential_authorized_at": "2011-01-26T19:06:43Z", - "authorized_credential_expires_at": "2011-02-25T19:06:43Z", - "scopes": [ - "user", - "repo" - ] - }, - { - "login": "hubot", - "credential_id": 161196, - "credential_type": "personal access token", - "token_last_eight": "Ae178B4a", - "credential_authorized_at": "2019-03-29T19:06:43Z", - "authorized_credential_expires_at": "2019-04-28T19:06:43Z", - "scopes": [ - "repo" - ] - } - ] + } } } } @@ -69761,24 +70844,22 @@ } }, "x-github": { - "githubCloudOnly": true, + "githubCloudOnly": false, "enabledForGitHubApps": true, "category": "orgs", - "subcategory": null + "subcategory": "custom-roles" } - } - }, - "/orgs/{org}/credential-authorizations/{credential_id}": { + }, "delete": { - "summary": "Remove a SAML SSO authorization for an organization", - "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `admin:org` scope can remove a credential authorization for an organization that uses SAML SSO. Once you remove someone's credential authorization, they will need to create a new personal access token or SSH key and authorize it for the organization they want to access.", + "summary": "Delete a custom role", + "description": "**Note**: This operation is in beta and is subject to change.\n\nDeletes a custom role from an organization. Once the custom role has been deleted, any\nuser, team, or invitation with the deleted custom role will be reassigned the inherited role.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", "tags": [ "orgs" ], - "operationId": "orgs/remove-saml-sso-authorization", + "operationId": "orgs/delete-custom-role", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/orgs#remove-a-saml-sso-authorization-for-an-organization" + "url": "https://docs.github.com/rest/reference/orgs#delete-a-custom-role" }, "parameters": [ { @@ -69791,7 +70872,8 @@ } }, { - "name": "credential_id", + "name": "role_id", + "description": "The unique identifier of the role.", "in": "path", "required": true, "schema": { @@ -69802,39 +70884,14 @@ "responses": { "204": { "description": "Response" - }, - "404": { - "description": "Resource not found", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" - } - } - } - } - } } }, "x-github": { - "githubCloudOnly": true, + "githubCloudOnly": false, "enabledForGitHubApps": true, + "previews": [], "category": "orgs", - "subcategory": null + "subcategory": "custom-roles" } } }, @@ -71857,8 +72914,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -74513,8 +75571,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -76258,6 +77317,85 @@ } } }, + "/orgs/{org}/fine_grained_permissions": { + "get": { + "summary": "List fine-grained permissions for an organization", + "description": "**Note**: This operation is in beta and subject to change.\n\nLists the fine-grained permissions available for an organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organizaiton and must use an access token with `admin:org repo` scope.\nGitHub Apps must have the `organization_custom_roles:read` organization permission to use this endpoint.", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-fine-grained-permissions", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-fine-grained-permissions-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Organization Fine-Grained Permission", + "description": "Fine-grained permissions available for the organization", + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "required": [ + "name", + "description" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "name": "add_assignee", + "description": "Assign or remove a user" + }, + { + "name": "remove_assignee", + "description": "Remove an assigned user" + }, + { + "name": "add_label", + "description": "Add or remove a label" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "previews": [], + "category": "orgs", + "subcategory": "custom-roles" + } + } + }, "/orgs/{org}/hooks": { "get": { "summary": "List organization webhooks", @@ -83678,8 +84816,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -86873,8 +88012,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -89918,8 +91058,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -91612,8 +92753,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -93335,8 +94477,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -95487,8 +96630,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -98056,8 +99200,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -100199,8 +101344,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -100847,15 +101993,15 @@ }, "/orgs/{org}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by an organization", - "description": "Returns all package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by an organization", + "description": "Lists package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-org", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-an-organization" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-an-organization" }, "parameters": [ { @@ -104434,8 +105580,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -104973,8 +106120,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -106077,8 +107225,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -119145,8 +120294,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -121194,8 +122344,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -129623,8 +130774,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -131061,8 +132213,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -132254,8 +133407,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -133334,8 +134488,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -134916,8 +136071,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -136354,8 +137510,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -137547,8 +138704,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -142654,8 +143812,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -143950,8 +145109,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -147465,8 +148625,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -149231,8 +150392,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -151892,8 +153054,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -153658,8 +154821,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -157031,8 +158195,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -158797,8 +159962,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -163140,7 +164306,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -165341,8 +166507,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -167107,8 +168274,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -194402,8 +195570,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -196986,8 +198155,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -199286,8 +200456,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -201759,8 +202930,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -209007,8 +210179,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -211813,8 +212986,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -214267,8 +215441,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -218355,8 +219530,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -225677,8 +226853,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -227011,8 +228188,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -232020,8 +233198,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -234241,8 +235420,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -238922,7 +240102,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -249420,8 +250600,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -252077,8 +253258,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -254135,8 +255317,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -255573,8 +256756,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -256766,8 +257950,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -268302,8 +269487,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -270585,8 +271771,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -273436,8 +274623,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -276297,8 +277485,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -282304,8 +283493,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -286221,8 +287411,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -290020,8 +291211,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -292858,8 +294050,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -295722,8 +296915,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -298389,8 +299583,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -319698,8 +320893,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -328990,8 +330186,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -335262,8 +336459,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -336596,8 +337794,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -352504,8 +353703,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -354958,8 +356158,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -361518,8 +362719,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -362852,8 +364054,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -366234,8 +367437,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -367568,8 +368772,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -386636,8 +387841,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -388487,8 +389693,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -390285,8 +391492,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -398249,8 +399457,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -400681,8 +401890,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -403108,8 +404318,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -415647,8 +416858,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -417716,8 +418928,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -422973,8 +424186,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -425962,8 +427176,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -428416,8 +429631,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -431237,8 +432453,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -434128,8 +435345,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -436754,8 +437972,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -440111,8 +441330,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -442817,8 +444037,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -448777,8 +449998,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -451679,8 +452901,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -456483,8 +457706,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -458231,8 +459455,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -459969,8 +461194,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -462280,8 +463506,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -464631,8 +465858,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -466713,8 +467941,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -467410,15 +468639,15 @@ }, "/user/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by the authenticated user", - "description": "Returns all package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by the authenticated user", + "description": "Lists package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" }, "parameters": [ { @@ -469958,8 +471187,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -471580,8 +472810,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -473615,8 +474846,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -476457,8 +477689,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -477794,8 +479027,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -480050,8 +481284,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -484043,8 +485278,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -487249,8 +488485,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -490457,8 +491694,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -495813,8 +497051,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -497956,8 +499195,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -498671,15 +499911,15 @@ }, "/users/{username}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by a user", - "description": "Returns all package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by a user", + "description": "Lists package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-a-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-a-user" }, "parameters": [ { @@ -501968,8 +503208,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -505176,8 +506417,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -507863,8 +509105,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -509807,8 +511050,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -511009,8 +512253,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -512838,8 +514083,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", diff --git a/cache/api.github.com.json b/cache/api.github.com.json index 8eaf6e491..13a9d0238 100644 --- a/cache/api.github.com.json +++ b/cache/api.github.com.json @@ -6843,7 +6843,7 @@ }, "examples": { "default": { - "$ref": "#/components/examples/organization-custom-repository-role-example-old" + "$ref": "#/components/examples/organization-custom-repository-role-example" } } } @@ -10089,6 +10089,302 @@ } } }, + "/orgs/{org}/custom_roles": { + "post": { + "summary": "Create a custom role", + "description": "**Note**: This operation is in beta and is subject to change.\n\nCreates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information on custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/create-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#create-a-custom-role" + }, + "parameters": [ + { + "$ref": "#/components/parameters/org" + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the custom role." + }, + "description": { + "type": "string", + "description": "A short description about the intended usage of this role or what permissions it grants." + }, + "base_role": { + "type": "string", + "enum": [ + "read", + "triage", + "write", + "maintain" + ], + "description": "The system role from which this role inherits permissions." + }, + "permissions": { + "type": "array", + "description": "A list of additional permissions included in this role.", + "items": { + "type": "string" + } + } + }, + "required": [ + "name", + "base_role", + "permissions" + ] + }, + "examples": { + "default": { + "value": { + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label" + ] + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/organization-custom-repository-role" + }, + "examples": { + "default": { + "value": { + "id": 8030, + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:19:11Z" + } + } + } + } + } + }, + "404": { + "$ref": "#/components/responses/not_found" + }, + "422": { + "$ref": "#/components/responses/validation_failed" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "custom-roles" + } + } + }, + "/orgs/{org}/custom_roles/{role_id}": { + "patch": { + "summary": "Update a custom role", + "description": "**Note**: This operation is in beta and subject to change.\n\nUpdates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/update-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#update-a-custom-role" + }, + "parameters": [ + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/role-id" + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the custom role." + }, + "description": { + "type": "string", + "description": "A short description about who this role is for or what permissions it grants." + }, + "base_role": { + "type": "string", + "enum": [ + "read", + "triage", + "write", + "maintain" + ], + "description": "The system role from which this role inherits permissions." + }, + "permissions": { + "type": "array", + "description": "A list of additional permissions included in this role. If specified, these permissions will replace any currently set on the role.", + "items": { + "type": "string" + } + } + } + }, + "examples": { + "default": { + "value": { + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label", + "remove_label" + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/organization-custom-repository-role" + }, + "examples": { + "default": { + "value": { + "id": 8030, + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label", + "remove_label" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:19:11Z" + } + } + } + } + } + }, + "404": { + "$ref": "#/components/responses/not_found" + }, + "422": { + "$ref": "#/components/responses/validation_failed" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "custom-roles" + } + }, + "delete": { + "summary": "Delete a custom role", + "description": "**Note**: This operation is in beta and is subject to change.\n\nDeletes a custom role from an organization. Once the custom role has been deleted, any\nuser, team, or invitation with the deleted custom role will be reassigned the inherited role.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/delete-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#delete-a-custom-role" + }, + "parameters": [ + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/role-id" + } + ], + "responses": { + "204": { + "description": "Response" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "previews": [], + "category": "orgs", + "subcategory": "custom-roles" + } + } + }, "/orgs/{org}/dependabot/secrets": { "get": { "summary": "List organization secrets", @@ -10812,6 +11108,52 @@ } } }, + "/orgs/{org}/fine_grained_permissions": { + "get": { + "summary": "List fine-grained permissions for an organization", + "description": "**Note**: This operation is in beta and subject to change.\n\nLists the fine-grained permissions available for an organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organizaiton and must use an access token with `admin:org repo` scope.\nGitHub Apps must have the `organization_custom_roles:read` organization permission to use this endpoint.", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-fine-grained-permissions", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-fine-grained-permissions-for-an-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/org" + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/organization-fine-grained-permission" + } + }, + "examples": { + "default": { + "$ref": "#/components/examples/organization-fine-grained-permission-example" + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "previews": [], + "category": "orgs", + "subcategory": "custom-roles" + } + } + }, "/orgs/{org}/hooks": { "get": { "summary": "List organization webhooks", @@ -13442,15 +13784,15 @@ }, "/orgs/{org}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by an organization", - "description": "Returns all package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by an organization", + "description": "Lists package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-org", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-an-organization" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-an-organization" }, "parameters": [ { @@ -14197,8 +14539,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -19036,8 +19379,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -22484,7 +22828,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -30525,7 +30869,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -55063,15 +55407,15 @@ }, "/user/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by the authenticated user", - "description": "Returns all package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by the authenticated user", + "description": "Lists package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" }, "parameters": [ { @@ -57480,15 +57824,15 @@ }, "/users/{username}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by a user", - "description": "Returns all package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by a user", + "description": "Lists package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-a-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-a-user" }, "parameters": [ { @@ -60503,8 +60847,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -65461,8 +65806,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -66166,6 +66512,39 @@ "name": { "description": "The name of the custom role.", "type": "string" + }, + "description": { + "description": "A short description about who this role is for or what permissions it grants.", + "type": "string", + "nullable": true + }, + "base_role": { + "type": "string", + "description": "The system role from which this role inherits permissions.", + "enum": [ + "read", + "triage", + "write", + "maintain" + ] + }, + "permissions": { + "description": "A list of additional permissions included in this role.", + "type": "array", + "items": { + "type": "string" + } + }, + "organization": { + "$ref": "#/components/schemas/simple-user" + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" } }, "required": [ @@ -67349,6 +67728,23 @@ "node_id" ] }, + "organization-fine-grained-permission": { + "title": "Organization Fine-Grained Permission", + "description": "Fine-grained permissions available for the organization", + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "required": [ + "name", + "description" + ] + }, "org-hook": { "title": "Org Hook", "description": "Org Hook", @@ -90806,17 +91202,76 @@ } ] }, - "organization-custom-repository-role-example-old": { + "organization-custom-repository-role-example": { "value": { "total_count": 2, "custom_roles": [ { "id": 8030, - "name": "Developer" + "name": "Security Engineer", + "description": "Able to contribute code and maintain the security pipeline", + "base_role": "maintain", + "permissions": [ + "delete_alerts_code_scanning" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:20:11Z" }, { "id": 8031, - "name": "Designer" + "name": "Community manager", + "description": "Able to handle all the community interactions without being able to contribute code", + "base_role": "read", + "permissions": [ + "mark_as_duplicate", + "manage_settings_pages", + "manage_settings_wiki", + "set_social_preview", + "edit_repo_metadata", + "toggle_discussion_comment_minimize" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-05T12:01:11Z", + "updated_at": "2022-07-05T12:20:11Z" } ] } @@ -92218,6 +92673,22 @@ } ] }, + "organization-fine-grained-permission-example": { + "value": [ + { + "name": "add_assignee", + "description": "Assign or remove a user" + }, + { + "name": "remove_assignee", + "description": "Remove an assigned user" + }, + { + "name": "add_label", + "description": "Add or remove a label" + } + ] + }, "org-hook-items": { "value": [ { @@ -111791,6 +112262,15 @@ "type": "string" } }, + "role-id": { + "name": "role_id", + "description": "The unique identifier of the role.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + } + }, "group-id": { "name": "group_id", "description": "The unique identifier of the group.", diff --git a/cache/ghes-3.2.deref.json b/cache/ghes-3.2.deref.json index 7164ba7b5..483ee8940 100644 --- a/cache/ghes-3.2.deref.json +++ b/cache/ghes-3.2.deref.json @@ -85514,8 +85514,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -111039,8 +111040,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -131554,7 +131556,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.2/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -191569,7 +191571,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/cache/ghes-3.2.json b/cache/ghes-3.2.json index 8cbd27e73..acae9776a 100644 --- a/cache/ghes-3.2.json +++ b/cache/ghes-3.2.json @@ -13538,8 +13538,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -17871,8 +17872,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -20114,7 +20116,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.2/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -26991,7 +26993,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/cache/ghes-3.3.deref.json b/cache/ghes-3.3.deref.json index 87aa8a28f..b888755f2 100644 --- a/cache/ghes-3.3.deref.json +++ b/cache/ghes-3.3.deref.json @@ -86241,8 +86241,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -112047,8 +112048,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -132746,7 +132748,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.3/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -193380,7 +193382,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/cache/ghes-3.3.json b/cache/ghes-3.3.json index ca4e9a79c..d5603e00e 100644 --- a/cache/ghes-3.3.json +++ b/cache/ghes-3.3.json @@ -13412,8 +13412,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -17550,8 +17551,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -19782,7 +19784,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.3/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -26860,7 +26862,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/cache/ghes-3.4.deref.json b/cache/ghes-3.4.deref.json index 9c2b2f69b..1d746c158 100644 --- a/cache/ghes-3.4.deref.json +++ b/cache/ghes-3.4.deref.json @@ -94848,8 +94848,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -120843,8 +120844,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -142468,7 +142470,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.4/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -206925,7 +206927,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/cache/ghes-3.4.json b/cache/ghes-3.4.json index c2ee10ebf..e5d2bd1b7 100644 --- a/cache/ghes-3.4.json +++ b/cache/ghes-3.4.json @@ -9236,7 +9236,7 @@ }, "examples": { "default": { - "$ref": "#/components/examples/organization-custom-repository-role-example-old" + "$ref": "#/components/examples/organization-custom-repository-role-example" } } } @@ -14716,8 +14716,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -18905,8 +18906,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -21406,7 +21408,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.4/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -28448,7 +28450,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -79785,7 +79787,7 @@ } ] }, - "organization-custom-repository-role-example-old": { + "organization-custom-repository-role-example": { "value": { "total_count": 2, "custom_roles": [ diff --git a/cache/ghes-3.5.deref.json b/cache/ghes-3.5.deref.json index 0418e0352..f592de1ac 100644 --- a/cache/ghes-3.5.deref.json +++ b/cache/ghes-3.5.deref.json @@ -96951,8 +96951,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -122840,8 +122841,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -150391,7 +150393,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.5/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -215354,7 +215356,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/cache/ghes-3.5.json b/cache/ghes-3.5.json index 2501b092f..459959cd9 100644 --- a/cache/ghes-3.5.json +++ b/cache/ghes-3.5.json @@ -9401,7 +9401,7 @@ }, "examples": { "default": { - "$ref": "#/components/examples/organization-custom-repository-role-example-old" + "$ref": "#/components/examples/organization-custom-repository-role-example" } } } @@ -15215,8 +15215,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -19359,8 +19360,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -22404,7 +22406,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.5/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -29507,7 +29509,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -81426,7 +81428,7 @@ } ] }, - "organization-custom-repository-role-example-old": { + "organization-custom-repository-role-example": { "value": { "total_count": 2, "custom_roles": [ diff --git a/cache/ghes-3.6.deref.json b/cache/ghes-3.6.deref.json index 8da93d87d..18f2844f2 100644 --- a/cache/ghes-3.6.deref.json +++ b/cache/ghes-3.6.deref.json @@ -11351,8 +11351,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -29737,8 +29738,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -31024,8 +31026,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -36121,8 +36124,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -48731,8 +48735,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -51203,8 +51208,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -54787,8 +54793,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -57539,8 +57546,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -59762,8 +59770,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -63476,8 +63485,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -66503,8 +66513,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -69067,8 +69078,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -70354,8 +70366,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -73654,8 +73667,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -77917,8 +77931,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -80573,8 +80588,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -87651,8 +87667,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -91111,8 +91128,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -92805,8 +92823,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -94528,8 +94547,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -98498,8 +98518,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -99037,8 +99058,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -100141,8 +100163,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -111871,8 +111894,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -113920,8 +113944,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -121953,8 +121978,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -123391,8 +123417,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -124584,8 +124611,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -125664,8 +125692,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -127246,8 +127275,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -128684,8 +128714,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -129877,8 +129908,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -134393,8 +134425,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -135689,8 +135722,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -139195,8 +139229,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -140961,8 +140996,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -143622,8 +143658,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -145388,8 +145425,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -148639,8 +148677,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -150405,8 +150444,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -154518,7 +154558,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.6/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -156710,8 +156750,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -158476,8 +158517,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -185541,8 +185583,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -188125,8 +188168,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -190425,8 +190469,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -192898,8 +192943,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -200219,8 +200265,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -207540,8 +207587,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -208874,8 +208922,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -213883,8 +213932,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -216104,8 +216154,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -220467,7 +220518,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -230607,8 +230658,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -233264,8 +233316,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -235314,8 +235367,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -236752,8 +236806,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -237945,8 +238000,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -247495,8 +247551,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -249778,8 +249835,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -252629,8 +252687,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -255490,8 +255549,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -261497,8 +261557,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -265414,8 +265475,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -269213,8 +269275,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -272051,8 +272114,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -274915,8 +274979,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -277582,8 +277647,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -298891,8 +298957,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -308143,8 +308210,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -314146,8 +314214,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -315480,8 +315549,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -335308,8 +335378,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -336642,8 +336713,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -340024,8 +340096,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -341358,8 +341431,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -359778,8 +359852,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -361495,8 +361570,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -363313,8 +363389,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -365837,8 +365914,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -368269,8 +368347,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -370696,8 +370775,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -384389,8 +384469,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -386458,8 +386539,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -393661,8 +393743,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -396284,8 +396367,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -400468,8 +400552,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -402216,8 +402301,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -404328,8 +404414,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -406740,8 +406827,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -408362,8 +408450,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -410397,8 +410486,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -412538,8 +412628,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -413875,8 +413966,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -416131,8 +416223,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -420123,8 +420216,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -423329,8 +423423,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -426537,8 +426632,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -432676,8 +432772,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -435884,8 +435981,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -438571,8 +438669,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -440190,8 +440289,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -441392,8 +441492,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -443221,8 +443322,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", diff --git a/cache/ghes-3.6.json b/cache/ghes-3.6.json index ed54f5229..6b837b250 100644 --- a/cache/ghes-3.6.json +++ b/cache/ghes-3.6.json @@ -9495,7 +9495,7 @@ }, "examples": { "default": { - "$ref": "#/components/examples/organization-custom-repository-role-example-old" + "$ref": "#/components/examples/organization-custom-repository-role-example" } } } @@ -15317,8 +15317,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -19467,8 +19468,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -22632,7 +22634,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.6/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -29738,7 +29740,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -55258,8 +55260,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -59365,8 +59368,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -82180,7 +82184,7 @@ } ] }, - "organization-custom-repository-role-example-old": { + "organization-custom-repository-role-example": { "value": { "total_count": 2, "custom_roles": [ diff --git a/cache/github.ae.deref.json b/cache/github.ae.deref.json index 966d261cb..157583c9b 100644 --- a/cache/github.ae.deref.json +++ b/cache/github.ae.deref.json @@ -67405,8 +67405,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -92526,8 +92527,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -117634,7 +117636,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/github-ae@latest/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -180372,7 +180374,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/cache/github.ae.json b/cache/github.ae.json index 054874f73..597eeffc0 100644 --- a/cache/github.ae.json +++ b/cache/github.ae.json @@ -10914,8 +10914,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -15071,8 +15072,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -17332,7 +17334,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/github-ae@latest/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -24411,7 +24413,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/generated/api.github.com.deref.json b/generated/api.github.com.deref.json index 209b0f19d..c30cf3821 100644 --- a/generated/api.github.com.deref.json +++ b/generated/api.github.com.deref.json @@ -5512,8 +5512,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -15947,8 +15948,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -17235,8 +17237,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -24122,8 +24125,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -36759,8 +36763,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -39233,8 +39238,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -45089,8 +45095,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -47842,8 +47849,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -50067,8 +50075,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -51308,6 +51317,155 @@ "name": { "description": "The name of the custom role.", "type": "string" + }, + "description": { + "description": "A short description about who this role is for or what permissions it grants.", + "type": "string", + "nullable": true + }, + "base_role": { + "type": "string", + "description": "The system role from which this role inherits permissions.", + "enum": [ + "read", + "triage", + "write", + "maintain" + ] + }, + "permissions": { + "description": "A list of additional permissions included in this role.", + "type": "array", + "items": { + "type": "string" + } + }, + "organization": { + "title": "Simple User", + "description": "Simple User", + "type": "object", + "properties": { + "name": { + "nullable": true, + "type": "string" + }, + "email": { + "nullable": true, + "type": "string" + }, + "login": { + "type": "string", + "example": "octocat" + }, + "id": { + "type": "integer", + "example": 1 + }, + "node_id": { + "type": "string", + "example": "MDQ6VXNlcjE=" + }, + "avatar_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/images/error/octocat_happy.gif" + }, + "gravatar_id": { + "type": "string", + "example": "41d064eb2195891e12d0413f63227ea7", + "nullable": true + }, + "url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat" + }, + "html_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/octocat" + }, + "followers_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/followers" + }, + "following_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/following{/other_user}" + }, + "gists_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/gists{/gist_id}" + }, + "starred_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/starred{/owner}{/repo}" + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/subscriptions" + }, + "organizations_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/orgs" + }, + "repos_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/repos" + }, + "events_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/events{/privacy}" + }, + "received_events_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/received_events" + }, + "type": { + "type": "string", + "example": "User" + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "example": "\"2020-07-09T00:17:55Z\"" + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" } }, "required": [ @@ -51325,11 +51483,70 @@ "custom_roles": [ { "id": 8030, - "name": "Developer" + "name": "Security Engineer", + "description": "Able to contribute code and maintain the security pipeline", + "base_role": "maintain", + "permissions": [ + "delete_alerts_code_scanning" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:20:11Z" }, { "id": 8031, - "name": "Designer" + "name": "Community manager", + "description": "Able to handle all the community interactions without being able to contribute code", + "base_role": "read", + "permissions": [ + "mark_as_duplicate", + "manage_settings_pages", + "manage_settings_wiki", + "set_social_preview", + "edit_repo_metadata", + "toggle_discussion_comment_minimize" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-05T12:01:11Z", + "updated_at": "2022-07-05T12:20:11Z" } ] } @@ -54093,8 +54310,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -57133,8 +57351,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -59697,8 +59916,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -60985,8 +61205,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -64305,8 +64526,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -68657,8 +68879,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -69763,198 +69986,1061 @@ } } } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": false, - "category": "codespaces", - "subcategory": "organizations" - }, - "x-octokit": { - "changes": [ - { - "type": "PARAMETER", - "date": "2022-07-01", - "parameter": "org", - "before": { - "name": "org_id" - } - } - ] - } - } - }, - "/orgs/{org}/credential-authorizations": { - "get": { - "summary": "List SAML SSO authorizations for an organization", - "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `read:org` scope can list all credential authorizations for an organization that uses SAML single sign-on (SSO). The credentials are either personal access tokens or SSH keys that organization members have authorized for the organization. For more information, see [About authentication with SAML single sign-on](https://docs.github.com/en/articles/about-authentication-with-saml-single-sign-on).", - "tags": [ - "orgs" - ], - "operationId": "orgs/list-saml-sso-authorizations", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/orgs#list-saml-sso-authorizations-for-an-organization" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": false, + "category": "codespaces", + "subcategory": "organizations" + }, + "x-octokit": { + "changes": [ + { + "type": "PARAMETER", + "date": "2022-07-01", + "parameter": "org", + "before": { + "name": "org_id" + } + } + ] + } + } + }, + "/orgs/{org}/credential-authorizations": { + "get": { + "summary": "List SAML SSO authorizations for an organization", + "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `read:org` scope can list all credential authorizations for an organization that uses SAML single sign-on (SSO). The credentials are either personal access tokens or SSH keys that organization members have authorized for the organization. For more information, see [About authentication with SAML single sign-on](https://docs.github.com/en/articles/about-authentication-with-saml-single-sign-on).", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-saml-sso-authorizations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-saml-sso-authorizations-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100).", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "Page token", + "in": "query", + "schema": { + "type": "integer" + } + }, + { + "name": "login", + "description": "Limits the list of credentials authorizations for an organization to a specific login", + "in": "query", + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Credential Authorization", + "description": "Credential Authorization", + "type": "object", + "properties": { + "login": { + "type": "string", + "example": "monalisa", + "description": "User login that owns the underlying credential." + }, + "credential_id": { + "type": "integer", + "example": 1, + "description": "Unique identifier for the credential." + }, + "credential_type": { + "type": "string", + "example": "SSH Key", + "description": "Human-readable description of the credential type." + }, + "token_last_eight": { + "type": "string", + "example": "12345678", + "description": "Last eight characters of the credential. Only included in responses with credential_type of personal access token." + }, + "credential_authorized_at": { + "type": "string", + "format": "date-time", + "example": "2011-01-26T19:06:43Z", + "description": "Date when the credential was authorized for use." + }, + "scopes": { + "type": "array", + "example": [ + "user", + "repo" + ], + "description": "List of oauth scopes the token has been granted.", + "items": { + "type": "string" + } + }, + "fingerprint": { + "type": "string", + "example": "jklmnop12345678", + "description": "Unique string to distinguish the credential. Only included in responses with credential_type of SSH Key." + }, + "credential_accessed_at": { + "type": "string", + "format": "date-time", + "example": "2011-01-26T19:06:43Z", + "description": "Date when the credential was last accessed. May be null if it was never accessed", + "nullable": true + }, + "authorized_credential_id": { + "type": "integer", + "nullable": true, + "example": 12345678 + }, + "authorized_credential_title": { + "type": "string", + "nullable": true, + "example": "my ssh key", + "description": "The title given to the ssh key. This will only be present when the credential is an ssh key." + }, + "authorized_credential_note": { + "type": "string", + "nullable": true, + "example": "my token", + "description": "The note given to the token. This will only be present when the credential is a token." + }, + "authorized_credential_expires_at": { + "type": "string", + "format": "date-time", + "nullable": true, + "description": "The expiry for the token. This will only be present when the credential is a token." + } + }, + "required": [ + "login", + "credential_id", + "credential_type", + "credential_authorized_at", + "credential_accessed_at", + "authorized_credential_id" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "login": "octocat", + "credential_id": 161195, + "credential_type": "personal access token", + "token_last_eight": "71c3fc11", + "credential_authorized_at": "2011-01-26T19:06:43Z", + "authorized_credential_expires_at": "2011-02-25T19:06:43Z", + "scopes": [ + "user", + "repo" + ] + }, + { + "login": "hubot", + "credential_id": 161196, + "credential_type": "personal access token", + "token_last_eight": "Ae178B4a", + "credential_authorized_at": "2019-03-29T19:06:43Z", + "authorized_credential_expires_at": "2019-04-28T19:06:43Z", + "scopes": [ + "repo" + ] + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": null + }, + "x-octokit": {} + } + }, + "/orgs/{org}/credential-authorizations/{credential_id}": { + "delete": { + "summary": "Remove a SAML SSO authorization for an organization", + "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `admin:org` scope can remove a credential authorization for an organization that uses SAML SSO. Once you remove someone's credential authorization, they will need to create a new personal access token or SSH key and authorize it for the organization they want to access.", + "tags": [ + "orgs" + ], + "operationId": "orgs/remove-saml-sso-authorization", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#remove-a-saml-sso-authorization-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "credential_id", + "in": "path", + "required": true, + "schema": { + "type": "integer" + } + } + ], + "responses": { + "204": { + "description": "Response" + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": null + }, + "x-octokit": {} + } + }, + "/orgs/{org}/custom_roles": { + "post": { + "summary": "Create a custom role", + "description": "**Note**: This operation is in beta and is subject to change.\n\nCreates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information on custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/create-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#create-a-custom-role" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the custom role." + }, + "description": { + "type": "string", + "description": "A short description about the intended usage of this role or what permissions it grants." + }, + "base_role": { + "type": "string", + "enum": [ + "read", + "triage", + "write", + "maintain" + ], + "description": "The system role from which this role inherits permissions." + }, + "permissions": { + "type": "array", + "description": "A list of additional permissions included in this role.", + "items": { + "type": "string" + } + } + }, + "required": [ + "name", + "base_role", + "permissions" + ] + }, + "examples": { + "default": { + "value": { + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label" + ] + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Organization Custom Repository Role", + "description": "Custom repository roles created by organization administrators", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the custom role.", + "type": "integer" + }, + "name": { + "description": "The name of the custom role.", + "type": "string" + }, + "description": { + "description": "A short description about who this role is for or what permissions it grants.", + "type": "string", + "nullable": true + }, + "base_role": { + "type": "string", + "description": "The system role from which this role inherits permissions.", + "enum": [ + "read", + "triage", + "write", + "maintain" + ] + }, + "permissions": { + "description": "A list of additional permissions included in this role.", + "type": "array", + "items": { + "type": "string" + } + }, + "organization": { + "title": "Simple User", + "description": "Simple User", + "type": "object", + "properties": { + "name": { + "nullable": true, + "type": "string" + }, + "email": { + "nullable": true, + "type": "string" + }, + "login": { + "type": "string", + "example": "octocat" + }, + "id": { + "type": "integer", + "example": 1 + }, + "node_id": { + "type": "string", + "example": "MDQ6VXNlcjE=" + }, + "avatar_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/images/error/octocat_happy.gif" + }, + "gravatar_id": { + "type": "string", + "example": "41d064eb2195891e12d0413f63227ea7", + "nullable": true + }, + "url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat" + }, + "html_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/octocat" + }, + "followers_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/followers" + }, + "following_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/following{/other_user}" + }, + "gists_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/gists{/gist_id}" + }, + "starred_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/starred{/owner}{/repo}" + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/subscriptions" + }, + "organizations_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/orgs" + }, + "repos_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/repos" + }, + "events_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/events{/privacy}" + }, + "received_events_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/received_events" + }, + "type": { + "type": "string", + "example": "User" + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "example": "\"2020-07-09T00:17:55Z\"" + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "name" + ] + }, + "examples": { + "default": { + "value": { + "id": 8030, + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:19:11Z" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "422": { + "description": "Validation failed", + "content": { + "application/json": { + "schema": { + "title": "Validation Error", + "description": "Validation Error", + "type": "object", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "required": [ + "code" + ], + "properties": { + "resource": { + "type": "string" + }, + "field": { + "type": "string" + }, + "message": { + "type": "string" + }, + "code": { + "type": "string" + }, + "index": { + "type": "integer" + }, + "value": { + "oneOf": [ + { + "type": "string", + "nullable": true + }, + { + "type": "integer", + "nullable": true + }, + { + "type": "array", + "nullable": true, + "items": { + "type": "string" + } + } + ] + } + } + } + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "custom-roles" + }, + "x-octokit": {} + } + }, + "/orgs/{org}/custom_roles/{role_id}": { + "patch": { + "summary": "Update a custom role", + "description": "**Note**: This operation is in beta and subject to change.\n\nUpdates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/update-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#update-a-custom-role" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "role_id", + "description": "The unique identifier of the role.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the custom role." + }, + "description": { + "type": "string", + "description": "A short description about who this role is for or what permissions it grants." + }, + "base_role": { + "type": "string", + "enum": [ + "read", + "triage", + "write", + "maintain" + ], + "description": "The system role from which this role inherits permissions." + }, + "permissions": { + "type": "array", + "description": "A list of additional permissions included in this role. If specified, these permissions will replace any currently set on the role.", + "items": { + "type": "string" + } + } + } + }, + "examples": { + "default": { + "value": { + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label", + "remove_label" + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Organization Custom Repository Role", + "description": "Custom repository roles created by organization administrators", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the custom role.", + "type": "integer" + }, + "name": { + "description": "The name of the custom role.", + "type": "string" + }, + "description": { + "description": "A short description about who this role is for or what permissions it grants.", + "type": "string", + "nullable": true + }, + "base_role": { + "type": "string", + "description": "The system role from which this role inherits permissions.", + "enum": [ + "read", + "triage", + "write", + "maintain" + ] + }, + "permissions": { + "description": "A list of additional permissions included in this role.", + "type": "array", + "items": { + "type": "string" + } + }, + "organization": { + "title": "Simple User", + "description": "Simple User", + "type": "object", + "properties": { + "name": { + "nullable": true, + "type": "string" + }, + "email": { + "nullable": true, + "type": "string" + }, + "login": { + "type": "string", + "example": "octocat" + }, + "id": { + "type": "integer", + "example": 1 + }, + "node_id": { + "type": "string", + "example": "MDQ6VXNlcjE=" + }, + "avatar_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/images/error/octocat_happy.gif" + }, + "gravatar_id": { + "type": "string", + "example": "41d064eb2195891e12d0413f63227ea7", + "nullable": true + }, + "url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat" + }, + "html_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/octocat" + }, + "followers_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/followers" + }, + "following_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/following{/other_user}" + }, + "gists_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/gists{/gist_id}" + }, + "starred_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/starred{/owner}{/repo}" + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/subscriptions" + }, + "organizations_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/orgs" + }, + "repos_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/repos" + }, + "events_url": { + "type": "string", + "example": "https://github.com/gitapi/users/octocat/events{/privacy}" + }, + "received_events_url": { + "type": "string", + "format": "uri", + "example": "https://github.com/gitapi/users/octocat/received_events" + }, + "type": { + "type": "string", + "example": "User" + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "example": "\"2020-07-09T00:17:55Z\"" + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "name" + ] + }, + "examples": { + "default": { + "value": { + "id": 8030, + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label", + "remove_label" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:19:11Z" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } }, - { - "name": "per_page", - "description": "The number of results per page (max 100).", - "in": "query", - "schema": { - "type": "integer", - "default": 30 - } - }, - { - "name": "page", - "description": "Page token", - "in": "query", - "schema": { - "type": "integer" - } - }, - { - "name": "login", - "description": "Limits the list of credentials authorizations for an organization to a specific login", - "in": "query", - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "Response", + "422": { + "description": "Validation failed", "content": { "application/json": { "schema": { - "type": "array", - "items": { - "title": "Credential Authorization", - "description": "Credential Authorization", - "type": "object", - "properties": { - "login": { - "type": "string", - "example": "monalisa", - "description": "User login that owns the underlying credential." - }, - "credential_id": { - "type": "integer", - "example": 1, - "description": "Unique identifier for the credential." - }, - "credential_type": { - "type": "string", - "example": "SSH Key", - "description": "Human-readable description of the credential type." - }, - "token_last_eight": { - "type": "string", - "example": "12345678", - "description": "Last eight characters of the credential. Only included in responses with credential_type of personal access token." - }, - "credential_authorized_at": { - "type": "string", - "format": "date-time", - "example": "2011-01-26T19:06:43Z", - "description": "Date when the credential was authorized for use." - }, - "scopes": { - "type": "array", - "example": [ - "user", - "repo" + "title": "Validation Error", + "description": "Validation Error", + "type": "object", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "required": [ + "code" ], - "description": "List of oauth scopes the token has been granted.", - "items": { - "type": "string" + "properties": { + "resource": { + "type": "string" + }, + "field": { + "type": "string" + }, + "message": { + "type": "string" + }, + "code": { + "type": "string" + }, + "index": { + "type": "integer" + }, + "value": { + "oneOf": [ + { + "type": "string", + "nullable": true + }, + { + "type": "integer", + "nullable": true + }, + { + "type": "array", + "nullable": true, + "items": { + "type": "string" + } + } + ] + } } - }, - "fingerprint": { - "type": "string", - "example": "jklmnop12345678", - "description": "Unique string to distinguish the credential. Only included in responses with credential_type of SSH Key." - }, - "credential_accessed_at": { - "type": "string", - "format": "date-time", - "example": "2011-01-26T19:06:43Z", - "description": "Date when the credential was last accessed. May be null if it was never accessed", - "nullable": true - }, - "authorized_credential_id": { - "type": "integer", - "nullable": true, - "example": 12345678 - }, - "authorized_credential_title": { - "type": "string", - "nullable": true, - "example": "my ssh key", - "description": "The title given to the ssh key. This will only be present when the credential is an ssh key." - }, - "authorized_credential_note": { - "type": "string", - "nullable": true, - "example": "my token", - "description": "The note given to the token. This will only be present when the credential is a token." - }, - "authorized_credential_expires_at": { - "type": "string", - "format": "date-time", - "nullable": true, - "description": "The expiry for the token. This will only be present when the credential is a token." } - }, - "required": [ - "login", - "credential_id", - "credential_type", - "credential_authorized_at", - "credential_accessed_at", - "authorized_credential_id" - ] - } - }, - "examples": { - "default": { - "value": [ - { - "login": "octocat", - "credential_id": 161195, - "credential_type": "personal access token", - "token_last_eight": "71c3fc11", - "credential_authorized_at": "2011-01-26T19:06:43Z", - "authorized_credential_expires_at": "2011-02-25T19:06:43Z", - "scopes": [ - "user", - "repo" - ] - }, - { - "login": "hubot", - "credential_id": 161196, - "credential_type": "personal access token", - "token_last_eight": "Ae178B4a", - "credential_authorized_at": "2019-03-29T19:06:43Z", - "authorized_credential_expires_at": "2019-04-28T19:06:43Z", - "scopes": [ - "repo" - ] - } - ] + } } } } @@ -69962,25 +71048,23 @@ } }, "x-github": { - "githubCloudOnly": true, + "githubCloudOnly": false, "enabledForGitHubApps": true, "category": "orgs", - "subcategory": null + "subcategory": "custom-roles" }, "x-octokit": {} - } - }, - "/orgs/{org}/credential-authorizations/{credential_id}": { + }, "delete": { - "summary": "Remove a SAML SSO authorization for an organization", - "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `admin:org` scope can remove a credential authorization for an organization that uses SAML SSO. Once you remove someone's credential authorization, they will need to create a new personal access token or SSH key and authorize it for the organization they want to access.", + "summary": "Delete a custom role", + "description": "**Note**: This operation is in beta and is subject to change.\n\nDeletes a custom role from an organization. Once the custom role has been deleted, any\nuser, team, or invitation with the deleted custom role will be reassigned the inherited role.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", "tags": [ "orgs" ], - "operationId": "orgs/remove-saml-sso-authorization", + "operationId": "orgs/delete-custom-role", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/orgs#remove-a-saml-sso-authorization-for-an-organization" + "url": "https://docs.github.com/rest/reference/orgs#delete-a-custom-role" }, "parameters": [ { @@ -69993,7 +71077,8 @@ } }, { - "name": "credential_id", + "name": "role_id", + "description": "The unique identifier of the role.", "in": "path", "required": true, "schema": { @@ -70004,39 +71089,14 @@ "responses": { "204": { "description": "Response" - }, - "404": { - "description": "Resource not found", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" - } - } - } - } - } } }, "x-github": { - "githubCloudOnly": true, + "githubCloudOnly": false, "enabledForGitHubApps": true, + "previews": [], "category": "orgs", - "subcategory": null + "subcategory": "custom-roles" }, "x-octokit": {} } @@ -72072,8 +73132,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -74732,8 +75793,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -76481,6 +77543,86 @@ "x-octokit": {} } }, + "/orgs/{org}/fine_grained_permissions": { + "get": { + "summary": "List fine-grained permissions for an organization", + "description": "**Note**: This operation is in beta and subject to change.\n\nLists the fine-grained permissions available for an organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organizaiton and must use an access token with `admin:org repo` scope.\nGitHub Apps must have the `organization_custom_roles:read` organization permission to use this endpoint.", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-fine-grained-permissions", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-fine-grained-permissions-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Organization Fine-Grained Permission", + "description": "Fine-grained permissions available for the organization", + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "required": [ + "name", + "description" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "name": "add_assignee", + "description": "Assign or remove a user" + }, + { + "name": "remove_assignee", + "description": "Remove an assigned user" + }, + { + "name": "add_label", + "description": "Add or remove a label" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "previews": [], + "category": "orgs", + "subcategory": "custom-roles" + }, + "x-octokit": {} + } + }, "/orgs/{org}/hooks": { "get": { "summary": "List organization webhooks", @@ -83921,8 +85063,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -87121,8 +88264,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -90170,8 +91314,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -91865,8 +93010,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -93589,8 +94735,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -95745,8 +96892,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -98318,8 +99466,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -100462,8 +101611,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -101113,15 +102263,15 @@ }, "/orgs/{org}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by an organization", - "description": "Returns all package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by an organization", + "description": "Lists package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-org", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-an-organization" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-an-organization" }, "parameters": [ { @@ -104720,8 +105870,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -105260,8 +106411,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -106364,8 +107516,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -119475,8 +120628,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -121525,8 +122679,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -129981,8 +131136,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -131419,8 +132575,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -132612,8 +133769,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -133693,8 +134851,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -135275,8 +136434,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -136713,8 +137873,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -137906,8 +139067,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -143048,8 +144210,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -144345,8 +145508,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -147868,8 +149032,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -149634,8 +150799,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -152296,8 +153462,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -154062,8 +155229,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -157440,8 +158608,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -159206,8 +160375,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -163571,7 +164741,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -165772,8 +166942,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -167538,8 +168709,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -194816,8 +195988,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -197400,8 +198573,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -199701,8 +200875,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -202175,8 +203350,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -209458,8 +210634,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -212265,8 +213442,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -214719,8 +215897,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -218818,8 +219997,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -226154,8 +227334,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -227488,8 +228669,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -232500,8 +233682,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -234722,8 +235905,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -239409,7 +240593,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -249933,8 +251117,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -252591,8 +253776,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -254650,8 +255836,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -256088,8 +257275,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -257281,8 +258469,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -268855,8 +270044,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -271139,8 +272329,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -273992,8 +275183,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -276854,8 +278046,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -282869,8 +284062,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -286787,8 +287981,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -290587,8 +291782,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -293426,8 +294622,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -296291,8 +297488,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -320153,8 +321351,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -329467,8 +330666,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -335753,8 +336953,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -337087,8 +338288,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -353006,8 +354208,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -355460,8 +356663,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -362029,8 +363233,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -363363,8 +364568,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -366746,8 +367952,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -368080,8 +369287,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -387213,8 +388421,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -389079,8 +390288,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -390878,8 +392088,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -398866,8 +400077,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -401299,8 +402511,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -403727,8 +404940,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -416300,8 +417514,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -418370,8 +419585,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -423649,8 +424865,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -426639,8 +427856,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -429093,8 +430311,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -431920,8 +433139,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -434815,8 +436035,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -437442,8 +438663,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -440804,8 +442026,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -443511,8 +444734,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -449554,8 +450778,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -452512,8 +453737,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -457366,8 +458592,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -459115,8 +460342,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -460854,8 +462082,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -463169,8 +464398,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -465532,8 +466762,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -467615,8 +468846,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -468315,15 +469547,15 @@ }, "/user/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by the authenticated user", - "description": "Returns all package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by the authenticated user", + "description": "Lists package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" }, "parameters": [ { @@ -470889,8 +472121,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -472512,8 +473745,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -474548,8 +475782,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -477417,8 +478652,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -478754,8 +479990,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -481014,8 +482251,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -485011,8 +486249,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -488218,8 +489457,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -491427,8 +492667,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -496793,8 +498034,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -498937,8 +500179,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -499655,15 +500898,15 @@ }, "/users/{username}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by a user", - "description": "Returns all package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by a user", + "description": "Lists package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-a-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-a-user" }, "parameters": [ { @@ -502957,8 +504200,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -506166,8 +507410,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -508854,8 +510099,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -510803,8 +512049,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -512005,8 +513252,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -513835,8 +515083,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", diff --git a/generated/api.github.com.json b/generated/api.github.com.json index 9c4c98adb..81201a72a 100644 --- a/generated/api.github.com.json +++ b/generated/api.github.com.json @@ -6969,7 +6969,7 @@ }, "examples": { "default": { - "$ref": "#/components/examples/organization-custom-repository-role-example-old" + "$ref": "#/components/examples/organization-custom-repository-role-example" } } } @@ -10292,6 +10292,305 @@ "x-octokit": {} } }, + "/orgs/{org}/custom_roles": { + "post": { + "summary": "Create a custom role", + "description": "**Note**: This operation is in beta and is subject to change.\n\nCreates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information on custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/create-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#create-a-custom-role" + }, + "parameters": [ + { + "$ref": "#/components/parameters/org" + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the custom role." + }, + "description": { + "type": "string", + "description": "A short description about the intended usage of this role or what permissions it grants." + }, + "base_role": { + "type": "string", + "enum": [ + "read", + "triage", + "write", + "maintain" + ], + "description": "The system role from which this role inherits permissions." + }, + "permissions": { + "type": "array", + "description": "A list of additional permissions included in this role.", + "items": { + "type": "string" + } + } + }, + "required": [ + "name", + "base_role", + "permissions" + ] + }, + "examples": { + "default": { + "value": { + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label" + ] + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/organization-custom-repository-role" + }, + "examples": { + "default": { + "value": { + "id": 8030, + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:19:11Z" + } + } + } + } + } + }, + "404": { + "$ref": "#/components/responses/not_found" + }, + "422": { + "$ref": "#/components/responses/validation_failed" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "custom-roles" + }, + "x-octokit": {} + } + }, + "/orgs/{org}/custom_roles/{role_id}": { + "patch": { + "summary": "Update a custom role", + "description": "**Note**: This operation is in beta and subject to change.\n\nUpdates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/update-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#update-a-custom-role" + }, + "parameters": [ + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/role-id" + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the custom role." + }, + "description": { + "type": "string", + "description": "A short description about who this role is for or what permissions it grants." + }, + "base_role": { + "type": "string", + "enum": [ + "read", + "triage", + "write", + "maintain" + ], + "description": "The system role from which this role inherits permissions." + }, + "permissions": { + "type": "array", + "description": "A list of additional permissions included in this role. If specified, these permissions will replace any currently set on the role.", + "items": { + "type": "string" + } + } + } + }, + "examples": { + "default": { + "value": { + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label", + "remove_label" + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/organization-custom-repository-role" + }, + "examples": { + "default": { + "value": { + "id": 8030, + "name": "Labeler", + "description": "A role for issue and PR labelers", + "base_role": "read", + "permissions": [ + "add_label", + "remove_label" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:19:11Z" + } + } + } + } + } + }, + "404": { + "$ref": "#/components/responses/not_found" + }, + "422": { + "$ref": "#/components/responses/validation_failed" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "custom-roles" + }, + "x-octokit": {} + }, + "delete": { + "summary": "Delete a custom role", + "description": "**Note**: This operation is in beta and is subject to change.\n\nDeletes a custom role from an organization. Once the custom role has been deleted, any\nuser, team, or invitation with the deleted custom role will be reassigned the inherited role.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"", + "tags": [ + "orgs" + ], + "operationId": "orgs/delete-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#delete-a-custom-role" + }, + "parameters": [ + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/role-id" + } + ], + "responses": { + "204": { + "description": "Response" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "previews": [], + "category": "orgs", + "subcategory": "custom-roles" + }, + "x-octokit": {} + } + }, "/orgs/{org}/dependabot/secrets": { "get": { "summary": "List organization secrets", @@ -11035,6 +11334,53 @@ "x-octokit": {} } }, + "/orgs/{org}/fine_grained_permissions": { + "get": { + "summary": "List fine-grained permissions for an organization", + "description": "**Note**: This operation is in beta and subject to change.\n\nLists the fine-grained permissions available for an organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organizaiton and must use an access token with `admin:org repo` scope.\nGitHub Apps must have the `organization_custom_roles:read` organization permission to use this endpoint.", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-fine-grained-permissions", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-fine-grained-permissions-for-an-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/org" + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/organization-fine-grained-permission" + } + }, + "examples": { + "default": { + "$ref": "#/components/examples/organization-fine-grained-permission-example" + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "previews": [], + "category": "orgs", + "subcategory": "custom-roles" + }, + "x-octokit": {} + } + }, "/orgs/{org}/hooks": { "get": { "summary": "List organization webhooks", @@ -13708,15 +14054,15 @@ }, "/orgs/{org}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by an organization", - "description": "Returns all package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by an organization", + "description": "Lists package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-org", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-an-organization" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-an-organization" }, "parameters": [ { @@ -14484,8 +14830,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -19395,8 +19742,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -22915,7 +23263,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -31012,7 +31360,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -56051,15 +56399,15 @@ }, "/user/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by the authenticated user", - "description": "Returns all package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by the authenticated user", + "description": "Lists package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" }, "parameters": [ { @@ -58547,15 +58895,15 @@ }, "/users/{username}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by a user", - "description": "Returns all package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", + "summary": "List package versions for a package owned by a user", + "description": "Lists package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.", "tags": [ "packages" ], "operationId": "packages/get-all-package-versions-for-package-owned-by-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-a-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-a-user" }, "parameters": [ { @@ -61660,8 +62008,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -66618,8 +66967,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -67323,6 +67673,39 @@ "name": { "description": "The name of the custom role.", "type": "string" + }, + "description": { + "description": "A short description about who this role is for or what permissions it grants.", + "type": "string", + "nullable": true + }, + "base_role": { + "type": "string", + "description": "The system role from which this role inherits permissions.", + "enum": [ + "read", + "triage", + "write", + "maintain" + ] + }, + "permissions": { + "description": "A list of additional permissions included in this role.", + "type": "array", + "items": { + "type": "string" + } + }, + "organization": { + "$ref": "#/components/schemas/simple-user" + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" } }, "required": [ @@ -68506,6 +68889,23 @@ "node_id" ] }, + "organization-fine-grained-permission": { + "title": "Organization Fine-Grained Permission", + "description": "Fine-grained permissions available for the organization", + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "required": [ + "name", + "description" + ] + }, "org-hook": { "title": "Org Hook", "description": "Org Hook", @@ -91963,17 +92363,76 @@ } ] }, - "organization-custom-repository-role-example-old": { + "organization-custom-repository-role-example": { "value": { "total_count": 2, "custom_roles": [ { "id": 8030, - "name": "Developer" + "name": "Security Engineer", + "description": "Able to contribute code and maintain the security pipeline", + "base_role": "maintain", + "permissions": [ + "delete_alerts_code_scanning" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-04T22:19:11Z", + "updated_at": "2022-07-04T22:20:11Z" }, { "id": 8031, - "name": "Designer" + "name": "Community manager", + "description": "Able to handle all the community interactions without being able to contribute code", + "base_role": "read", + "permissions": [ + "mark_as_duplicate", + "manage_settings_pages", + "manage_settings_wiki", + "set_social_preview", + "edit_repo_metadata", + "toggle_discussion_comment_minimize" + ], + "organization": { + "login": "github", + "id": 9919, + "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=", + "avatar_url": "https://github.com/avatars/u/9919?v=4", + "gravatar_id": "", + "url": "https://github.com/gitapi/users/github", + "html_url": "https://github.com/github", + "followers_url": "https://github.com/gitapi/users/github/followers", + "following_url": "https://github.com/gitapi/users/github/following{/other_user}", + "gists_url": "https://github.com/gitapi/users/github/gists{/gist_id}", + "starred_url": "https://github.com/gitapi/users/github/starred{/owner}{/repo}", + "subscriptions_url": "https://github.com/gitapi/users/github/subscriptions", + "organizations_url": "https://github.com/gitapi/users/github/orgs", + "repos_url": "https://github.com/gitapi/users/github/repos", + "events_url": "https://github.com/gitapi/users/github/events{/privacy}", + "received_events_url": "https://github.com/gitapi/users/github/received_events", + "type": "Organization", + "site_admin": false + }, + "created_at": "2022-07-05T12:01:11Z", + "updated_at": "2022-07-05T12:20:11Z" } ] } @@ -93375,6 +93834,22 @@ } ] }, + "organization-fine-grained-permission-example": { + "value": [ + { + "name": "add_assignee", + "description": "Assign or remove a user" + }, + { + "name": "remove_assignee", + "description": "Remove an assigned user" + }, + { + "name": "add_label", + "description": "Add or remove a label" + } + ] + }, "org-hook-items": { "value": [ { @@ -112948,6 +113423,15 @@ "type": "string" } }, + "role-id": { + "name": "role_id", + "description": "The unique identifier of the role.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + } + }, "group-id": { "name": "group_id", "description": "The unique identifier of the group.", diff --git a/generated/ghes-3.2-diff-to-ghes-3.3.deref.json b/generated/ghes-3.2-diff-to-ghes-3.3.deref.json index df52dcd35..db4ef802e 100644 --- a/generated/ghes-3.2-diff-to-ghes-3.3.deref.json +++ b/generated/ghes-3.2-diff-to-ghes-3.3.deref.json @@ -35253,8 +35253,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -46071,8 +46072,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -61974,7 +61976,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.2/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" diff --git a/generated/ghes-3.2-diff-to-ghes-3.3.json b/generated/ghes-3.2-diff-to-ghes-3.3.json index e13d86d57..b7393dbdb 100644 --- a/generated/ghes-3.2-diff-to-ghes-3.3.json +++ b/generated/ghes-3.2-diff-to-ghes-3.3.json @@ -1989,8 +1989,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -2448,8 +2449,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -2978,7 +2980,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.2/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" diff --git a/generated/ghes-3.2.deref.json b/generated/ghes-3.2.deref.json index 28c344fe1..214500b55 100644 --- a/generated/ghes-3.2.deref.json +++ b/generated/ghes-3.2.deref.json @@ -85860,8 +85860,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -111466,8 +111467,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -132073,7 +132075,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.2/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -192201,7 +192203,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/generated/ghes-3.2.json b/generated/ghes-3.2.json index 4e289b8d4..3a492b95e 100644 --- a/generated/ghes-3.2.json +++ b/generated/ghes-3.2.json @@ -13884,8 +13884,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -18298,8 +18299,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -20633,7 +20635,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.2/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -27623,7 +27625,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/generated/ghes-3.3.deref.json b/generated/ghes-3.3.deref.json index 07cdd397d..ab283fed0 100644 --- a/generated/ghes-3.3.deref.json +++ b/generated/ghes-3.3.deref.json @@ -86628,8 +86628,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -112510,8 +112511,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -133259,7 +133261,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.3/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -194016,7 +194018,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/generated/ghes-3.3.json b/generated/ghes-3.3.json index a72227e73..84de46bc5 100644 --- a/generated/ghes-3.3.json +++ b/generated/ghes-3.3.json @@ -13799,8 +13799,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -18013,8 +18014,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -20295,7 +20297,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.3/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -27496,7 +27498,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/generated/ghes-3.4-diff-to-ghes-3.5.deref.json b/generated/ghes-3.4-diff-to-ghes-3.5.deref.json index fb1528cab..dbd8919db 100644 --- a/generated/ghes-3.4-diff-to-ghes-3.5.deref.json +++ b/generated/ghes-3.4-diff-to-ghes-3.5.deref.json @@ -26853,7 +26853,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.4/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" diff --git a/generated/ghes-3.4-diff-to-ghes-3.5.json b/generated/ghes-3.4-diff-to-ghes-3.5.json index f43327728..c7b40aeca 100644 --- a/generated/ghes-3.4-diff-to-ghes-3.5.json +++ b/generated/ghes-3.4-diff-to-ghes-3.5.json @@ -1801,7 +1801,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.4/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" diff --git a/generated/ghes-3.4.deref.json b/generated/ghes-3.4.deref.json index 4441fa373..b17d90358 100644 --- a/generated/ghes-3.4.deref.json +++ b/generated/ghes-3.4.deref.json @@ -95211,8 +95211,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -121289,8 +121290,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -142981,7 +142983,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.4/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -207541,7 +207543,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/generated/ghes-3.4.json b/generated/ghes-3.4.json index 926e2ef29..e864ba1c9 100644 --- a/generated/ghes-3.4.json +++ b/generated/ghes-3.4.json @@ -9445,7 +9445,7 @@ }, "examples": { "default": { - "$ref": "#/components/examples/organization-custom-repository-role-example-old" + "$ref": "#/components/examples/organization-custom-repository-role-example" } } } @@ -15079,8 +15079,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -19351,8 +19352,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -21919,7 +21921,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.4/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -29056,7 +29058,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -81501,7 +81503,7 @@ } ] }, - "organization-custom-repository-role-example-old": { + "organization-custom-repository-role-example": { "value": { "total_count": 2, "custom_roles": [ diff --git a/generated/ghes-3.5-diff-to-ghes-3.6.deref.json b/generated/ghes-3.5-diff-to-ghes-3.6.deref.json index f93c4f323..746051d2a 100644 --- a/generated/ghes-3.5-diff-to-ghes-3.6.deref.json +++ b/generated/ghes-3.5-diff-to-ghes-3.6.deref.json @@ -45138,8 +45138,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -58342,8 +58343,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -78786,7 +78788,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.5/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" diff --git a/generated/ghes-3.5-diff-to-ghes-3.6.json b/generated/ghes-3.5-diff-to-ghes-3.6.json index 5ebcf6458..d1655be0f 100644 --- a/generated/ghes-3.5-diff-to-ghes-3.6.json +++ b/generated/ghes-3.5-diff-to-ghes-3.6.json @@ -2551,8 +2551,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -3352,8 +3353,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -4001,7 +4003,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.5/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" diff --git a/generated/ghes-3.5.deref.json b/generated/ghes-3.5.deref.json index 12d66c5b1..09f6d3f0e 100644 --- a/generated/ghes-3.5.deref.json +++ b/generated/ghes-3.5.deref.json @@ -97394,8 +97394,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -123389,8 +123390,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -151059,7 +151061,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.5/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -216131,7 +216133,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", diff --git a/generated/ghes-3.5.json b/generated/ghes-3.5.json index 619464d3b..a5a62083c 100644 --- a/generated/ghes-3.5.json +++ b/generated/ghes-3.5.json @@ -9637,7 +9637,7 @@ }, "examples": { "default": { - "$ref": "#/components/examples/organization-custom-repository-role-example-old" + "$ref": "#/components/examples/organization-custom-repository-role-example" } } } @@ -15658,8 +15658,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -19908,8 +19909,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -23072,7 +23074,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.5/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -30276,7 +30278,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -83151,7 +83153,7 @@ } ] }, - "organization-custom-repository-role-example-old": { + "organization-custom-repository-role-example": { "value": { "total_count": 2, "custom_roles": [ diff --git a/generated/ghes-3.6-anicca-diff-to-api.github.com.deref.json b/generated/ghes-3.6-anicca-diff-to-api.github.com.deref.json index 3fae82178..50d1866ba 100644 --- a/generated/ghes-3.6-anicca-diff-to-api.github.com.deref.json +++ b/generated/ghes-3.6-anicca-diff-to-api.github.com.deref.json @@ -17568,6 +17568,42 @@ } } }, + "/organizations/{organization_id}/custom_roles": { + "get": { + "responses": { + "changed": { + "200": { + "content": { + "changed": { + "application/json": { + "schema_changed": { + "properties_changed": { + "changed": { + "custom_roles": { + "items_changed": { + "properties_changed": { + "removed": [ + "base_role", + "created_at", + "description", + "organization", + "permissions", + "updated_at" + ] + } + } + } + } + } + } + } + } + } + } + } + } + } + }, "/orgs/{org}": { "get": { "responses": { @@ -18602,6 +18638,13 @@ "/orgs/{org}/credential-authorizations/{credential_id}": [ "delete" ], + "/orgs/{org}/custom_roles": [ + "post" + ], + "/orgs/{org}/custom_roles/{role_id}": [ + "delete", + "patch" + ], "/orgs/{org}/external-group/{group_id}": [ "get" ], @@ -18611,6 +18654,9 @@ "/orgs/{org}/failed_invitations": [ "get" ], + "/orgs/{org}/fine_grained_permissions": [ + "get" + ], "/orgs/{org}/interaction-limits": [ "get", "put", diff --git a/generated/ghes-3.6-diff-to-api.github.com.deref.json b/generated/ghes-3.6-diff-to-api.github.com.deref.json index 606c7f0f1..765ed3e44 100644 --- a/generated/ghes-3.6-diff-to-api.github.com.deref.json +++ b/generated/ghes-3.6-diff-to-api.github.com.deref.json @@ -9553,8 +9553,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -21783,6 +21784,102 @@ } } }, + "/organizations/{organization_id}/custom_roles": { + "get": { + "summary": "List custom repository roles in an organization", + "description": "List the custom repository roles available in this organization. In order to see custom\nrepository roles in an organization, the authenticated user must be an organization owner.\n\nTo use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organizaiton and must use an access token with `admin:org repo` scope.\nGitHub Apps must have the `organization_custom_roles:read` organization permission to use this endpoint.\n\nFor more information on custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/enterprise-server@3.6/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization)\".", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-custom-roles", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-server@3.6/rest/reference/orgs#list-custom-repository-roles-in-an-organization" + }, + "parameters": [ + { + "name": "organization_id", + "description": "The unique identifier of the organization.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response - list of custom role names", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "total_count": { + "description": "The number of custom roles in this organization", + "example": 3, + "type": "integer" + }, + "custom_roles": { + "type": "array", + "items": { + "title": "Organization Custom Repository Role", + "description": "Custom repository roles created by organization administrators", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the custom role.", + "type": "integer" + }, + "name": { + "description": "The name of the custom role.", + "type": "string" + } + }, + "required": [ + "id", + "name" + ] + } + } + } + }, + "examples": { + "default": { + "value": { + "total_count": 2, + "custom_roles": [ + { + "id": 8030, + "name": "Developer" + }, + { + "id": 8031, + "name": "Designer" + } + ] + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "custom_roles" + }, + "x-octokit": { + "diff": { + "api.github.com": { + "type": "changed" + } + } + } + } + }, "/orgs/{org}": { "get": { "summary": "Get an organization", @@ -30100,8 +30197,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -31866,8 +31964,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -32448,7 +32547,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.6/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -34640,8 +34739,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -36406,8 +36506,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -39910,8 +40011,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -41348,8 +41450,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -42541,8 +42644,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -51539,8 +51643,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", diff --git a/generated/ghes-3.6-diff-to-api.github.com.json b/generated/ghes-3.6-diff-to-api.github.com.json index fa4840621..bb3b9d95e 100644 --- a/generated/ghes-3.6-diff-to-api.github.com.json +++ b/generated/ghes-3.6-diff-to-api.github.com.json @@ -4706,6 +4706,74 @@ } } }, + "/organizations/{organization_id}/custom_roles": { + "get": { + "summary": "List custom repository roles in an organization", + "description": "List the custom repository roles available in this organization. In order to see custom\nrepository roles in an organization, the authenticated user must be an organization owner.\n\nTo use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organizaiton and must use an access token with `admin:org repo` scope.\nGitHub Apps must have the `organization_custom_roles:read` organization permission to use this endpoint.\n\nFor more information on custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/enterprise-server@3.6/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization)\".", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-custom-roles", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-server@3.6/rest/reference/orgs#list-custom-repository-roles-in-an-organization" + }, + "parameters": [ + { + "name": "organization_id", + "description": "The unique identifier of the organization.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response - list of custom role names", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "total_count": { + "description": "The number of custom roles in this organization", + "example": 3, + "type": "integer" + }, + "custom_roles": { + "type": "array", + "items": { + "$ref": "#/components/schemas/organization-custom-repository-role" + } + } + } + }, + "examples": { + "default": { + "$ref": "#/components/examples/organization-custom-repository-role-example" + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "custom_roles" + }, + "x-octokit": { + "diff": { + "api.github.com": { + "type": "changed" + } + } + } + } + }, "/orgs/{org}": { "get": { "summary": "Get an organization", @@ -6080,7 +6148,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.6/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -11291,6 +11359,25 @@ "verifiable_password_authentication" ] }, + "organization-custom-repository-role": { + "title": "Organization Custom Repository Role", + "description": "Custom repository roles created by organization administrators", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the custom role.", + "type": "integer" + }, + "name": { + "description": "The name of the custom role.", + "type": "string" + } + }, + "required": [ + "id", + "name" + ] + }, "organization-full": { "title": "Organization Full", "description": "Organization Full", @@ -15260,8 +15347,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -17323,8 +17411,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -18775,6 +18864,21 @@ "installed_version": "3.6.0" } }, + "organization-custom-repository-role-example": { + "value": { + "total_count": 2, + "custom_roles": [ + { + "id": 8030, + "name": "Developer" + }, + { + "id": 8031, + "name": "Designer" + } + ] + } + }, "organization-full-default-response": { "summary": "Default response", "value": { diff --git a/generated/ghes-3.6.deref.json b/generated/ghes-3.6.deref.json index 1b4d9e3aa..829e03f11 100644 --- a/generated/ghes-3.6.deref.json +++ b/generated/ghes-3.6.deref.json @@ -11605,8 +11605,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -30254,8 +30255,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -31542,8 +31544,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -36660,8 +36663,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -49293,8 +49297,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -51767,8 +51772,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -55363,8 +55369,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -58116,8 +58123,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -60341,8 +60349,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -61619,7 +61628,13 @@ "category": "orgs", "subcategory": "custom_roles" }, - "x-octokit": {} + "x-octokit": { + "diff": { + "api.github.com": { + "type": "changed" + } + } + } } }, "/orgs/{org}": { @@ -64081,8 +64096,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -67133,8 +67149,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -69707,8 +69724,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -70995,8 +71013,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -74315,8 +74334,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -78602,8 +78622,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -81262,8 +81283,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -88366,8 +88388,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -91833,8 +91856,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -93528,8 +93552,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -95252,8 +95277,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -99260,8 +99286,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -99800,8 +99827,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -100904,8 +100932,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -112678,8 +112707,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -114728,8 +114758,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -122791,8 +122822,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -124229,8 +124261,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -125422,8 +125455,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -126503,8 +126537,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -128085,8 +128120,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -129523,8 +129559,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -130716,8 +130753,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -135288,8 +135326,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -136585,8 +136624,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -140099,8 +140139,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -141865,8 +141906,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -144533,8 +144575,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -146299,8 +146342,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -149554,8 +149598,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -151320,8 +151365,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -155454,7 +155500,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.6/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -157646,8 +157692,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -159412,8 +159459,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -186481,8 +186529,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -189065,8 +189114,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -191366,8 +191416,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -193840,8 +193891,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -201210,8 +201262,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -208551,8 +208604,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -209885,8 +209939,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -214897,8 +214952,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -217119,8 +217175,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -221487,7 +221544,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -231652,8 +231709,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -234310,8 +234368,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -236361,8 +236420,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -237799,8 +237859,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -238992,8 +239053,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -248581,8 +248643,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -250865,8 +250928,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -253718,8 +253782,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -256580,8 +256645,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -262595,8 +262661,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -266513,8 +266580,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -270313,8 +270381,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -273152,8 +273221,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -276017,8 +276087,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -299879,8 +299950,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -309171,8 +309243,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -315214,8 +315287,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -316548,8 +316622,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -336395,8 +336470,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -337729,8 +337805,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -341112,8 +341189,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -342446,8 +342524,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -360976,8 +361055,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -362705,8 +362785,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -364524,8 +364605,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -367060,8 +367142,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -369493,8 +369576,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -371921,8 +372005,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -385724,8 +385809,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -387794,8 +387880,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -395080,8 +395167,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -397726,8 +397814,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -401958,8 +402047,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -403707,8 +403797,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -405821,8 +405912,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -408257,8 +408349,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -409880,8 +409973,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -411916,8 +412010,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -414080,8 +414175,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -415417,8 +415513,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -417677,8 +417774,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -421673,8 +421771,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -424880,8 +424979,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -428089,8 +428189,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -434245,8 +434346,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -437454,8 +437556,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -440142,8 +440245,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -441776,8 +441880,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -442978,8 +443083,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -444808,8 +444914,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -447840,6 +447947,70 @@ } } }, + "/orgs/{org}/custom_roles": { + "post": { + "summary": "Create a custom role", + "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", + "tags": [ + "orgs" + ], + "operationId": "orgs/create-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#create-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, + "/orgs/{org}/custom_roles/{role_id}": { + "delete": { + "summary": "Delete a custom role", + "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", + "tags": [ + "orgs" + ], + "operationId": "orgs/delete-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#delete-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + }, + "patch": { + "summary": "Update a custom role", + "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", + "tags": [ + "orgs" + ], + "operationId": "orgs/update-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#update-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, "/orgs/{org}/external-group/{group_id}": { "get": { "summary": "Get an external group", @@ -447906,6 +448077,28 @@ } } }, + "/orgs/{org}/fine_grained_permissions": { + "get": { + "summary": "List fine-grained permissions for an organization", + "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-fine-grained-permissions", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-fine-grained-permissions-for-an-organization" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, "/orgs/{org}/interaction-limits": { "get": { "summary": "Get interaction restrictions for an organization", @@ -448272,7 +448465,7 @@ }, "/orgs/{org}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by an organization", + "summary": "List package versions for a package owned by an organization", "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", "tags": [ "packages" @@ -448280,7 +448473,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-org", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-an-organization" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-an-organization" }, "x-octokit": { "api.github.com": "removed" @@ -450755,7 +450948,7 @@ }, "/user/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by the authenticated user", + "summary": "List package versions for a package owned by the authenticated user", "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", "tags": [ "packages" @@ -450763,7 +450956,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" }, "x-octokit": { "api.github.com": "removed" @@ -451011,7 +451204,7 @@ }, "/users/{username}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by a user", + "summary": "List package versions for a package owned by a user", "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", "tags": [ "packages" @@ -451019,7 +451212,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-a-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-a-user" }, "x-octokit": { "api.github.com": "removed" diff --git a/generated/ghes-3.6.json b/generated/ghes-3.6.json index 782202503..dffe6dfcc 100644 --- a/generated/ghes-3.6.json +++ b/generated/ghes-3.6.json @@ -10081,7 +10081,7 @@ }, "examples": { "default": { - "$ref": "#/components/examples/organization-custom-repository-role-example-old" + "$ref": "#/components/examples/organization-custom-repository-role-example" } } } @@ -10094,7 +10094,13 @@ "category": "orgs", "subcategory": "custom_roles" }, - "x-octokit": {} + "x-octokit": { + "diff": { + "api.github.com": { + "type": "changed" + } + } + } } }, "/orgs/{org}": { @@ -16080,8 +16086,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -20306,8 +20313,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -23568,7 +23576,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-server@3.6/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -30758,7 +30766,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -54507,6 +54515,70 @@ } } }, + "/orgs/{org}/custom_roles": { + "post": { + "summary": "Create a custom role", + "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", + "tags": [ + "orgs" + ], + "operationId": "orgs/create-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#create-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, + "/orgs/{org}/custom_roles/{role_id}": { + "delete": { + "summary": "Delete a custom role", + "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", + "tags": [ + "orgs" + ], + "operationId": "orgs/delete-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#delete-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + }, + "patch": { + "summary": "Update a custom role", + "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", + "tags": [ + "orgs" + ], + "operationId": "orgs/update-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#update-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, "/orgs/{org}/external-group/{group_id}": { "get": { "summary": "Get an external group", @@ -54573,6 +54645,28 @@ } } }, + "/orgs/{org}/fine_grained_permissions": { + "get": { + "summary": "List fine-grained permissions for an organization", + "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-fine-grained-permissions", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-fine-grained-permissions-for-an-organization" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, "/orgs/{org}/interaction-limits": { "get": { "summary": "Get interaction restrictions for an organization", @@ -54939,7 +55033,7 @@ }, "/orgs/{org}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by an organization", + "summary": "List package versions for a package owned by an organization", "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", "tags": [ "packages" @@ -54947,7 +55041,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-org", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-an-organization" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-an-organization" }, "x-octokit": { "api.github.com": "removed" @@ -57422,7 +57516,7 @@ }, "/user/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by the authenticated user", + "summary": "List package versions for a package owned by the authenticated user", "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", "tags": [ "packages" @@ -57430,7 +57524,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" }, "x-octokit": { "api.github.com": "removed" @@ -57678,7 +57772,7 @@ }, "/users/{username}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by a user", + "summary": "List package versions for a package owned by a user", "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com", "tags": [ "packages" @@ -57686,7 +57780,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-a-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-a-user" }, "x-octokit": { "api.github.com": "removed" @@ -60863,8 +60957,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -64970,8 +65065,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Whether a squash merge commit can use the pull request title as default.", - "default": false + "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -87785,7 +87881,7 @@ } ] }, - "organization-custom-repository-role-example-old": { + "organization-custom-repository-role-example": { "value": { "total_count": 2, "custom_roles": [ diff --git a/generated/github.ae-anicca-diff-to-api.github.com.deref.json b/generated/github.ae-anicca-diff-to-api.github.com.deref.json index 352cf6e3a..1c3dcc57c 100644 --- a/generated/github.ae-anicca-diff-to-api.github.com.deref.json +++ b/generated/github.ae-anicca-diff-to-api.github.com.deref.json @@ -11861,6 +11861,13 @@ "/orgs/{org}/credential-authorizations/{credential_id}": [ "delete" ], + "/orgs/{org}/custom_roles": [ + "post" + ], + "/orgs/{org}/custom_roles/{role_id}": [ + "delete", + "patch" + ], "/orgs/{org}/dependabot/secrets": [ "get" ], @@ -11886,6 +11893,9 @@ "/orgs/{org}/failed_invitations": [ "get" ], + "/orgs/{org}/fine_grained_permissions": [ + "get" + ], "/orgs/{org}/interaction-limits": [ "get", "put", diff --git a/generated/github.ae-diff-to-api.github.com.deref.json b/generated/github.ae-diff-to-api.github.com.deref.json index 175c3b1d7..ab7a5e427 100644 --- a/generated/github.ae-diff-to-api.github.com.deref.json +++ b/generated/github.ae-diff-to-api.github.com.deref.json @@ -41676,8 +41676,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -52468,8 +52469,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -72907,7 +72909,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/github-ae@latest/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" diff --git a/generated/github.ae-diff-to-api.github.com.json b/generated/github.ae-diff-to-api.github.com.json index e782d2365..37644b9dd 100644 --- a/generated/github.ae-diff-to-api.github.com.json +++ b/generated/github.ae-diff-to-api.github.com.json @@ -5118,8 +5118,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -5619,8 +5620,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -6125,7 +6127,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/github-ae@latest/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" diff --git a/generated/github.ae.deref.json b/generated/github.ae.deref.json index 24b9eb934..0481c64d6 100644 --- a/generated/github.ae.deref.json +++ b/generated/github.ae.deref.json @@ -68032,8 +68032,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -93241,8 +93242,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -118442,7 +118444,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/github-ae@latest/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -181322,7 +181324,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -387732,6 +387734,70 @@ } } }, + "/orgs/{org}/custom_roles": { + "post": { + "summary": "Create a custom role", + "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", + "tags": [ + "orgs" + ], + "operationId": "orgs/create-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#create-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, + "/orgs/{org}/custom_roles/{role_id}": { + "delete": { + "summary": "Delete a custom role", + "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", + "tags": [ + "orgs" + ], + "operationId": "orgs/delete-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#delete-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + }, + "patch": { + "summary": "Update a custom role", + "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", + "tags": [ + "orgs" + ], + "operationId": "orgs/update-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#update-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, "/orgs/{org}/dependabot/secrets": { "get": { "summary": "List organization secrets", @@ -387966,6 +388032,28 @@ } } }, + "/orgs/{org}/fine_grained_permissions": { + "get": { + "summary": "List fine-grained permissions for an organization", + "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-fine-grained-permissions", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-fine-grained-permissions-for-an-organization" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, "/orgs/{org}/interaction-limits": { "get": { "summary": "Get interaction restrictions for an organization", @@ -388332,7 +388420,7 @@ }, "/orgs/{org}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by an organization", + "summary": "List package versions for a package owned by an organization", "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", "tags": [ "packages" @@ -388340,7 +388428,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-org", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-an-organization" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-an-organization" }, "x-octokit": { "api.github.com": "removed" @@ -391567,7 +391655,7 @@ }, "/user/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by the authenticated user", + "summary": "List package versions for a package owned by the authenticated user", "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", "tags": [ "packages" @@ -391575,7 +391663,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" }, "x-octokit": { "api.github.com": "removed" @@ -391867,7 +391955,7 @@ }, "/users/{username}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by a user", + "summary": "List package versions for a package owned by a user", "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", "tags": [ "packages" @@ -391875,7 +391963,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-a-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-a-user" }, "x-octokit": { "api.github.com": "removed" diff --git a/generated/github.ae.json b/generated/github.ae.json index 9a9f14001..cae3f42e0 100644 --- a/generated/github.ae.json +++ b/generated/github.ae.json @@ -11541,8 +11541,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -15786,8 +15787,9 @@ }, "use_squash_pr_title_as_default": { "type": "boolean", - "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.", - "default": false + "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.", + "default": false, + "deprecated": true }, "squash_merge_commit_title": { "type": "string", @@ -18140,7 +18142,7 @@ }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { "get": { - "summary": "List workflow runs", + "summary": "List workflow runs for a workflow", "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/github-ae@latest/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.", "tags": [ "actions" @@ -25361,7 +25363,7 @@ }, "sha": { "type": "string", - "description": "The blob SHA of the file being replaced." + "description": "The blob SHA of the file being deleted." }, "branch": { "type": "string", @@ -47466,6 +47468,70 @@ } } }, + "/orgs/{org}/custom_roles": { + "post": { + "summary": "Create a custom role", + "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", + "tags": [ + "orgs" + ], + "operationId": "orgs/create-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#create-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, + "/orgs/{org}/custom_roles/{role_id}": { + "delete": { + "summary": "Delete a custom role", + "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", + "tags": [ + "orgs" + ], + "operationId": "orgs/delete-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#delete-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + }, + "patch": { + "summary": "Update a custom role", + "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", + "tags": [ + "orgs" + ], + "operationId": "orgs/update-custom-role", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#update-a-custom-role" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, "/orgs/{org}/dependabot/secrets": { "get": { "summary": "List organization secrets", @@ -47700,6 +47766,28 @@ } } }, + "/orgs/{org}/fine_grained_permissions": { + "get": { + "summary": "List fine-grained permissions for an organization", + "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", + "tags": [ + "orgs" + ], + "operationId": "orgs/list-fine-grained-permissions", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/reference/orgs#list-fine-grained-permissions-for-an-organization" + }, + "x-octokit": { + "api.github.com": "removed" + }, + "responses": { + "501": { + "description": "Not Implemented" + } + } + } + }, "/orgs/{org}/interaction-limits": { "get": { "summary": "Get interaction restrictions for an organization", @@ -48066,7 +48154,7 @@ }, "/orgs/{org}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by an organization", + "summary": "List package versions for a package owned by an organization", "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", "tags": [ "packages" @@ -48074,7 +48162,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-org", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-an-organization" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-an-organization" }, "x-octokit": { "api.github.com": "removed" @@ -51301,7 +51389,7 @@ }, "/user/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by the authenticated user", + "summary": "List package versions for a package owned by the authenticated user", "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", "tags": [ "packages" @@ -51309,7 +51397,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user" }, "x-octokit": { "api.github.com": "removed" @@ -51601,7 +51689,7 @@ }, "/users/{username}/packages/{package_type}/{package_name}/versions": { "get": { - "summary": "Get all package versions for a package owned by a user", + "summary": "List package versions for a package owned by a user", "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.", "tags": [ "packages" @@ -51609,7 +51697,7 @@ "operationId": "packages/get-all-package-versions-for-package-owned-by-user", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-a-user" + "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-a-user" }, "x-octokit": { "api.github.com": "removed"