GitHubKit 0.12.10__py3-none-any.whl → 0.12.12__py3-none-any.whl

githubkit/versions/v2022_11_28/rest/pulls.py

@@ -100,7 +100,27 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[PullRequestSimple], list[PullRequestSimpleType]]:
-        """See also: https://docs.github.com/rest/pulls/pulls#list-pull-requests"""
+        """pulls/list
+
+        GET /repos/{owner}/{repo}/pulls
+
+        Lists pull requests in a specified repository.
+
+        Draft pull requests are available in public repositories with GitHub
+        Free and GitHub Free for organizations, GitHub Pro, and legacy per-repository billing
+        plans, and in public and private repositories with GitHub Team and GitHub Enterprise
+        Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products)
+        in the GitHub Help documentation.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#list-pull-requests
+        """
 
         from ..models import PullRequestSimple, ValidationError
 
@@ -145,7 +165,27 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[PullRequestSimple], list[PullRequestSimpleType]]:
-        """See also: https://docs.github.com/rest/pulls/pulls#list-pull-requests"""
+        """pulls/list
+
+        GET /repos/{owner}/{repo}/pulls
+
+        Lists pull requests in a specified repository.
+
+        Draft pull requests are available in public repositories with GitHub
+        Free and GitHub Free for organizations, GitHub Pro, and legacy per-repository billing
+        plans, and in public and private repositories with GitHub Team and GitHub Enterprise
+        Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products)
+        in the GitHub Help documentation.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#list-pull-requests
+        """
 
         from ..models import PullRequestSimple, ValidationError
 
@@ -211,7 +251,25 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequest, PullRequestType]:
-        """See also: https://docs.github.com/rest/pulls/pulls#create-a-pull-request"""
+        """pulls/create
+
+        POST /repos/{owner}/{repo}/pulls
+
+        Draft pull requests are available in public repositories with GitHub Free and GitHub Free for organizations, GitHub Pro, and legacy per-repository billing plans, and in public and private repositories with GitHub Team and GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products) in the GitHub Help documentation.
+
+        To open or update a pull request in a public repository, you must have write access to the head or the source branch. For organization-owned repositories, you must be a member of the organization that owns the repository to open or update a pull request.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#create-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -282,7 +340,25 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequest, PullRequestType]:
-        """See also: https://docs.github.com/rest/pulls/pulls#create-a-pull-request"""
+        """pulls/create
+
+        POST /repos/{owner}/{repo}/pulls
+
+        Draft pull requests are available in public repositories with GitHub Free and GitHub Free for organizations, GitHub Pro, and legacy per-repository billing plans, and in public and private repositories with GitHub Team and GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products) in the GitHub Help documentation.
+
+        To open or update a pull request in a public repository, you must have write access to the head or the source branch. For organization-owned repositories, you must be a member of the organization that owns the repository to open or update a pull request.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#create-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -328,7 +404,22 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[PullRequestReviewComment], list[PullRequestReviewCommentType]]:
-        """See also: https://docs.github.com/rest/pulls/comments#list-review-comments-in-a-repository"""
+        """pulls/list-review-comments-for-repo
+
+        GET /repos/{owner}/{repo}/pulls/comments
+
+        Lists review comments for all pull requests in a repository. By default,
+        review comments are in ascending order by ID.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#list-review-comments-in-a-repository
+        """
 
         from ..models import PullRequestReviewComment
 
@@ -364,7 +455,22 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[PullRequestReviewComment], list[PullRequestReviewCommentType]]:
-        """See also: https://docs.github.com/rest/pulls/comments#list-review-comments-in-a-repository"""
+        """pulls/list-review-comments-for-repo
+
+        GET /repos/{owner}/{repo}/pulls/comments
+
+        Lists review comments for all pull requests in a repository. By default,
+        review comments are in ascending order by ID.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#list-review-comments-in-a-repository
+        """
 
         from ..models import PullRequestReviewComment
 
