Objects

In this article

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."

ActorLocation

Location information for an actor.

Fields

Name Description

city (String)

City.

country (String)

Country name.

countryCode (String)

Country code.

region (String)

Region name.

regionCode (String)

Region or state code.


AddedToProjectEvent

Represents aadded_to_projectevent on a given issue or pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

databaseId (Int)

Identifies the primary key from the database.

project (Project)

Project referenced by event.

Preview notice

project is available under the Project event details preview. During the preview period, the API may change without notice.

projectCard (ProjectCard)

Project card referenced by this project event.

Preview notice

projectCard is available under the Project event details preview. During the preview period, the API may change without notice.

projectColumnName (String!)

Column name referenced by this project event.

Preview notice

projectColumnName is available under the Project event details preview. During the preview period, the API may change without notice.


App

A GitHub App.

Fields

Name Description

createdAt (DateTime!)

Identifies the date and time when the object was created.

databaseId (Int)

Identifies the primary key from the database.

description (String)

The description of the app.

ipAllowListEntries (IpAllowListEntryConnection!)

The IP addresses of the app.

Arguments

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

orderBy (IpAllowListEntryOrder)

Ordering options for IP allow list entries returned.

logoBackgroundColor (String!)

The hex color code, without the leading '#', for the logo background.

logoUrl (URI!)

A URL pointing to the app's logo.

Arguments

size (Int)

The size of the resulting image.

name (String!)

The name of the app.

slug (String!)

A slug based on the name of the app for use in URLs.

updatedAt (DateTime!)

Identifies the date and time when the object was last updated.

url (URI!)

The URL to the app's homepage.


AssignedEvent

Represents anassignedevent on any assignable object.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

assignable (Assignable!)

Identifies the assignable associated with the event.

assignee (Assignee)

Identifies the user or mannequin that was assigned.

createdAt (DateTime!)

Identifies the date and time when the object was created.

user (User)

Identifies the user who was assigned.

Deprecation notice

user is deprecated.

Assignees can now be mannequins. Use the assignee field instead. Removal on 2020-01-01 UTC.


AutoMergeDisabledEvent

Represents aauto_merge_disabledevent on a given pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

disabler (User)

The user who disabled auto-merge for this Pull Request.

pullRequest (PullRequest)

PullRequest referenced by event.

reason (String)

The reason auto-merge was disabled.

reasonCode (String)

The reason_code relating to why auto-merge was disabled.


AutoMergeEnabledEvent

Represents aauto_merge_enabledevent on a given pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

enabler (User)

The user who enabled auto-merge for this Pull Request.

pullRequest (PullRequest)

PullRequest referenced by event.


AutoMergeRequest

Represents an auto-merge request for a pull request.

Fields

Name Description

authorEmail (String)

The email address of the author of this auto-merge request.

commitBody (String)

The commit message of the auto-merge request.

commitHeadline (String)

The commit title of the auto-merge request.

enabledAt (DateTime)

When was this auto-merge request was enabled.

enabledBy (Actor)

The actor who created the auto-merge request.

mergeMethod (PullRequestMergeMethod!)

The merge method of the auto-merge request.

pullRequest (PullRequest!)

The pull request that this auto-merge request is set against.


AutoRebaseEnabledEvent

Represents aauto_rebase_enabledevent on a given pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

enabler (User)

The user who enabled auto-merge (rebase) for this Pull Request.

pullRequest (PullRequest)

PullRequest referenced by event.


AutoSquashEnabledEvent

Represents aauto_squash_enabledevent on a given pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

enabler (User)

The user who enabled auto-merge (squash) for this Pull Request.

pullRequest (PullRequest)

PullRequest referenced by event.


AutomaticBaseChangeFailedEvent

Represents aautomatic_base_change_failedevent on a given pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

newBase (String!)

The new base for this PR.

oldBase (String!)

The old base for this PR.

pullRequest (PullRequest!)

PullRequest referenced by event.


AutomaticBaseChangeSucceededEvent

Represents aautomatic_base_change_succeededevent on a given pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

newBase (String!)

The new base for this PR.

oldBase (String!)

The old base for this PR.

pullRequest (PullRequest!)

PullRequest referenced by event.


BaseRefChangedEvent

Represents abase_ref_changedevent on a given issue or pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

currentRefName (String!)

Identifies the name of the base ref for the pull request after it was changed.

databaseId (Int)

Identifies the primary key from the database.

previousRefName (String!)

Identifies the name of the base ref for the pull request before it was changed.

pullRequest (PullRequest!)

PullRequest referenced by event.


