This version of GitHub Enterprise was discontinued on 2020-11-12. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

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.

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.

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