Objects

In this article

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.

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.

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.


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.

databaseId (Int)

Identifies the primary key from the database.


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.

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

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.

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.

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.

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.


CheckAnnotation

A single check annotation.

Preview notice

CheckAnnotation is available under the Checks preview. During the preview period, the API may change without notice.

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.

Preview notice

nodes is available under the Checks preview. During the preview period, the API may change without notice.

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.

Preview notice

node is available under the Checks preview. During the preview period, the API may change without notice.


CheckAnnotationPosition

A character position in a check annotation.

Preview notice

CheckAnnotationPosition is available under the Checks preview. During the preview period, the API may change without notice.

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.

Preview notice

CheckAnnotationSpan is available under the Checks preview. During the preview period, the API may change without notice.

Fields

Name Description

end (CheckAnnotationPosition!)

End position (inclusive).

start (CheckAnnotationPosition!)

Start position (inclusive).


CheckRun

A check run.

Preview notice

CheckRun is available under the Checks preview. During the preview period, the API may change without notice.

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 (DateTime)

Identifies the date and time when the check run was completed.

conclusion (CheckConclusionState)

The conclusion of the check run.

databaseId (Int)

Identifies the primary key from the database.

detailsUrl (URI)

The URL from which to find full details of the check run on the integrator's site.

externalId (String)

A reference for the check run on the integrator's system.

name (String!)

The name of the check for this check run.

permalink (URI!)

The permalink to the check run summary.

repository (Repository!)

The repository associated with this check run.

resourcePath (URI!)

The HTTP path for this check run.

startedAt (DateTime)

Identifies the date and time when the check run was started.

status (CheckStatusState!)

The current status of the check run.

summary (String)

A string representing the check run's summary.

text (String)

A string representing the check run's text.

title (String)

A string representing the check run.

url (URI!)

The HTTP URL for this check run.


CheckRunConnection

The connection type for CheckRun.

Fields

Name Description

edges ([CheckRunEdge])

A list of edges.

nodes ([CheckRun])

A list of nodes.

Preview notice

nodes is available under the Checks preview. During the preview period, the API may change without notice.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


CheckRunEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (CheckRun)

The item at the end of the edge.

Preview notice

node is available under the Checks preview. During the preview period, the API may change without notice.


CheckSuite

A check suite.

Preview notice

CheckSuite is available under the Checks preview. During the preview period, the API may change without notice.

Fields

Name Description

app (App)

The GitHub App which created this check suite.

branch (Ref)

The name of the branch for this check suite.

checkRuns (CheckRunConnection)

The check runs associated with a check suite.

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.

filterBy (CheckRunFilter)

Filters the check runs by this type.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

commit (Commit!)

The commit for this check suite.

conclusion (CheckConclusionState)

The conclusion of this check suite.

createdAt (DateTime!)

Identifies the date and time when the object was created.

databaseId (Int)

Identifies the primary key from the database.

matchingPullRequests (PullRequestConnection)

A list of open pull requests matching the check suite.

Arguments

after (String)

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

baseRefName (String)

The base ref name to filter the pull requests by.

before (String)

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

first (Int)

Returns the first n elements from the list.

headRefName (String)

The head ref name to filter the pull requests by.

labels ([String!])

A list of label names to filter the pull requests by.

last (Int)

Returns the last n elements from the list.

orderBy (IssueOrder)

Ordering options for pull requests returned from the connection.

states ([PullRequestState!])

A list of states to filter the pull requests by.

push (Push)

The push that triggered this check suite.

repository (Repository!)

The repository associated with this check suite.

resourcePath (URI!)

The HTTP path for this check suite.

status (CheckStatusState!)

The status of this check suite.

updatedAt (DateTime!)

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

url (URI!)

The HTTP URL for this check suite.


CheckSuiteConnection

The connection type for CheckSuite.

Fields

Name Description

edges ([CheckSuiteEdge])

A list of edges.

nodes ([CheckSuite])

A list of nodes.

Preview notice

nodes is available under the Checks preview. During the preview period, the API may change without notice.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


CheckSuiteEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (CheckSuite)

The item at the end of the edge.

Preview notice

node is available under the Checks preview. During the preview period, the API may change without notice.


ClosedEvent

Represents aclosedevent on any Closable.

Fields

Name Description

actor (Actor)

Identifies the actor who performed the event.

closable (Closable!)

Object that was closed.

closer (Closer)

Object which triggered the creation of this event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

