About objects
Objects in GraphQL represent the resources you can access. An object can contain a list of fields, which are specifically typed.
For example, the Repository
object has a field called name
, which is a String
.
For more information, see Introduction to GraphQL.
ActorConnection
The connection type for Actor.
Fields for ActorConnection
Name | Description |
---|---|
| A list of edges. |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
ActorEdge
An edge in a connection.
ActorLocation
Location information for an actor.
AddedToMergeQueueEvent
Represents anadded_to_merge_queue
event on a given pull request.
AddedToMergeQueueEvent
Implements
Fields for AddedToMergeQueueEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| The user who added this Pull Request to the merge queue. |
| The Node ID of the AddedToMergeQueueEvent object. |
| The merge queue where this pull request was added to. |
| PullRequest referenced by event. |
AddedToProjectEvent
Represents aadded_to_project
event on a given issue or pull request.
AddedToProjectEvent
Implements
Fields for AddedToProjectEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| Identifies the primary key from the database. Warning
Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC. |
| The Node ID of the AddedToProjectEvent object. |
| Project referenced by event. Warning
Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC. |
| Project card referenced by this project event. Warning
Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC. |
| Column name referenced by this project event. Warning
Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC. |
AnnouncementBanner
An announcement banner for an enterprise or organization.
App
A GitHub App.
App
Implements
Fields for App
Name | Description |
---|---|
| The client ID of the app. |
| Identifies the date and time when the object was created. |
| Identifies the primary key from the database. |
| The description of the app. |
| The Node ID of the App object. |
| The IP addresses of the app. Arguments for
|
| The hex color code, without the leading '#', for the logo background. |
| A URL pointing to the app's logo. Arguments for
|
| The name of the app. |
| A slug based on the name of the app for use in URLs. |
| Identifies the date and time when the object was last updated. |
| The URL to the app's homepage. |
AssignedEvent
Represents anassigned
event on any assignable object.
AssignedEvent
Implements
Fields for AssignedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the assignable associated with the event. |
| Identifies the user or mannequin that was assigned. |
| Identifies the date and time when the object was created. |
| The Node ID of the AssignedEvent object. |
| Identifies the user who was assigned. Warning
Assignees can now be mannequins. Use the |
AssigneeConnection
The connection type for Assignee.
Fields for AssigneeConnection
Name | Description |
---|---|
| A list of edges. |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
AssigneeEdge
An edge in a connection.
AutoMergeDisabledEvent
Represents aauto_merge_disabled
event on a given pull request.
AutoMergeDisabledEvent
Implements
Fields for AutoMergeDisabledEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| The user who disabled auto-merge for this Pull Request. |
| The Node ID of the AutoMergeDisabledEvent object. |
| PullRequest referenced by event. |
| The reason auto-merge was disabled. |
| The reason_code relating to why auto-merge was disabled. |
AutoMergeEnabledEvent
Represents aauto_merge_enabled
event on a given pull request.
AutoMergeEnabledEvent
Implements
Fields for AutoMergeEnabledEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| The user who enabled auto-merge for this Pull Request. |
| The Node ID of the AutoMergeEnabledEvent object. |
| PullRequest referenced by event. |
AutoMergeRequest
Represents an auto-merge request for a pull request.
Fields for AutoMergeRequest
Name | Description |
---|---|
| The email address of the author of this auto-merge request. |
| The commit message of the auto-merge request. If a merge queue is required by the base branch, this value will be set by the merge queue when merging. |
| The commit title of the auto-merge request. If a merge queue is required by the base branch, this value will be set by the merge queue when merging. |
| When was this auto-merge request was enabled. |
| The actor who created the auto-merge request. |
| The merge method of the auto-merge request. If a merge queue is required by the base branch, this value will be set by the merge queue when merging. |
| The pull request that this auto-merge request is set against. |
AutoRebaseEnabledEvent
Represents aauto_rebase_enabled
event on a given pull request.
AutoRebaseEnabledEvent
Implements
Fields for AutoRebaseEnabledEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| The user who enabled auto-merge (rebase) for this Pull Request. |
| The Node ID of the AutoRebaseEnabledEvent object. |
| PullRequest referenced by event. |
AutoSquashEnabledEvent
Represents aauto_squash_enabled
event on a given pull request.
AutoSquashEnabledEvent
Implements
Fields for AutoSquashEnabledEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| The user who enabled auto-merge (squash) for this Pull Request. |
| The Node ID of the AutoSquashEnabledEvent object. |
| PullRequest referenced by event. |
AutomaticBaseChangeFailedEvent
Represents aautomatic_base_change_failed
event on a given pull request.
AutomaticBaseChangeFailedEvent
Implements
Fields for AutomaticBaseChangeFailedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| The Node ID of the AutomaticBaseChangeFailedEvent object. |
| The new base for this PR. |
| The old base for this PR. |
| PullRequest referenced by event. |
AutomaticBaseChangeSucceededEvent
Represents aautomatic_base_change_succeeded
event on a given pull request.
AutomaticBaseChangeSucceededEvent
Implements
Fields for AutomaticBaseChangeSucceededEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| The Node ID of the AutomaticBaseChangeSucceededEvent object. |
| The new base for this PR. |
| The old base for this PR. |
| PullRequest referenced by event. |
BaseRefChangedEvent
Represents abase_ref_changed
event on a given issue or pull request.
BaseRefChangedEvent
Implements
Fields for BaseRefChangedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| Identifies the name of the base ref for the pull request after it was changed. |
| Identifies the primary key from the database. |
| The Node ID of the BaseRefChangedEvent object. |
| Identifies the name of the base ref for the pull request before it was changed. |
| PullRequest referenced by event. |
BaseRefDeletedEvent
Represents abase_ref_deleted
event on a given pull request.
BaseRefDeletedEvent
Implements
Fields for BaseRefDeletedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the name of the Ref associated with the |
| Identifies the date and time when the object was created. |
| The Node ID of the BaseRefDeletedEvent object. |
| PullRequest referenced by event. |
BaseRefForcePushedEvent
Represents abase_ref_force_pushed
event on a given pull request.
BaseRefForcePushedEvent
Implements
Fields for BaseRefForcePushedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the after commit SHA for the |
| Identifies the before commit SHA for the |
| Identifies the date and time when the object was created. |
| The Node ID of the BaseRefForcePushedEvent object. |
| PullRequest referenced by event. |
| Identifies the fully qualified ref name for the |
Blame
Represents a Git blame.
Fields for Blame
Name | Description |
---|---|
| The list of ranges from a Git blame. |
BlameRange
Represents a range of information from a Git blame.
Fields for BlameRange
Name | Description |
---|---|
| Identifies the recency of the change, from 1 (new) to 10 (old). This is calculated as a 2-quantile and determines the length of distance between the median age of all the changes in the file and the recency of the current range's change. |
| Identifies the line author. |
| The ending line for the range. |
| The starting line for the range. |
Blob
Represents a Git blob.
Blob
Implements
Fields for Blob
Name | Description |
---|---|
| An abbreviated version of the Git object ID. |
| Byte size of Blob object. |
| The HTTP path for this Git object. |
| The HTTP URL for this Git object. |
| The Node ID of the Blob object. |
| Indicates whether the Blob is binary or text. Returns null if unable to determine the encoding. |
| Indicates whether the contents is truncated. |
| The Git object ID. |
| The Repository the Git object belongs to. |
| UTF8 text data or null if the Blob is binary. |
BlockedByAddedEvent
Represents ablocked_by_added
event on a given issue.
BlockedByAddedEvent
Implements
Fields for BlockedByAddedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| The blocking issue that was added. |
| Identifies the date and time when the object was created. |
| The Node ID of the BlockedByAddedEvent object. |
BlockedByRemovedEvent
Represents ablocked_by_removed
event on a given issue.
BlockedByRemovedEvent
Implements
Fields for BlockedByRemovedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| The blocking issue that was removed. |
| Identifies the date and time when the object was created. |
| The Node ID of the BlockedByRemovedEvent object. |
BlockingAddedEvent
Represents ablocking_added
event on a given issue.
BlockingAddedEvent
Implements
Fields for BlockingAddedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| The blocked issue that was added. |
| Identifies the date and time when the object was created. |
| The Node ID of the BlockingAddedEvent object. |
BlockingRemovedEvent
Represents ablocking_removed
event on a given issue.
BlockingRemovedEvent
Implements
Fields for BlockingRemovedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| The blocked issue that was removed. |
| Identifies the date and time when the object was created. |
| The Node ID of the BlockingRemovedEvent object. |
Bot
A special type of user which takes actions on behalf of GitHub Apps.
Bot
Implements
Fields for Bot
Name | Description |
---|---|
| A URL pointing to the GitHub App's public avatar. Arguments for
|
| Identifies the date and time when the object was created. |
| Identifies the primary key from the database. |
| The Node ID of the Bot object. |
| The username of the actor. |
| The HTTP path for this bot. |
| Identifies the date and time when the object was last updated. |
| The HTTP URL for this bot. |
BranchNamePatternParameters
Parameters to be used for the branch_name_pattern rule.
BranchProtectionRule
A branch protection rule.
BranchProtectionRule
Implements
Fields for BranchProtectionRule
Name | Description |
---|---|
| Can this branch be deleted. |
| Are force pushes allowed on this branch. |
| Is branch creation a protected operation. |
| A list of conflicts matching branches protection rule and other branch protection rules. Arguments for
|
| A list of actors able to force push for this branch protection rule. Arguments for
|
| A list of actors able to bypass PRs for this branch protection rule. Arguments for
|
| The actor who created this branch protection rule. |
| Identifies the primary key from the database. |
| Will new commits pushed to matching branches dismiss pull request review approvals. |
| The Node ID of the BranchProtectionRule object. |
| Can admins override branch protection. |
| Whether users can pull changes from upstream when the branch is locked. Set to
|
| Whether to set the branch as read-only. If this is true, users will not be able to push to the branch. |
| Repository refs that are protected by this rule. Arguments for
|
| Identifies the protection rule pattern. |
| A list push allowances for this branch protection rule. Arguments for
|
| The repository associated with this branch protection rule. |
| Whether the most recent push must be approved by someone other than the person who pushed it. |
| Number of approving reviews required to update matching branches. |
| List of required deployment environments that must be deployed successfully to update matching branches. |
| List of required status check contexts that must pass for commits to be accepted to matching branches. |
| List of required status checks that must pass for commits to be accepted to matching branches. |
| Are approving reviews required to update matching branches. |
| Are reviews from code owners required to update matching branches. |
| Are commits required to be signed. |
| Are conversations required to be resolved before merging. |
| Does this branch require deployment to specific environments before merging. |
| Are merge commits prohibited from being pushed to this branch. |
| Are status checks required to update matching branches. |
| Are branches required to be up to date before merging. |
| Is pushing to matching branches restricted. |
| Is dismissal of pull request reviews restricted. |
| A list review dismissal allowances for this branch protection rule. Arguments for
|
BranchProtectionRuleConflict
A conflict between two branch protection rules.
Fields for BranchProtectionRuleConflict
Name | Description |
---|---|
| Identifies the branch protection rule. |
| Identifies the conflicting branch protection rule. |
| Identifies the branch ref that has conflicting rules. |
BranchProtectionRuleConflictConnection
The connection type for BranchProtectionRuleConflict.
Fields for BranchProtectionRuleConflictConnection
Name | Description |
---|---|
A list of edges. | |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
BranchProtectionRuleConflictEdge
An edge in a connection.
Fields for BranchProtectionRuleConflictEdge
Name | Description |
---|---|
| A cursor for use in pagination. |
| The item at the end of the edge. |
BranchProtectionRuleConnection
The connection type for BranchProtectionRule.
Fields for BranchProtectionRuleConnection
Name | Description |
---|---|
| A list of edges. |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
BranchProtectionRuleEdge
An edge in a connection.
Fields for BranchProtectionRuleEdge
Name | Description |
---|---|
| A cursor for use in pagination. |
| The item at the end of the edge. |
BypassForcePushAllowance
A user, team, or app who has the ability to bypass a force push requirement on a protected branch.
BypassForcePushAllowance
Implements
Fields for BypassForcePushAllowance
Name | Description |
---|---|
| The actor that can force push. |
| Identifies the branch protection rule associated with the allowed user, team, or app. |
| The Node ID of the BypassForcePushAllowance object. |
BypassForcePushAllowanceConnection
The connection type for BypassForcePushAllowance.
Fields for BypassForcePushAllowanceConnection
Name | Description |
---|---|
| A list of edges. |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
BypassForcePushAllowanceEdge
An edge in a connection.
Fields for BypassForcePushAllowanceEdge
Name | Description |
---|---|
| A cursor for use in pagination. |
| The item at the end of the edge. |
BypassPullRequestAllowance
A user, team, or app who has the ability to bypass a pull request requirement on a protected branch.
BypassPullRequestAllowance
Implements
Fields for BypassPullRequestAllowance
Name | Description |
---|---|
| The actor that can bypass. |
| Identifies the branch protection rule associated with the allowed user, team, or app. |
| The Node ID of the BypassPullRequestAllowance object. |
BypassPullRequestAllowanceConnection
The connection type for BypassPullRequestAllowance.
Fields for BypassPullRequestAllowanceConnection
Name | Description |
---|---|
| A list of edges. |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
BypassPullRequestAllowanceEdge
An edge in a connection.
Fields for BypassPullRequestAllowanceEdge
Name | Description |
---|---|
| A cursor for use in pagination. |
| The item at the end of the edge. |
CVSS
The Common Vulnerability Scoring System.
CWE
A common weakness enumeration.
CWEConnection
The connection type for CWE.
CWEEdge
An edge in a connection.
CheckAnnotation
A single check annotation.
Fields for CheckAnnotation
Name | Description |
---|---|
| The annotation's severity level. |
| The path to the file that this annotation was made on. |
| Identifies the primary key from the database. |
| The position of this annotation. |
| The annotation's message. |
| The path that this annotation was made on. |
| Additional information about the annotation. |
| The annotation's title. |
CheckAnnotationConnection
The connection type for CheckAnnotation.
Fields for CheckAnnotationConnection
Name | Description |
---|---|
| A list of edges. |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
CheckAnnotationEdge
An edge in a connection.
Fields for CheckAnnotationEdge
Name | Description |
---|---|
| A cursor for use in pagination. |
| The item at the end of the edge. |
CheckAnnotationPosition
A character position in a check annotation.
CheckAnnotationSpan
An inclusive pair of positions for a check annotation.
Fields for CheckAnnotationSpan
Name | Description |
---|---|
| End position (inclusive). |
| Start position (inclusive). |
CheckRun
A check run.
CheckRun
Implements
Fields for CheckRun
Name | Description |
---|---|
| The check run's annotations. Arguments for
|
| The check suite that this run is a part of. |
| Identifies the date and time when the check run was completed. |
| The conclusion of the check run. |
| Identifies the primary key from the database. |
| The corresponding deployment for this job, if any. |
| The URL from which to find full details of the check run on the integrator's site. |
| A reference for the check run on the integrator's system. |
| The Node ID of the CheckRun object. |
| Whether this is required to pass before merging for a specific pull request. |
| The name of the check for this check run. |
| Information about a pending deployment, if any, in this check run. |
| The permalink to the check run summary. |
| The repository associated with this check run. |
| The HTTP path for this check run. |
| Identifies the date and time when the check run was started. |
| The current status of the check run. |
| The check run's steps. Arguments for
|
| A string representing the check run's summary. |
| A string representing the check run's text. |
| A string representing the check run. |
| The HTTP URL for this check run. |
CheckRunConnection
The connection type for CheckRun.
Fields for CheckRunConnection
Name | Description |
---|---|
| A list of edges. |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
CheckRunEdge
An edge in a connection.
CheckRunStateCount
Represents a count of the state of a check run.
Fields for CheckRunStateCount
Name | Description |
---|---|
| The number of check runs with this state. |
| The state of a check run. |
CheckStep
A single check step.
Fields for CheckStep
Name | Description |
---|---|
| Identifies the date and time when the check step was completed. |
| The conclusion of the check step. |
| A reference for the check step on the integrator's system. |
| The step's name. |
| The index of the step in the list of steps of the parent check run. |
| Number of seconds to completion. |
| Identifies the date and time when the check step was started. |
| The current status of the check step. |
CheckStepConnection
The connection type for CheckStep.
Fields for CheckStepConnection
Name | Description |
---|---|
| A list of edges. |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
CheckStepEdge
An edge in a connection.
CheckSuite
A check suite.
CheckSuite
Implements
Fields for CheckSuite
Name | Description |
---|---|
| The GitHub App which created this check suite. |
| The name of the branch for this check suite. |
| The check runs associated with a check suite. Arguments for
|
| The commit for this check suite. |
| The conclusion of this check suite. |
| Identifies the date and time when the object was created. |
| The user who triggered the check suite. |
| Identifies the primary key from the database. |
| The Node ID of the CheckSuite object. |
| A list of open pull requests matching the check suite. Arguments for
|
| The push that triggered this check suite. |
| The repository associated with this check suite. |
| The HTTP path for this check suite. |
| The status of this check suite. |
| Identifies the date and time when the object was last updated. |
| The HTTP URL for this check suite. |
| The workflow run associated with this check suite. |
CheckSuiteConnection
The connection type for CheckSuite.
Fields for CheckSuiteConnection
Name | Description |
---|---|
| A list of edges. |
| A list of nodes. |
| Information to aid in pagination. |
| Identifies the total count of items in the connection. |
CheckSuiteEdge
An edge in a connection.
Fields for CheckSuiteEdge
Name | Description |
---|---|
| A cursor for use in pagination. |
| The item at the end of the edge. |
ClosedEvent
Represents aclosed
event on any Closable
.
ClosedEvent
Implements
Fields for ClosedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Object that was closed. |
| Object which triggered the creation of this event. |
| Identifies the date and time when the object was created. |
| The issue or pull request that this issue was marked as a duplicate of. |
| The Node ID of the ClosedEvent object. |
| The HTTP path for this closed event. |
| The reason the issue state was changed to closed. |
| The HTTP URL for this closed event. |
CodeOfConduct
The Code of Conduct for a repository.
CodeOfConduct
Implements
Fields for CodeOfConduct
Name | Description |
---|---|
| The body of the Code of Conduct. |
| The Node ID of the CodeOfConduct object. |
| The key for the Code of Conduct. |
| The formal name of the Code of Conduct. |
| The HTTP path for this Code of Conduct. |
| The HTTP URL for this Code of Conduct. |
CodeScanningParameters
Choose which tools must provide code scanning results before the reference is updated. When configured, code scanning must be enabled and have results for both the commit and the reference being updated.
Fields for CodeScanningParameters
Name | Description |
---|---|
| Tools that must provide code scanning results for this rule to pass. |
CodeScanningTool
A tool that must provide code scanning results for this rule to pass.
Fields for CodeScanningTool
Name | Description |
---|---|
| The severity level at which code scanning results that raise alerts block a reference update. For more information on alert severity levels, see "About code scanning alerts.". |
| The severity level at which code scanning results that raise security alerts block a reference update. For more information on security severity levels, see "About code scanning alerts.". |
| The name of a code scanning tool. |
CommentDeletedEvent
Represents acomment_deleted
event on a given issue or pull request.
CommentDeletedEvent
Implements
Fields for CommentDeletedEvent
Name | Description |
---|---|
| Identifies the actor who performed the event. |
| Identifies the date and time when the object was created. |
| Identifies the primary key from the database. |
| The user who authored the deleted comment. |
| The Node ID of the CommentDeletedEvent object. |
Commit
Represents a Git commit.
Commit
Implements
Fields for Commit
Name | Description |
---|---|
| An abbreviated version of the Git object ID. |
| The number of additions in this commit. |
| The merged Pull Request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open Pull Requests associated with the commit. Arguments for
|