Skip to content

GitHub: Orgs schemas

35 GitHub schemas with complete fields and constraints.

← Orgs operations · All schemas

Create an organization invitation — response body

FieldTypePresenceDescription and constraints
$objectRootOrganization Invitation
created_atstringRequired within parent
emailJSONRequired within parent
email (anyOf 1)stringAlternative
email (anyOf 2)nullAlternative
failed_atJSONOptional
failed_at (anyOf 1)stringAlternative
failed_at (anyOf 2)nullAlternative
failed_reasonJSONOptional
failed_reason (anyOf 1)stringAlternative
failed_reason (anyOf 2)nullAlternative
idJSONRequired within parent
id (anyOf 1)integerAlternativeFormat: int64
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
invitation_sourcestringOptional
invitation_teams_urlstringRequired within parent
inviterModelRequired within parentExpand List users — response body — item
loginJSONRequired within parent
login (anyOf 1)stringAlternative
login (anyOf 2)nullAlternative
node_idstringRequired within parent
rolestringRequired within parent
team_countJSONRequired within parent
team_count (anyOf 1)integerAlternative
team_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: List users — response body — item

Create issue field for an organization — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
data_typestringRequired within parentThe data type of the issue field.
One of: text, date, single_select, multi_select, number
descriptionJSONOptional
description (anyOf 1)stringAlternativeDescription of the issue field.
description (anyOf 2)nullAlternative
namestringRequired within parentName of the issue field.
optionsJSONOptional
options (anyOf 1)arrayAlternativeOptions for select fields. Required when data_type is 'single_select' or 'multi_select'.
options (anyOf 1)[]objectEach item
options (anyOf 1)[].colorstringRequired within parentColor for the option.
One of: gray, blue, green, yellow, orange, red, pink, purple
options (anyOf 1)[].descriptionJSONOptional
options (anyOf 1)[].description (anyOf 1)stringAlternativeDescription of the option.
options (anyOf 1)[].description (anyOf 2)nullAlternative
options (anyOf 1)[].namestringRequired within parentName of the option.
options (anyOf 1)[].priorityintegerRequired within parentPriority of the option for ordering.
options (anyOf 2)nullAlternative
visibilitystringOptionalThe visibility of the issue field. Can be `organization_members_only` (visible only within the organization) or `all` (visible to all users who can see issues). Only used when the visibility settings feature is enabled. Defaults to `organization_members_only`.
One of: organization_members_only, all

Create issue field for an organization — response body

FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)objectAlternativeA custom attribute defined at the organization level for attaching structured data to issues.
$ (anyOf 1).created_atstringOptionalThe time the issue field was created.
Format: date-time
$ (anyOf 1).data_typestringRequired within parentThe data type of the issue field.
Known values: text, date, single_select, multi_select, number
$ (anyOf 1).descriptionJSONOptional
$ (anyOf 1).description (anyOf 1)stringAlternativeThe description of the issue field.
$ (anyOf 1).description (anyOf 2)nullAlternative
$ (anyOf 1).idJSONRequired within parent
$ (anyOf 1).id (anyOf 1)integerAlternativeThe unique identifier of the issue field.
$ (anyOf 1).id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).namestringRequired within parentThe name of the issue field.
$ (anyOf 1).node_idstringRequired within parentThe node identifier of the issue field.
$ (anyOf 1).optionsJSONOptional
$ (anyOf 1).options (anyOf 1)arrayAlternativeAvailable options for single select and multi select fields.
$ (anyOf 1).options (anyOf 1)[]objectEach item
$ (anyOf 1).options (anyOf 1)[].colorJSONOptional
$ (anyOf 1).options (anyOf 1)[].color (anyOf 1)stringAlternativeThe color of the option.
Known values: gray, blue, green, yellow, orange, red, pink, purple
$ (anyOf 1).options (anyOf 1)[].color (anyOf 2)nullAlternative
$ (anyOf 1).options (anyOf 1)[].created_atstringOptionalThe time the option was created.
Format: date-time
$ (anyOf 1).options (anyOf 1)[].descriptionJSONOptional
$ (anyOf 1).options (anyOf 1)[].description (anyOf 1)stringAlternativeThe description of the option.
$ (anyOf 1).options (anyOf 1)[].description (anyOf 2)nullAlternative
$ (anyOf 1).options (anyOf 1)[].idJSONRequired within parent
$ (anyOf 1).options (anyOf 1)[].id (anyOf 1)integerAlternativeThe unique identifier of the option.
$ (anyOf 1).options (anyOf 1)[].id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).options (anyOf 1)[].namestringRequired within parentThe name of the option.
$ (anyOf 1).options (anyOf 1)[].priorityJSONOptional
$ (anyOf 1).options (anyOf 1)[].priority (anyOf 1)JSONAlternative
$ (anyOf 1).options (anyOf 1)[].priority (anyOf 1) (anyOf 1)integerAlternativeThe priority of the option for ordering.
$ (anyOf 1).options (anyOf 1)[].priority (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).options (anyOf 1)[].priority (anyOf 2)nullAlternative
$ (anyOf 1).options (anyOf 1)[].updated_atstringOptionalThe time the option was last updated.
Format: date-time
$ (anyOf 1).options (anyOf 2)nullAlternative
$ (anyOf 1).updated_atstringOptionalThe time the issue field was last updated.
Format: date-time
$ (anyOf 1).visibilitystringOptionalThe visibility of the issue field. Can be `organization_members_only` (visible only within the organization) or `all` (visible to all users who can see issues).
Known values: organization_members_only, all
$ (anyOf 2)nullAlternative

Create issue type for an organization — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
colorJSONOptional
color (anyOf 1)stringAlternativeColor for the issue type.
One of: gray, blue, green, yellow, orange, red, pink, purple
color (anyOf 2)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternativeDescription of the issue type.
description (anyOf 2)nullAlternative
is_enabledbooleanRequired within parentWhether or not the issue type is enabled at the organization level.
namestringRequired within parentName of the issue type.

Create issue type for an organization — response body

FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)objectAlternativeThe type assigned to the issue. This is only present for issues in repositories where issue types are supported.
$ (anyOf 1).colorJSONOptional
$ (anyOf 1).color (anyOf 1)stringAlternativeThe color of the issue type.
Known values: gray, blue, green, yellow, orange, red, pink, purple
$ (anyOf 1).color (anyOf 2)nullAlternative
$ (anyOf 1).created_atstringOptionalThe time the issue type created.
Format: date-time
$ (anyOf 1).descriptionJSONRequired within parent
$ (anyOf 1).description (anyOf 1)stringAlternativeThe description of the issue type.
$ (anyOf 1).description (anyOf 2)nullAlternative
$ (anyOf 1).idJSONRequired within parent
$ (anyOf 1).id (anyOf 1)integerAlternativeThe unique identifier of the issue type.
$ (anyOf 1).id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).is_enabledbooleanOptionalThe enabled state of the issue type.
$ (anyOf 1).namestringRequired within parentThe name of the issue type.
$ (anyOf 1).node_idstringRequired within parentThe node identifier of the issue type.
$ (anyOf 1).updated_atstringOptionalThe time the issue type last updated.
Format: date-time
$ (anyOf 2)nullAlternative

Create or update a custom property for an organization — request body — body

FieldTypePresenceDescription and constraints
$objectRootCustom property set payload
allowed_valuesJSONOptional
allowed_values (anyOf 1)arrayAlternativeAn ordered list of the allowed values of the property.
The property can have up to 200 allowed values.
allowed_values (anyOf 1)[]stringEach item
allowed_values (anyOf 2)nullAlternative
default_valueJSONOptional
default_value (anyOf 1)JSONAlternativeDefault value of the property
default_value (anyOf 1) (oneOf 1)JSONAlternative
default_value (anyOf 1) (oneOf 1) (anyOf 1)stringAlternative
default_value (anyOf 1) (oneOf 1) (anyOf 2)nullAlternative
default_value (anyOf 1) (oneOf 2)arrayAlternative
default_value (anyOf 1) (oneOf 2)[]stringEach item
default_value (anyOf 2)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternativeShort description of the property
description (anyOf 2)nullAlternative
require_explicit_valuesbooleanOptionalWhether setting properties values is mandatory
requiredbooleanOptionalWhether the property is required.
value_typestringRequired within parentThe type of the value for the property
One of: string, single_select, multi_select, true_false, url
values_editable_byJSONOptional
values_editable_by (anyOf 1)stringAlternativeWho can edit the values of the property
One of: org_actors, org_and_repo_actors
values_editable_by (anyOf 2)nullAlternative

Create or update custom properties for an organization — request body — body properties item

FieldTypePresenceDescription and constraints
$objectRootCustom property defined on an organization
allowed_valuesJSONOptional
allowed_values (anyOf 1)arrayAlternativeAn ordered list of the allowed values of the property.
The property can have up to 200 allowed values.
allowed_values (anyOf 1)[]stringEach item
allowed_values (anyOf 2)nullAlternative
default_valueJSONOptional
default_value (anyOf 1)JSONAlternativeDefault value of the property
default_value (anyOf 1) (oneOf 1)stringAlternative
default_value (anyOf 1) (oneOf 2)arrayAlternative
default_value (anyOf 1) (oneOf 2)[]stringEach item
default_value (anyOf 2)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternativeShort description of the property
description (anyOf 2)nullAlternative
property_namestringRequired within parentThe name of the property
require_explicit_valuesbooleanOptionalWhether setting properties values is mandatory
requiredbooleanOptionalWhether the property is required.
source_typestringOptionalThe source type of the property
One of: organization, enterprise
urlstringOptionalThe URL that can be used to fetch, update, or delete info about this property via the API.
Format: uri
value_typestringRequired within parentThe type of the value for the property
One of: string, single_select, multi_select, true_false, url
values_editable_byJSONOptional
values_editable_by (anyOf 1)stringAlternativeWho can edit the values of the property
One of: org_actors, org_and_repo_actors
values_editable_by (anyOf 2)nullAlternative

Create or update external custom property values for a property across organization repositories — request body — body repository values item

FieldTypePresenceDescription and constraints
$objectRootRepository name and associated external custom property value
repository_namestringRequired within parentThe name of the repository
valueJSONRequired within parent
value (anyOf 1)stringAlternativeThe value assigned to the repository. Set to `null` to unset the value for this repository.
value (anyOf 2)nullAlternative

Get a custom property for an organization — response body

FieldTypePresenceDescription and constraints
$objectRootCustom property defined on an organization
allowed_valuesJSONOptional
allowed_values (anyOf 1)arrayAlternativeAn ordered list of the allowed values of the property.
The property can have up to 200 allowed values.
allowed_values (anyOf 1)[]stringEach item
allowed_values (anyOf 2)nullAlternative
default_valueJSONOptional
default_value (anyOf 1)JSONAlternativeDefault value of the property
default_value (anyOf 1) (anyOf 1)stringAlternative
default_value (anyOf 1) (anyOf 2)arrayAlternative
default_value (anyOf 1) (anyOf 2)[]stringEach item
default_value (anyOf 2)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternativeShort description of the property
description (anyOf 2)nullAlternative
property_namestringRequired within parentThe name of the property
require_explicit_valuesbooleanOptionalWhether setting properties values is mandatory
requiredbooleanOptionalWhether the property is required.
source_typestringOptionalThe source type of the property
Known values: organization, enterprise
urlstringOptionalThe URL that can be used to fetch, update, or delete info about this property via the API.
Format: uri
value_typestringRequired within parentThe type of the value for the property
Known values: string, single_select, multi_select, true_false, url
values_editable_byJSONOptional
values_editable_by (anyOf 1)stringAlternativeWho can edit the values of the property
Known values: org_actors, org_and_repo_actors
values_editable_by (anyOf 2)nullAlternative

Get all external custom properties for a Git Hub App installation in an organization — response body — item

FieldTypePresenceDescription and constraints
$objectRootExternal custom property defined for a GitHub App installation
property_namestringRequired within parentThe name of the external property