@@ -396,7 +502,21 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequestReviewComment, PullRequestReviewCommentType]:
-        """See also: https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request"""
+        """pulls/get-review-comment
+
+        GET /repos/{owner}/{repo}/pulls/comments/{comment_id}
+
+        Provides details for a specified review comment.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request
+        """
 
         from ..models import BasicError, PullRequestReviewComment
 
@@ -422,7 +542,21 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequestReviewComment, PullRequestReviewCommentType]:
-        """See also: https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request"""
+        """pulls/get-review-comment
+
+        GET /repos/{owner}/{repo}/pulls/comments/{comment_id}
+
+        Provides details for a specified review comment.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request
+        """
 
         from ..models import BasicError, PullRequestReviewComment
 
@@ -448,7 +582,14 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/pulls/comments#delete-a-review-comment-for-a-pull-request"""
+        """pulls/delete-review-comment
+
+        DELETE /repos/{owner}/{repo}/pulls/comments/{comment_id}
+
+        Deletes a review comment.
+
+        See also: https://docs.github.com/rest/pulls/comments#delete-a-review-comment-for-a-pull-request
+        """
 
         from ..models import BasicError
 
@@ -473,7 +614,14 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/pulls/comments#delete-a-review-comment-for-a-pull-request"""
+        """pulls/delete-review-comment
+
+        DELETE /repos/{owner}/{repo}/pulls/comments/{comment_id}
+
+        Deletes a review comment.
+
+        See also: https://docs.github.com/rest/pulls/comments#delete-a-review-comment-for-a-pull-request
+        """
 
         from ..models import BasicError
 
