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

githubkit/versions/v2022_11_28/rest/orgs.py

@@ -141,7 +141,17 @@ class OrgsClient:
         per_page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationSimple], list[OrganizationSimpleType]]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-organizations"""
+        """orgs/list
+
+        GET /organizations
+
+        Lists all organizations, in the order that they were created.
+
+        > [!NOTE]
+        > Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers) to get the URL for the next page of organizations.
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-organizations
+        """
 
         from ..models import OrganizationSimple
 
@@ -169,7 +179,17 @@ class OrgsClient:
         per_page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationSimple], list[OrganizationSimpleType]]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-organizations"""
+        """orgs/list
+
+        GET /organizations
+
+        Lists all organizations, in the order that they were created.
+
+        > [!NOTE]
+        > Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers) to get the URL for the next page of organizations.
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-organizations
+        """
 
         from ..models import OrganizationSimple
 
@@ -196,7 +216,22 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrganizationFull, OrganizationFullType]:
-        """See also: https://docs.github.com/rest/orgs/orgs#get-an-organization"""
+        """orgs/get
+
+        GET /orgs/{org}
+
+        Gets information about an organization.
+
+        When the value of `two_factor_requirement_enabled` is `true`, the organization requires all members, billing managers, outside collaborators, guest collaborators, repository collaborators, or everyone with access to any repository within the organization to enable [two-factor authentication](https://docs.github.com/articles/securing-your-account-with-two-factor-authentication-2fa/).
+
+        To see the full details about an organization, the authenticated user must be an organization owner.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to see the full details about an organization.
+
+        To see information about an organization's GitHub plan, GitHub Apps need the `Organization plan` permission.
+
+        See also: https://docs.github.com/rest/orgs/orgs#get-an-organization
+        """
 
         from ..models import BasicError, OrganizationFull
 
@@ -220,7 +255,22 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrganizationFull, OrganizationFullType]:
-        """See also: https://docs.github.com/rest/orgs/orgs#get-an-organization"""
+        """orgs/get
+
+        GET /orgs/{org}
+
+        Gets information about an organization.
+
+        When the value of `two_factor_requirement_enabled` is `true`, the organization requires all members, billing managers, outside collaborators, guest collaborators, repository collaborators, or everyone with access to any repository within the organization to enable [two-factor authentication](https://docs.github.com/articles/securing-your-account-with-two-factor-authentication-2fa/).
+
+        To see the full details about an organization, the authenticated user must be an organization owner.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to see the full details about an organization.
+
+        To see information about an organization's GitHub plan, GitHub Apps need the `Organization plan` permission.
+
+        See also: https://docs.github.com/rest/orgs/orgs#get-an-organization
+        """
 
         from ..models import BasicError, OrganizationFull
 
@@ -247,7 +297,20 @@ class OrgsClient:
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/orgs#delete-an-organization"""
+        """orgs/delete
+
+        DELETE /orgs/{org}
+
+        Deletes an organization and all its repositories.
+
+        The organization login will be unavailable for 90 days after deletion.
+
+        Please review the Terms of Service regarding account deletion before using this endpoint:
+
+        https://docs.github.com/site-policy/github-terms/github-terms-of-service
+
+        See also: https://docs.github.com/rest/orgs/orgs#delete-an-organization
+        """
 
         from ..models import (
             AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
@@ -278,7 +341,20 @@ class OrgsClient:
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/orgs#delete-an-organization"""
+        """orgs/delete
+
+        DELETE /orgs/{org}
+
+        Deletes an organization and all its repositories.
+
+        The organization login will be unavailable for 90 days after deletion.
+
+        Please review the Terms of Service regarding account deletion before using this endpoint:
+
+        https://docs.github.com/site-policy/github-terms/github-terms-of-service
+
+        See also: https://docs.github.com/rest/orgs/orgs#delete-an-organization
+        """
 
         from ..models import (
             AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
@@ -362,7 +438,24 @@ class OrgsClient:
         data: Missing[OrgsOrgPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrganizationFull, OrganizationFullType]:
-        """See also: https://docs.github.com/rest/orgs/orgs#update-an-organization"""
+        """orgs/update
+
+        PATCH /orgs/{org}
+
+        > [!WARNING]
+        > **Closing down notice:** GitHub will replace and discontinue `members_allowed_repository_creation_type` in favor of more granular permissions. The new input parameters are `members_can_create_public_repositories`, `members_can_create_private_repositories` for all organizations and `members_can_create_internal_repositories` for organizations associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+. For more information, see the [blog post](https://developer.github.com/changes/2019-12-03-internal-visibility-changes).
+
+        > [!WARNING]
+        > **Closing down notice:** Code security product enablement for new repositories through the organization API is closing down. Please use [code security configurations](https://docs.github.com/rest/code-security/configurations#set-a-code-security-configuration-as-a-default-for-an-organization) to set defaults instead. For more information on setting a default security configuration, see the [changelog](https://github.blog/changelog/2024-07-09-sunsetting-security-settings-defaults-parameters-in-the-organizations-rest-api/).
+
+        Updates the organization's profile and member privileges.
+
+        The authenticated user must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` or `repo` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/orgs#update-an-organization
+        """
 
         from typing import Union
 
@@ -461,7 +554,24 @@ class OrgsClient:
         data: Missing[OrgsOrgPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrganizationFull, OrganizationFullType]:
-        """See also: https://docs.github.com/rest/orgs/orgs#update-an-organization"""
+        """orgs/update
+
+        PATCH /orgs/{org}
+
+        > [!WARNING]
+        > **Closing down notice:** GitHub will replace and discontinue `members_allowed_repository_creation_type` in favor of more granular permissions. The new input parameters are `members_can_create_public_repositories`, `members_can_create_private_repositories` for all organizations and `members_can_create_internal_repositories` for organizations associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+. For more information, see the [blog post](https://developer.github.com/changes/2019-12-03-internal-visibility-changes).
+
+        > [!WARNING]
+        > **Closing down notice:** Code security product enablement for new repositories through the organization API is closing down. Please use [code security configurations](https://docs.github.com/rest/code-security/configurations#set-a-code-security-configuration-as-a-default-for-an-organization) to set defaults instead. For more information on setting a default security configuration, see the [changelog](https://github.blog/changelog/2024-07-09-sunsetting-security-settings-defaults-parameters-in-the-organizations-rest-api/).
+
+        Updates the organization's profile and member privileges.
+
+        The authenticated user must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` or `repo` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/orgs#update-an-organization
+        """
 
         from typing import Union
 
@@ -512,7 +622,18 @@ class OrgsClient:
         OrgsOrgAttestationsSubjectDigestGetResponse200,
         OrgsOrgAttestationsSubjectDigestGetResponse200Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-attestations"""
+        """orgs/list-attestations
+
+        GET /orgs/{org}/attestations/{subject_digest}
+
+        List a collection of artifact attestations with a given subject digest that are associated with repositories owned by an organization.
+
+        The collection of attestations returned by this endpoint is filtered according to the authenticated user's permissions; if the authenticated user cannot read a repository, the attestations associated with that repository will not be included in the response. In addition, when using a fine-grained access token the `attestations:read` permission is required.
+
+        **Please note:** in order to offer meaningful security benefits, an attestation's signature and timestamps **must** be cryptographically verified, and the identity of the attestation signer **must** be validated. Attestations can be verified using the [GitHub CLI `attestation verify` command](https://cli.github.com/manual/gh_attestation_verify). For more information, see [our guide on how to use artifact attestations to establish a build's provenance](https://docs.github.com/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds).
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-attestations
+        """
 
         from ..models import OrgsOrgAttestationsSubjectDigestGetResponse200
 
@@ -549,7 +670,18 @@ class OrgsClient:
         OrgsOrgAttestationsSubjectDigestGetResponse200,
         OrgsOrgAttestationsSubjectDigestGetResponse200Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-attestations"""
+        """orgs/list-attestations
+
+        GET /orgs/{org}/attestations/{subject_digest}
+
+        List a collection of artifact attestations with a given subject digest that are associated with repositories owned by an organization.
+
+        The collection of attestations returned by this endpoint is filtered according to the authenticated user's permissions; if the authenticated user cannot read a repository, the attestations associated with that repository will not be included in the response. In addition, when using a fine-grained access token the `attestations:read` permission is required.
+
+        **Please note:** in order to offer meaningful security benefits, an attestation's signature and timestamps **must** be cryptographically verified, and the identity of the attestation signer **must** be validated. Attestations can be verified using the [GitHub CLI `attestation verify` command](https://cli.github.com/manual/gh_attestation_verify). For more information, see [our guide on how to use artifact attestations to establish a build's provenance](https://docs.github.com/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds).
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-attestations
+        """
 
         from ..models import OrgsOrgAttestationsSubjectDigestGetResponse200
 
@@ -580,7 +712,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[SimpleUser], list[SimpleUserType]]:
-        """See also: https://docs.github.com/rest/orgs/blocking#list-users-blocked-by-an-organization"""
+        """orgs/list-blocked-users
+
+        GET /orgs/{org}/blocks
+
+        List the users blocked by an organization.
+
+        See also: https://docs.github.com/rest/orgs/blocking#list-users-blocked-by-an-organization
+        """
 
         from ..models import SimpleUser
 
@@ -609,7 +748,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[SimpleUser], list[SimpleUserType]]:
-        """See also: https://docs.github.com/rest/orgs/blocking#list-users-blocked-by-an-organization"""
+        """orgs/list-blocked-users
+
+        GET /orgs/{org}/blocks
+
+        List the users blocked by an organization.
+
+        See also: https://docs.github.com/rest/orgs/blocking#list-users-blocked-by-an-organization
+        """
 
         from ..models import SimpleUser
 
@@ -637,7 +783,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/blocking#check-if-a-user-is-blocked-by-an-organization"""
+        """orgs/check-blocked-user
+
+        GET /orgs/{org}/blocks/{username}
+
+        Returns a 204 if the given user is blocked by the given organization. Returns a 404 if the organization is not blocking the user, or if the user account has been identified as spam by GitHub.
+
+        See also: https://docs.github.com/rest/orgs/blocking#check-if-a-user-is-blocked-by-an-organization
+        """
 
         from ..models import BasicError
 
@@ -661,7 +814,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/blocking#check-if-a-user-is-blocked-by-an-organization"""
+        """orgs/check-blocked-user
+
+        GET /orgs/{org}/blocks/{username}
+
+        Returns a 204 if the given user is blocked by the given organization. Returns a 404 if the organization is not blocking the user, or if the user account has been identified as spam by GitHub.
+
+        See also: https://docs.github.com/rest/orgs/blocking#check-if-a-user-is-blocked-by-an-organization
+        """
 
         from ..models import BasicError
 
@@ -685,7 +845,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/blocking#block-a-user-from-an-organization"""
+        """orgs/block-user
+
+        PUT /orgs/{org}/blocks/{username}
+
+        Blocks the given user on behalf of the specified organization and returns a 204. If the organization cannot block the given user a 422 is returned.
+
+        See also: https://docs.github.com/rest/orgs/blocking#block-a-user-from-an-organization
+        """
 
         from ..models import ValidationError
 
@@ -709,7 +876,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/blocking#block-a-user-from-an-organization"""
+        """orgs/block-user
+
+        PUT /orgs/{org}/blocks/{username}
+
+        Blocks the given user on behalf of the specified organization and returns a 204. If the organization cannot block the given user a 422 is returned.
+
+        See also: https://docs.github.com/rest/orgs/blocking#block-a-user-from-an-organization
+        """
 
         from ..models import ValidationError
 
@@ -733,7 +907,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/blocking#unblock-a-user-from-an-organization"""
+        """orgs/unblock-user
+
+        DELETE /orgs/{org}/blocks/{username}
+
+        Unblocks the given user on behalf of the specified organization.
+
+        See also: https://docs.github.com/rest/orgs/blocking#unblock-a-user-from-an-organization
+        """
 
         url = f"/orgs/{org}/blocks/{username}"
 