BaseRefDeletedEvent

Represents abase_ref_deletedevent on a given pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

baseRefName (String)

Identifies the name of the Ref associated with the base_ref_deleted event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

pullRequest (PullRequest)

PullRequest referenced by event.


BaseRefForcePushedEvent

Represents abase_ref_force_pushedevent on a given pull request.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

afterCommit (Commit)

Identifies the after commit SHA for thebase_ref_force_pushedevent.

beforeCommit (Commit)

Identifies the before commit SHA for thebase_ref_force_pushedevent.

createdAt (DateTime!)

Identifies the date and time when the object was created.

pullRequest (PullRequest!)

PullRequest referenced by event.

ref (Ref)

Identifies the fully qualified ref name for thebase_ref_force_pushedevent.


Blame

Represents a Git blame.

Fields

Name Description

ranges ([BlameRange!]!)

The list of ranges from a Git blame.


BlameRange

Represents a range of information from a Git blame.

Fields

Name Description

age (Int!)

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.

commit (Commit!)

Identifies the line author.

endingLine (Int!)

The ending line for the range.

startingLine (Int!)

The starting line for the range.


Blob

Represents a Git blob.

Fields

Name Description

abbreviatedOid (String!)

An abbreviated version of the Git object ID.

byteSize (Int!)

Byte size of Blob object.

commitResourcePath (URI!)

The HTTP path for this Git object.

commitUrl (URI!)

The HTTP URL for this Git object.

isBinary (Boolean)

Indicates whether the Blob is binary or text. Returns null if unable to determine the encoding.

isTruncated (Boolean!)

Indicates whether the contents is truncated.

oid (GitObjectID!)

The Git object ID.

repository (Repository!)

The Repository the Git object belongs to.

text (String)

UTF8 text data or null if the Blob is binary.


Bot

A special type of user which takes actions on behalf of GitHub Apps.

Fields

Name Description

avatarUrl (URI!)

A URL pointing to the GitHub App's public avatar.

Arguments

size (Int)

The size of the resulting square image.

createdAt (DateTime!)

Identifies the date and time when the object was created.

databaseId (Int)

Identifies the primary key from the database.

login (String!)

The username of the actor.

resourcePath (URI!)

The HTTP path for this bot.

updatedAt (DateTime!)

Identifies the date and time when the object was last updated.

url (URI!)

The HTTP URL for this bot.


BranchProtectionRule

A branch protection rule.

Fields

Name Description

allowsDeletions (Boolean!)

Can this branch be deleted.

allowsForcePushes (Boolean!)

Are force pushes allowed on this branch.

branchProtectionRuleConflicts (BranchProtectionRuleConflictConnection!)

A list of conflicts matching branches protection rule and other branch protection rules.

Arguments

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

bypassForcePushAllowances (BypassForcePushAllowanceConnection!)

A list of actors able to force push for this branch protection rule.

Arguments

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

bypassPullRequestAllowances (BypassPullRequestAllowanceConnection!)

A list of actors able to bypass PRs for this branch protection rule.

Arguments

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

creator (Actor)

The actor who created this branch protection rule.

databaseId (Int)

Identifies the primary key from the database.

dismissesStaleReviews (Boolean!)

Will new commits pushed to matching branches dismiss pull request review approvals.

isAdminEnforced (Boolean!)

Can admins overwrite branch protection.

matchingRefs (RefConnection!)

Repository refs that are protected by this rule.

Arguments

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

query (String)

Filters refs with query on name.

pattern (String!)

Identifies the protection rule pattern.

pushAllowances (PushAllowanceConnection!)

A list push allowances for this branch protection rule.

Arguments

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

repository (Repository)

The repository associated with this branch protection rule.

requiredApprovingReviewCount (Int)

Number of approving reviews required to update matching branches.

requiredStatusCheckContexts ([String])

List of required status check contexts that must pass for commits to be accepted to matching branches.

requiredStatusChecks ([RequiredStatusCheckDescription!])

List of required status checks that must pass for commits to be accepted to matching branches.

requiresApprovingReviews (Boolean!)

Are approving reviews required to update matching branches.

requiresCodeOwnerReviews (Boolean!)

Are reviews from code owners required to update matching branches.

requiresCommitSignatures (Boolean!)

Are commits required to be signed.

requiresConversationResolution (Boolean!)

Are conversations required to be resolved before merging.

requiresLinearHistory (Boolean!)

Are merge commits prohibited from being pushed to this branch.

requiresStatusChecks (Boolean!)

Are status checks required to update matching branches.

requiresStrictStatusChecks (Boolean!)