@@ -523,7 +671,21 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsCommentsCommentIdPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReviewComment, PullRequestReviewCommentType]:
-        """See also: https://docs.github.com/rest/pulls/comments#update-a-review-comment-for-a-pull-request"""
+        """pulls/update-review-comment
+
+        PATCH /repos/{owner}/{repo}/pulls/comments/{comment_id}
+
+        Edits the content of a specified review comment.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#update-a-review-comment-for-a-pull-request
+        """
 
         from ..models import (
             PullRequestReviewComment,
@@ -586,7 +748,21 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsCommentsCommentIdPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReviewComment, PullRequestReviewCommentType]:
-        """See also: https://docs.github.com/rest/pulls/comments#update-a-review-comment-for-a-pull-request"""
+        """pulls/update-review-comment
+
+        PATCH /repos/{owner}/{repo}/pulls/comments/{comment_id}
+
+        Edits the content of a specified review comment.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#update-a-review-comment-for-a-pull-request
+        """
 
         from ..models import (
             PullRequestReviewComment,
@@ -624,7 +800,36 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequest, PullRequestType]:
-        """See also: https://docs.github.com/rest/pulls/pulls#get-a-pull-request"""
+        """pulls/get
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}
+
+        Draft pull requests are available in public repositories with GitHub Free and GitHub Free for organizations, GitHub Pro, and legacy per-repository billing plans, and in public and private repositories with GitHub Team and GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products) in the GitHub Help documentation.
+
+        Lists details of a pull request by providing its number.
+
+        When you get, [create](https://docs.github.com/rest/pulls/pulls/#create-a-pull-request), or [edit](https://docs.github.com/rest/pulls/pulls#update-a-pull-request) a pull request, GitHub creates a merge commit to test whether the pull request can be automatically merged into the base branch. This test commit is not added to the base branch or the head branch. You can review the status of the test commit using the `mergeable` key. For more information, see "[Checking mergeability of pull requests](https://docs.github.com/rest/guides/getting-started-with-the-git-database-api#checking-mergeability-of-pull-requests)".
+
+        The value of the `mergeable` attribute can be `true`, `false`, or `null`. If the value is `null`, then GitHub has started a background job to compute the mergeability. After giving the job time to complete, resubmit the request. When the job finishes, you will see a non-`null` value for the `mergeable` attribute in the response. If `mergeable` is `true`, then `merge_commit_sha` will be the SHA of the _test_ merge commit.
+
+        The value of the `merge_commit_sha` attribute changes depending on the state of the pull request. Before merging a pull request, the `merge_commit_sha` attribute holds the SHA of the _test_ merge commit. After merging a pull request, the `merge_commit_sha` attribute changes depending on how you merged the pull request:
+
+        *   If merged as a [merge commit](https://docs.github.com/articles/about-merge-methods-on-github/), `merge_commit_sha` represents the SHA of the merge commit.
+        *   If merged via a [squash](https://docs.github.com/articles/about-merge-methods-on-github/#squashing-your-merge-commits), `merge_commit_sha` represents the SHA of the squashed commit on the base branch.
+        *   If [rebased](https://docs.github.com/articles/about-merge-methods-on-github/#rebasing-and-merging-your-commits), `merge_commit_sha` represents the commit that the base branch was updated to.
+
+        Pass the appropriate [media type](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types) to fetch diff and patch formats.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+        - **`application/vnd.github.diff`**: For more information, see "[git-diff](https://git-scm.com/docs/git-diff)" in the Git documentation. If a diff is corrupt, contact us through the [GitHub Support portal](https://support.github.com/). Include the repository name and pull request ID in your message.
+
+        See also: https://docs.github.com/rest/pulls/pulls#get-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -657,7 +862,36 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequest, PullRequestType]:
-        """See also: https://docs.github.com/rest/pulls/pulls#get-a-pull-request"""
+        """pulls/get
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}
+
+        Draft pull requests are available in public repositories with GitHub Free and GitHub Free for organizations, GitHub Pro, and legacy per-repository billing plans, and in public and private repositories with GitHub Team and GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products) in the GitHub Help documentation.
+
+        Lists details of a pull request by providing its number.
+
+        When you get, [create](https://docs.github.com/rest/pulls/pulls/#create-a-pull-request), or [edit](https://docs.github.com/rest/pulls/pulls#update-a-pull-request) a pull request, GitHub creates a merge commit to test whether the pull request can be automatically merged into the base branch. This test commit is not added to the base branch or the head branch. You can review the status of the test commit using the `mergeable` key. For more information, see "[Checking mergeability of pull requests](https://docs.github.com/rest/guides/getting-started-with-the-git-database-api#checking-mergeability-of-pull-requests)".
+
+        The value of the `mergeable` attribute can be `true`, `false`, or `null`. If the value is `null`, then GitHub has started a background job to compute the mergeability. After giving the job time to complete, resubmit the request. When the job finishes, you will see a non-`null` value for the `mergeable` attribute in the response. If `mergeable` is `true`, then `merge_commit_sha` will be the SHA of the _test_ merge commit.
+
+        The value of the `merge_commit_sha` attribute changes depending on the state of the pull request. Before merging a pull request, the `merge_commit_sha` attribute holds the SHA of the _test_ merge commit. After merging a pull request, the `merge_commit_sha` attribute changes depending on how you merged the pull request:
+
+        *   If merged as a [merge commit](https://docs.github.com/articles/about-merge-methods-on-github/), `merge_commit_sha` represents the SHA of the merge commit.
+        *   If merged via a [squash](https://docs.github.com/articles/about-merge-methods-on-github/#squashing-your-merge-commits), `merge_commit_sha` represents the SHA of the squashed commit on the base branch.
+        *   If [rebased](https://docs.github.com/articles/about-merge-methods-on-github/#rebasing-and-merging-your-commits), `merge_commit_sha` represents the commit that the base branch was updated to.
+
+        Pass the appropriate [media type](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types) to fetch diff and patch formats.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+        - **`application/vnd.github.diff`**: For more information, see "[git-diff](https://git-scm.com/docs/git-diff)" in the Git documentation. If a diff is corrupt, contact us through the [GitHub Support portal](https://support.github.com/). Include the repository name and pull request ID in your message.
+
+        See also: https://docs.github.com/rest/pulls/pulls#get-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -719,7 +953,23 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPullNumberPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequest, PullRequestType]:
-        """See also: https://docs.github.com/rest/pulls/pulls#update-a-pull-request"""
+        """pulls/update
+
+        PATCH /repos/{owner}/{repo}/pulls/{pull_number}
+
+        Draft pull requests are available in public repositories with GitHub Free and GitHub Free for organizations, GitHub Pro, and legacy per-repository billing plans, and in public and private repositories with GitHub Team and GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products) in the GitHub Help documentation.
+
+        To open or update a pull request in a public repository, you must have write access to the head or the source branch. For organization-owned repositories, you must be a member of the organization that owns the repository to open or update a pull request.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#update-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -790,7 +1040,23 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPullNumberPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequest, PullRequestType]:
-        """See also: https://docs.github.com/rest/pulls/pulls#update-a-pull-request"""
+        """pulls/update
+
+        PATCH /repos/{owner}/{repo}/pulls/{pull_number}
+
+        Draft pull requests are available in public repositories with GitHub Free and GitHub Free for organizations, GitHub Pro, and legacy per-repository billing plans, and in public and private repositories with GitHub Team and GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products) in the GitHub Help documentation.
+
+        To open or update a pull request in a public repository, you must have write access to the head or the source branch. For organization-owned repositories, you must be a member of the organization that owns the repository to open or update a pull request.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#update-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -837,7 +1103,22 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[PullRequestReviewComment], list[PullRequestReviewCommentType]]:
-        """See also: https://docs.github.com/rest/pulls/comments#list-review-comments-on-a-pull-request"""
+        """pulls/list-review-comments
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/comments
+
+        Lists all review comments for a specified pull request. By default, review comments
+        are in ascending order by ID.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#list-review-comments-on-a-pull-request
+        """
 
         from ..models import PullRequestReviewComment
 