@@ -752,7 +933,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/blocking#unblock-a-user-from-an-organization"""
+        """orgs/unblock-user
+
+        DELETE /orgs/{org}/blocks/{username}
+
+        Unblocks the given user on behalf of the specified organization.
+
+        See also: https://docs.github.com/rest/orgs/blocking#unblock-a-user-from-an-organization
+        """
 
         url = f"/orgs/{org}/blocks/{username}"
 
@@ -772,7 +960,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationInvitation], list[OrganizationInvitationType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-failed-organization-invitations"""
+        """orgs/list-failed-invitations
+
+        GET /orgs/{org}/failed_invitations
+
+        The return hash contains `failed_at` and `failed_reason` fields which represent the time at which the invitation failed and the reason for the failure.
+
+        See also: https://docs.github.com/rest/orgs/members#list-failed-organization-invitations
+        """
 
         from ..models import BasicError, OrganizationInvitation
 
@@ -804,7 +999,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationInvitation], list[OrganizationInvitationType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-failed-organization-invitations"""
+        """orgs/list-failed-invitations
+
+        GET /orgs/{org}/failed_invitations
+
+        The return hash contains `failed_at` and `failed_reason` fields which represent the time at which the invitation failed and the reason for the failure.
+
+        See also: https://docs.github.com/rest/orgs/members#list-failed-organization-invitations
+        """
 
         from ..models import BasicError, OrganizationInvitation
 
@@ -836,7 +1038,19 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrgHook], list[OrgHookType]]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#list-organization-webhooks"""
+        """orgs/list-webhooks
+
+        GET /orgs/{org}/hooks
+
+        List webhooks for an organization.
+
+        The authenticated user must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#list-organization-webhooks
+        """
 
         from ..models import BasicError, OrgHook
 
@@ -868,7 +1082,19 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrgHook], list[OrgHookType]]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#list-organization-webhooks"""
+        """orgs/list-webhooks
+
+        GET /orgs/{org}/hooks
+
+        List webhooks for an organization.
+
+        The authenticated user must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#list-organization-webhooks
+        """
 
         from ..models import BasicError, OrgHook
 
@@ -922,7 +1148,19 @@ class OrgsClient:
         data: Missing[OrgsOrgHooksPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrgHook, OrgHookType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#create-an-organization-webhook"""
+        """orgs/create-webhook
+
+        POST /orgs/{org}/hooks
+
+        Create a hook that posts payloads in JSON format.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or
+        edit webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#create-an-organization-webhook
+        """
 
         from ..models import BasicError, OrgHook, OrgsOrgHooksPostBody, ValidationError
 
@@ -981,7 +1219,19 @@ class OrgsClient:
         data: Missing[OrgsOrgHooksPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrgHook, OrgHookType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#create-an-organization-webhook"""
+        """orgs/create-webhook
+
+        POST /orgs/{org}/hooks
+
+        Create a hook that posts payloads in JSON format.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or
+        edit webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#create-an-organization-webhook
+        """
 
         from ..models import BasicError, OrgHook, OrgsOrgHooksPostBody, ValidationError
 
@@ -1017,7 +1267,20 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrgHook, OrgHookType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#get-an-organization-webhook"""
+        """orgs/get-webhook
+
+        GET /orgs/{org}/hooks/{hook_id}
+
+        Returns a webhook configured in an organization. To get only the webhook
+        `config` properties, see "[Get a webhook configuration for an organization](/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization).
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#get-an-organization-webhook
+        """
 
         from ..models import BasicError, OrgHook
 
@@ -1042,7 +1305,20 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrgHook, OrgHookType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#get-an-organization-webhook"""
+        """orgs/get-webhook
+
+        GET /orgs/{org}/hooks/{hook_id}
+
+        Returns a webhook configured in an organization. To get only the webhook
+        `config` properties, see "[Get a webhook configuration for an organization](/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization).
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#get-an-organization-webhook
+        """
 
         from ..models import BasicError, OrgHook
 
@@ -1067,7 +1343,19 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/webhooks#delete-an-organization-webhook"""
+        """orgs/delete-webhook
+
+        DELETE /orgs/{org}/hooks/{hook_id}
+
+        Delete a webhook for an organization.
+
+        The authenticated user must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#delete-an-organization-webhook
+        """
 
         from ..models import BasicError
 
@@ -1091,7 +1379,19 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/webhooks#delete-an-organization-webhook"""
+        """orgs/delete-webhook
+
+        DELETE /orgs/{org}/hooks/{hook_id}
+
+        Delete a webhook for an organization.
+
+        The authenticated user must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#delete-an-organization-webhook
+        """
 
         from ..models import BasicError
 
@@ -1141,7 +1441,23 @@ class OrgsClient:
         data: Missing[OrgsOrgHooksHookIdPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrgHook, OrgHookType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#update-an-organization-webhook"""
+        """orgs/update-webhook
+
+        PATCH /orgs/{org}/hooks/{hook_id}
+
+        Updates a webhook configured in an organization. When you update a webhook,
+        the `secret` will be overwritten. If you previously had a `secret` set, you must
+        provide the same `secret` or set a new `secret` or the secret will be removed. If
+        you are only updating individual webhook `config` properties, use "[Update a webhook
+        configuration for an organization](/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization)".
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#update-an-organization-webhook
+        """
 
         from ..models import (
             BasicError,
@@ -1208,7 +1524,23 @@ class OrgsClient:
         data: Missing[OrgsOrgHooksHookIdPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrgHook, OrgHookType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#update-an-organization-webhook"""
+        """orgs/update-webhook
+
+        PATCH /orgs/{org}/hooks/{hook_id}
+
+        Updates a webhook configured in an organization. When you update a webhook,
+        the `secret` will be overwritten. If you previously had a `secret` set, you must
+        provide the same `secret` or set a new `secret` or the secret will be removed. If
+        you are only updating individual webhook `config` properties, use "[Update a webhook
+        configuration for an organization](/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization)".
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#update-an-organization-webhook
+        """
 
         from ..models import (
             BasicError,
@@ -1249,7 +1581,19 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[WebhookConfig, WebhookConfigType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization"""
+        """orgs/get-webhook-config-for-org
+
+        GET /orgs/{org}/hooks/{hook_id}/config
+
+        Returns the webhook configuration for an organization. To get more information about the webhook, including the `active` state and `events`, use "[Get an organization webhook ](/rest/orgs/webhooks#get-an-organization-webhook)."
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization
+        """
 
         from ..models import WebhookConfig
 
@@ -1271,7 +1615,19 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[WebhookConfig, WebhookConfigType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization"""
+        """orgs/get-webhook-config-for-org
+
+        GET /orgs/{org}/hooks/{hook_id}/config
+
+        Returns the webhook configuration for an organization. To get more information about the webhook, including the `active` state and `events`, use "[Get an organization webhook ](/rest/orgs/webhooks#get-an-organization-webhook)."
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization
+        """
 
         from ..models import WebhookConfig
 
@@ -1319,7 +1675,19 @@ class OrgsClient:
         data: Missing[OrgsOrgHooksHookIdConfigPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[WebhookConfig, WebhookConfigType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization"""
+        """orgs/update-webhook-config-for-org
+
+        PATCH /orgs/{org}/hooks/{hook_id}/config
+
+        Updates the webhook configuration for an organization. To update more information about the webhook, including the `active` state and `events`, use "[Update an organization webhook ](/rest/orgs/webhooks#update-an-organization-webhook)."
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization
+        """
 
         from ..models import OrgsOrgHooksHookIdConfigPatchBody, WebhookConfig
 
@@ -1377,7 +1745,19 @@ class OrgsClient:
         data: Missing[OrgsOrgHooksHookIdConfigPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[WebhookConfig, WebhookConfigType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization"""
+        """orgs/update-webhook-config-for-org
+
+        PATCH /orgs/{org}/hooks/{hook_id}/config
+
+        Updates the webhook configuration for an organization. To update more information about the webhook, including the `active` state and `events`, use "[Update an organization webhook ](/rest/orgs/webhooks#update-an-organization-webhook)."
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization
+        """
 
         from ..models import OrgsOrgHooksHookIdConfigPatchBody, WebhookConfig
 
@@ -1411,7 +1791,19 @@ class OrgsClient:
         cursor: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[HookDeliveryItem], list[HookDeliveryItemType]]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#list-deliveries-for-an-organization-webhook"""
+        """orgs/list-webhook-deliveries
+
+        GET /orgs/{org}/hooks/{hook_id}/deliveries
+
+        Returns a list of webhook deliveries for a webhook configured in an organization.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#list-deliveries-for-an-organization-webhook
+        """
 
         from ..models import BasicError, HookDeliveryItem, ValidationError
 
@@ -1445,7 +1837,19 @@ class OrgsClient:
         cursor: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[HookDeliveryItem], list[HookDeliveryItemType]]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#list-deliveries-for-an-organization-webhook"""
+        """orgs/list-webhook-deliveries
+
+        GET /orgs/{org}/hooks/{hook_id}/deliveries
+
+        Returns a list of webhook deliveries for a webhook configured in an organization.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#list-deliveries-for-an-organization-webhook
+        """
 
         from ..models import BasicError, HookDeliveryItem, ValidationError
 
@@ -1478,7 +1882,19 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[HookDelivery, HookDeliveryType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook"""
+        """orgs/get-webhook-delivery
+
+        GET /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}
+
+        Returns a delivery for a webhook configured in an organization.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook
+        """
 
         from ..models import BasicError, HookDelivery, ValidationError
 
@@ -1505,7 +1921,19 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[HookDelivery, HookDeliveryType]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook"""
+        """orgs/get-webhook-delivery
+
+        GET /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}
+
+        Returns a delivery for a webhook configured in an organization.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook
+        """
 
         from ..models import BasicError, HookDelivery, ValidationError
 
@@ -1535,7 +1963,19 @@ class OrgsClient:
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook"""
+        """orgs/redeliver-webhook-delivery
+
+        POST /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts
+
+        Redeliver a delivery for a webhook configured in an organization.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook
+        """
 
         from ..models import (
             AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
@@ -1569,7 +2009,19 @@ class OrgsClient:
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook"""
+        """orgs/redeliver-webhook-delivery
+
+        POST /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts
+
+        Redeliver a delivery for a webhook configured in an organization.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook
+        """
 
         from ..models import (
             AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
@@ -1599,7 +2051,20 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/webhooks#ping-an-organization-webhook"""
+        """orgs/ping-webhook
+
+        POST /orgs/{org}/hooks/{hook_id}/pings
+
+        This will trigger a [ping event](https://docs.github.com/webhooks/#ping-event)
+        to be sent to the hook.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#ping-an-organization-webhook
+        """
 
         from ..models import BasicError
 
@@ -1623,7 +2088,20 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/webhooks#ping-an-organization-webhook"""
+        """orgs/ping-webhook
+
+        POST /orgs/{org}/hooks/{hook_id}/pings
+
+        This will trigger a [ping event](https://docs.github.com/webhooks/#ping-event)
+        to be sent to the hook.
+
+        You must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+        webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
+        See also: https://docs.github.com/rest/orgs/webhooks#ping-an-organization-webhook
+        """
 
         from ..models import BasicError
 
@@ -1674,7 +2152,14 @@ class OrgsClient:
     ) -> Response[
         list[ApiInsightsRouteStatsItems], list[ApiInsightsRouteStatsItemsType]
     ]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-route-stats-by-actor"""
+        """api-insights/get-route-stats-by-actor
+
+        GET /orgs/{org}/insights/api/route-stats/{actor_type}/{actor_id}
+
+        Get API request count statistics for an actor broken down by route within a specified time frame.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-route-stats-by-actor
+        """
 
         from ..models import ApiInsightsRouteStatsItems
 
@@ -1734,7 +2219,14 @@ class OrgsClient:
     ) -> Response[
         list[ApiInsightsRouteStatsItems], list[ApiInsightsRouteStatsItemsType]
     ]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-route-stats-by-actor"""
+        """api-insights/get-route-stats-by-actor
+
+        GET /orgs/{org}/insights/api/route-stats/{actor_type}/{actor_id}
+
+        Get API request count statistics for an actor broken down by route within a specified time frame.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-route-stats-by-actor
+        """
 
         from ..models import ApiInsightsRouteStatsItems
 
@@ -1785,7 +2277,14 @@ class OrgsClient:
     ) -> Response[
         list[ApiInsightsSubjectStatsItems], list[ApiInsightsSubjectStatsItemsType]
     ]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-subject-stats"""
+        """api-insights/get-subject-stats
+
+        GET /orgs/{org}/insights/api/subject-stats
+
+        Get API request statistics for all subjects within an organization within a specified time frame. Subjects can be users or GitHub Apps.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-subject-stats
+        """
 
         from ..models import ApiInsightsSubjectStatsItems
 
@@ -1836,7 +2335,14 @@ class OrgsClient:
     ) -> Response[
         list[ApiInsightsSubjectStatsItems], list[ApiInsightsSubjectStatsItemsType]
     ]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-subject-stats"""
+        """api-insights/get-subject-stats
+
+        GET /orgs/{org}/insights/api/subject-stats
+
+        Get API request statistics for all subjects within an organization within a specified time frame. Subjects can be users or GitHub Apps.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-subject-stats
+        """
 
         from ..models import ApiInsightsSubjectStatsItems
 
@@ -1870,7 +2376,14 @@ class OrgsClient:
         max_timestamp: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[ApiInsightsSummaryStats, ApiInsightsSummaryStatsType]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats"""
+        """api-insights/get-summary-stats
+
+        GET /orgs/{org}/insights/api/summary-stats
+
+        Get overall statistics of API requests made within an organization by all users and apps within a specified time frame.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats
+        """
 
         from ..models import ApiInsightsSummaryStats
 
@@ -1899,7 +2412,14 @@ class OrgsClient:
         max_timestamp: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[ApiInsightsSummaryStats, ApiInsightsSummaryStatsType]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats"""
+        """api-insights/get-summary-stats
+
+        GET /orgs/{org}/insights/api/summary-stats
+
+        Get overall statistics of API requests made within an organization by all users and apps within a specified time frame.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats
+        """
 
         from ..models import ApiInsightsSummaryStats
 
@@ -1929,7 +2449,14 @@ class OrgsClient:
         max_timestamp: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[ApiInsightsSummaryStats, ApiInsightsSummaryStatsType]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-user"""
+        """api-insights/get-summary-stats-by-user
+
+        GET /orgs/{org}/insights/api/summary-stats/users/{user_id}
+
+        Get overall statistics of API requests within the organization for a user.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-user
+        """
 
         from ..models import ApiInsightsSummaryStats
 
@@ -1959,7 +2486,14 @@ class OrgsClient:
         max_timestamp: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[ApiInsightsSummaryStats, ApiInsightsSummaryStatsType]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-user"""
+        """api-insights/get-summary-stats-by-user
+
+        GET /orgs/{org}/insights/api/summary-stats/users/{user_id}
+
+        Get overall statistics of API requests within the organization for a user.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-user
+        """
 
         from ..models import ApiInsightsSummaryStats
 
@@ -1996,7 +2530,14 @@ class OrgsClient:
         max_timestamp: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[ApiInsightsSummaryStats, ApiInsightsSummaryStatsType]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-actor"""
+        """api-insights/get-summary-stats-by-actor
+
+        GET /orgs/{org}/insights/api/summary-stats/{actor_type}/{actor_id}
+
+        Get overall statistics of API requests within the organization made by a specific actor. Actors can be GitHub App installations, OAuth apps or other tokens on behalf of a user.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-actor
+        """
 
         from ..models import ApiInsightsSummaryStats
 
@@ -2033,7 +2574,14 @@ class OrgsClient:
         max_timestamp: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[ApiInsightsSummaryStats, ApiInsightsSummaryStatsType]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-actor"""
+        """api-insights/get-summary-stats-by-actor
+
+        GET /orgs/{org}/insights/api/summary-stats/{actor_type}/{actor_id}
+
+        Get overall statistics of API requests within the organization made by a specific actor. Actors can be GitHub App installations, OAuth apps or other tokens on behalf of a user.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-actor
+        """
 
         from ..models import ApiInsightsSummaryStats
 
@@ -2063,7 +2611,14 @@ class OrgsClient:
         timestamp_increment: str,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ApiInsightsTimeStatsItems], list[ApiInsightsTimeStatsItemsType]]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats"""
+        """api-insights/get-time-stats
+
+        GET /orgs/{org}/insights/api/time-stats
+
+        Get the number of API requests and rate-limited requests made within an organization over a specified time period.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats
+        """
 
         from ..models import ApiInsightsTimeStatsItems
 
@@ -2094,7 +2649,14 @@ class OrgsClient:
         timestamp_increment: str,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ApiInsightsTimeStatsItems], list[ApiInsightsTimeStatsItemsType]]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats"""
+        """api-insights/get-time-stats
+
+        GET /orgs/{org}/insights/api/time-stats
+
+        Get the number of API requests and rate-limited requests made within an organization over a specified time period.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats
+        """
 
         from ..models import ApiInsightsTimeStatsItems
 
@@ -2126,7 +2688,14 @@ class OrgsClient:
         timestamp_increment: str,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ApiInsightsTimeStatsItems], list[ApiInsightsTimeStatsItemsType]]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-user"""
+        """api-insights/get-time-stats-by-user
+
+        GET /orgs/{org}/insights/api/time-stats/users/{user_id}
+
+        Get the number of API requests and rate-limited requests made within an organization by a specific user over a specified time period.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-user
+        """
 
         from ..models import ApiInsightsTimeStatsItems
 
@@ -2158,7 +2727,14 @@ class OrgsClient:
         timestamp_increment: str,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ApiInsightsTimeStatsItems], list[ApiInsightsTimeStatsItemsType]]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-user"""
+        """api-insights/get-time-stats-by-user
+
+        GET /orgs/{org}/insights/api/time-stats/users/{user_id}
+
+        Get the number of API requests and rate-limited requests made within an organization by a specific user over a specified time period.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-user
+        """
 
         from ..models import ApiInsightsTimeStatsItems
 
@@ -2197,7 +2773,14 @@ class OrgsClient:
         timestamp_increment: str,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ApiInsightsTimeStatsItems], list[ApiInsightsTimeStatsItemsType]]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-actor"""
+        """api-insights/get-time-stats-by-actor
+
+        GET /orgs/{org}/insights/api/time-stats/{actor_type}/{actor_id}
+
+        Get the number of API requests and rate-limited requests made within an organization by a specific actor within a specified time period.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-actor
+        """
 
         from ..models import ApiInsightsTimeStatsItems
 
@@ -2236,7 +2819,14 @@ class OrgsClient:
         timestamp_increment: str,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ApiInsightsTimeStatsItems], list[ApiInsightsTimeStatsItemsType]]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-actor"""