Get an organization role — response body

FieldTypePresenceDescription and constraints
$objectRootOrganization roles
base_roleJSONOptional
base_role (anyOf 1)stringAlternativeThe system role from which this role inherits permissions.
Known values: read, triage, write, maintain, admin
base_role (anyOf 2)nullAlternative
created_atstringRequired within parentThe date and time the role was created.
Format: date-time
descriptionJSONOptional
description (anyOf 1)stringAlternativeA short description about who this role is for or what permissions it grants.
description (anyOf 2)nullAlternative
idJSONRequired within parent
id (anyOf 1)integerAlternativeThe unique identifier of the role.
Format: int64
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
namestringRequired within parentThe name of the role.
organizationModelRequired within parentExpand Get an issue — response body — user
permissionsarrayRequired within parentA list of permissions included in this role.
permissions[]stringEach item
sourceJSONOptional
source (anyOf 1)stringAlternativeSource answers the question, "where did this role come from?"
Known values: Organization, Enterprise, Predefined
source (anyOf 2)nullAlternative
updated_atstringRequired within parentThe date and time the role was last updated.
Format: date-time

Referenced models: Get an issue — response body — user

Get an organization webhook — response body

FieldTypePresenceDescription and constraints
$objectRootOrg Hook
activebooleanRequired within parent
configobjectRequired within parent
config.content_typestringOptional
config.insecure_sslstringOptional
config.secretstringOptional
config.urlstringOptional
created_atstringRequired within parentFormat: date-time
deliveries_urlstringOptionalFormat: uri
eventsarrayRequired within parent
events[]stringEach item
idJSONRequired within parent
id (anyOf 1)integerAlternative
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
namestringRequired within parent
ping_urlstringRequired within parentFormat: uri
typestringRequired within parent
updated_atstringRequired within parentFormat: date-time
urlstringRequired within parentFormat: uri

Get an organization — response body

FieldTypePresenceDescription and constraints
$objectRootOrganization Full
advanced_security_enabled_for_new_repositoriesbooleanOptional**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/rest/code-security/configurations) instead.

Whether GitHub Advanced Security is enabled for new repositories and repositories transferred to this organization.

This field is only visible to organization owners or members of a team with the security manager role.
archived_atJSONRequired within parent
archived_at (anyOf 1)stringAlternativeFormat: date-time
archived_at (anyOf 2)nullAlternative
avatar_urlstringRequired within parent
billing_emailJSONOptional
billing_email (anyOf 1)stringAlternativeFormat: email
billing_email (anyOf 2)nullAlternative
blogJSONOptional
blog (anyOf 1)stringAlternativeFormat: uri
blog (anyOf 2)nullAlternative
collaboratorsJSONOptional
collaborators (anyOf 1)JSONAlternative
collaborators (anyOf 1) (anyOf 1)integerAlternativeThe number of collaborators on private repositories.

This field may be null if the number of private repositories is over 50,000.
collaborators (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
collaborators (anyOf 2)nullAlternative
companyJSONOptional
company (anyOf 1)stringAlternative
company (anyOf 2)nullAlternative
created_atstringRequired within parentFormat: date-time
default_repository_branchJSONOptional
default_repository_branch (anyOf 1)stringAlternativeThe default branch for repositories created in this organization.
default_repository_branch (anyOf 2)nullAlternative
default_repository_permissionJSONOptional
default_repository_permission (anyOf 1)stringAlternative
default_repository_permission (anyOf 2)nullAlternative
dependabot_alerts_enabled_for_new_repositoriesbooleanOptional**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/rest/code-security/configurations) instead.

Whether Dependabot alerts are automatically enabled for new repositories and repositories transferred to this organization.

This field is only visible to organization owners or members of a team with the security manager role.
dependabot_security_updates_enabled_for_new_repositoriesbooleanOptional**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/rest/code-security/configurations) instead.

Whether Dependabot security updates are automatically enabled for new repositories and repositories transferred to this organization.

This field is only visible to organization owners or members of a team with the security manager role.
dependency_graph_enabled_for_new_repositoriesbooleanOptional**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/rest/code-security/configurations) instead.

Whether dependency graph is automatically enabled for new repositories and repositories transferred to this organization.