@@ -874,7 +1155,22 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[PullRequestReviewComment], list[PullRequestReviewCommentType]]:
-        """See also: https://docs.github.com/rest/pulls/comments#list-review-comments-on-a-pull-request"""
+        """pulls/list-review-comments
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/comments
+
+        Lists all review comments for a specified pull request. By default, review comments
+        are in ascending order by ID.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#list-review-comments-on-a-pull-request
+        """
 
         from ..models import PullRequestReviewComment
 
@@ -940,7 +1236,28 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPullNumberCommentsPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReviewComment, PullRequestReviewCommentType]:
-        """See also: https://docs.github.com/rest/pulls/comments#create-a-review-comment-for-a-pull-request"""
+        """pulls/create-review-comment
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/comments
+
+        Creates a review comment on the diff of a specified pull request. To add a regular comment to a pull request timeline, see "[Create an issue comment](https://docs.github.com/rest/issues/comments#create-an-issue-comment)."
+
+        If your comment applies to more than one line in the pull request diff, you should use the parameters `line`, `side`, and optionally `start_line` and `start_side` in your request.
+
+        The `position` parameter is closing down. If you use `position`, the `line`, `side`, `start_line`, and `start_side` parameters are not required.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)"
+        and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#create-a-review-comment-for-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -1018,7 +1335,28 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPullNumberCommentsPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReviewComment, PullRequestReviewCommentType]:
-        """See also: https://docs.github.com/rest/pulls/comments#create-a-review-comment-for-a-pull-request"""
+        """pulls/create-review-comment
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/comments
+
+        Creates a review comment on the diff of a specified pull request. To add a regular comment to a pull request timeline, see "[Create an issue comment](https://docs.github.com/rest/issues/comments#create-an-issue-comment)."
+
+        If your comment applies to more than one line in the pull request diff, you should use the parameters `line`, `side`, and optionally `start_line` and `start_side` in your request.
+
+        The `position` parameter is closing down. If you use `position`, the `line`, `side`, `start_line`, and `start_side` parameters are not required.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)"
+        and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#create-a-review-comment-for-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -1092,7 +1430,24 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReviewComment, PullRequestReviewCommentType]:
-        """See also: https://docs.github.com/rest/pulls/comments#create-a-reply-for-a-review-comment"""
+        """pulls/create-reply-for-review-comment
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/comments/{comment_id}/replies
+
+        Creates a reply to a review comment for a pull request. For the `comment_id`, provide the ID of the review comment you are replying to. This must be the ID of a _top-level review comment_, not a reply to that comment. Replies to replies are not supported.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)"
+        and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#create-a-reply-for-a-review-comment
+        """
 
         from ..models import (
             BasicError,
@@ -1164,7 +1519,24 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReviewComment, PullRequestReviewCommentType]:
-        """See also: https://docs.github.com/rest/pulls/comments#create-a-reply-for-a-review-comment"""
+        """pulls/create-reply-for-review-comment
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/comments/{comment_id}/replies
+
+        Creates a reply to a review comment for a pull request. For the `comment_id`, provide the ID of the review comment you are replying to. This must be the ID of a _top-level review comment_, not a reply to that comment. Replies to replies are not supported.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)"
+        and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/comments#create-a-reply-for-a-review-comment
+        """
 
         from ..models import (
             BasicError,
@@ -1208,7 +1580,23 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[Commit], list[CommitType]]:
-        """See also: https://docs.github.com/rest/pulls/pulls#list-commits-on-a-pull-request"""
+        """pulls/list-commits
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/commits
+
+        Lists a maximum of 250 commits for a pull request. To receive a complete
+        commit list for pull requests with more than 250 commits, use the [List commits](https://docs.github.com/rest/commits/commits#list-commits)
+        endpoint.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#list-commits-on-a-pull-request
+        """
 
         from ..models import Commit
 