+        """api-insights/get-time-stats-by-actor
+
+        GET /orgs/{org}/insights/api/time-stats/{actor_type}/{actor_id}
+
+        Get the number of API requests and rate-limited requests made within an organization by a specific actor within a specified time period.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-actor
+        """
 
         from ..models import ApiInsightsTimeStatsItems
 
@@ -2282,7 +2872,14 @@ class OrgsClient:
         actor_name_substring: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ApiInsightsUserStatsItems], list[ApiInsightsUserStatsItemsType]]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-user-stats"""
+        """api-insights/get-user-stats
+
+        GET /orgs/{org}/insights/api/user-stats/{user_id}
+
+        Get API usage statistics within an organization for a user broken down by the type of access.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-user-stats
+        """
 
         from ..models import ApiInsightsUserStatsItems
 
@@ -2332,7 +2929,14 @@ class OrgsClient:
         actor_name_substring: Missing[str] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[ApiInsightsUserStatsItems], list[ApiInsightsUserStatsItemsType]]:
-        """See also: https://docs.github.com/rest/orgs/api-insights#get-user-stats"""
+        """api-insights/get-user-stats
+
+        GET /orgs/{org}/insights/api/user-stats/{user_id}
+
+        Get API usage statistics within an organization for a user broken down by the type of access.
+
+        See also: https://docs.github.com/rest/orgs/api-insights#get-user-stats
+        """
 
         from ..models import ApiInsightsUserStatsItems
 
@@ -2368,7 +2972,19 @@ class OrgsClient:
     ) -> Response[
         OrgsOrgInstallationsGetResponse200, OrgsOrgInstallationsGetResponse200Type
     ]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-app-installations-for-an-organization"""
+        """orgs/list-app-installations
+
+        GET /orgs/{org}/installations
+
+        Lists all GitHub Apps in an organization. The installation count includes
+        all GitHub Apps installed on repositories in the organization.
+
+        The authenticated user must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:read` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-app-installations-for-an-organization
+        """
 
         from ..models import OrgsOrgInstallationsGetResponse200
 
@@ -2399,7 +3015,19 @@ class OrgsClient:
     ) -> Response[
         OrgsOrgInstallationsGetResponse200, OrgsOrgInstallationsGetResponse200Type
     ]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-app-installations-for-an-organization"""
+        """orgs/list-app-installations
+
+        GET /orgs/{org}/installations
+
+        Lists all GitHub Apps in an organization. The installation count includes
+        all GitHub Apps installed on repositories in the organization.
+
+        The authenticated user must be an organization owner to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:read` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-app-installations-for-an-organization
+        """
 
         from ..models import OrgsOrgInstallationsGetResponse200
 
@@ -2434,7 +3062,17 @@ class OrgsClient:
         invitation_source: Missing[Literal["all", "member", "scim"]] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationInvitation], list[OrganizationInvitationType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-pending-organization-invitations"""
+        """orgs/list-pending-invitations
+
+        GET /orgs/{org}/invitations
+
+        The return hash contains a `role` field which refers to the Organization
+        Invitation role and will be one of the following values: `direct_member`, `admin`,
+        `billing_manager`, or `hiring_manager`. If the invitee is not a GitHub
+        member, the `login` field in the return hash will be `null`.
+
+        See also: https://docs.github.com/rest/orgs/members#list-pending-organization-invitations
+        """
 
         from ..models import BasicError, OrganizationInvitation
 