Are branches required to be up to date before merging.

restrictsPushes (Boolean!)

Is pushing to matching branches restricted.

restrictsReviewDismissals (Boolean!)

Is dismissal of pull request reviews restricted.

reviewDismissalAllowances (ReviewDismissalAllowanceConnection!)

A list review dismissal allowances for this branch protection rule.

Arguments

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.


BranchProtectionRuleConflict

A conflict between two branch protection rules.

Fields

Name Description

branchProtectionRule (BranchProtectionRule)

Identifies the branch protection rule.

conflictingBranchProtectionRule (BranchProtectionRule)

Identifies the conflicting branch protection rule.

ref (Ref)

Identifies the branch ref that has conflicting rules.


BranchProtectionRuleConflictConnection

The connection type for BranchProtectionRuleConflict.

Fields

Name Description

edges ([BranchProtectionRuleConflictEdge])

A list of edges.

nodes ([BranchProtectionRuleConflict])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


BranchProtectionRuleConflictEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (BranchProtectionRuleConflict)

The item at the end of the edge.


BranchProtectionRuleConnection

The connection type for BranchProtectionRule.

Fields

Name Description

edges ([BranchProtectionRuleEdge])

A list of edges.

nodes ([BranchProtectionRule])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


BranchProtectionRuleEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (BranchProtectionRule)

The item at the end of the edge.


BypassForcePushAllowance

A team or user who has the ability to bypass a force push requirement on a protected branch.

Fields

Name Description

actor (BranchActorAllowanceActor)

The actor that can dismiss.

branchProtectionRule (BranchProtectionRule)

Identifies the branch protection rule associated with the allowed user or team.


BypassForcePushAllowanceConnection

The connection type for BypassForcePushAllowance.

Fields

Name Description

edges ([BypassForcePushAllowanceEdge])

A list of edges.

nodes ([BypassForcePushAllowance])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


BypassForcePushAllowanceEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (BypassForcePushAllowance)

The item at the end of the edge.


BypassPullRequestAllowance

A team or user who has the ability to bypass a pull request requirement on a protected branch.

Fields

Name Description

actor (BranchActorAllowanceActor)

The actor that can dismiss.

branchProtectionRule (BranchProtectionRule)

Identifies the branch protection rule associated with the allowed user or team.


BypassPullRequestAllowanceConnection

The connection type for BypassPullRequestAllowance.

Fields

Name Description

edges ([BypassPullRequestAllowanceEdge])

A list of edges.

nodes ([BypassPullRequestAllowance])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


BypassPullRequestAllowanceEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (BypassPullRequestAllowance)

The item at the end of the edge.


CVSS

The Common Vulnerability Scoring System.

Fields

Name Description

score (Float!)

The CVSS score associated with this advisory.

vectorString (String)

The CVSS vector string associated with this advisory.


CWE

A common weakness enumeration.

Fields

Name Description

cweId (String!)

The id of the CWE.

description (String!)

A detailed description of this CWE.

name (String!)

The name of this CWE.


CWEConnection

The connection type for CWE.

Fields

Name Description

edges ([CWEEdge])

A list of edges.

nodes ([CWE])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


CWEEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (CWE)

The item at the end of the edge.


CheckAnnotation

A single check annotation.

Fields

Name Description

annotationLevel (CheckAnnotationLevel)

The annotation's severity level.

blobUrl (URI!)

The path to the file that this annotation was made on.

databaseId (Int)

Identifies the primary key from the database.

location (CheckAnnotationSpan!)

The position of this annotation.

message (String!)

The annotation's message.

path (String!)

The path that this annotation was made on.

rawDetails (String)

Additional information about the annotation.

title (String)

The annotation's title.


CheckAnnotationConnection

The connection type for CheckAnnotation.

Fields

Name Description

edges ([CheckAnnotationEdge])

A list of edges.

nodes ([CheckAnnotation])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


CheckAnnotationEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (CheckAnnotation)

The item at the end of the edge.


CheckAnnotationPosition

A character position in a check annotation.

Fields

Name Description

column (Int)

Column number (1 indexed).

line (Int!)

Line number (1 indexed).


CheckAnnotationSpan

An inclusive pair of positions for a check annotation.

Fields

Name Description

end (CheckAnnotationPosition!)

End position (inclusive).

start (CheckAnnotationPosition!)

Start position (inclusive).


CheckRun

A check run.

Fields

Name Description

annotations (CheckAnnotationConnection)

The check run's annotations.

Arguments

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

checkSuite (CheckSuite!)

The check suite that this run is a part of.

completedAt (