@@ -1239,7 +1627,23 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[Commit], list[CommitType]]:
-        """See also: https://docs.github.com/rest/pulls/pulls#list-commits-on-a-pull-request"""
+        """pulls/list-commits
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/commits
+
+        Lists a maximum of 250 commits for a pull request. To receive a complete
+        commit list for pull requests with more than 250 commits, use the [List commits](https://docs.github.com/rest/commits/commits#list-commits)
+        endpoint.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#list-commits-on-a-pull-request
+        """
 
         from ..models import Commit
 
@@ -1270,7 +1674,24 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[DiffEntry], list[DiffEntryType]]:
-        """See also: https://docs.github.com/rest/pulls/pulls#list-pull-requests-files"""
+        """pulls/list-files
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/files
+
+        Lists the files in a specified pull request.
+
+        > [!NOTE]
+        > Responses include a maximum of 3000 files. The paginated response returns 30 files per page by default.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#list-pull-requests-files
+        """
 
         from ..models import (
             BasicError,
@@ -1311,7 +1732,24 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[DiffEntry], list[DiffEntryType]]:
-        """See also: https://docs.github.com/rest/pulls/pulls#list-pull-requests-files"""
+        """pulls/list-files
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/files
+
+        Lists the files in a specified pull request.
+
+        > [!NOTE]
+        > Responses include a maximum of 3000 files. The paginated response returns 30 files per page by default.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/pulls#list-pull-requests-files
+        """
 
         from ..models import (
             BasicError,
@@ -1350,7 +1788,14 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/pulls/pulls#check-if-a-pull-request-has-been-merged"""
+        """pulls/check-if-merged
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/merge
+
+        Checks if a pull request has been merged into the base branch. The HTTP status of the response indicates whether or not the pull request has been merged; the response body is empty.
+
+        See also: https://docs.github.com/rest/pulls/pulls#check-if-a-pull-request-has-been-merged
+        """
 
         url = f"/repos/{owner}/{repo}/pulls/{pull_number}/merge"
 
@@ -1371,7 +1816,14 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/pulls/pulls#check-if-a-pull-request-has-been-merged"""
+        """pulls/check-if-merged
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/merge
+
+        Checks if a pull request has been merged into the base branch. The HTTP status of the response indicates whether or not the pull request has been merged; the response body is empty.
+
+        See also: https://docs.github.com/rest/pulls/pulls#check-if-a-pull-request-has-been-merged
+        """
 
         url = f"/repos/{owner}/{repo}/pulls/{pull_number}/merge"
 
@@ -1424,7 +1876,15 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestMergeResult, PullRequestMergeResultType]:
-        """See also: https://docs.github.com/rest/pulls/pulls#merge-a-pull-request"""
+        """pulls/merge
+
+        PUT /repos/{owner}/{repo}/pulls/{pull_number}/merge
+
+        Merges a pull request into the base branch.
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        See also: https://docs.github.com/rest/pulls/pulls#merge-a-pull-request
+        """
 
         from typing import Union
 