@@ -2474,7 +3112,17 @@ class OrgsClient:
         invitation_source: Missing[Literal["all", "member", "scim"]] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationInvitation], list[OrganizationInvitationType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-pending-organization-invitations"""
+        """orgs/list-pending-invitations
+
+        GET /orgs/{org}/invitations
+
+        The return hash contains a `role` field which refers to the Organization
+        Invitation role and will be one of the following values: `direct_member`, `admin`,
+        `billing_manager`, or `hiring_manager`. If the invitee is not a GitHub
+        member, the `login` field in the return hash will be `null`.
+
+        See also: https://docs.github.com/rest/orgs/members#list-pending-organization-invitations
+        """
 
         from ..models import BasicError, OrganizationInvitation
 
@@ -2532,7 +3180,17 @@ class OrgsClient:
         data: Missing[OrgsOrgInvitationsPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrganizationInvitation, OrganizationInvitationType]:
-        """See also: https://docs.github.com/rest/orgs/members#create-an-organization-invitation"""
+        """orgs/create-invitation
+
+        POST /orgs/{org}/invitations
+
+        Invite people to an organization by using their GitHub user ID or their email address. In order to create invitations in an organization, the authenticated user must be an organization owner.
+
+        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/orgs/members#create-an-organization-invitation
+        """
 
         from ..models import (
             BasicError,
@@ -2598,7 +3256,17 @@ class OrgsClient:
         data: Missing[OrgsOrgInvitationsPostBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrganizationInvitation, OrganizationInvitationType]:
-        """See also: https://docs.github.com/rest/orgs/members#create-an-organization-invitation"""
+        """orgs/create-invitation
+
+        POST /orgs/{org}/invitations
+
+        Invite people to an organization by using their GitHub user ID or their email address. In order to create invitations in an organization, the authenticated user must be an organization owner.
+
+        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/orgs/members#create-an-organization-invitation
+        """
 
         from ..models import (
             BasicError,
@@ -2639,7 +3307,16 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#cancel-an-organization-invitation"""
+        """orgs/cancel-invitation
+
+        DELETE /orgs/{org}/invitations/{invitation_id}
+
+        Cancel an organization invitation. In order to cancel an organization invitation, the authenticated user must be an organization owner.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications).
+
+        See also: https://docs.github.com/rest/orgs/members#cancel-an-organization-invitation
+        """
 
         from ..models import BasicError, ValidationError
 
@@ -2664,7 +3341,16 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#cancel-an-organization-invitation"""
+        """orgs/cancel-invitation
+
+        DELETE /orgs/{org}/invitations/{invitation_id}
+
+        Cancel an organization invitation. In order to cancel an organization invitation, the authenticated user must be an organization owner.
+
+        This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications).
+
+        See also: https://docs.github.com/rest/orgs/members#cancel-an-organization-invitation
+        """
 
         from ..models import BasicError, ValidationError
 
@@ -2691,7 +3377,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[Team], list[TeamType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-organization-invitation-teams"""
+        """orgs/list-invitation-teams
+
+        GET /orgs/{org}/invitations/{invitation_id}/teams
+
+        List all teams associated with an invitation. In order to see invitations in an organization, the authenticated user must be an organization owner.
+
+        See also: https://docs.github.com/rest/orgs/members#list-organization-invitation-teams
+        """
 
         from ..models import BasicError, Team
 
@@ -2724,7 +3417,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[Team], list[TeamType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-organization-invitation-teams"""
+        """orgs/list-invitation-teams
+
+        GET /orgs/{org}/invitations/{invitation_id}/teams
+
+        List all teams associated with an invitation. In order to see invitations in an organization, the authenticated user must be an organization owner.
+
+        See also: https://docs.github.com/rest/orgs/members#list-organization-invitation-teams
+        """
 
         from ..models import BasicError, Team
 
@@ -2754,7 +3454,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[Union[IssueType, None]], list[Union[IssueTypeType, None]]]:
-        """See also: https://docs.github.com/rest/orgs/issue-types#list-issue-types-for-an-organization"""
+        """orgs/list-issue-types
+
+        GET /orgs/{org}/issue-types
+
+        Lists all issue types for an organization. OAuth app tokens and personal access tokens (classic) need the read:org scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/issue-types#list-issue-types-for-an-organization
+        """
 
         from typing import Union
 
@@ -2780,7 +3487,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[Union[IssueType, None]], list[Union[IssueTypeType, None]]]:
-        """See also: https://docs.github.com/rest/orgs/issue-types#list-issue-types-for-an-organization"""
+        """orgs/list-issue-types
+
+        GET /orgs/{org}/issue-types
+
+        Lists all issue types for an organization. OAuth app tokens and personal access tokens (classic) need the read:org scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/issue-types#list-issue-types-for-an-organization
+        """
 
         from typing import Union
 
@@ -2837,7 +3551,19 @@ class OrgsClient:
         data: Missing[OrganizationCreateIssueTypeType] = UNSET,
         **kwargs,
     ) -> Response[Union[IssueType, None], Union[IssueTypeType, None]]:
-        """See also: https://docs.github.com/rest/orgs/issue-types#create-issue-type-for-an-organization"""
+        """orgs/create-issue-type
+
+        POST /orgs/{org}/issue-types
+
+        Create a new issue type for an organization.
+
+        You can find out more about issue types in [Managing issue types in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization).
+
+        To use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and
+        personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/issue-types#create-issue-type-for-an-organization
+        """
 
         from typing import Union
 
@@ -2910,7 +3636,19 @@ class OrgsClient:
         data: Missing[OrganizationCreateIssueTypeType] = UNSET,
         **kwargs,
     ) -> Response[Union[IssueType, None], Union[IssueTypeType, None]]:
-        """See also: https://docs.github.com/rest/orgs/issue-types#create-issue-type-for-an-organization"""
+        """orgs/create-issue-type
+
+        POST /orgs/{org}/issue-types
+
+        Create a new issue type for an organization.
+
+        You can find out more about issue types in [Managing issue types in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization).
+
+        To use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and
+        personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/issue-types#create-issue-type-for-an-organization
+        """
 
         from typing import Union
 
@@ -2986,7 +3724,19 @@ class OrgsClient:
         data: Missing[OrganizationUpdateIssueTypeType] = UNSET,
         **kwargs,
     ) -> Response[Union[IssueType, None], Union[IssueTypeType, None]]:
-        """See also: https://docs.github.com/rest/orgs/issue-types#update-issue-type-for-an-organization"""
+        """orgs/update-issue-type
+
+        PUT /orgs/{org}/issue-types/{issue_type_id}
+
+        Updates an issue type for an organization.
+
+        You can find out more about issue types in [Managing issue types in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization).
+
+        To use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and
+        personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/issue-types#update-issue-type-for-an-organization
+        """
 
         from typing import Union
 
@@ -3062,7 +3812,19 @@ class OrgsClient:
         data: Missing[OrganizationUpdateIssueTypeType] = UNSET,
         **kwargs,
     ) -> Response[Union[IssueType, None], Union[IssueTypeType, None]]:
-        """See also: https://docs.github.com/rest/orgs/issue-types#update-issue-type-for-an-organization"""
+        """orgs/update-issue-type
+
+        PUT /orgs/{org}/issue-types/{issue_type_id}
+
+        Updates an issue type for an organization.
+
+        You can find out more about issue types in [Managing issue types in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization).
+
+        To use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and
+        personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/issue-types#update-issue-type-for-an-organization
+        """
 
         from typing import Union
 
@@ -3105,7 +3867,19 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/issue-types#delete-issue-type-for-an-organization"""
+        """orgs/delete-issue-type
+
+        DELETE /orgs/{org}/issue-types/{issue_type_id}
+
+        Deletes an issue type for an organization.
+
+        You can find out more about issue types in [Managing issue types in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization).
+
+        To use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and
+        personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/issue-types#delete-issue-type-for-an-organization
+        """
 
         from ..models import BasicError, ValidationErrorSimple
 
@@ -3130,7 +3904,19 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/issue-types#delete-issue-type-for-an-organization"""
+        """orgs/delete-issue-type
+
+        DELETE /orgs/{org}/issue-types/{issue_type_id}
+
+        Deletes an issue type for an organization.
+
+        You can find out more about issue types in [Managing issue types in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization).
+
+        To use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and
+        personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/issue-types#delete-issue-type-for-an-organization
+        """
 
         from ..models import BasicError, ValidationErrorSimple
 
@@ -3158,7 +3944,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[SimpleUser], list[SimpleUserType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-organization-members"""
+        """orgs/list-members
+
+        GET /orgs/{org}/members
+
+        List all users who are members of an organization. If the authenticated user is also a member of this organization then both concealed and public members will be returned.
+
+        See also: https://docs.github.com/rest/orgs/members#list-organization-members
+        """
 
         from ..models import SimpleUser, ValidationError
 
@@ -3194,7 +3987,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[SimpleUser], list[SimpleUserType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-organization-members"""
+        """orgs/list-members
+
+        GET /orgs/{org}/members
+
+        List all users who are members of an organization. If the authenticated user is also a member of this organization then both concealed and public members will be returned.
+
+        See also: https://docs.github.com/rest/orgs/members#list-organization-members
+        """
 
         from ..models import SimpleUser, ValidationError
 
@@ -3227,7 +4027,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#check-organization-membership-for-a-user"""
+        """orgs/check-membership-for-user
+
+        GET /orgs/{org}/members/{username}
+
+        Check if a user is, publicly or privately, a member of the organization.
+
+        See also: https://docs.github.com/rest/orgs/members#check-organization-membership-for-a-user
+        """
 
         url = f"/orgs/{org}/members/{username}"
 
@@ -3247,7 +4054,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#check-organization-membership-for-a-user"""
+        """orgs/check-membership-for-user
+
+        GET /orgs/{org}/members/{username}
+
+        Check if a user is, publicly or privately, a member of the organization.
+
+        See also: https://docs.github.com/rest/orgs/members#check-organization-membership-for-a-user
+        """
 
         url = f"/orgs/{org}/members/{username}"
 
@@ -3267,7 +4081,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#remove-an-organization-member"""
+        """orgs/remove-member
+
+        DELETE /orgs/{org}/members/{username}
+
+        Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.
+
+        See also: https://docs.github.com/rest/orgs/members#remove-an-organization-member
+        """
 
         from ..models import BasicError
 
@@ -3291,7 +4112,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#remove-an-organization-member"""
+        """orgs/remove-member
+
+        DELETE /orgs/{org}/members/{username}
+
+        Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.
+
+        See also: https://docs.github.com/rest/orgs/members#remove-an-organization-member
+        """
 
         from ..models import BasicError
 
@@ -3315,7 +4143,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrgMembership, OrgMembershipType]:
-        """See also: https://docs.github.com/rest/orgs/members#get-organization-membership-for-a-user"""
+        """orgs/get-membership-for-user
+
+        GET /orgs/{org}/memberships/{username}
+
+        In order to get a user's membership with an organization, the authenticated user must be an organization member. The `state` parameter in the response can be used to identify the user's membership status.
+
+        See also: https://docs.github.com/rest/orgs/members#get-organization-membership-for-a-user
+        """
 
         from ..models import BasicError, OrgMembership
 
@@ -3341,7 +4176,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrgMembership, OrgMembershipType]:
-        """See also: https://docs.github.com/rest/orgs/members#get-organization-membership-for-a-user"""
+        """orgs/get-membership-for-user
+
+        GET /orgs/{org}/memberships/{username}
+
+        In order to get a user's membership with an organization, the authenticated user must be an organization member. The `state` parameter in the response can be used to identify the user's membership status.
+
+        See also: https://docs.github.com/rest/orgs/members#get-organization-membership-for-a-user
+        """
 
         from ..models import BasicError, OrgMembership
 
@@ -3390,7 +4232,22 @@ class OrgsClient:
         data: Missing[OrgsOrgMembershipsUsernamePutBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrgMembership, OrgMembershipType]:
-        """See also: https://docs.github.com/rest/orgs/members#set-organization-membership-for-a-user"""
+        """orgs/set-membership-for-user
+
+        PUT /orgs/{org}/memberships/{username}
+
+        Only authenticated organization owners can add a member to the organization or update the member's role.
+
+        *   If the authenticated user is _adding_ a member to the organization, the invited user will receive an email inviting them to the organization. The user's [membership status](https://docs.github.com/rest/orgs/members#get-organization-membership-for-a-user) will be `pending` until they accept the invitation.
+
+        *   Authenticated users can _update_ a user's membership by passing the `role` parameter. If the authenticated user changes a member's role to `admin`, the affected user will receive an email notifying them that they've been made an organization owner. If the authenticated user changes an owner's role to `member`, no email will be sent.
+
+        **Rate limits**
+
+        To prevent abuse, organization owners are limited to creating 50 organization invitations for an organization within a 24 hour period. If the organization is more than one month old or on a paid plan, the limit is 500 invitations per 24 hour period.
+
+        See also: https://docs.github.com/rest/orgs/members#set-organization-membership-for-a-user
+        """
 
         from ..models import (
             BasicError,
@@ -3454,7 +4311,22 @@ class OrgsClient:
         data: Missing[OrgsOrgMembershipsUsernamePutBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrgMembership, OrgMembershipType]:
-        """See also: https://docs.github.com/rest/orgs/members#set-organization-membership-for-a-user"""
+        """orgs/set-membership-for-user
+
+        PUT /orgs/{org}/memberships/{username}
+
+        Only authenticated organization owners can add a member to the organization or update the member's role.
+
+        *   If the authenticated user is _adding_ a member to the organization, the invited user will receive an email inviting them to the organization. The user's [membership status](https://docs.github.com/rest/orgs/members#get-organization-membership-for-a-user) will be `pending` until they accept the invitation.
+
+        *   Authenticated users can _update_ a user's membership by passing the `role` parameter. If the authenticated user changes a member's role to `admin`, the affected user will receive an email notifying them that they've been made an organization owner. If the authenticated user changes an owner's role to `member`, no email will be sent.
+
+        **Rate limits**
+
+        To prevent abuse, organization owners are limited to creating 50 organization invitations for an organization within a 24 hour period. If the organization is more than one month old or on a paid plan, the limit is 500 invitations per 24 hour period.
+
+        See also: https://docs.github.com/rest/orgs/members#set-organization-membership-for-a-user
+        """
 
         from ..models import (
             BasicError,
@@ -3495,7 +4367,16 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#remove-organization-membership-for-a-user"""
+        """orgs/remove-membership-for-user
+
+        DELETE /orgs/{org}/memberships/{username}
+
+        In order to remove a user's membership with an organization, the authenticated user must be an organization owner.
+
+        If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.
+
+        See also: https://docs.github.com/rest/orgs/members#remove-organization-membership-for-a-user
+        """
 
         from ..models import BasicError
 
@@ -3520,7 +4401,16 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#remove-organization-membership-for-a-user"""
+        """orgs/remove-membership-for-user
+
+        DELETE /orgs/{org}/memberships/{username}
+
+        In order to remove a user's membership with an organization, the authenticated user must be an organization owner.
+
+        If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.
+
+        See also: https://docs.github.com/rest/orgs/members#remove-organization-membership-for-a-user
+        """
 
         from ..models import BasicError
 
@@ -3547,7 +4437,21 @@ class OrgsClient:
         OrgsOrgOrganizationRolesGetResponse200,
         OrgsOrgOrganizationRolesGetResponse200Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#get-all-organization-roles-for-an-organization"""
+        """orgs/list-org-roles
+
+        GET /orgs/{org}/organization-roles
+
+        Lists the organization roles available in this organization. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        To use this endpoint, the authenticated user must be one of:
+
+        - An administrator for the organization.
+        - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#get-all-organization-roles-for-an-organization
+        """
 
         from ..models import (
             BasicError,
@@ -3579,7 +4483,21 @@ class OrgsClient:
         OrgsOrgOrganizationRolesGetResponse200,
         OrgsOrgOrganizationRolesGetResponse200Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#get-all-organization-roles-for-an-organization"""
+        """orgs/list-org-roles
+
+        GET /orgs/{org}/organization-roles
+
+        Lists the organization roles available in this organization. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        To use this endpoint, the authenticated user must be one of:
+
+        - An administrator for the organization.
+        - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#get-all-organization-roles-for-an-organization
+        """
 
         from ..models import (
             BasicError,
@@ -3609,7 +4527,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#remove-all-organization-roles-for-a-team"""
+        """orgs/revoke-all-org-roles-team
+
+        DELETE /orgs/{org}/organization-roles/teams/{team_slug}
+
+        Removes all assigned organization roles from a team. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#remove-all-organization-roles-for-a-team
+        """
 
         url = f"/orgs/{org}/organization-roles/teams/{team_slug}"
 
@@ -3628,7 +4557,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#remove-all-organization-roles-for-a-team"""
+        """orgs/revoke-all-org-roles-team
+
+        DELETE /orgs/{org}/organization-roles/teams/{team_slug}
+
+        Removes all assigned organization roles from a team. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#remove-all-organization-roles-for-a-team
+        """
 
         url = f"/orgs/{org}/organization-roles/teams/{team_slug}"
 
@@ -3648,7 +4588,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#assign-an-organization-role-to-a-team"""
+        """orgs/assign-team-to-org-role
+
+        PUT /orgs/{org}/organization-roles/teams/{team_slug}/{role_id}
+
+        Assigns an organization role to a team in an organization. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#assign-an-organization-role-to-a-team
+        """
 
         url = f"/orgs/{org}/organization-roles/teams/{team_slug}/{role_id}"
 
@@ -3669,7 +4620,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#assign-an-organization-role-to-a-team"""
+        """orgs/assign-team-to-org-role
+
+        PUT /orgs/{org}/organization-roles/teams/{team_slug}/{role_id}
+
+        Assigns an organization role to a team in an organization. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#assign-an-organization-role-to-a-team
+        """
 
         url = f"/orgs/{org}/organization-roles/teams/{team_slug}/{role_id}"
 
@@ -3690,7 +4652,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#remove-an-organization-role-from-a-team"""
+        """orgs/revoke-org-role-team
+
+        DELETE /orgs/{org}/organization-roles/teams/{team_slug}/{role_id}
+
+        Removes an organization role from a team. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#remove-an-organization-role-from-a-team
+        """
 
         url = f"/orgs/{org}/organization-roles/teams/{team_slug}/{role_id}"
 
@@ -3710,7 +4683,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#remove-an-organization-role-from-a-team"""
+        """orgs/revoke-org-role-team
+
+        DELETE /orgs/{org}/organization-roles/teams/{team_slug}/{role_id}
+
+        Removes an organization role from a team. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#remove-an-organization-role-from-a-team
+        """
 
         url = f"/orgs/{org}/organization-roles/teams/{team_slug}/{role_id}"
 
@@ -3729,7 +4713,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#remove-all-organization-roles-for-a-user"""
+        """orgs/revoke-all-org-roles-user
+
+        DELETE /orgs/{org}/organization-roles/users/{username}
+
+        Revokes all assigned organization roles from a user. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#remove-all-organization-roles-for-a-user
+        """
 
         url = f"/orgs/{org}/organization-roles/users/{username}"
 
@@ -3748,7 +4743,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#remove-all-organization-roles-for-a-user"""
+        """orgs/revoke-all-org-roles-user
+
+        DELETE /orgs/{org}/organization-roles/users/{username}
+
+        Revokes all assigned organization roles from a user. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#remove-all-organization-roles-for-a-user
+        """
 
         url = f"/orgs/{org}/organization-roles/users/{username}"
 
@@ -3768,7 +4774,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#assign-an-organization-role-to-a-user"""
+        """orgs/assign-user-to-org-role
+
+        PUT /orgs/{org}/organization-roles/users/{username}/{role_id}
+
+        Assigns an organization role to a member of an organization. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#assign-an-organization-role-to-a-user
+        """
 
         url = f"/orgs/{org}/organization-roles/users/{username}/{role_id}"
 
@@ -3789,7 +4806,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#assign-an-organization-role-to-a-user"""
+        """orgs/assign-user-to-org-role
+
+        PUT /orgs/{org}/organization-roles/users/{username}/{role_id}
+
+        Assigns an organization role to a member of an organization. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#assign-an-organization-role-to-a-user
+        """
 
         url = f"/orgs/{org}/organization-roles/users/{username}/{role_id}"
 
@@ -3810,7 +4838,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#remove-an-organization-role-from-a-user"""
+        """orgs/revoke-org-role-user
+
+        DELETE /orgs/{org}/organization-roles/users/{username}/{role_id}
+
+        Remove an organization role from a user. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#remove-an-organization-role-from-a-user
+        """
 
         url = f"/orgs/{org}/organization-roles/users/{username}/{role_id}"
 
@@ -3830,7 +4869,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#remove-an-organization-role-from-a-user"""
+        """orgs/revoke-org-role-user
+
+        DELETE /orgs/{org}/organization-roles/users/{username}/{role_id}
+
+        Remove an organization role from a user. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        The authenticated user must be an administrator for the organization to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#remove-an-organization-role-from-a-user
+        """
 
         url = f"/orgs/{org}/organization-roles/users/{username}/{role_id}"
 
@@ -3849,7 +4899,21 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrganizationRole, OrganizationRoleType]:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#get-an-organization-role"""
+        """orgs/get-org-role
+
+        GET /orgs/{org}/organization-roles/{role_id}
+
+        Gets an organization role that is available to this organization. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        To use this endpoint, the authenticated user must be one of:
+
+        - An administrator for the organization.
+        - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#get-an-organization-role
+        """
 
         from ..models import BasicError, OrganizationRole, ValidationError
 
@@ -3875,7 +4939,21 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrganizationRole, OrganizationRoleType]:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#get-an-organization-role"""
+        """orgs/get-org-role
+
+        GET /orgs/{org}/organization-roles/{role_id}
+
+        Gets an organization role that is available to this organization. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        To use this endpoint, the authenticated user must be one of:
+
+        - An administrator for the organization.
+        - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#get-an-organization-role
+        """
 
         from ..models import BasicError, OrganizationRole, ValidationError
 
@@ -3903,7 +4981,18 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[TeamRoleAssignment], list[TeamRoleAssignmentType]]:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role"""
+        """orgs/list-org-role-teams
+
+        GET /orgs/{org}/organization-roles/{role_id}/teams
+
+        Lists the teams that are assigned to an organization role. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        To use this endpoint, you must be an administrator for the organization.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role
+        """
 
         from ..models import TeamRoleAssignment
 
@@ -3934,7 +5023,18 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[TeamRoleAssignment], list[TeamRoleAssignmentType]]:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role"""
+        """orgs/list-org-role-teams
+
+        GET /orgs/{org}/organization-roles/{role_id}/teams
+
+        Lists the teams that are assigned to an organization role. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        To use this endpoint, you must be an administrator for the organization.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role
+        """
 
         from ..models import TeamRoleAssignment
 
@@ -3965,7 +5065,18 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[UserRoleAssignment], list[UserRoleAssignmentType]]:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role"""
+        """orgs/list-org-role-users
+
+        GET /orgs/{org}/organization-roles/{role_id}/users
+
+        Lists organization members that are assigned to an organization role. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        To use this endpoint, you must be an administrator for the organization.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role
+        """
 
         from ..models import UserRoleAssignment
 
@@ -3996,7 +5107,18 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[UserRoleAssignment], list[UserRoleAssignmentType]]:
-        """See also: https://docs.github.com/rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role"""
+        """orgs/list-org-role-users
+
+        GET /orgs/{org}/organization-roles/{role_id}/users
+
+        Lists organization members that are assigned to an organization role. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."
+
+        To use this endpoint, you must be an administrator for the organization.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role
+        """
 
         from ..models import UserRoleAssignment
 
@@ -4027,7 +5149,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[SimpleUser], list[SimpleUserType]]:
-        """See also: https://docs.github.com/rest/orgs/outside-collaborators#list-outside-collaborators-for-an-organization"""
+        """orgs/list-outside-collaborators
+
+        GET /orgs/{org}/outside_collaborators
+
+        List all users who are outside collaborators of an organization.
+
+        See also: https://docs.github.com/rest/orgs/outside-collaborators#list-outside-collaborators-for-an-organization
+        """
 
         from ..models import SimpleUser
 
@@ -4058,7 +5187,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[SimpleUser], list[SimpleUserType]]:
-        """See also: https://docs.github.com/rest/orgs/outside-collaborators#list-outside-collaborators-for-an-organization"""
+        """orgs/list-outside-collaborators
+
+        GET /orgs/{org}/outside_collaborators
+
+        List all users who are outside collaborators of an organization.
+
+        See also: https://docs.github.com/rest/orgs/outside-collaborators#list-outside-collaborators-for-an-organization
+        """
 
         from ..models import SimpleUser
 
@@ -4119,7 +5255,14 @@ class OrgsClient:
         OrgsOrgOutsideCollaboratorsUsernamePutResponse202,
         OrgsOrgOutsideCollaboratorsUsernamePutResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/outside-collaborators#convert-an-organization-member-to-outside-collaborator"""
