Users

Reference documentation for GraphQL schema types in the Users category.

In this article

Queries

user

Query

Lookup a user by login.

Type: User

Arguments for user

NameDescription

login (String!)

The user's login.

viewer

Query

The currently authenticated user.

Type: User!

Mutations

changeUserStatus

Mutation

Update your status on GitHub.

Input fields for changeUserStatus

Return fields for changeUserStatus

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

status (UserStatus)

Your updated status.

createUserList

Mutation

Creates a new user list.

Input fields for createUserList

Return fields for createUserList

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

list (UserList)

The list that was just created.

viewer (User)

The user who created the list.

deleteUserList

Mutation

Deletes a user list.

Input fields for deleteUserList

Return fields for deleteUserList

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

user (User)

The owner of the list that will be deleted.

followUser

Mutation

Follow a user.

Input fields for followUser

Return fields for followUser

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

user (User)

The user that was followed.

setUserInteractionLimit

Mutation

Set a user level interaction limit for an user's public repositories.

Input fields for setUserInteractionLimit

Return fields for setUserInteractionLimit

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

user (User)

The user that the interaction limit was set for.

unfollowUser

Mutation

Unfollow a user.

Input fields for unfollowUser

Return fields for unfollowUser

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

user (User)

The user that was unfollowed.

updateUserList

Mutation

Updates an existing user list.

Input fields for updateUserList

Return fields for updateUserList

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

list (UserList)

The list that was just updated.

updateUserListsForItem

Mutation

Updates which of the viewer's lists an item belongs to.

Input fields for updateUserListsForItem

Return fields for updateUserListsForItem

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

item (UserListItems)

The item that was added.

lists ([UserList!])

The lists to which this item belongs.

user (User)

The user who owns the lists.

Objects

ActorConnection

Object

The connection type for Actor.

Fields for ActorConnection

NameDescription

edges ([ActorEdge])

A list of edges.

nodes ([Actor])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ActorEdge

Object

An edge in a connection.

Fields for ActorEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (Actor)

The item at the end of the edge.

ActorLocation

Object

Location information for an actor.

Fields for ActorLocation

NameDescription

city (String)

City.

country (String)

Country name.

countryCode (String)

Country code.

region (String)

Region name.

regionCode (String)

Region or state code.

ContributionCalendar

Object

A calendar of contributions made on GitHub by a user.

Fields for ContributionCalendar

NameDescription

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

Object

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

Fields for ContributionCalendarDay

NameDescription

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.

contributionLevel (ContributionLevel!)

Indication of contributions, relative to other days. Can be used to indicate which color to represent this day on a calendar.

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

Object

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

Fields for ContributionCalendarMonth

NameDescription

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

Object

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

Fields for ContributionCalendarWeek

NameDescription

contributionDays ([ContributionCalendarDay!]!)

The days of contributions in this week.

firstDay (Date!)

The date of the earliest square in this week.

ContributionsCollection

Object

A collection of contributions made by a user, including opened issues, commits, and pull requests. Contributions in private and internal repositories are only included with the optional read:user scope.

Fields for ContributionsCollection

NameDescription

commitContributionsByRepository ([CommitContributionsByRepository!]!)

Commit contributions made by the user, grouped by repository.

Arguments for commitContributionsByRepository

  • 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 for issueContributions

  • 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 for issueContributionsByRepository

  • 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 for pullRequestContributions

  • 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 for pullRequestContributionsByRepository

  • 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. Returns the most recently submitted review for each PR reviewed by the user.

Arguments for pullRequestReviewContributions

  • 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 for pullRequestReviewContributionsByRepository

  • 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 for repositoryContributions

  • 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 for totalIssueContributions

  • 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 for totalPullRequestContributions

  • 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 for totalRepositoriesWithContributedIssues

  • 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 for totalRepositoriesWithContributedPullRequests

  • 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 for totalRepositoryContributions

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

CreatedCommitContribution

Object

Represents the contribution a user made by committing to a repository.

CreatedCommitContribution Implements

Fields for CreatedCommitContribution

NameDescription

commitCount (Int!)

How many commits were made on this day to this repository by the user.

isRestricted (Boolean!)

Whether this contribution is associated with a record you do not have access to. For example, your own 'first issue' contribution may have been made on a repository you can no longer access.

occurredAt (DateTime!)

When this contribution was made.

repository (Repository!)

The repository the user made a commit in.

resourcePath (URI!)

The HTTP path for this contribution.

url (URI!)

The HTTP URL for this contribution.

user (User!)

The user who made this contribution.

CreatedCommitContributionConnection

Object

The connection type for CreatedCommitContribution.

Fields for CreatedCommitContributionConnection

NameDescription

edges ([CreatedCommitContributionEdge])

A list of edges.

nodes ([CreatedCommitContribution])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of commits across days and repositories in the connection.

CreatedCommitContributionEdge

Object

An edge in a connection.

Fields for CreatedCommitContributionEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (CreatedCommitContribution)

The item at the end of the edge.

CreatedIssueContribution

Object

Represents the contribution a user made on GitHub by opening an issue.

CreatedIssueContribution Implements

Fields for CreatedIssueContribution

NameDescription

isRestricted (Boolean!)

Whether this contribution is associated with a record you do not have access to. For example, your own 'first issue' contribution may have been made on a repository you can no longer access.

issue (Issue!)

The issue that was opened.

occurredAt (DateTime!)

When this contribution was made.

resourcePath (URI!)

The HTTP path for this contribution.

url (URI!)

The HTTP URL for this contribution.

user (User!)

The user who made this contribution.

CreatedIssueContributionConnection

Object

The connection type for CreatedIssueContribution.

Fields for CreatedIssueContributionConnection

NameDescription

edges ([CreatedIssueContributionEdge])

A list of edges.

nodes ([CreatedIssueContribution])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

CreatedIssueContributionEdge

Object

An edge in a connection.

Fields for CreatedIssueContributionEdge

NameDescription