@@ -1507,7 +1967,15 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestMergeResult, PullRequestMergeResultType]:
-        """See also: https://docs.github.com/rest/pulls/pulls#merge-a-pull-request"""
+        """pulls/merge
+
+        PUT /repos/{owner}/{repo}/pulls/{pull_number}/merge
+
+        Merges a pull request into the base branch.
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        See also: https://docs.github.com/rest/pulls/pulls#merge-a-pull-request
+        """
 
         from typing import Union
 
@@ -1558,7 +2026,14 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequestReviewRequest, PullRequestReviewRequestType]:
-        """See also: https://docs.github.com/rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request"""
+        """pulls/list-requested-reviewers
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
+
+        Gets the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the [List reviews for a pull request](https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request) operation.
+
+        See also: https://docs.github.com/rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request
+        """
 
         from ..models import PullRequestReviewRequest
 
@@ -1581,7 +2056,14 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequestReviewRequest, PullRequestReviewRequestType]:
-        """See also: https://docs.github.com/rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request"""
+        """pulls/list-requested-reviewers
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
+
+        Gets the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the [List reviews for a pull request](https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request) operation.
+
+        See also: https://docs.github.com/rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request
+        """
 
         from ..models import PullRequestReviewRequest
 
@@ -1653,7 +2135,15 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestSimple, PullRequestSimpleType]:
-        """See also: https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request"""
+        """pulls/request-reviewers
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
+
+        Requests reviews for a pull request from a given set of users and/or teams.
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        See also: https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request
+        """
 
         from typing import Union
 
@@ -1751,7 +2241,15 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestSimple, PullRequestSimpleType]:
-        """See also: https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request"""
+        """pulls/request-reviewers
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
+
+        Requests reviews for a pull request from a given set of users and/or teams.
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        See also: https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request
+        """
 
         from typing import Union
 
@@ -1828,7 +2326,14 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestSimple, PullRequestSimpleType]:
-        """See also: https://docs.github.com/rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request"""
+        """pulls/remove-requested-reviewers
+
+        DELETE /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
+
+        Removes review requests from a pull request for a given set of users and/or teams.
+
+        See also: https://docs.github.com/rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request
+        """
 
         from ..models import (
             PullRequestSimple,
@@ -1898,7 +2403,14 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestSimple, PullRequestSimpleType]:
-        """See also: https://docs.github.com/rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request"""
+        """pulls/remove-requested-reviewers
+
+        DELETE /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
+
+        Removes review requests from a pull request for a given set of users and/or teams.
+
+        See also: https://docs.github.com/rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request
+        """
 
         from ..models import (
             PullRequestSimple,
@@ -1942,7 +2454,21 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[PullRequestReview], list[PullRequestReviewType]]:
-        """See also: https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request"""
+        """pulls/list-reviews
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/reviews
+
+        Lists all reviews for a specified pull request. The list of reviews returns in chronological order.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request
+        """
 
         from ..models import PullRequestReview
 
@@ -1973,7 +2499,21 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[PullRequestReview], list[PullRequestReviewType]]:
-        """See also: https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request"""
+        """pulls/list-reviews
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/reviews
+
+        Lists all reviews for a specified pull request. The list of reviews returns in chronological order.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request
+        """
 
         from ..models import PullRequestReview
 