resourcePath (URI!)

The HTTP path for this closed event.

url (URI!)

The HTTP URL for this closed event.


CodeOfConduct

The Code of Conduct for a repository.

Fields

Name Description

body (String)

The body of the Code of Conduct.

key (String!)

The key for the Code of Conduct.

name (String!)

The formal name of the Code of Conduct.

resourcePath (URI)

The HTTP path for this Code of Conduct.

url (URI)

The HTTP URL for this Code of Conduct.


CommentDeletedEvent

Represents acomment_deletedevent 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.


Commit

Represents a Git commit.

Fields

Name Description

abbreviatedOid (String!)

An abbreviated version of the Git object ID.

additions (Int!)

The number of additions in this commit.

associatedPullRequests (PullRequestConnection)

The pull requests associated with a commit.

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 (PullRequestOrder)

Ordering options for pull requests.

author (GitActor)

Authorship details of the commit.

authoredByCommitter (Boolean!)

Check if the committer and the author match.

authoredDate (DateTime!)

The datetime when this commit was authored.

blame (Blame!)

Fetches git blame information.

Arguments

path (String!)

The file whose Git blame information you want.

changedFiles (Int!)

The number of changed files in this commit.

checkSuites (CheckSuiteConnection)

The check suites associated with a commit.

Preview notice

checkSuites is available under the Checks preview. During the preview period, the API may change without notice.

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.

filterBy (CheckSuiteFilter)

Filters the check suites by this type.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

comments (CommitCommentConnection!)

Comments made on the commit.

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.

commitResourcePath (URI!)

The HTTP path for this Git object.

commitUrl (URI!)

The HTTP URL for this Git object.

committedDate (DateTime!)

The datetime when this commit was committed.

committedViaWeb (Boolean!)

Check if commited via GitHub web UI.

committer (GitActor)

Committership details of the commit.

deletions (Int!)

The number of deletions in this commit.

deployments (DeploymentConnection)

The deployments associated with a commit.

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.

environments ([String!])

Environments to list deployments for.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

orderBy (DeploymentOrder)

Ordering options for deployments returned from the connection.

history (CommitHistoryConnection!)

The linear commit history starting from (and including) this commit, in the same order as git log.

Arguments

after (String)

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

author (CommitAuthor)

If non-null, filters history to only show commits with matching authorship.

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.

path (String)

If non-null, filters history to only show commits touching files under this path.

since (GitTimestamp)

Allows specifying a beginning time or date for fetching commits.

until (GitTimestamp)

Allows specifying an ending time or date for fetching commits.

message (String!)

The Git commit message.

messageBody (String!)

The Git commit message body.

messageBodyHTML (HTML!)

The commit message body rendered to HTML.

messageHeadline (String!)

The Git commit message headline.

messageHeadlineHTML (HTML!)

The commit message headline rendered to HTML.

oid (GitObjectID!)

The Git object ID.

onBehalfOf (Organization)

The organization this commit was made on behalf of.

parents (CommitConnection!)

The parents of a commit.

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.

pushedDate (DateTime)

The datetime when this commit was pushed.

repository (Repository!)

The Repository this commit belongs to.

resourcePath (URI!)

The HTTP path for this commit.

signature (GitSignature)

Commit signing information, if present.

status (Status)

Status information for this commit.

statusCheckRollup (StatusCheckRollup)

Check and Status rollup information for this commit.

submodules (SubmoduleConnection!)

Returns a list of all submodules in this repository as of this Commit parsed from the .gitmodules file.

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.

tarballUrl (URI!)

Returns a URL to download a tarball archive for a repository. Note: For private repositories, these links are temporary and expire after five minutes.

tree (Tree!)

Commit's root Tree.

treeResourcePath (URI!)

The HTTP path for the tree of this commit.

treeUrl (URI!)

The HTTP URL for the tree of this commit.

url (URI!)

The HTTP URL for this commit.

viewerCanSubscribe (Boolean!)

Check if the viewer is able to change their subscription status for the repository.

viewerSubscription (SubscriptionState)

Identifies if the viewer is watching, not watching, or ignoring the subscribable entity.

zipballUrl (URI!)

Returns a URL to download a zipball archive for a repository. Note: For private repositories, these links are temporary and expire after five minutes.


CommitComment

Represents a comment on a given Commit.

Fields

Name Description

author (Actor)

The actor who authored the comment.

authorAssociation (CommentAuthorAssociation!)

Author's association with the subject of the comment.