+        """orgs/convert-member-to-outside-collaborator
+
+        PUT /orgs/{org}/outside_collaborators/{username}
+
+        When an organization member is converted to an outside collaborator, they'll only have access to the repositories that their current team membership allows. The user will no longer be a member of the organization. For more information, see "[Converting an organization member to an outside collaborator](https://docs.github.com/articles/converting-an-organization-member-to-an-outside-collaborator/)". Converting an organization member to an outside collaborator may be restricted by enterprise administrators. For more information, see "[Enforcing repository management policies in your enterprise](https://docs.github.com/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-inviting-outside-collaborators-to-repositories)."
+
+        See also: https://docs.github.com/rest/orgs/outside-collaborators#convert-an-organization-member-to-outside-collaborator
+        """
 
         from ..models import (
             BasicError,
@@ -4192,7 +5335,14 @@ class OrgsClient:
         OrgsOrgOutsideCollaboratorsUsernamePutResponse202,
         OrgsOrgOutsideCollaboratorsUsernamePutResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/outside-collaborators#convert-an-organization-member-to-outside-collaborator"""
+        """orgs/convert-member-to-outside-collaborator
+
+        PUT /orgs/{org}/outside_collaborators/{username}
+
+        When an organization member is converted to an outside collaborator, they'll only have access to the repositories that their current team membership allows. The user will no longer be a member of the organization. For more information, see "[Converting an organization member to an outside collaborator](https://docs.github.com/articles/converting-an-organization-member-to-an-outside-collaborator/)". Converting an organization member to an outside collaborator may be restricted by enterprise administrators. For more information, see "[Enforcing repository management policies in your enterprise](https://docs.github.com/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-inviting-outside-collaborators-to-repositories)."
+
+        See also: https://docs.github.com/rest/orgs/outside-collaborators#convert-an-organization-member-to-outside-collaborator
+        """
 
         from ..models import (
             BasicError,
@@ -4233,7 +5383,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/outside-collaborators#remove-outside-collaborator-from-an-organization"""
+        """orgs/remove-outside-collaborator
+
+        DELETE /orgs/{org}/outside_collaborators/{username}
+
+        Removing a user from this list will remove them from all the organization's repositories.
+
+        See also: https://docs.github.com/rest/orgs/outside-collaborators#remove-outside-collaborator-from-an-organization
+        """
 
         from ..models import OrgsOrgOutsideCollaboratorsUsernameDeleteResponse422
 
@@ -4257,7 +5414,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/outside-collaborators#remove-outside-collaborator-from-an-organization"""
+        """orgs/remove-outside-collaborator
+
+        DELETE /orgs/{org}/outside_collaborators/{username}
+
+        Removing a user from this list will remove them from all the organization's repositories.
+
+        See also: https://docs.github.com/rest/orgs/outside-collaborators#remove-outside-collaborator-from-an-organization
+        """
 
         from ..models import OrgsOrgOutsideCollaboratorsUsernameDeleteResponse422
 
@@ -4293,7 +5457,16 @@ class OrgsClient:
         list[OrganizationProgrammaticAccessGrantRequest],
         list[OrganizationProgrammaticAccessGrantRequestType],
     ]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens"""
+        """orgs/list-pat-grant-requests
+
+        GET /orgs/{org}/personal-access-token-requests
+
+        Lists requests from organization members to access organization resources with a fine-grained personal access token.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens
+        """
 
         from ..models import (
             BasicError,
@@ -4351,7 +5524,16 @@ class OrgsClient:
         list[OrganizationProgrammaticAccessGrantRequest],
         list[OrganizationProgrammaticAccessGrantRequestType],
     ]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens"""
+        """orgs/list-pat-grant-requests
+
+        GET /orgs/{org}/personal-access-token-requests
+
+        Lists requests from organization members to access organization resources with a fine-grained personal access token.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens
+        """
 
         from ..models import (
             BasicError,
@@ -4428,7 +5610,16 @@ class OrgsClient:
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#review-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens"""
+        """orgs/review-pat-grant-requests-in-bulk
+
+        POST /orgs/{org}/personal-access-token-requests
+
+        Approves or denies multiple pending requests to access organization resources via a fine-grained personal access token.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#review-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens
+        """
 
         from ..models import (
             AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
@@ -4504,7 +5695,16 @@ class OrgsClient:
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#review-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens"""
+        """orgs/review-pat-grant-requests-in-bulk
+
+        POST /orgs/{org}/personal-access-token-requests
+
+        Approves or denies multiple pending requests to access organization resources via a fine-grained personal access token.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#review-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens
+        """
 
         from ..models import (
             AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
@@ -4575,7 +5775,16 @@ class OrgsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token"""
+        """orgs/review-pat-grant-request
+
+        POST /orgs/{org}/personal-access-token-requests/{pat_request_id}
+
+        Approves or denies a pending request to access organization resources via a fine-grained personal access token.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token
+        """
 
         from ..models import (
             BasicError,
@@ -4644,7 +5853,16 @@ class OrgsClient:
         ] = UNSET,
         **kwargs,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token"""
+        """orgs/review-pat-grant-request
+
+        POST /orgs/{org}/personal-access-token-requests/{pat_request_id}
+
+        Approves or denies a pending request to access organization resources via a fine-grained personal access token.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token
+        """
 
         from ..models import (
             BasicError,
@@ -4689,7 +5907,16 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[MinimalRepository], list[MinimalRepositoryType]]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token"""
+        """orgs/list-pat-grant-request-repositories
+
+        GET /orgs/{org}/personal-access-token-requests/{pat_request_id}/repositories
+
+        Lists the repositories a fine-grained personal access token request is requesting access to.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token
+        """
 
         from ..models import BasicError, MinimalRepository
 
@@ -4726,7 +5953,16 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[MinimalRepository], list[MinimalRepositoryType]]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token"""
+        """orgs/list-pat-grant-request-repositories
+
+        GET /orgs/{org}/personal-access-token-requests/{pat_request_id}/repositories
+
+        Lists the repositories a fine-grained personal access token request is requesting access to.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token
+        """
 
         from ..models import BasicError, MinimalRepository
 
@@ -4773,7 +6009,16 @@ class OrgsClient:
         list[OrganizationProgrammaticAccessGrant],
         list[OrganizationProgrammaticAccessGrantType],
     ]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-fine-grained-personal-access-tokens-with-access-to-organization-resources"""
+        """orgs/list-pat-grants
+
+        GET /orgs/{org}/personal-access-tokens
+
+        Lists approved fine-grained personal access tokens owned by organization members that can access organization resources.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-fine-grained-personal-access-tokens-with-access-to-organization-resources
+        """
 
         from ..models import (
             BasicError,
@@ -4831,7 +6076,16 @@ class OrgsClient:
         list[OrganizationProgrammaticAccessGrant],
         list[OrganizationProgrammaticAccessGrantType],
     ]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-fine-grained-personal-access-tokens-with-access-to-organization-resources"""
+        """orgs/list-pat-grants
+
+        GET /orgs/{org}/personal-access-tokens
+
+        Lists approved fine-grained personal access tokens owned by organization members that can access organization resources.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-fine-grained-personal-access-tokens-with-access-to-organization-resources
+        """
 
         from ..models import (
             BasicError,
@@ -4907,7 +6161,16 @@ class OrgsClient:
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens"""
+        """orgs/update-pat-accesses
+
+        POST /orgs/{org}/personal-access-tokens
+
+        Updates the access organization members have to organization resources via fine-grained personal access tokens. Limited to revoking a token's existing access.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens
+        """
 
         from ..models import (
             AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
@@ -4980,7 +6243,16 @@ class OrgsClient:
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
         AppHookDeliveriesDeliveryIdAttemptsPostResponse202Type,
     ]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens"""
+        """orgs/update-pat-accesses
+
+        POST /orgs/{org}/personal-access-tokens
+
+        Updates the access organization members have to organization resources via fine-grained personal access tokens. Limited to revoking a token's existing access.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens
+        """
 
         from ..models import (
             AppHookDeliveriesDeliveryIdAttemptsPostResponse202,
@@ -5046,7 +6318,16 @@ class OrgsClient:
         data: Missing[OrgsOrgPersonalAccessTokensPatIdPostBodyType] = UNSET,
         **kwargs,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources"""
+        """orgs/update-pat-access
+
+        POST /orgs/{org}/personal-access-tokens/{pat_id}
+
+        Updates the access an organization member has to organization resources via a fine-grained personal access token. Limited to revoking the token's existing access. Limited to revoking a token's existing access.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources
+        """
 
         from ..models import (
             BasicError,
@@ -5110,7 +6391,16 @@ class OrgsClient:
         data: Missing[OrgsOrgPersonalAccessTokensPatIdPostBodyType] = UNSET,
         **kwargs,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources"""
+        """orgs/update-pat-access
+
+        POST /orgs/{org}/personal-access-tokens/{pat_id}
+
+        Updates the access an organization member has to organization resources via a fine-grained personal access token. Limited to revoking the token's existing access. Limited to revoking a token's existing access.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources
+        """
 
         from ..models import (
             BasicError,
@@ -5153,7 +6443,16 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[MinimalRepository], list[MinimalRepositoryType]]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-repositories-a-fine-grained-personal-access-token-has-access-to"""
+        """orgs/list-pat-grant-repositories
+
+        GET /orgs/{org}/personal-access-tokens/{pat_id}/repositories
+
+        Lists the repositories a fine-grained personal access token has access to.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-repositories-a-fine-grained-personal-access-token-has-access-to
+        """
 
         from ..models import BasicError, MinimalRepository
 
@@ -5188,7 +6487,16 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[MinimalRepository], list[MinimalRepositoryType]]:
-        """See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-repositories-a-fine-grained-personal-access-token-has-access-to"""
+        """orgs/list-pat-grant-repositories
+
+        GET /orgs/{org}/personal-access-tokens/{pat_id}/repositories
+
+        Lists the repositories a fine-grained personal access token has access to.
+
+        Only GitHub Apps can use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/personal-access-tokens#list-repositories-a-fine-grained-personal-access-token-has-access-to
+        """
 
         from ..models import BasicError, MinimalRepository
 
@@ -5220,7 +6528,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[CustomProperty], list[CustomPropertyType]]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#get-all-custom-properties-for-an-organization"""
+        """orgs/get-all-custom-properties
+
+        GET /orgs/{org}/properties/schema
+
+        Gets all custom properties defined for an organization.
+        Organization members can read these properties.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#get-all-custom-properties-for-an-organization
+        """
 
         from ..models import BasicError, CustomProperty
 
@@ -5245,7 +6561,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[CustomProperty], list[CustomPropertyType]]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#get-all-custom-properties-for-an-organization"""
+        """orgs/get-all-custom-properties
+
+        GET /orgs/{org}/properties/schema
+
+        Gets all custom properties defined for an organization.
+        Organization members can read these properties.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#get-all-custom-properties-for-an-organization
+        """
 
         from ..models import BasicError, CustomProperty
 
@@ -5291,7 +6615,22 @@ class OrgsClient:
         data: Missing[OrgsOrgPropertiesSchemaPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[list[CustomProperty], list[CustomPropertyType]]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-custom-properties-for-an-organization"""
+        """orgs/create-or-update-custom-properties
+
+        PATCH /orgs/{org}/properties/schema
+
+        Creates new or updates existing custom properties defined for an organization in a batch.
+
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
+        To use this endpoint, the authenticated user must be one of:
+          - An administrator for the organization.
+          - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-custom-properties-for-an-organization
+        """
 
         from ..models import (
             BasicError,
@@ -5351,7 +6690,22 @@ class OrgsClient:
         data: Missing[OrgsOrgPropertiesSchemaPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[list[CustomProperty], list[CustomPropertyType]]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-custom-properties-for-an-organization"""
+        """orgs/create-or-update-custom-properties
+
+        PATCH /orgs/{org}/properties/schema
+
+        Creates new or updates existing custom properties defined for an organization in a batch.
+
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
+        To use this endpoint, the authenticated user must be one of:
+          - An administrator for the organization.
+          - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-custom-properties-for-an-organization
+        """
 
         from ..models import (
             BasicError,
@@ -5391,7 +6745,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[CustomProperty, CustomPropertyType]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#get-a-custom-property-for-an-organization"""
+        """orgs/get-custom-property
+
+        GET /orgs/{org}/properties/schema/{custom_property_name}
+
+        Gets a custom property that is defined for an organization.
+        Organization members can read these properties.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#get-a-custom-property-for-an-organization
+        """
 
         from ..models import BasicError, CustomProperty
 
@@ -5417,7 +6779,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[CustomProperty, CustomPropertyType]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#get-a-custom-property-for-an-organization"""
+        """orgs/get-custom-property
+
+        GET /orgs/{org}/properties/schema/{custom_property_name}
+
+        Gets a custom property that is defined for an organization.
+        Organization members can read these properties.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#get-a-custom-property-for-an-organization
+        """
 
         from ..models import BasicError, CustomProperty
 
@@ -5473,7 +6843,18 @@ class OrgsClient:
         data: Missing[CustomPropertySetPayloadType] = UNSET,
         **kwargs,
     ) -> Response[CustomProperty, CustomPropertyType]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-a-custom-property-for-an-organization"""
+        """orgs/create-or-update-custom-property
+
+        PUT /orgs/{org}/properties/schema/{custom_property_name}
+
+        Creates a new or updates an existing custom property that is defined for an organization.
+
+        To use this endpoint, the authenticated user must be one of:
+        - An administrator for the organization.
+        - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-a-custom-property-for-an-organization
+        """
 
         from ..models import BasicError, CustomProperty, CustomPropertySetPayload
 
@@ -5539,7 +6920,18 @@ class OrgsClient:
         data: Missing[CustomPropertySetPayloadType] = UNSET,
         **kwargs,
     ) -> Response[CustomProperty, CustomPropertyType]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-a-custom-property-for-an-organization"""
+        """orgs/create-or-update-custom-property
+
+        PUT /orgs/{org}/properties/schema/{custom_property_name}
+
+        Creates a new or updates an existing custom property that is defined for an organization.
+
+        To use this endpoint, the authenticated user must be one of:
+        - An administrator for the organization.
+        - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-a-custom-property-for-an-organization
+        """
 
         from ..models import BasicError, CustomProperty, CustomPropertySetPayload
 
@@ -5575,7 +6967,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#remove-a-custom-property-for-an-organization"""
+        """orgs/remove-custom-property
+
+        DELETE /orgs/{org}/properties/schema/{custom_property_name}
+
+        Removes a custom property that is defined for an organization.
+
+        To use this endpoint, the authenticated user must be one of:
+          - An administrator for the organization.
+          - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#remove-a-custom-property-for-an-organization
+        """
 
         from ..models import BasicError
 
@@ -5600,7 +7003,18 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#remove-a-custom-property-for-an-organization"""
+        """orgs/remove-custom-property
+
+        DELETE /orgs/{org}/properties/schema/{custom_property_name}
+
+        Removes a custom property that is defined for an organization.
+
+        To use this endpoint, the authenticated user must be one of:
+          - An administrator for the organization.
+          - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#remove-a-custom-property-for-an-organization
+        """
 
         from ..models import BasicError
 
@@ -5629,7 +7043,15 @@ class OrgsClient:
     ) -> Response[
         list[OrgRepoCustomPropertyValues], list[OrgRepoCustomPropertyValuesType]
     ]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#list-custom-property-values-for-organization-repositories"""
+        """orgs/list-custom-properties-values-for-repos
+
+        GET /orgs/{org}/properties/values
+
+        Lists organization repositories with all of their custom property values.
+        Organization members can read these properties.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#list-custom-property-values-for-organization-repositories
+        """
 
         from ..models import BasicError, OrgRepoCustomPropertyValues
 
@@ -5666,7 +7088,15 @@ class OrgsClient:
     ) -> Response[
         list[OrgRepoCustomPropertyValues], list[OrgRepoCustomPropertyValuesType]
     ]:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#list-custom-property-values-for-organization-repositories"""
+        """orgs/list-custom-properties-values-for-repos
+
+        GET /orgs/{org}/properties/values
+
+        Lists organization repositories with all of their custom property values.
+        Organization members can read these properties.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#list-custom-property-values-for-organization-repositories
+        """
 
         from ..models import BasicError, OrgRepoCustomPropertyValues
 
@@ -5720,7 +7150,23 @@ class OrgsClient:
         data: Missing[OrgsOrgPropertiesValuesPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-custom-property-values-for-organization-repositories"""
+        """orgs/create-or-update-custom-properties-values-for-repos
+
+        PATCH /orgs/{org}/properties/values
+
+        Create new or update existing custom property values for repositories in a batch that belong to an organization.
+        Each target repository will have its custom property values updated to match the values provided in the request.
+
+        A maximum of 30 repositories can be updated in a single request.
+
+        Using a value of `null` for a custom property will remove or 'unset' the property value from the repository.
+
+        To use this endpoint, the authenticated user must be one of:
+          - An administrator for the organization.
+          - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_values_editor` in the organization.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-custom-property-values-for-organization-repositories
+        """
 
         from ..models import (
             BasicError,
@@ -5781,7 +7227,23 @@ class OrgsClient:
         data: Missing[OrgsOrgPropertiesValuesPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-custom-property-values-for-organization-repositories"""
+        """orgs/create-or-update-custom-properties-values-for-repos
+
+        PATCH /orgs/{org}/properties/values
+
+        Create new or update existing custom property values for repositories in a batch that belong to an organization.
+        Each target repository will have its custom property values updated to match the values provided in the request.
+
+        A maximum of 30 repositories can be updated in a single request.
+
+        Using a value of `null` for a custom property will remove or 'unset' the property value from the repository.
+
+        To use this endpoint, the authenticated user must be one of:
+          - An administrator for the organization.
+          - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_values_editor` in the organization.
+
+        See also: https://docs.github.com/rest/orgs/custom-properties#create-or-update-custom-property-values-for-organization-repositories
+        """
 
         from ..models import (
             BasicError,
@@ -5822,7 +7284,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[SimpleUser], list[SimpleUserType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-public-organization-members"""
+        """orgs/list-public-members
+
+        GET /orgs/{org}/public_members
+
+        Members of an organization can choose to have their membership publicized or not.
+
+        See also: https://docs.github.com/rest/orgs/members#list-public-organization-members
+        """
 
         from ..models import SimpleUser
 
@@ -5851,7 +7320,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[SimpleUser], list[SimpleUserType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-public-organization-members"""
+        """orgs/list-public-members
+
+        GET /orgs/{org}/public_members
+
+        Members of an organization can choose to have their membership publicized or not.
+
+        See also: https://docs.github.com/rest/orgs/members#list-public-organization-members
+        """
 
         from ..models import SimpleUser
 
@@ -5879,7 +7355,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#check-public-organization-membership-for-a-user"""
+        """orgs/check-public-membership-for-user
+
+        GET /orgs/{org}/public_members/{username}
+
+        Check if the provided user is a public member of the organization.
+
+        See also: https://docs.github.com/rest/orgs/members#check-public-organization-membership-for-a-user
+        """
 
         url = f"/orgs/{org}/public_members/{username}"
 
@@ -5899,7 +7382,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#check-public-organization-membership-for-a-user"""
+        """orgs/check-public-membership-for-user
+
+        GET /orgs/{org}/public_members/{username}
+
+        Check if the provided user is a public member of the organization.
+
+        See also: https://docs.github.com/rest/orgs/members#check-public-organization-membership-for-a-user
+        """
 
         url = f"/orgs/{org}/public_members/{username}"
 
@@ -5919,7 +7409,16 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#set-public-organization-membership-for-the-authenticated-user"""
+        """orgs/set-public-membership-for-authenticated-user
+
+        PUT /orgs/{org}/public_members/{username}
+
+        The user can publicize their own membership. (A user cannot publicize the membership for another user.)
+
+        Note that you'll need to set `Content-Length` to zero when calling out to this endpoint. For more information, see "[HTTP method](https://docs.github.com/rest/guides/getting-started-with-the-rest-api#http-method)."
+
+        See also: https://docs.github.com/rest/orgs/members#set-public-organization-membership-for-the-authenticated-user
+        """
 
         from ..models import BasicError
 
@@ -5943,7 +7442,16 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#set-public-organization-membership-for-the-authenticated-user"""
+        """orgs/set-public-membership-for-authenticated-user
+
+        PUT /orgs/{org}/public_members/{username}
+
+        The user can publicize their own membership. (A user cannot publicize the membership for another user.)
+
+        Note that you'll need to set `Content-Length` to zero when calling out to this endpoint. For more information, see "[HTTP method](https://docs.github.com/rest/guides/getting-started-with-the-rest-api#http-method)."
+
+        See also: https://docs.github.com/rest/orgs/members#set-public-organization-membership-for-the-authenticated-user
+        """
 
         from ..models import BasicError
 
@@ -5967,7 +7475,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#remove-public-organization-membership-for-the-authenticated-user"""
+        """orgs/remove-public-membership-for-authenticated-user
+
+        DELETE /orgs/{org}/public_members/{username}
+
+        Removes the public membership for the authenticated user from the specified organization, unless public visibility is enforced by default.
+
+        See also: https://docs.github.com/rest/orgs/members#remove-public-organization-membership-for-the-authenticated-user
+        """
 
         url = f"/orgs/{org}/public_members/{username}"
 
@@ -5986,7 +7501,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/members#remove-public-organization-membership-for-the-authenticated-user"""
+        """orgs/remove-public-membership-for-authenticated-user
+
+        DELETE /orgs/{org}/public_members/{username}
+
+        Removes the public membership for the authenticated user from the specified organization, unless public visibility is enforced by default.
+
+        See also: https://docs.github.com/rest/orgs/members#remove-public-organization-membership-for-the-authenticated-user
+        """
 
         url = f"/orgs/{org}/public_members/{username}"
 
@@ -6007,7 +7529,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[RulesetVersion], list[RulesetVersionType]]:
-        """See also: https://docs.github.com/rest/orgs/rules#get-organization-ruleset-history"""
+        """orgs/get-org-ruleset-history
+
+        GET /orgs/{org}/rulesets/{ruleset_id}/history
+
+        Get the history of an organization ruleset.
+
+        See also: https://docs.github.com/rest/orgs/rules#get-organization-ruleset-history
+        """
 
         from ..models import BasicError, RulesetVersion
 
@@ -6041,7 +7570,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[RulesetVersion], list[RulesetVersionType]]:
-        """See also: https://docs.github.com/rest/orgs/rules#get-organization-ruleset-history"""
+        """orgs/get-org-ruleset-history
+
+        GET /orgs/{org}/rulesets/{ruleset_id}/history
+
+        Get the history of an organization ruleset.
+
+        See also: https://docs.github.com/rest/orgs/rules#get-organization-ruleset-history
+        """
 
         from ..models import BasicError, RulesetVersion
 
@@ -6074,7 +7610,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[RulesetVersionWithState, RulesetVersionWithStateType]:
-        """See also: https://docs.github.com/rest/orgs/rules#get-organization-ruleset-version"""
+        """orgs/get-org-ruleset-version
+
+        GET /orgs/{org}/rulesets/{ruleset_id}/history/{version_id}
+
+        Get a version of an organization ruleset.
+
+        See also: https://docs.github.com/rest/orgs/rules#get-organization-ruleset-version
+        """
 
         from ..models import BasicError, RulesetVersionWithState
 
@@ -6101,7 +7644,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[RulesetVersionWithState, RulesetVersionWithStateType]:
-        """See also: https://docs.github.com/rest/orgs/rules#get-organization-ruleset-version"""
+        """orgs/get-org-ruleset-version
+
+        GET /orgs/{org}/rulesets/{ruleset_id}/history/{version_id}
+
+        Get a version of an organization ruleset.
+
+        See also: https://docs.github.com/rest/orgs/rules#get-organization-ruleset-version
+        """
 
         from ..models import BasicError, RulesetVersionWithState
 
@@ -6126,7 +7676,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[TeamSimple], list[TeamSimpleType]]:
-        """See also: https://docs.github.com/rest/orgs/security-managers#list-security-manager-teams"""
+        """DEPRECATED orgs/list-security-manager-teams
+
+        GET /orgs/{org}/security-managers
+
+        > [!WARNING]
+        > **Closing down notice:** This operation is closing down and will be removed starting January 1, 2026. Please use the "[Organization Roles](https://docs.github.com/rest/orgs/organization-roles)" endpoints instead.
+
+        See also: https://docs.github.com/rest/orgs/security-managers#list-security-manager-teams
+        """
 
         from ..models import TeamSimple
 
@@ -6147,7 +7705,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[TeamSimple], list[TeamSimpleType]]:
-        """See also: https://docs.github.com/rest/orgs/security-managers#list-security-manager-teams"""
+        """DEPRECATED orgs/list-security-manager-teams
+
+        GET /orgs/{org}/security-managers
+
+        > [!WARNING]
+        > **Closing down notice:** This operation is closing down and will be removed starting January 1, 2026. Please use the "[Organization Roles](https://docs.github.com/rest/orgs/organization-roles)" endpoints instead.
+
+        See also: https://docs.github.com/rest/orgs/security-managers#list-security-manager-teams
+        """
 
         from ..models import TeamSimple
 
@@ -6169,7 +7735,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/security-managers#add-a-security-manager-team"""
+        """DEPRECATED orgs/add-security-manager-team
+
+        PUT /orgs/{org}/security-managers/teams/{team_slug}
+
+        > [!WARNING]
+        > **Closing down notice:** This operation is closing down and will be removed starting January 1, 2026. Please use the "[Organization Roles](https://docs.github.com/rest/orgs/organization-roles)" endpoints instead.
+
+        See also: https://docs.github.com/rest/orgs/security-managers#add-a-security-manager-team
+        """
 
         url = f"/orgs/{org}/security-managers/teams/{team_slug}"
 
@@ -6188,7 +7762,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/security-managers#add-a-security-manager-team"""
+        """DEPRECATED orgs/add-security-manager-team
+
+        PUT /orgs/{org}/security-managers/teams/{team_slug}
+
+        > [!WARNING]
+        > **Closing down notice:** This operation is closing down and will be removed starting January 1, 2026. Please use the "[Organization Roles](https://docs.github.com/rest/orgs/organization-roles)" endpoints instead.
+
+        See also: https://docs.github.com/rest/orgs/security-managers#add-a-security-manager-team
+        """
 
         url = f"/orgs/{org}/security-managers/teams/{team_slug}"
 
@@ -6207,7 +7789,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/security-managers#remove-a-security-manager-team"""
+        """DEPRECATED orgs/remove-security-manager-team
+
+        DELETE /orgs/{org}/security-managers/teams/{team_slug}
+
+        > [!WARNING]
+        > **Closing down notice:** This operation is closing down and will be removed starting January 1, 2026. Please use the "[Organization Roles](https://docs.github.com/rest/orgs/organization-roles)" endpoints instead.
+
+        See also: https://docs.github.com/rest/orgs/security-managers#remove-a-security-manager-team
+        """
 
         url = f"/orgs/{org}/security-managers/teams/{team_slug}"
 
@@ -6226,7 +7816,15 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/security-managers#remove-a-security-manager-team"""
+        """DEPRECATED orgs/remove-security-manager-team
+
+        DELETE /orgs/{org}/security-managers/teams/{team_slug}
+
+        > [!WARNING]
+        > **Closing down notice:** This operation is closing down and will be removed starting January 1, 2026. Please use the "[Organization Roles](https://docs.github.com/rest/orgs/organization-roles)" endpoints instead.
+
+        See also: https://docs.github.com/rest/orgs/security-managers#remove-a-security-manager-team
+        """
 
         url = f"/orgs/{org}/security-managers/teams/{team_slug}"
 
@@ -6295,7 +7893,21 @@ class OrgsClient:
         data: Missing[OrgsOrgSecurityProductEnablementPostBodyType] = UNSET,
         **kwargs,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/orgs#enable-or-disable-a-security-feature-for-an-organization"""
+        """DEPRECATED orgs/enable-or-disable-security-product-on-all-org-repos
+
+        POST /orgs/{org}/{security_product}/{enablement}
+
+        > [!WARNING]
+        > **Closing down notice:** The ability to enable or disable a security feature for all eligible repositories in an organization is closing down. Please use [code security configurations](https://docs.github.com/rest/code-security/configurations) instead. For more information, see the [changelog](https://github.blog/changelog/2024-07-22-deprecation-of-api-endpoint-to-enable-or-disable-a-security-feature-for-an-organization/).
+
+        Enables or disables the specified security feature for all eligible repositories in an organization. For more information, see "[Managing security managers in your organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization)."
+
+        The authenticated user must be an organization owner or be member of a team with the security manager role to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org`, `write:org`, or `repo` scopes to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/orgs#enable-or-disable-a-security-feature-for-an-organization
+        """
 
         from ..models import OrgsOrgSecurityProductEnablementPostBody
 
@@ -6377,7 +7989,21 @@ class OrgsClient:
         data: Missing[OrgsOrgSecurityProductEnablementPostBodyType] = UNSET,
         **kwargs,
     ) -> Response:
-        """See also: https://docs.github.com/rest/orgs/orgs#enable-or-disable-a-security-feature-for-an-organization"""
+        """DEPRECATED orgs/enable-or-disable-security-product-on-all-org-repos
+
+        POST /orgs/{org}/{security_product}/{enablement}
+
+        > [!WARNING]
+        > **Closing down notice:** The ability to enable or disable a security feature for all eligible repositories in an organization is closing down. Please use [code security configurations](https://docs.github.com/rest/code-security/configurations) instead. For more information, see the [changelog](https://github.blog/changelog/2024-07-22-deprecation-of-api-endpoint-to-enable-or-disable-a-security-feature-for-an-organization/).
+
+        Enables or disables the specified security feature for all eligible repositories in an organization. For more information, see "[Managing security managers in your organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization)."
+
+        The authenticated user must be an organization owner or be member of a team with the security manager role to use this endpoint.
+
+        OAuth app tokens and personal access tokens (classic) need the `admin:org`, `write:org`, or `repo` scopes to use this endpoint.
+
+        See also: https://docs.github.com/rest/orgs/orgs#enable-or-disable-a-security-feature-for-an-organization
+        """
 
         from ..models import OrgsOrgSecurityProductEnablementPostBody
 
@@ -6410,7 +8036,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrgMembership], list[OrgMembershipType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-organization-memberships-for-the-authenticated-user"""
+        """orgs/list-memberships-for-authenticated-user
+
+        GET /user/memberships/orgs
+
+        Lists all of the authenticated user's organization memberships.
+
+        See also: https://docs.github.com/rest/orgs/members#list-organization-memberships-for-the-authenticated-user
+        """
 
         from ..models import BasicError, OrgMembership, ValidationError
 
@@ -6445,7 +8078,14 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrgMembership], list[OrgMembershipType]]:
-        """See also: https://docs.github.com/rest/orgs/members#list-organization-memberships-for-the-authenticated-user"""
+        """orgs/list-memberships-for-authenticated-user
+
+        GET /user/memberships/orgs
+
+        Lists all of the authenticated user's organization memberships.
+
+        See also: https://docs.github.com/rest/orgs/members#list-organization-memberships-for-the-authenticated-user
+        """
 
         from ..models import BasicError, OrgMembership, ValidationError
 
@@ -6478,7 +8118,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrgMembership, OrgMembershipType]:
-        """See also: https://docs.github.com/rest/orgs/members#get-an-organization-membership-for-the-authenticated-user"""
+        """orgs/get-membership-for-authenticated-user
+
+        GET /user/memberships/orgs/{org}
+
+        If the authenticated user is an active or pending member of the organization, this endpoint will return the user's membership. If the authenticated user is not affiliated with the organization, a `404` is returned. This endpoint will return a `403` if the request is made by a GitHub App that is blocked by the organization.
+
+        See also: https://docs.github.com/rest/orgs/members#get-an-organization-membership-for-the-authenticated-user
+        """
 
         from ..models import BasicError, OrgMembership
 