This field is only visible to organization owners or members of a team with the security manager role.
deploy_keys_enabled_for_repositoriesbooleanOptionalControls whether or not deploy keys may be added and used for repositories in the organization.
descriptionJSONRequired within parent
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
disk_usageJSONOptional
disk_usage (anyOf 1)JSONAlternative
disk_usage (anyOf 1) (anyOf 1)integerAlternative
disk_usage (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
disk_usage (anyOf 2)nullAlternative
display_commenter_full_name_setting_enabledbooleanOptional
emailJSONOptional
email (anyOf 1)stringAlternativeFormat: email
email (anyOf 2)nullAlternative
events_urlstringRequired within parentFormat: uri
followersJSONRequired within parent
followers (anyOf 1)integerAlternative
followers (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
followingJSONRequired within parent
following (anyOf 1)integerAlternative
following (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
has_organization_projectsbooleanRequired within parent
has_repository_projectsbooleanRequired within parent
hooks_urlstringRequired within parent
html_urlstringRequired within parentFormat: uri
idJSONRequired within parent
id (anyOf 1)integerAlternative
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
is_verifiedbooleanOptional
issues_urlstringRequired within parent
locationJSONOptional
location (anyOf 1)stringAlternative
location (anyOf 2)nullAlternative
loginstringRequired within parent
members_allowed_repository_creation_typestringOptional
members_can_change_repo_visibilitybooleanOptional
members_can_create_internal_repositoriesbooleanOptional
members_can_create_pagesbooleanOptional
members_can_create_private_pagesbooleanOptional
members_can_create_private_repositoriesbooleanOptional
members_can_create_public_pagesbooleanOptional
members_can_create_public_repositoriesbooleanOptional
members_can_create_repositoriesJSONOptional
members_can_create_repositories (anyOf 1)booleanAlternative
members_can_create_repositories (anyOf 2)nullAlternative
members_can_create_teamsbooleanOptional
members_can_delete_issuesbooleanOptional
members_can_delete_repositoriesbooleanOptional
members_can_fork_private_repositoriesJSONOptional
members_can_fork_private_repositories (anyOf 1)booleanAlternative
members_can_fork_private_repositories (anyOf 2)nullAlternative
members_can_invite_outside_collaboratorsbooleanOptional
members_can_view_dependency_insightsbooleanOptional
members_urlstringRequired within parent
namestringOptional
node_idstringRequired within parent
owned_private_reposJSONOptional
owned_private_repos (anyOf 1)integerAlternative
owned_private_repos (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
planModelOptionalExpand Get an organization — response body — plan
private_gistsJSONOptional
private_gists (anyOf 1)JSONAlternative
private_gists (anyOf 1) (anyOf 1)integerAlternative
private_gists (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
private_gists (anyOf 2)nullAlternative
public_gistsJSONRequired within parent
public_gists (anyOf 1)integerAlternative
public_gists (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
public_members_urlstringRequired within parent
public_reposJSONRequired within parent
public_repos (anyOf 1)integerAlternative
public_repos (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
readers_can_create_discussionsbooleanOptional
repos_urlstringRequired within parentFormat: uri
secret_scanning_enabled_for_new_repositoriesbooleanOptional**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/rest/code-security/configurations) instead.

Whether secret scanning is automatically enabled for new repositories and repositories transferred to this organization.

This field is only visible to organization owners or members of a team with the security manager role.
secret_scanning_push_protection_custom_linkJSONOptional
secret_scanning_push_protection_custom_link (anyOf 1)stringAlternativeAn optional URL string to display to contributors who are blocked from pushing a secret.
secret_scanning_push_protection_custom_link (anyOf 2)nullAlternative
secret_scanning_push_protection_enabled_for_new_repositoriesbooleanOptional**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/rest/code-security/configurations) instead.

Whether secret scanning push protection is automatically enabled for new repositories and repositories transferred to this organization.

This field is only visible to organization owners or members of a team with the security manager role.
total_private_reposJSONOptional
total_private_repos (anyOf 1)integerAlternative
total_private_repos (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
twitter_usernameJSONOptional
twitter_username (anyOf 1)stringAlternative
twitter_username (anyOf 2)nullAlternative
two_factor_requirement_enabledJSONOptional
two_factor_requirement_enabled (anyOf 1)booleanAlternative
two_factor_requirement_enabled (anyOf 2)nullAlternative
typestringRequired within parent
updated_atstringRequired within parentFormat: date-time
urlstringRequired within parentFormat: uri
web_commit_signoff_requiredbooleanOptional

Referenced models: Get an organization — response body — plan

Get an organization — response body — plan

FieldTypePresenceDescription and constraints
$objectRoot
filled_seatsJSONOptional
filled_seats (anyOf 1)integerAlternative
filled_seats (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
namestringRequired within parent
private_reposJSONRequired within parent
private_repos (anyOf 1)integerAlternative
private_repos (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
seatsJSONOptional
seats (anyOf 1)integerAlternative
seats (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
spaceJSONRequired within parent
space (anyOf 1)integerAlternative
space (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Get immutable releases settings for an organization — response body

FieldTypePresenceDescription and constraints
$objectRootCheck immutable releases settings for an organization.
enforced_repositoriesstringRequired within parentThe policy that controls how immutable releases are enforced in the organization.
Known values: all, none, selected
selected_repositories_urlstringOptionalThe API URL to use to get or set the selected repositories for immutable releases enforcement, when `enforced_repositories` is set to `selected`.

Get organization membership for a user — response body

FieldTypePresenceDescription and constraints
$objectRootOrg Membership
direct_membershipbooleanOptionalWhether the user has direct membership in the organization.
enterprise_teams_providing_indirect_membershiparrayOptionalThe slugs of the enterprise teams providing the user with indirect membership in the organization.
A limit of 100 enterprise team slugs is returned.
Maximum items: 100
enterprise_teams_providing_indirect_membership[]stringEach item
organizationModelRequired within parentExpand List organizations — response body — item
organization_urlstringRequired within parentFormat: uri
permissionsobjectOptional
permissions.can_create_repositorybooleanRequired within parent
rolestringRequired within parentThe user's membership type in the organization.
Known values: admin, member, billing_manager
statestringRequired within parentThe state of the member in the organization. The `pending` state indicates the user has not yet accepted an invitation.
Known values: active, pending
urlstringRequired within parentFormat: uri
userModelRequired within parentExpand Get an issue — response body — user

Referenced models: Get an issue — response body — user, List organizations — response body — item

Get route stats by actor — response body

FieldTypePresenceDescription and constraints
$arrayRootAPI Insights usage route stats for an actor
$[]objectEach item
$[].api_routestringOptionalThe API path's route template
$[].http_methodstringOptionalThe HTTP method
$[].last_rate_limited_timestampJSONOptional
$[].last_rate_limited_timestamp (anyOf 1)stringAlternative
$[].last_rate_limited_timestamp (anyOf 2)nullAlternative
$[].last_request_timestampstringOptional
$[].rate_limited_request_countJSONOptional
$[].rate_limited_request_count (anyOf 1)integerAlternativeThe total number of requests that were rate limited within the queried time period
Format: int64
$[].rate_limited_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$[].total_request_countJSONOptional
$[].total_request_count (anyOf 1)integerAlternativeThe total number of requests within the queried time period
Format: int64
$[].total_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Get subject stats — response body

FieldTypePresenceDescription and constraints
$arrayRootAPI Insights usage subject stats for an organization
$[]objectEach item
$[].last_rate_limited_timestampJSONOptional
$[].last_rate_limited_timestamp (anyOf 1)stringAlternative
$[].last_rate_limited_timestamp (anyOf 2)nullAlternative
$[].last_request_timestampstringOptional
$[].rate_limited_request_countJSONOptional
$[].rate_limited_request_count (anyOf 1)integerAlternative
$[].rate_limited_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$[].subject_idJSONOptional
$[].subject_id (anyOf 1)integerAlternativeFormat: int64
$[].subject_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$[].subject_namestringOptional
$[].subject_typestringOptional
$[].total_request_countJSONOptional
$[].total_request_count (anyOf 1)integerAlternative
$[].total_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Get summary stats — response body

FieldTypePresenceDescription and constraints
$objectRootAPI Insights usage summary stats for an organization
rate_limited_request_countJSONOptional
rate_limited_request_count (anyOf 1)integerAlternativeThe total number of requests that were rate limited within the queried time period
Format: int64
rate_limited_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
total_request_countJSONOptional
total_request_count (anyOf 1)integerAlternativeThe total number of requests within the queried time period
Format: int64
total_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Get time stats — response body

FieldTypePresenceDescription and constraints
$arrayRootAPI Insights usage time stats for an organization
$[]objectEach item
$[].rate_limited_request_countJSONOptional
$[].rate_limited_request_count (anyOf 1)integerAlternativeFormat: int64
$[].rate_limited_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$[].timestampstringOptional
$[].total_request_countJSONOptional
$[].total_request_count (anyOf 1)integerAlternativeFormat: int64
$[].total_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Get user stats — response body

FieldTypePresenceDescription and constraints
$arrayRootAPI Insights usage stats for a user
$[]objectEach item
$[].actor_idJSONOptional
$[].actor_id (anyOf 1)integerAlternativeFormat: int64
$[].actor_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$[].actor_namestringOptional
$[].actor_typestringOptional
$[].integration_idJSONOptional
$[].integration_id (anyOf 1)JSONAlternative
$[].integration_id (anyOf 1) (anyOf 1)integerAlternativeFormat: int64
$[].integration_id (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$[].integration_id (anyOf 2)nullAlternative
$[].last_rate_limited_timestampJSONOptional
$[].last_rate_limited_timestamp (anyOf 1)stringAlternative
$[].last_rate_limited_timestamp (anyOf 2)nullAlternative
$[].last_request_timestampstringOptional
$[].oauth_application_idJSONOptional
$[].oauth_application_id (anyOf 1)JSONAlternative
$[].oauth_application_id (anyOf 1) (anyOf 1)integerAlternativeFormat: int64
$[].oauth_application_id (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$[].oauth_application_id (anyOf 2)nullAlternative
$[].rate_limited_request_countJSONOptional
$[].rate_limited_request_count (anyOf 1)integerAlternative
$[].rate_limited_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$[].total_request_countJSONOptional
$[].total_request_count (anyOf 1)integerAlternative
$[].total_request_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

List app installations for an organization — response body — installations item

FieldTypePresenceDescription and constraints
$objectRootInstallation
access_tokens_urlstringRequired within parentFormat: uri
accountJSONRequired within parent
account (anyOf 1)JSONAlternative
account (anyOf 1) (anyOf 1)ModelAlternativeExpand List users — response body — item
account (anyOf 1) (anyOf 2)ModelAlternativeExpand Get an app — response body — client id, created at, description, events, external url, html url, id, installations count, name, node id, owner, permissions, slug, updated at owner Enterprise
account (anyOf 2)nullAlternative
app_idJSONRequired within parent
app_id (anyOf 1)integerAlternative
app_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
app_slugstringRequired within parent
client_idstringOptional
contact_emailJSONOptional
contact_email (anyOf 1)stringAlternative
contact_email (anyOf 2)nullAlternative
created_atstringRequired within parentFormat: date-time
eventsarrayRequired within parent
events[]stringEach item
has_multiple_single_filesbooleanOptional
html_urlstringRequired within parentFormat: uri
idJSONRequired within parent
id (anyOf 1)integerAlternativeThe ID of the installation.
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
permissionsModelRequired within parentExpand List app installations for an organization — response body — installations item permissions
repositories_urlstringRequired within parentFormat: uri
repository_selectionstringRequired within parentDescribe whether all repositories have been selected or there's a selection involved
Known values: all, selected
single_file_nameJSONRequired within parent
single_file_name (anyOf 1)stringAlternative
single_file_name (anyOf 2)nullAlternative
single_file_pathsarrayOptional
single_file_paths[]stringEach item
suspended_atJSONRequired within parent
suspended_at (anyOf 1)stringAlternativeFormat: date-time
suspended_at (anyOf 2)nullAlternative
suspended_byModelRequired within parentExpand Get an issue — response body — user
target_idJSONRequired within parent
target_id (anyOf 1)integerAlternativeThe ID of the user or organization this token is being scoped to.
target_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
target_typestringRequired within parent
updated_atstringRequired within parentFormat: date-time

Referenced models: List app installations for an organization — response body — installations item permissions, Get an app — response body — client id, created at, description, events, external url, html url, id, installations count, name, node id, owner, permissions, slug, updated at owner Enterprise, Get an issue — response body — user, List users — response body — item

List app installations for an organization — response body — installations item permissions

FieldTypePresenceDescription and constraints
$objectRootThe permissions granted to the fine-grained access token.
actionsstringOptionalThe level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.
Known values: read, write
administrationstringOptionalThe level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.
Known values: read, write
artifact_metadatastringOptionalThe level of permission to grant the access token to create and retrieve build artifact metadata records.
Known values: read, write
attestationsstringOptionalThe level of permission to create and retrieve the access token for repository attestations.
Known values: read, write
checksstringOptionalThe level of permission to grant the access token for checks on code.
Known values: read, write
code_qualitystringOptionalThe level of permission to grant the access token to view and manage code quality data.
Known values: read, write
codespacesstringOptionalThe level of permission to grant the access token to create, edit, delete, and list Codespaces.
Known values: read, write
contentsstringOptionalThe level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.
Known values: read, write
custom_properties_for_organizationsstringOptionalThe level of permission to grant the access token to view and edit custom properties for an organization, when allowed by the property.
Known values: read, write
dependabot_secretsstringOptionalThe level of permission to grant the access token to manage Dependabot secrets.
Known values: read, write
deploymentsstringOptionalThe level of permission to grant the access token for deployments and deployment statuses.
Known values: read, write
discussionsstringOptionalThe level of permission to grant the access token for discussions and related comments and labels.
Known values: read, write
email_addressesstringOptionalThe level of permission to grant the access token to manage the email addresses belonging to a user.
Known values: read, write
enterprise_custom_properties_for_organizationsstringOptionalThe level of permission to grant the access token for organization custom properties management at the enterprise level.
Known values: read, write, admin
environmentsstringOptionalThe level of permission to grant the access token for managing repository environments.
Known values: read, write
followersstringOptionalThe level of permission to grant the access token to manage the followers belonging to a user.
Known values: read, write
git_ssh_keysstringOptionalThe level of permission to grant the access token to manage git SSH keys.
Known values: read, write
gpg_keysstringOptionalThe level of permission to grant the access token to view and manage GPG keys belonging to a user.
Known values: read, write
interaction_limitsstringOptionalThe level of permission to grant the access token to view and manage interaction limits on a repository.
Known values: read, write
issuesstringOptionalThe level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.
Known values: read, write
membersstringOptionalThe level of permission to grant the access token for organization teams and members.
Known values: read, write
merge_queuesstringOptionalThe level of permission to grant the access token to manage the merge queues for a repository.
Known values: read, write
metadatastringOptionalThe level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.
Known values: read, write
organization_administrationstringOptionalThe level of permission to grant the access token to manage access to an organization.
Known values: read, write
organization_announcement_bannersstringOptionalThe level of permission to grant the access token to view and manage announcement banners for an organization.
Known values: read, write
organization_copilot_agent_settingsstringOptionalThe level of permission to grant the access token to view and manage Copilot cloud agent settings for an organization.
Known values: read, write
organization_copilot_requestsstringOptionalThe level of permission to grant the access token to make Copilot requests billed to the organization where the app is installed. This property is in public preview and is subject to change.
Known values: read
organization_copilot_seat_managementstringOptionalThe level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.
Known values: read, write
organization_custom_org_rolesstringOptionalThe level of permission to grant the access token for custom organization roles management.
Known values: read, write
organization_custom_propertiesstringOptionalThe level of permission to grant the access token for repository custom properties management at the organization level.
Known values: read, write, admin
organization_custom_rolesstringOptionalThe level of permission to grant the access token for custom repository roles management.
Known values: read, write
organization_eventsstringOptionalThe level of permission to grant the access token to view events triggered by an activity in an organization.
Known values: read
organization_external_properties_for_reposstringOptionalThe level of permission to grant the access token for managing external custom properties for repositories in an organization.
Known values: read, write, admin
organization_hooksstringOptionalThe level of permission to grant the access token to manage the post-receive hooks for an organization.
Known values: read, write
organization_packagesstringOptionalThe level of permission to grant the access token for organization packages published to GitHub Packages.
Known values: read, write
organization_personal_access_token_requestsstringOptionalThe level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.
Known values: read, write
organization_personal_access_tokensstringOptionalThe level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.
Known values: read, write
organization_planstringOptionalThe level of permission to grant the access token for viewing an organization's plan.
Known values: read
organization_projectsstringOptionalThe level of permission to grant the access token to manage organization projects and projects public preview (where available).
Known values: read, write, admin
organization_secretsstringOptionalThe level of permission to grant the access token to manage organization secrets.
Known values: read, write
organization_self_hosted_runnersstringOptionalThe level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.
Known values: read, write
organization_user_blockingstringOptionalThe level of permission to grant the access token to view and manage users blocked by the organization.
Known values: read, write
packagesstringOptionalThe level of permission to grant the access token for packages published to GitHub Packages.
Known values: read, write
pagesstringOptionalThe level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.
Known values: read, write
profilestringOptionalThe level of permission to grant the access token to manage the profile settings belonging to a user.
Known values: write
pull_requestsstringOptionalThe level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.
Known values: read, write
repository_custom_propertiesstringOptionalThe level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.
Known values: read, write
repository_hooksstringOptionalThe level of permission to grant the access token to manage the post-receive hooks for a repository.
Known values: read, write
repository_projectsstringOptionalThe level of permission to grant the access token to manage repository projects, columns, and cards.
Known values: read, write, admin
secret_scanning_alertsstringOptionalThe level of permission to grant the access token to view and manage secret scanning alerts.
Known values: read, write
secretsstringOptionalThe level of permission to grant the access token to manage repository secrets.
Known values: read, write
security_eventsstringOptionalThe level of permission to grant the access token to view and manage security events like code scanning alerts.
Known values: read, write
single_filestringOptionalThe level of permission to grant the access token to manage just a single file.
Known values: read, write
starringstringOptionalThe level of permission to grant the access token to list and manage repositories a user is starring.
Known values: read, write
statusesstringOptionalThe level of permission to grant the access token for commit statuses.
Known values: read, write
vulnerability_alertsstringOptionalThe level of permission to grant the access token to manage Dependabot alerts.
Known values: read, write
workflowsstringOptionalThe level of permission to grant the access token to update GitHub Actions workflow files.
Known values: write

List artifact deployment records — response body — deployment records item

FieldTypePresenceDescription and constraints
$objectRootArtifact Metadata Deployment Record
attestation_idJSONOptional
attestation_id (anyOf 1)JSONAlternative
attestation_id (anyOf 1) (anyOf 1)integerAlternativeThe ID of the provenance attestation associated with the deployment record.
attestation_id (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
attestation_id (anyOf 2)nullAlternative
clusterstringOptional
created_atstringOptional
deployment_namestringOptional
digeststringOptional
idJSONOptional
id (anyOf 1)integerAlternative
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
logical_environmentstringOptional
physical_environmentstringOptional
runtime_risksarrayOptionalA list of runtime risks associated with the deployment.
Maximum items: 4
Unique items: true
runtime_risks[]stringEach itemKnown values: critical-resource, internet-exposed, lateral-movement, sensitive-data
tagsobjectOptionalAdditional keys: see wildcard field
tags.*stringAdditional keys
updated_atstringOptional

List custom property values for organization repositories — response body — item

FieldTypePresenceDescription and constraints
$objectRootList of custom property values for a repository
propertiesarrayRequired within parentList of custom property names and associated values
properties[]ModelEach itemExpand Get all custom property values for a repository — response body — item
repository_full_namestringRequired within parent
repository_idJSONRequired within parent
repository_id (anyOf 1)integerAlternative
repository_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
repository_namestringRequired within parent

Referenced models: Get all custom property values for a repository — response body — item

List fine-grained personal access tokens with access to organization resources — request body — query

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
per_pageintegerOptionalDefault: 30
pageintegerOptionalDefault: 1
sortstringOptionalDefault: created_at
One of: created_at
directionstringOptionalDefault: desc
One of: asc, desc
ownerarrayOptionalMaximum items: 10
owner[]stringEach item
repositorystringOptional
permissionstringOptional
last_used_beforestringOptionalFormat: date-time
last_used_afterstringOptionalFormat: date-time
token_idarrayOptionalMaximum items: 50
token_id[]stringEach item

List fine-grained personal access tokens with access to organization resources — response body — item

FieldTypePresenceDescription and constraints
$objectRootMinimal representation of an organization programmatic access grant for enumerations
access_granted_atstringRequired within parentDate and time when the fine-grained personal access token was approved to access the organization.
idJSONRequired within parent
id (anyOf 1)integerAlternativeUnique identifier of the fine-grained personal access token grant. The `pat_id` used to get details about an approved fine-grained personal access token.
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
ownerModelRequired within parentExpand List users — response body — item
permissionsobjectRequired within parentPermissions requested, categorized by type of permission.
permissions.organizationobjectOptionalAdditional keys: see wildcard field
permissions.organization.*stringAdditional keys
permissions.otherobjectOptionalAdditional keys: see wildcard field
permissions.other.*stringAdditional keys
permissions.repositoryobjectOptionalAdditional keys: see wildcard field
permissions.repository.*stringAdditional keys
repositories_urlstringRequired within parentURL to the list of repositories the fine-grained personal access token can access. Only follow when `repository_selection` is `subset`.
repository_selectionstringRequired within parentType of repository selection requested.
Known values: none, all, subset
token_expiredbooleanRequired within parentWhether the associated fine-grained personal access token has expired.
token_expires_atJSONRequired within parent
token_expires_at (anyOf 1)stringAlternativeDate and time when the associated fine-grained personal access token expires.
token_expires_at (anyOf 2)nullAlternative
token_idJSONRequired within parent
token_id (anyOf 1)integerAlternativeUnique identifier of the user's token. This field can also be found in audit log events and the organization's settings for their PAT grants.
token_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
token_last_used_atJSONRequired within parent
token_last_used_at (anyOf 1)stringAlternativeDate and time when the associated fine-grained personal access token was last used for authentication.
token_last_used_at (anyOf 2)nullAlternative
token_namestringRequired within parentThe name given to the user's token. This field can also be found in an organization's settings page for Active Tokens.

Referenced models: List users — response body — item

List organizations — response body — item

FieldTypePresenceDescription and constraints
$objectRootA GitHub organization.
avatar_urlstringRequired within parent
descriptionJSONRequired within parent
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
events_urlstringRequired within parentFormat: uri
hooks_urlstringRequired within parent
idJSONRequired within parent
id (anyOf 1)integerAlternative
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
issues_urlstringRequired within parent
loginstringRequired within parent
members_urlstringRequired within parent
node_idstringRequired within parent
public_members_urlstringRequired within parent
repos_urlstringRequired within parentFormat: uri
urlstringRequired within parentFormat: uri

List requests to access organization resources with fine-grained personal access tokens — response body — item

FieldTypePresenceDescription and constraints
$objectRootMinimal representation of an organization programmatic access grant request for enumerations
created_atstringRequired within parentDate and time when the request for access was created.
idJSONRequired within parent
id (anyOf 1)integerAlternativeUnique identifier of the request for access via fine-grained personal access token. The `pat_request_id` used to review PAT requests.
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
ownerModelRequired within parentExpand List users — response body — item
permissionsobjectRequired within parentPermissions requested, categorized by type of permission.
permissions.organizationobjectOptionalAdditional keys: see wildcard field
permissions.organization.*stringAdditional keys
permissions.otherobjectOptionalAdditional keys: see wildcard field
permissions.other.*stringAdditional keys
permissions.repositoryobjectOptionalAdditional keys: see wildcard field
permissions.repository.*stringAdditional keys
reasonJSONRequired within parent
reason (anyOf 1)stringAlternativeReason for requesting access.
reason (anyOf 2)nullAlternative
repositories_urlstringRequired within parentURL to the list of repositories requested to be accessed via fine-grained personal access token. Should only be followed when `repository_selection` is `subset`.
repository_selectionstringRequired within parentType of repository selection requested.
Known values: none, all, subset
token_expiredbooleanRequired within parentWhether the associated fine-grained personal access token has expired.
token_expires_atJSONRequired within parent
token_expires_at (anyOf 1)stringAlternativeDate and time when the associated fine-grained personal access token expires.
token_expires_at (anyOf 2)nullAlternative
token_idJSONRequired within parent
token_id (anyOf 1)integerAlternativeUnique identifier of the user's token. This field can also be found in audit log events and the organization's settings for their PAT grants.
token_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
token_last_used_atJSONRequired within parent
token_last_used_at (anyOf 1)stringAlternativeDate and time when the associated fine-grained personal access token was last used for authentication.
token_last_used_at (anyOf 2)nullAlternative
token_namestringRequired within parentThe name given to the user's token. This field can also be found in an organization's settings page for Active Tokens.

Referenced models: List users — response body — item

List security manager teams — response body — item

FieldTypePresenceDescription and constraints
$objectRootGroups of organization members that gives permissions on specified repositories.
descriptionJSONRequired within parent
description (anyOf 1)stringAlternativeDescription of the team
description (anyOf 2)nullAlternative
enterprise_idJSONOptional
enterprise_id (anyOf 1)integerAlternativeUnique identifier of the enterprise to which this team belongs
enterprise_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
html_urlstringRequired within parentFormat: uri
idJSONRequired within parent
id (anyOf 1)integerAlternativeUnique identifier of the team
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
ldap_dnstringOptionalDistinguished Name (DN) that team maps to within LDAP environment
members_urlstringRequired within parent
namestringRequired within parentName of the team
node_idstringRequired within parent
notification_settingstringOptionalThe notification setting the team has set
organization_idJSONOptional
organization_id (anyOf 1)integerAlternativeUnique identifier of the organization to which this team belongs
organization_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
permissionstringRequired within parentPermission that the team will have for its repositories
privacystringOptionalThe level of privacy this team should have
repositories_urlstringRequired within parentFormat: uri
slugstringRequired within parent
typestringRequired within parentThe ownership type of the team
Known values: enterprise, organization
urlstringRequired within parentURL for the team
Format: uri

List teams that are assigned to an organization role — response body — item

FieldTypePresenceDescription and constraints
$objectRootThe Relationship a Team has with a role.
assignmentstringOptionalDetermines if the team has a direct, indirect, or mixed relationship to a role
Known values: direct, indirect, mixed
descriptionJSONRequired within parent
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
enterprise_idJSONOptional
enterprise_id (anyOf 1)integerAlternativeUnique identifier of the enterprise to which this team belongs
enterprise_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
html_urlstringRequired within parentFormat: uri
idJSONRequired within parent
id (anyOf 1)integerAlternative
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
members_urlstringRequired within parent
namestringRequired within parent
node_idstringRequired within parent
notification_settingstringOptional
organization_idJSONOptional
organization_id (anyOf 1)integerAlternativeUnique identifier of the organization to which this team belongs
organization_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
parentModelRequired within parentExpand Create a team — response body — parent
permissionstringRequired within parent
permissionsobjectOptional
permissions.adminbooleanRequired within parent
permissions.maintainbooleanRequired within parent
permissions.pullbooleanRequired within parent
permissions.pushbooleanRequired within parent
permissions.triagebooleanRequired within parent
privacystringOptional
repositories_urlstringRequired within parentFormat: uri
slugstringRequired within parent
typestringRequired within parentThe ownership type of the team
Known values: enterprise, organization
urlstringRequired within parentFormat: uri

Referenced models: Create a team — response body — parent

List users that are assigned to an organization role — response body — item

FieldTypePresenceDescription and constraints
$objectRootThe Relationship a User has with a role.
assignmentstringOptionalDetermines if the user has a direct, indirect, or mixed relationship to a role
Known values: direct, indirect, mixed
avatar_urlstringRequired within parentFormat: uri
emailJSONOptional
email (anyOf 1)stringAlternative
email (anyOf 2)nullAlternative
events_urlstringRequired within parent
followers_urlstringRequired within parentFormat: uri
following_urlstringRequired within parent
gists_urlstringRequired within parent
gravatar_idJSONRequired within parent
gravatar_id (anyOf 1)stringAlternative
gravatar_id (anyOf 2)nullAlternative
html_urlstringRequired within parentFormat: uri
idJSONRequired within parent
id (anyOf 1)integerAlternative
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
inherited_fromarrayOptionalTeam the user has gotten the role through
inherited_from[]ModelEach itemExpand List security manager teams — response body — item
loginstringRequired within parent
nameJSONOptional
name (anyOf 1)stringAlternative
name (anyOf 2)nullAlternative
node_idstringRequired within parent
organizations_urlstringRequired within parentFormat: uri
received_events_urlstringRequired within parentFormat: uri
repos_urlstringRequired within parentFormat: uri
site_adminbooleanRequired within parent
starred_atstringOptional
starred_urlstringRequired within parent
subscriptions_urlstringRequired within parentFormat: uri
typestringRequired within parent
urlstringRequired within parentFormat: uri
user_view_typestringOptional

Referenced models: List security manager teams — response body — item

Register an app installation for external custom properties — response body

FieldTypePresenceDescription and constraints
$objectRootA GitHub App installation that has been registered to read and write an organization's external custom properties, together with the display name assigned to it.
display_namestringRequired within parentThe display name assigned to the app installation's external custom properties in the organization.
installationobjectRequired within parentThe GitHub App installation that was registered.
installation.idJSONRequired within parent
installation.id (anyOf 1)integerAlternativeThe unique identifier of the GitHub App installation.
installation.id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Update a webhook configuration for an organization — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
content_typestringOptionalThe media type used to serialize the payloads. Supported values include `json` and `form`. The default is `form`.
insecure_sslModelOptionalExpand Update a webhook configuration for a repository — request body — body insecure ssl
secretstringOptionalIf provided, the `secret` will be used as the `key` to generate the HMAC hex digest value for [delivery signature headers](https://docs.github.com/webhooks/event-payloads/#delivery-headers).
urlstringOptionalThe URL to which the payloads will be delivered.
Format: uri

Referenced models: Update a webhook configuration for a repository — request body — body insecure ssl

Update issue field for an organization — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
descriptionJSONOptional
description (anyOf 1)stringAlternativeDescription of the issue field.
description (anyOf 2)nullAlternative
namestringOptionalName of the issue field.
optionsarrayOptionalOptions for select fields. Only applicable when updating single_select or multi_select fields. When provided, this array **replaces** the entire existing set of options rather than adding to or updating individual options. To retain or update an existing option, include it in the array with its `id`. Options sent without an `id` are treated as new options and may cause existing options to be deleted and recreated.
options[]objectEach item
options[].colorstringRequired within parentColor for the option.
One of: gray, blue, green, yellow, orange, red, pink, purple
options[].descriptionJSONOptional
options[].description (anyOf 1)stringAlternativeDescription of the option.
options[].description (anyOf 2)nullAlternative
options[].idintegerOptionalThe id of an existing option to retain or update. Omit this when creating a new option.
options[].namestringRequired within parentName of the option.
options[].priorityintegerRequired within parentPriority of the option for ordering.
visibilitystringOptionalThe visibility of the issue field. Can be `organization_members_only` (visible only within the organization) or `all` (visible to all users who can see issues). Only used when the visibility settings feature is enabled.
One of: organization_members_only, all

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.