@@ -2032,7 +2572,30 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPullNumberReviewsPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request"""
+        """pulls/create-review
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/reviews
+
+        Creates a review on a specified pull request.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        Pull request reviews created in the `PENDING` state are not submitted and therefore do not include the `submitted_at` property in the response. To create a pending review for a pull request, leave the `event` parameter blank. For more information about submitting a `PENDING` review, see "[Submit a review for a pull request](https://docs.github.com/rest/pulls/reviews#submit-a-review-for-a-pull-request)."
+
+        > [!NOTE]
+        > To comment on a specific line in a file, you need to first determine the position of that line in the diff. To see a pull request diff, add the `application/vnd.github.v3.diff` media type to the `Accept` header of a call to the [Get a pull request](https://docs.github.com/rest/pulls/pulls#get-a-pull-request) endpoint.
+
+        The `position` value equals the number of lines down from the first "@@" hunk header in the file you want to add a comment. The line just below the "@@" line is position 1, the next line is position 2, and so on. The position in the diff continues to increase through lines of whitespace and additional hunks until the beginning of a new file.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -2106,7 +2669,30 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPullNumberReviewsPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request"""
+        """pulls/create-review
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/reviews
+
+        Creates a review on a specified pull request.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)."
+
+        Pull request reviews created in the `PENDING` state are not submitted and therefore do not include the `submitted_at` property in the response. To create a pending review for a pull request, leave the `event` parameter blank. For more information about submitting a `PENDING` review, see "[Submit a review for a pull request](https://docs.github.com/rest/pulls/reviews#submit-a-review-for-a-pull-request)."
+
+        > [!NOTE]
+        > To comment on a specific line in a file, you need to first determine the position of that line in the diff. To see a pull request diff, add the `application/vnd.github.v3.diff` media type to the `Accept` header of a call to the [Get a pull request](https://docs.github.com/rest/pulls/pulls#get-a-pull-request) endpoint.
+
+        The `position` value equals the number of lines down from the first "@@" hunk header in the file you want to add a comment. The line just below the "@@" line is position 1, the next line is position 2, and so on. The position in the diff continues to increase through lines of whitespace and additional hunks until the beginning of a new file.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -2151,7 +2737,21 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#get-a-review-for-a-pull-request"""
+        """pulls/get-review
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
+
+        Retrieves a pull request review by its ID.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#get-a-review-for-a-pull-request
+        """
 
         from ..models import BasicError, PullRequestReview
 
@@ -2178,7 +2778,21 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#get-a-review-for-a-pull-request"""
+        """pulls/get-review
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
+
+        Retrieves a pull request review by its ID.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#get-a-review-for-a-pull-request
+        """
 
         from ..models import BasicError, PullRequestReview
 
@@ -2232,7 +2846,21 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPullNumberReviewsReviewIdPutBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#update-a-review-for-a-pull-request"""
+        """pulls/update-review
+
+        PUT /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
+
+        Updates the contents of a specified review summary comment.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#update-a-review-for-a-pull-request
+        """
 
         from ..models import (
             PullRequestReview,
@@ -2302,7 +2930,21 @@ class PullsClient:
         data: Missing[ReposOwnerRepoPullsPullNumberReviewsReviewIdPutBodyType] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#update-a-review-for-a-pull-request"""
+        """pulls/update-review
+
+        PUT /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
+
+        Updates the contents of a specified review summary comment.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#update-a-review-for-a-pull-request
+        """
 
         from ..models import (
             PullRequestReview,
@@ -2345,7 +2987,21 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#delete-a-pending-review-for-a-pull-request"""
+        """pulls/delete-pending-review
+
+        DELETE /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
+
+        Deletes a pull request review that has not been submitted. Submitted reviews cannot be deleted.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#delete-a-pending-review-for-a-pull-request
+        """
 
         from ..models import BasicError, PullRequestReview, ValidationErrorSimple
 
@@ -2373,7 +3029,21 @@ class PullsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#delete-a-pending-review-for-a-pull-request"""
+        """pulls/delete-pending-review
+
+        DELETE /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
+
+        Deletes a pull request review that has not been submitted. Submitted reviews cannot be deleted.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#delete-a-pending-review-for-a-pull-request
+        """
 
         from ..models import BasicError, PullRequestReview, ValidationErrorSimple
 
@@ -2403,7 +3073,21 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ReviewComment], list[ReviewCommentType]]:
-        """See also: https://docs.github.com/rest/pulls/reviews#list-comments-for-a-pull-request-review"""
+        """pulls/list-comments-for-review
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/comments
+
+        Lists comments for a specific pull request review.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#list-comments-for-a-pull-request-review
+        """
 
         from ..models import BasicError, ReviewComment
 
@@ -2438,7 +3122,21 @@ class PullsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ReviewComment], list[ReviewCommentType]]:
-        """See also: https://docs.github.com/rest/pulls/reviews#list-comments-for-a-pull-request-review"""
+        """pulls/list-comments-for-review
+
+        GET /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/comments
+
+        Lists comments for a specific pull request review.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#list-comments-for-a-pull-request-review
+        """
 
         from ..models import BasicError, ReviewComment
 