body (String!)

Identifies the comment body.

bodyHTML (HTML!)

The body rendered to HTML.

bodyText (String!)

The body rendered to text.

commit (Commit)

Identifies the commit associated with the comment, if the commit exists.

createdAt (DateTime!)

Identifies the date and time when the object was created.

createdViaEmail (Boolean!)

Check if this comment was created via an email reply.

databaseId (Int)

Identifies the primary key from the database.

editor (Actor)

The actor who edited the comment.

includesCreatedEdit (Boolean!)

Check if this comment was edited and includes an edit with the creation data.

isMinimized (Boolean!)

Returns whether or not a comment has been minimized.

lastEditedAt (DateTime)

The moment the editor made the last edit.

minimizedReason (String)

Returns why the comment was minimized.

path (String)

Identifies the file path associated with the comment.

position (Int)

Identifies the line position associated with the comment.

publishedAt (DateTime)

Identifies when the comment was published at.

reactionGroups ([ReactionGroup!])

A list of reactions grouped by content left on the subject.

reactions (ReactionConnection!)

A list of Reactions left on the Issue.

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.

content (ReactionContent)

Allows filtering Reactions by emoji.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

orderBy (ReactionOrder)

Allows specifying the order in which reactions are returned.

repository (Repository!)

The repository associated with this node.

resourcePath (URI!)

The HTTP path permalink for this commit comment.

updatedAt (DateTime!)

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

url (URI!)

The HTTP URL permalink for this commit comment.

userContentEdits (UserContentEditConnection)

A list of edits to this content.

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.

viewerCanDelete (Boolean!)

Check if the current viewer can delete this object.

viewerCanMinimize (Boolean!)

Check if the current viewer can minimize this object.

viewerCanReact (Boolean!)

Can user react to this subject.

viewerCanUpdate (Boolean!)

Check if the current viewer can update this object.

viewerCannotUpdateReasons ([CommentCannotUpdateReason!]!)

Reasons why the current viewer can not update this comment.

viewerDidAuthor (Boolean!)

Did the viewer author this comment.


CommitCommentConnection

The connection type for CommitComment.

Fields

Name Description

edges ([CommitCommentEdge])

A list of edges.

nodes ([CommitComment])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


CommitCommentEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (CommitComment)

The item at the end of the edge.


CommitCommentThread

A thread of comments on a commit.

Fields

Name Description

comments (CommitCommentConnection!)

The comments that exist in this thread.

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.

commit (Commit)

The commit the comments were made on.

path (String)

The file the comments were made on.

position (Int)

The position in the diff for the commit that the comment was made on.

repository (Repository!)

The repository associated with this node.


CommitConnection

The connection type for Commit.

Fields

Name Description

edges ([CommitEdge])

A list of edges.

nodes ([Commit])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


CommitContributionsByRepository

This aggregates commits made by a user within one repository.

Fields

Name Description

contributions (CreatedCommitContributionConnection!)

The commit contributions, each representing a day.

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 (CommitContributionOrder)

Ordering options for commit contributions returned from the connection.

repository (Repository!)

The repository in which the commits were made.

resourcePath (URI!)

The HTTP path for the user's commits to the repository in this time range.

url (URI!)

The HTTP URL for the user's commits to the repository in this time range.


CommitEdge

An edge in a connection.

Fields

Name Description

cursor (String!)

A cursor for use in pagination.

node (Commit)

The item at the end of the edge.


CommitHistoryConnection

The connection type for Commit.

Fields

Name Description

edges ([CommitEdge])

A list of edges.

nodes ([Commit])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.


ConnectedEvent

Represents aconnectedevent 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.

isCrossRepository (Boolean!)

Reference originated in a different repository.

source (ReferencedSubject!)

Issue or pull request that made the reference.

subject (ReferencedSubject!)

Issue or pull request which was connected.


ContentAttachment

A content attachment.

Fields

Name Description

body (String!)

The body text of the content attachment. This parameter supports markdown.

contentReference (ContentReference!)

The content reference that the content attachment is attached to.

databaseId (Int!)

Identifies the primary key from the database.

title (String!)

The title of the content attachment.


ContentReference

A content reference.

Fields

Name Description

databaseId (Int!)

Identifies the primary key from the database.

reference (String!)

The reference of the content reference.


ContributionCalendar

A calendar of contributions made on GitHub by a user.

Fields

Name Description

colors ([String!]!)

