Skip to main content

pat_grants

Overview

Namepat_grants
TypeResource
Idgithub.orgs.pat_grants

Fields

NameDatatypeDescription
idintegerUnique identifier of the fine-grained personal access token. The pat_id used to get details about an approved fine-grained personal access token.
access_granted_atstringDate and time when the fine-grained personal access token was approved to access the organization.
ownerobjectA GitHub user.
permissionsobjectPermissions requested, categorized by type of permission.
repositories_urlstringURL to the list of repositories the fine-grained personal access token can access. Only follow when repository_selection is subset.
repository_selectionstringType of repository selection requested.
token_expiredbooleanWhether the associated fine-grained personal access token has expired.
token_expires_atstringDate and time when the associated fine-grained personal access token expires.
token_last_used_atstringDate and time when the associated fine-grained personal access token was last used for authentication.

Methods

NameAccessible byRequired ParamsDescription
list_pat_grantsSELECTorgLists approved fine-grained personal access tokens owned by organization members that can access organization resources. Only GitHub Apps can call this API,
using the organization_personal_access_tokens: read permission.

Note: Fine-grained PATs are in public beta. Related APIs, events, and functionality are subject to change.
update_pat_accessEXECorg, pat_id, data__actionUpdates 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 call this API,
using the organization_personal_access_tokens: write permission.

Note: Fine-grained PATs are in public beta. Related APIs, events, and functionality are subject to change.
update_pat_accessesEXECorg, data__action, data__pat_idsUpdates 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 call this API,
using the organization_personal_access_tokens: write permission.

Note: Fine-grained PATs are in public beta. Related APIs, events, and functionality are subject to change.