@@ -2501,7 +3199,24 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#dismiss-a-review-for-a-pull-request"""
+        """pulls/dismiss-review
+
+        PUT /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/dismissals
+
+        Dismisses a specified review on a pull request.
+
+        > [!NOTE]
+        > To dismiss a pull request review on a [protected branch](https://docs.github.com/rest/branches/branch-protection), you must be a repository administrator or be included in the list of people or teams who can dismiss pull request reviews.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#dismiss-a-review-for-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -2578,7 +3293,24 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#dismiss-a-review-for-a-pull-request"""
+        """pulls/dismiss-review
+
+        PUT /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/dismissals
+
+        Dismisses a specified review on a pull request.
+
+        > [!NOTE]
+        > To dismiss a pull request review on a [protected branch](https://docs.github.com/rest/branches/branch-protection), you must be a repository administrator or be included in the list of people or teams who can dismiss pull request reviews.
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#dismiss-a-review-for-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -2655,7 +3387,21 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#submit-a-review-for-a-pull-request"""
+        """pulls/submit-review
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/events
+
+        Submits a pending review for a pull request. For more information about creating a pending review for a pull request, see "[Create a review for a pull request](https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request)."
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#submit-a-review-for-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -2731,7 +3477,21 @@ class PullsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response[PullRequestReview, PullRequestReviewType]:
-        """See also: https://docs.github.com/rest/pulls/reviews#submit-a-review-for-a-pull-request"""
+        """pulls/submit-review
+
+        POST /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/events
+
+        Submits a pending review for a pull request. For more information about creating a pending review for a pull request, see "[Create a review for a pull request](https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request)."
+
+        This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)."
+
+        - **`application/vnd.github-commitcomment.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type.
+        - **`application/vnd.github-commitcomment.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`.
+        - **`application/vnd.github-commitcomment.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`.
+        - **`application/vnd.github-commitcomment.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`.
+
+        See also: https://docs.github.com/rest/pulls/reviews#submit-a-review-for-a-pull-request
+        """
 
         from ..models import (
             BasicError,
@@ -2814,7 +3574,15 @@ class PullsClient:
         ReposOwnerRepoPullsPullNumberUpdateBranchPutResponse202,
         ReposOwnerRepoPullsPullNumberUpdateBranchPutResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/pulls/pulls#update-a-pull-request-branch"""
+        """pulls/update-branch
+
+        PUT /repos/{owner}/{repo}/pulls/{pull_number}/update-branch
+
+        Updates the pull request branch with the latest upstream changes by merging HEAD from the base branch into the pull request branch.
+        Note: If making a request on behalf of a GitHub App you must also have permissions to write the contents of the head repository.
+
+        See also: https://docs.github.com/rest/pulls/pulls#update-a-pull-request-branch
+        """
 
         from typing import Union
 
@@ -2898,7 +3666,15 @@ class PullsClient:
         ReposOwnerRepoPullsPullNumberUpdateBranchPutResponse202,
         ReposOwnerRepoPullsPullNumberUpdateBranchPutResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/pulls/pulls#update-a-pull-request-branch"""
+        """pulls/update-branch
+
+        PUT /repos/{owner}/{repo}/pulls/{pull_number}/update-branch
+
+        Updates the pull request branch with the latest upstream changes by merging HEAD from the base branch into the pull request branch.
+        Note: If making a request on behalf of a GitHub App you must also have permissions to write the contents of the head repository.
+
+        See also: https://docs.github.com/rest/pulls/pulls#update-a-pull-request-branch
+        """
 
         from typing import Union