A list of hex color codes used in this calendar. The darker the color, the more contributions it represents.

isHalloween (Boolean!)

Determine if the color set was chosen because it's currently Halloween.

months ([ContributionCalendarMonth!]!)

A list of the months of contributions in this calendar.

totalContributions (Int!)

The count of total contributions in the calendar.

weeks ([ContributionCalendarWeek!]!)

A list of the weeks of contributions in this calendar.


ContributionCalendarDay

Represents a single day of contributions on GitHub by a user.

Fields

Name Description

color (String!)

The hex color code that represents how many contributions were made on this day compared to others in the calendar.

contributionCount (Int!)

How many contributions were made by the user on this day.

date (Date!)

The day this square represents.

weekday (Int!)

A number representing which day of the week this square represents, e.g., 1 is Monday.


ContributionCalendarMonth

A month of contributions in a user's contribution graph.

Fields

Name Description

firstDay (Date!)

The date of the first day of this month.

name (String!)

The name of the month.

totalWeeks (Int!)

How many weeks started in this month.

year (Int!)

The year the month occurred in.


ContributionCalendarWeek

A week of contributions in a user's contribution graph.

Fields

Name Description

contributionDays ([ContributionCalendarDay!]!)

The days of contributions in this week.

firstDay (Date!)

The date of the earliest square in this week.


ContributionsCollection

A contributions collection aggregates contributions such as opened issues and commits created by a user.

Fields

Name Description

commitContributionsByRepository ([CommitContributionsByRepository!]!)

Commit contributions made by the user, grouped by repository.

Arguments

maxRepositories (Int)

How many repositories should be included.

The default value is 25.

contributionCalendar (ContributionCalendar!)

A calendar of this user's contributions on GitHub.

contributionYears ([Int!]!)

The years the user has been making contributions with the most recent year first.

doesEndInCurrentMonth (Boolean!)

Determine if this collection's time span ends in the current month.

earliestRestrictedContributionDate (Date)

The date of the first restricted contribution the user made in this time period. Can only be non-null when the user has enabled private contribution counts.

endedAt (DateTime!)

The ending date and time of this collection.

firstIssueContribution (CreatedIssueOrRestrictedContribution)

The first issue the user opened on GitHub. This will be null if that issue was opened outside the collection's time range and ignoreTimeRange is false. If the issue is not visible but the user has opted to show private contributions, a RestrictedContribution will be returned.

firstPullRequestContribution (CreatedPullRequestOrRestrictedContribution)

The first pull request the user opened on GitHub. This will be null if that pull request was opened outside the collection's time range and ignoreTimeRange is not true. If the pull request is not visible but the user has opted to show private contributions, a RestrictedContribution will be returned.

firstRepositoryContribution (CreatedRepositoryOrRestrictedContribution)

The first repository the user created on GitHub. This will be null if that first repository was created outside the collection's time range and ignoreTimeRange is false. If the repository is not visible, then a RestrictedContribution is returned.

hasActivityInThePast (Boolean!)

Does the user have any more activity in the timeline that occurred prior to the collection's time range?.

hasAnyContributions (Boolean!)

Determine if there are any contributions in this collection.

hasAnyRestrictedContributions (Boolean!)

Determine if the user made any contributions in this time frame whose details are not visible because they were made in a private repository. Can only be true if the user enabled private contribution counts.

isSingleDay (Boolean!)

Whether or not the collector's time span is all within the same day.

issueContributions (CreatedIssueContributionConnection!)

A list of issues the user opened.

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.

excludeFirst (Boolean)

Should the user's first issue ever be excluded from the result.

The default value is false.

excludePopular (Boolean)

Should the user's most commented issue be excluded from the result.

The default value is false.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

orderBy (ContributionOrder)

Ordering options for contributions returned from the connection.

issueContributionsByRepository ([IssueContributionsByRepository!]!)

Issue contributions made by the user, grouped by repository.

Arguments

excludeFirst (Boolean)

Should the user's first issue ever be excluded from the result.

The default value is false.

excludePopular (Boolean)

Should the user's most commented issue be excluded from the result.

The default value is false.

maxRepositories (Int)

How many repositories should be included.

The default value is 25.

joinedGitHubContribution (JoinedGitHubContribution)

When the user signed up for GitHub. This will be null if that sign up date falls outside the collection's time range and ignoreTimeRange is false.

latestRestrictedContributionDate (Date)

The date of the most recent restricted contribution the user made in this time period. Can only be non-null when the user has enabled private contribution counts.