@@ -6503,7 +8150,14 @@ class OrgsClient:
         *,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[OrgMembership, OrgMembershipType]:
-        """See also: https://docs.github.com/rest/orgs/members#get-an-organization-membership-for-the-authenticated-user"""
+        """orgs/get-membership-for-authenticated-user
+
+        GET /user/memberships/orgs/{org}
+
+        If the authenticated user is an active or pending member of the organization, this endpoint will return the user's membership. If the authenticated user is not affiliated with the organization, a `404` is returned. This endpoint will return a `403` if the request is made by a GitHub App that is blocked by the organization.
+
+        See also: https://docs.github.com/rest/orgs/members#get-an-organization-membership-for-the-authenticated-user
+        """
 
         from ..models import BasicError, OrgMembership
 
@@ -6549,7 +8203,14 @@ class OrgsClient:
         data: Missing[UserMembershipsOrgsOrgPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrgMembership, OrgMembershipType]:
-        """See also: https://docs.github.com/rest/orgs/members#update-an-organization-membership-for-the-authenticated-user"""
+        """orgs/update-membership-for-authenticated-user
+
+        PATCH /user/memberships/orgs/{org}
+
+        Converts the authenticated user to an active member of the organization, if that user has a pending invitation from the organization.
+
+        See also: https://docs.github.com/rest/orgs/members#update-an-organization-membership-for-the-authenticated-user
+        """
 
         from ..models import (
             BasicError,
@@ -6611,7 +8272,14 @@ class OrgsClient:
         data: Missing[UserMembershipsOrgsOrgPatchBodyType] = UNSET,
         **kwargs,
     ) -> Response[OrgMembership, OrgMembershipType]:
-        """See also: https://docs.github.com/rest/orgs/members#update-an-organization-membership-for-the-authenticated-user"""
+        """orgs/update-membership-for-authenticated-user
+
+        PATCH /user/memberships/orgs/{org}
+
+        Converts the authenticated user to an active member of the organization, if that user has a pending invitation from the organization.
+
+        See also: https://docs.github.com/rest/orgs/members#update-an-organization-membership-for-the-authenticated-user
+        """
 
         from ..models import (
             BasicError,
@@ -6653,7 +8321,19 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationSimple], list[OrganizationSimpleType]]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-organizations-for-the-authenticated-user"""
+        """orgs/list-for-authenticated-user
+
+        GET /user/orgs
+
+        List organizations for the authenticated user.
+
+        For OAuth app tokens and personal access tokens (classic), this endpoint only lists organizations that your authorization allows you to operate on in some way (e.g., you can list teams with `read:org` scope, you can publicize your organization membership with `user` scope, etc.). Therefore, this API requires at least `user` or `read:org` scope for OAuth app tokens and personal access tokens (classic). Requests with insufficient scope will receive a `403 Forbidden` response.
+
+        > [!NOTE]
+        > Requests using a fine-grained access token will receive a `200 Success` response with an empty list.
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-organizations-for-the-authenticated-user
+        """
 
         from ..models import BasicError, OrganizationSimple
 
@@ -6685,7 +8365,19 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationSimple], list[OrganizationSimpleType]]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-organizations-for-the-authenticated-user"""
+        """orgs/list-for-authenticated-user
+
+        GET /user/orgs
+
+        List organizations for the authenticated user.
+
+        For OAuth app tokens and personal access tokens (classic), this endpoint only lists organizations that your authorization allows you to operate on in some way (e.g., you can list teams with `read:org` scope, you can publicize your organization membership with `user` scope, etc.). Therefore, this API requires at least `user` or `read:org` scope for OAuth app tokens and personal access tokens (classic). Requests with insufficient scope will receive a `403 Forbidden` response.
+
+        > [!NOTE]
+        > Requests using a fine-grained access token will receive a `200 Success` response with an empty list.
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-organizations-for-the-authenticated-user
+        """
 
         from ..models import BasicError, OrganizationSimple
 
@@ -6718,7 +8410,16 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationSimple], list[OrganizationSimpleType]]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-organizations-for-a-user"""
+        """orgs/list-for-user
+
+        GET /users/{username}/orgs
+
+        List [public organization memberships](https://docs.github.com/articles/publicizing-or-concealing-organization-membership) for the specified user.
+
+        This method only lists _public_ memberships, regardless of authentication. If you need to fetch all of the organization memberships (public and private) for the authenticated user, use the [List organizations for the authenticated user](https://docs.github.com/rest/orgs/orgs#list-organizations-for-the-authenticated-user) API instead.
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-organizations-for-a-user
+        """
 
         from ..models import OrganizationSimple
 
@@ -6747,7 +8448,16 @@ class OrgsClient:
         page: Missing[int] = UNSET,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Response[list[OrganizationSimple], list[OrganizationSimpleType]]:
-        """See also: https://docs.github.com/rest/orgs/orgs#list-organizations-for-a-user"""
+        """orgs/list-for-user
+
+        GET /users/{username}/orgs
+
+        List [public organization memberships](https://docs.github.com/articles/publicizing-or-concealing-organization-membership) for the specified user.
+
+        This method only lists _public_ memberships, regardless of authentication. If you need to fetch all of the organization memberships (public and private) for the authenticated user, use the [List organizations for the authenticated user](https://docs.github.com/rest/orgs/orgs#list-organizations-for-the-authenticated-user) API instead.
+
+        See also: https://docs.github.com/rest/orgs/orgs#list-organizations-for-a-user
+        """
 
         from ..models import OrganizationSimple