mostRecentCollectionWithActivity (ContributionsCollection)

When this collection's time range does not include any activity from the user, use this to get a different collection from an earlier time range that does have activity.

mostRecentCollectionWithoutActivity (ContributionsCollection)

Returns a different contributions collection from an earlier time range than this one that does not have any contributions.

popularIssueContribution (CreatedIssueContribution)

The issue the user opened on GitHub that received the most comments in the specified time frame.

popularPullRequestContribution (CreatedPullRequestContribution)

The pull request the user opened on GitHub that received the most comments in the specified time frame.

pullRequestContributions (CreatedPullRequestContributionConnection!)

Pull request contributions made by the user.

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.

excludeFirst (Boolean)

Should the user's first pull request ever be excluded from the result.

The default value is false.

excludePopular (Boolean)

Should the user's most commented pull request be excluded from the result.

The default value is false.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

orderBy (ContributionOrder)

Ordering options for contributions returned from the connection.

pullRequestContributionsByRepository ([PullRequestContributionsByRepository!]!)

Pull request contributions made by the user, grouped by repository.

Arguments

excludeFirst (Boolean)

Should the user's first pull request ever be excluded from the result.

The default value is false.

excludePopular (Boolean)

Should the user's most commented pull request be excluded from the result.

The default value is false.

maxRepositories (Int)

How many repositories should be included.

The default value is 25.

pullRequestReviewContributions (CreatedPullRequestReviewContributionConnection!)

Pull request review contributions made by the user.

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 (ContributionOrder)

Ordering options for contributions returned from the connection.

pullRequestReviewContributionsByRepository ([PullRequestReviewContributionsByRepository!]!)

Pull request review contributions made by the user, grouped by repository.

Arguments

maxRepositories (Int)

How many repositories should be included.

The default value is 25.

repositoryContributions (CreatedRepositoryContributionConnection!)

A list of repositories owned by the user that the user created in this time range.

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.

excludeFirst (Boolean)

Should the user's first repository ever be excluded from the result.

The default value is false.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

orderBy (ContributionOrder)

Ordering options for contributions returned from the connection.

restrictedContributionsCount (Int!)

A count of contributions made by the user that the viewer cannot access. Only non-zero when the user has chosen to share their private contribution counts.

startedAt (DateTime!)

The beginning date and time of this collection.

totalCommitContributions (Int!)

How many commits were made by the user in this time span.

totalIssueContributions (Int!)

How many issues the user opened.

Arguments

excludeFirst (Boolean)

Should the user's first issue ever be excluded from this count.

The default value is false.

excludePopular (Boolean)

Should the user's most commented issue be excluded from this count.

The default value is false.

totalPullRequestContributions (Int!)

How many pull requests the user opened.

Arguments

excludeFirst (Boolean)

Should the user's first pull request ever be excluded from this count.

The default value is false.

excludePopular (Boolean)

Should the user's most commented pull request be excluded from this count.

The default value is false.

totalPullRequestReviewContributions (Int!)

How many pull request reviews the user left.

totalRepositoriesWithContributedCommits (Int!)

How many different repositories the user committed to.

totalRepositoriesWithContributedIssues (Int!)

How many different repositories the user opened issues in.

Arguments

excludeFirst (Boolean)

Should the user's first issue ever be excluded from this count.

The default value is false.

excludePopular (Boolean)

Should the user's most commented issue be excluded from this count.

The default value is false.

totalRepositoriesWithContributedPullRequestReviews (Int!)

How many different repositories the user left pull request reviews in.

totalRepositoriesWithContributedPullRequests (Int!)

How many different repositories the user opened pull requests in.

Arguments

excludeFirst (Boolean)

Should the user's first pull request ever be excluded from this count.

The default value is false.

excludePopular (Boolean)

Should the user's most commented pull request be excluded from this count.

The default value is false.

totalRepositoryContributions (Int!)

How many repositories the user created.

Arguments

excludeFirst (Boolean)

Should the user's first repository ever be excluded from this count.

The default value is false.

user (User!)

The user who made the contributions in this collection.


ConvertToDraftEvent

Represents aconvert_to_draftevent 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.

pullRequest (PullRequest!)

PullRequest referenced by event.

resourcePath (URI!)

The HTTP path for this convert to draft event.

url (URI!)

The HTTP URL for this convert to draft event.


ConvertedNoteToIssueEvent

Represents aconverted_note_to_issueevent 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