Skip to main content

Reference documentation for GraphQL schema types in the Projects category.

In this article

Mutations

addProjectV2DraftIssue

Mutation

Creates a new draft issue and add it to a Project.

Input fields for addProjectV2DraftIssue

Return fields for addProjectV2DraftIssue

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectItem (ProjectV2Item)

The draft issue added to the project.

addProjectV2ItemById

Mutation

Links an existing content instance to a Project.

Input fields for addProjectV2ItemById

Return fields for addProjectV2ItemById

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

item (ProjectV2Item)

The item added to the project.

archiveProjectV2Item

Mutation

Archives a ProjectV2Item.

Input fields for archiveProjectV2Item

Return fields for archiveProjectV2Item

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

item (ProjectV2Item)

The item archived from the project.

clearProjectV2ItemFieldValue

Mutation

This mutation clears the value of a field for an item in a Project. Currently only text, number, date, assignees, labels, single-select, iteration and milestone fields are supported.

Input fields for clearProjectV2ItemFieldValue

Return fields for clearProjectV2ItemFieldValue

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2Item (ProjectV2Item)

The updated item.

convertProjectV2DraftIssueItemToIssue

Mutation

Converts a projectV2 draft issue item to an issue.

Input fields for convertProjectV2DraftIssueItemToIssue

Return fields for convertProjectV2DraftIssueItemToIssue

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

item (ProjectV2Item)

The updated project item.

copyProjectV2

Mutation

Copy a project.

Input fields for copyProjectV2

Return fields for copyProjectV2

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2 (ProjectV2)

The copied project.

createProjectV2

Mutation

Creates a new project.

Input fields for createProjectV2

Return fields for createProjectV2

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2 (ProjectV2)

The new project.

createProjectV2Field

Mutation

Create a new project field.

Input fields for createProjectV2Field

Return fields for createProjectV2Field

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2Field (ProjectV2FieldConfiguration)

The new field.

createProjectV2IssueField

Mutation

Create a new project issue field.

Input fields for createProjectV2IssueField

Return fields for createProjectV2IssueField

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2Field (ProjectV2FieldConfiguration)

The new field.

createProjectV2StatusUpdate

Mutation

Creates a status update within a Project.

Input fields for createProjectV2StatusUpdate

Return fields for createProjectV2StatusUpdate

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

statusUpdate (ProjectV2StatusUpdate)

The status update updated in the project.

deleteProjectV2

Mutation

Delete a project.

Input fields for deleteProjectV2

Return fields for deleteProjectV2

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2 (ProjectV2)

The deleted Project.

deleteProjectV2Field

Mutation

Delete a project field.

Input fields for deleteProjectV2Field

Return fields for deleteProjectV2Field

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2Field (ProjectV2FieldConfiguration)

The deleted field.

deleteProjectV2Item

Mutation

Deletes an item from a Project.

Input fields for deleteProjectV2Item

Return fields for deleteProjectV2Item

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

deletedItemId (ID)

The ID of the deleted item.

deleteProjectV2StatusUpdate

Mutation

Deletes a project status update.

Input fields for deleteProjectV2StatusUpdate

Return fields for deleteProjectV2StatusUpdate

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

deletedStatusUpdateId (ID)

The ID of the deleted status update.

projectV2 (ProjectV2)

The project the deleted status update was in.

deleteProjectV2Workflow

Mutation

Deletes a project workflow.

Input fields for deleteProjectV2Workflow

Return fields for deleteProjectV2Workflow

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

deletedWorkflowId (ID)

The ID of the deleted workflow.

projectV2 (ProjectV2)

The project the deleted workflow was in.

linkProjectV2ToRepository

Mutation

Links a project to a repository.

Input fields for linkProjectV2ToRepository

Return fields for linkProjectV2ToRepository

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

repository (Repository)

The repository the project is linked to.

linkProjectV2ToTeam

Mutation

Links a project to a team.

Input fields for linkProjectV2ToTeam

Return fields for linkProjectV2ToTeam

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

team (Team)

The team the project is linked to.

markProjectV2AsTemplate

Mutation

Mark a project as a template. Note that only projects which are owned by an Organization can be marked as a template.

Input fields for markProjectV2AsTemplate

Return fields for markProjectV2AsTemplate

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2 (ProjectV2)

The project.

unarchiveProjectV2Item

Mutation

Unarchives a ProjectV2Item.

Input fields for unarchiveProjectV2Item

Return fields for unarchiveProjectV2Item

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

item (ProjectV2Item)

The item unarchived from the project.

unlinkProjectV2FromRepository

Mutation

Unlinks a project from a repository.

Input fields for unlinkProjectV2FromRepository

Return fields for unlinkProjectV2FromRepository

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

repository (Repository)

The repository the project is no longer linked to.

unlinkProjectV2FromTeam

Mutation

Unlinks a project to a team.

Input fields for unlinkProjectV2FromTeam

Return fields for unlinkProjectV2FromTeam

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

team (Team)

The team the project is unlinked from.

unmarkProjectV2AsTemplate

Mutation

Unmark a project as a template.

Input fields for unmarkProjectV2AsTemplate

Return fields for unmarkProjectV2AsTemplate

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2 (ProjectV2)

The project.

updateProjectV2

Mutation

Updates an existing project.

Input fields for updateProjectV2

Return fields for updateProjectV2

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2 (ProjectV2)

The updated Project.

updateProjectV2Collaborators

Mutation

Update the collaborators on a team or a project.

Input fields for updateProjectV2Collaborators

Return fields for updateProjectV2Collaborators

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

collaborators (ProjectV2ActorConnection)

The collaborators granted a role.

updateProjectV2DraftIssue

Mutation

Updates a draft issue within a Project.

Input fields for updateProjectV2DraftIssue

Return fields for updateProjectV2DraftIssue

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

draftIssue (DraftIssue)

The draft issue updated in the project.

updateProjectV2Field

Mutation

Update a project field.

Input fields for updateProjectV2Field

Return fields for updateProjectV2Field

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2Field (ProjectV2FieldConfiguration)

The updated field.

updateProjectV2ItemFieldValue

Mutation

This mutation updates the value of a field for an item in a Project. Currently only single-select, text, number, date, and iteration fields are supported.

Input fields for updateProjectV2ItemFieldValue

Return fields for updateProjectV2ItemFieldValue

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectV2Item (ProjectV2Item)

The updated item.

updateProjectV2ItemPosition

Mutation

This mutation updates the position of the item in the project, where the position represents the priority of an item.

Input fields for updateProjectV2ItemPosition

Return fields for updateProjectV2ItemPosition

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

items (ProjectV2ItemConnection)

The items in the new order.

updateProjectV2StatusUpdate

Mutation

Updates a status update within a Project.

Input fields for updateProjectV2StatusUpdate

Return fields for updateProjectV2StatusUpdate

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

statusUpdate (ProjectV2StatusUpdate)

The status update updated in the project.

Objects

AddedToProjectV2Event

Object

Represents aadded_to_project_v2event on a given issue or pull request.

AddedToProjectV2Event Implements

Fields for AddedToProjectV2Event

NameDescription

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

id (ID!)

The Node ID of the AddedToProjectV2Event object.

project (ProjectV2)

Project referenced by event.

wasAutomated (Boolean!)

Did this event result from workflow automation?.

DraftIssue

Object

A draft issue within a project.

DraftIssue Implements

Fields for DraftIssue

NameDescription

assignees (UserConnection!)

A list of users to assigned to this draft issue.

Arguments for assignees

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

body (String!)

The body of the draft issue.

bodyHTML (HTML!)

The body of the draft issue rendered to HTML.

bodyText (String!)

The body of the draft issue rendered to text.

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created this draft issue.

id (ID!)

The Node ID of the DraftIssue object.

projectV2Items (ProjectV2ItemConnection!)

List of items linked with the draft issue (currently draft issue can be linked to only one item).

Arguments for projectV2Items

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

projectsV2 (ProjectV2Connection!)

Projects that link to this draft issue (currently draft issue can be linked to only one project).

Arguments for projectsV2

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

title (String!)

The title of the draft issue.

updatedAt (DateTime!)

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

ProjectV2

Object

New projects that manage issues, pull requests and drafts using tables and boards.

ProjectV2 Implements

Fields for ProjectV2

NameDescription

closed (Boolean!)

Returns true if the project is closed.

closedAt (DateTime)

Identifies the date and time when the object was closed.

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who originally created the project.

databaseId (Int)

Identifies the primary key from the database.

Warning

databaseId is deprecated.

databaseId will be removed because it does not support 64-bit signed integer identifiers. Use fullDatabaseId instead. Removal on 2025-04-01 UTC.

field (ProjectV2FieldConfiguration)

A field of the project.

Arguments for field

  • name (String!)

    The name of the field.

fields (ProjectV2FieldConfigurationConnection!)

List of fields and their constraints in the project.

Arguments for fields

  • 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 (ProjectV2FieldOrder)

    Ordering options for project v2 fields returned from the connection.

fullDatabaseId (BigInt)

Identifies the primary key from the database as a BigInt.

id (ID!)

The Node ID of the ProjectV2 object.

items (ProjectV2ItemConnection!)

List of items in the project.

Arguments for items

  • 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 (ProjectV2ItemOrder)

    Ordering options for project v2 items returned from the connection.

  • query (String)

    Search query for filtering items.

    The default value is .

number (Int!)

The project's number.

owner (ProjectV2Owner!)

The project's owner. Currently limited to organizations and users.

public (Boolean!)

Returns true if the project is public.

readme (String)

The project's readme.

repositories (RepositoryConnection!)

The repositories the project is linked to.

Arguments for repositories

  • 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 (RepositoryOrder)

    Ordering options for repositories returned from the connection.

resourcePath (URI!)

The HTTP path for this project.

shortDescription (String)

The project's short description.

statusUpdates (ProjectV2StatusUpdateConnection!)

List of the status updates in the project.

Arguments for statusUpdates

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

teams (TeamConnection!)

The teams the project is linked to.

Arguments for teams

  • 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 (TeamOrder)

    Ordering options for teams returned from this connection.

template (Boolean!)

Returns true if this project is a template.

title (String!)

The project's name.

updatedAt (DateTime!)

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

url (URI!)

The HTTP URL for this project.

view (ProjectV2View)

A view of the project.

Arguments for view

  • number (Int!)

    The number of a view belonging to the project.

viewerCanClose (Boolean!)

Indicates if the object can be closed by the viewer.

viewerCanReopen (Boolean!)

Indicates if the object can be reopened by the viewer.

viewerCanUpdate (Boolean!)

Check if the current viewer can update this object.

views (ProjectV2ViewConnection!)

List of views in the project.

Arguments for views

  • 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 (ProjectV2ViewOrder)

    Ordering options for project v2 views returned from the connection.

workflow (ProjectV2Workflow)

A workflow of the project.

Arguments for workflow

  • number (Int!)

    The number of a workflow belonging to the project.

workflows (ProjectV2WorkflowConnection!)

List of the workflows in the project.

Arguments for workflows

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

ProjectV2ActorConnection

Object

The connection type for ProjectV2Actor.

Fields for ProjectV2ActorConnection

NameDescription

edges ([ProjectV2ActorEdge])

A list of edges.

nodes ([ProjectV2Actor])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2ActorEdge

Object

An edge in a connection.

Fields for ProjectV2ActorEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2Actor)

The item at the end of the edge.

ProjectV2Connection

Object

The connection type for ProjectV2.

Fields for ProjectV2Connection

NameDescription

edges ([ProjectV2Edge])

A list of edges.

nodes ([ProjectV2])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2Edge

Object

An edge in a connection.

Fields for ProjectV2Edge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2)

The item at the end of the edge.

ProjectV2Field

Object

A field inside a project.

ProjectV2Field Implements

Fields for ProjectV2Field

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

dataType (ProjectV2FieldType!)

The field's type.

databaseId (Int)

Identifies the primary key from the database.

id (ID!)

The Node ID of the ProjectV2Field object.

name (String!)

The project field's name.

project (ProjectV2!)

The project that contains this field.

updatedAt (DateTime!)

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

ProjectV2FieldConfigurationConnection

Object

The connection type for ProjectV2FieldConfiguration.

Fields for ProjectV2FieldConfigurationConnection

NameDescription

edges ([ProjectV2FieldConfigurationEdge])

A list of edges.

nodes ([ProjectV2FieldConfiguration])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2FieldConfigurationEdge

Object

An edge in a connection.

Fields for ProjectV2FieldConfigurationEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2FieldConfiguration)

The item at the end of the edge.

ProjectV2FieldConnection

Object

The connection type for ProjectV2Field.

Fields for ProjectV2FieldConnection

NameDescription

edges ([ProjectV2FieldEdge])

A list of edges.

nodes ([ProjectV2Field])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2FieldEdge

Object

An edge in a connection.

Fields for ProjectV2FieldEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2Field)

The item at the end of the edge.

ProjectV2Item

Object

An item within a Project.

ProjectV2Item Implements

Fields for ProjectV2Item

NameDescription

content (ProjectV2ItemContent)

The content of the referenced draft issue, issue, pull request.

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created the item.

databaseId (Int)

Identifies the primary key from the database.

Warning

databaseId is deprecated.

databaseId will be removed because it does not support 64-bit signed integer identifiers. Use fullDatabaseId instead. Removal on 2025-04-01 UTC.

fieldValueByName (ProjectV2ItemFieldValue)

The field value of the first project field which matches thenameargument that is set on the item.

Arguments for fieldValueByName

  • name (String!)

    The name of the field to return the field value of.

fieldValues (ProjectV2ItemFieldValueConnection!)

The field values that are set on the item.

Arguments for fieldValues

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

fullDatabaseId (BigInt)

Identifies the primary key from the database as a BigInt.

id (ID!)

The Node ID of the ProjectV2Item object.

isArchived (Boolean!)

Whether the item is archived.

project (ProjectV2!)

The project that contains this item.

type (ProjectV2ItemType!)

The type of the item.

updatedAt (DateTime!)

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

ProjectV2ItemConnection

Object

The connection type for ProjectV2Item.

Fields for ProjectV2ItemConnection

NameDescription

edges ([ProjectV2ItemEdge])

A list of edges.

nodes ([ProjectV2Item])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2ItemEdge

Object

An edge in a connection.

Fields for ProjectV2ItemEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2Item)

The item at the end of the edge.

ProjectV2ItemFieldDateValue

Object

The value of a date field in a Project item.

ProjectV2ItemFieldDateValue Implements

Fields for ProjectV2ItemFieldDateValue

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created the item.

databaseId (Int)

Identifies the primary key from the database.

date (Date)

Date value for the field.

field (ProjectV2FieldConfiguration!)

The project field that contains this value.

id (ID!)

The Node ID of the ProjectV2ItemFieldDateValue object.

item (ProjectV2Item!)

The project item that contains this value.

updatedAt (DateTime!)

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

ProjectV2ItemFieldIterationValue

Object

The value of an iteration field in a Project item.

ProjectV2ItemFieldIterationValue Implements

Fields for ProjectV2ItemFieldIterationValue

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created the item.

databaseId (Int)

Identifies the primary key from the database.

duration (Int!)

The duration of the iteration in days.

field (ProjectV2FieldConfiguration!)

The project field that contains this value.

id (ID!)

The Node ID of the ProjectV2ItemFieldIterationValue object.

item (ProjectV2Item!)

The project item that contains this value.

iterationId (String!)

The ID of the iteration.

startDate (Date!)

The start date of the iteration.

title (String!)

The title of the iteration.

titleHTML (String!)

The title of the iteration, with HTML.

updatedAt (DateTime!)

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

ProjectV2ItemFieldLabelValue

Object

The value of the labels field in a Project item.

Fields for ProjectV2ItemFieldLabelValue

NameDescription

field (ProjectV2FieldConfiguration!)

The field that contains this value.

labels (LabelConnection)

Labels value of a field.

Arguments for labels

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

ProjectV2ItemFieldMilestoneValue

Object

The value of a milestone field in a Project item.

Fields for ProjectV2ItemFieldMilestoneValue

NameDescription

field (ProjectV2FieldConfiguration!)

The field that contains this value.

milestone (Milestone)

Milestone value of a field.

ProjectV2ItemFieldNumberValue

Object

The value of a number field in a Project item.

ProjectV2ItemFieldNumberValue Implements

Fields for ProjectV2ItemFieldNumberValue

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created the item.

databaseId (Int)

Identifies the primary key from the database.

field (ProjectV2FieldConfiguration!)

The project field that contains this value.

id (ID!)

The Node ID of the ProjectV2ItemFieldNumberValue object.

item (ProjectV2Item!)

The project item that contains this value.

number (Float)

Number as a float(8).

updatedAt (DateTime!)

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

ProjectV2ItemFieldPullRequestValue

Object

The value of a pull request field in a Project item.

Fields for ProjectV2ItemFieldPullRequestValue

NameDescription

field (ProjectV2FieldConfiguration!)

The field that contains this value.

pullRequests (PullRequestConnection)

The pull requests for this field.

Arguments for pullRequests

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

ProjectV2ItemFieldRepositoryValue

Object

The value of a repository field in a Project item.

Fields for ProjectV2ItemFieldRepositoryValue

NameDescription

field (ProjectV2FieldConfiguration!)

The field that contains this value.

repository (Repository)

The repository for this field.

ProjectV2ItemFieldReviewerValue

Object

The value of a reviewers field in a Project item.

Fields for ProjectV2ItemFieldReviewerValue

NameDescription

field (ProjectV2FieldConfiguration!)

The field that contains this value.

reviewers (RequestedReviewerConnection)

The reviewers for this field.

Arguments for reviewers

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

ProjectV2ItemFieldSingleSelectValue

Object

The value of a single select field in a Project item.

ProjectV2ItemFieldSingleSelectValue Implements

Fields for ProjectV2ItemFieldSingleSelectValue

NameDescription

color (ProjectV2SingleSelectFieldOptionColor!)

The color applied to the selected single-select option.

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created the item.

databaseId (Int)

Identifies the primary key from the database.

description (String)

A plain-text description of the selected single-select option, such as what the option means.

descriptionHTML (String)

The description of the selected single-select option, including HTML tags.

field (ProjectV2FieldConfiguration!)

The project field that contains this value.

id (ID!)

The Node ID of the ProjectV2ItemFieldSingleSelectValue object.

item (ProjectV2Item!)

The project item that contains this value.

name (String)

The name of the selected single select option.

nameHTML (String)

The html name of the selected single select option.

optionId (String)

The id of the selected single select option.

updatedAt (DateTime!)

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

ProjectV2ItemFieldTextValue

Object

The value of a text field in a Project item.

ProjectV2ItemFieldTextValue Implements

Fields for ProjectV2ItemFieldTextValue

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created the item.

databaseId (Int)

Identifies the primary key from the database.

field (ProjectV2FieldConfiguration!)

The project field that contains this value.

id (ID!)

The Node ID of the ProjectV2ItemFieldTextValue object.

item (ProjectV2Item!)

The project item that contains this value.

text (String)

Text value of a field.

updatedAt (DateTime!)

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

ProjectV2ItemFieldUserValue

Object

The value of a user field in a Project item.

Fields for ProjectV2ItemFieldUserValue

NameDescription

field (ProjectV2FieldConfiguration!)

The field that contains this value.

users (UserConnection)

The users for this field.

Arguments for users

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

ProjectV2ItemFieldValueConnection

Object

The connection type for ProjectV2ItemFieldValue.

Fields for ProjectV2ItemFieldValueConnection

NameDescription

edges ([ProjectV2ItemFieldValueEdge])

A list of edges.

nodes ([ProjectV2ItemFieldValue])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2ItemFieldValueEdge

Object

An edge in a connection.

Fields for ProjectV2ItemFieldValueEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2ItemFieldValue)

The item at the end of the edge.

ProjectV2ItemIssueFieldValue

Object

The value of an issue field in a Project item.

Fields for ProjectV2ItemIssueFieldValue

NameDescription

field (ProjectV2FieldConfiguration!)

Field that contains this value.

issueFieldValue (ProjectV2IssueFieldValues)

Value of the Issue Field.

ProjectV2ItemStatusChangedEvent

Object

Represents aproject_v2_item_status_changedevent on a given issue or pull request.

ProjectV2ItemStatusChangedEvent Implements

Fields for ProjectV2ItemStatusChangedEvent

NameDescription

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

id (ID!)

The Node ID of the ProjectV2ItemStatusChangedEvent object.

previousStatus (String!)

The previous status of the project item.

project (ProjectV2)

Project referenced by event.

status (String!)

The new status of the project item.

wasAutomated (Boolean!)

Did this event result from workflow automation?.

ProjectV2IterationField

Object

An iteration field inside a project.

ProjectV2IterationField Implements

Fields for ProjectV2IterationField

NameDescription

configuration (ProjectV2IterationFieldConfiguration!)

Iteration configuration settings.

createdAt (DateTime!)

Identifies the date and time when the object was created.

dataType (ProjectV2FieldType!)

The field's type.

databaseId (Int)

Identifies the primary key from the database.

id (ID!)

The Node ID of the ProjectV2IterationField object.

name (String!)

The project field's name.

project (ProjectV2!)

The project that contains this field.

updatedAt (DateTime!)

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

ProjectV2IterationFieldConfiguration

Object

Iteration field configuration for a project.

Fields for ProjectV2IterationFieldConfiguration

NameDescription

completedIterations ([ProjectV2IterationFieldIteration!]!)

The iteration's completed iterations.

duration (Int!)

The iteration's duration in days.

iterations ([ProjectV2IterationFieldIteration!]!)

The iteration's iterations.

startDay (Int!)

The iteration's start day of the week.

ProjectV2IterationFieldIteration

Object

Iteration field iteration settings for a project.

Fields for ProjectV2IterationFieldIteration

NameDescription

duration (Int!)

The iteration's duration in days.

id (String!)

The iteration's ID.

startDate (Date!)

The iteration's start date.

title (String!)

The iteration's title.

titleHTML (String!)

The iteration's html title.

ProjectV2SingleSelectField

Object

A single select field inside a project.

ProjectV2SingleSelectField Implements

Fields for ProjectV2SingleSelectField

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

dataType (ProjectV2FieldType!)

The field's type.

databaseId (Int)

Identifies the primary key from the database.

id (ID!)

The Node ID of the ProjectV2SingleSelectField object.

name (String!)

The project field's name.

options ([ProjectV2SingleSelectFieldOption!]!)

Options for the single select field.

Arguments for options

  • names ([String!])

    Filter returned options to only those matching these names, case insensitive.

project (ProjectV2!)

The project that contains this field.

updatedAt (DateTime!)

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

ProjectV2SingleSelectFieldOption

Object

Single select field option for a configuration for a project.

Fields for ProjectV2SingleSelectFieldOption

NameDescription

color (ProjectV2SingleSelectFieldOptionColor!)

The option's display color.

description (String!)

The option's plain-text description.

descriptionHTML (String!)

The option's description, possibly containing HTML.

id (String!)

The option's ID.

name (String!)

The option's name.

nameHTML (String!)

The option's html name.

ProjectV2SortBy

Object

Represents a sort by field and direction.

Fields for ProjectV2SortBy

NameDescription

direction (OrderDirection!)

The direction of the sorting. Possible values are ASC and DESC.

field (ProjectV2Field!)

The field by which items are sorted.

ProjectV2SortByConnection

Object

The connection type for ProjectV2SortBy.

Fields for ProjectV2SortByConnection

NameDescription

edges ([ProjectV2SortByEdge])

A list of edges.

nodes ([ProjectV2SortBy])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2SortByEdge

Object

An edge in a connection.

Fields for ProjectV2SortByEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2SortBy)

The item at the end of the edge.

ProjectV2SortByField

Object

Represents a sort by field and direction.

Fields for ProjectV2SortByField

NameDescription

direction (OrderDirection!)

The direction of the sorting. Possible values are ASC and DESC.

field (ProjectV2FieldConfiguration!)

The field by which items are sorted.

ProjectV2SortByFieldConnection

Object

The connection type for ProjectV2SortByField.

Fields for ProjectV2SortByFieldConnection

NameDescription

edges ([ProjectV2SortByFieldEdge])

A list of edges.

nodes ([ProjectV2SortByField])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2SortByFieldEdge

Object

An edge in a connection.

Fields for ProjectV2SortByFieldEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2SortByField)

The item at the end of the edge.

ProjectV2StatusUpdate

Object

A status update within a project.

ProjectV2StatusUpdate Implements

Fields for ProjectV2StatusUpdate

NameDescription

body (String)

The body of the status update.

bodyHTML (HTML)

The body of the status update rendered to HTML.

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created the status update.

databaseId (Int)

Identifies the primary key from the database.

Warning

databaseId is deprecated.

databaseId will be removed because it does not support 64-bit signed integer identifiers. Use fullDatabaseId instead. Removal on 2025-04-01 UTC.

fullDatabaseId (BigInt)

Identifies the primary key from the database as a BigInt.

id (ID!)

The Node ID of the ProjectV2StatusUpdate object.

project (ProjectV2!)

The project that contains this status update.

startDate (Date)

The start date of the status update.

status (ProjectV2StatusUpdateStatus)

The status of the status update.

targetDate (Date)

The target date of the status update.

updatedAt (DateTime!)

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

ProjectV2StatusUpdateConnection

Object

The connection type for ProjectV2StatusUpdate.

Fields for ProjectV2StatusUpdateConnection

NameDescription

edges ([ProjectV2StatusUpdateEdge])

A list of edges.

nodes ([ProjectV2StatusUpdate])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2StatusUpdateEdge

Object

An edge in a connection.

Fields for ProjectV2StatusUpdateEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2StatusUpdate)

The item at the end of the edge.

ProjectV2View

Object

A view within a ProjectV2.

ProjectV2View Implements

Fields for ProjectV2View

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

databaseId (Int)

Identifies the primary key from the database.

Warning

databaseId is deprecated.

databaseId will be removed because it does not support 64-bit signed integer identifiers. Use fullDatabaseId instead. Removal on 2025-04-01 UTC.

fields (ProjectV2FieldConfigurationConnection)

The view's visible fields.

Arguments for fields

  • 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 (ProjectV2FieldOrder)

    Ordering options for the project v2 fields returned from the connection.

filter (String)

The project view's filter.

fullDatabaseId (BigInt)

Identifies the primary key from the database as a BigInt.

groupBy (ProjectV2FieldConnection)

The view's group-by field.

Warning

groupBy is deprecated.

The ProjectV2View#order_by API is deprecated in favour of the more capable ProjectV2View#group_by_field API. Check out the ProjectV2View#group_by_fields API as an example for the more capable alternative. Removal on 2023-04-01 UTC.

Arguments for groupBy

  • 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 (ProjectV2FieldOrder)

    Ordering options for the project v2 fields returned from the connection.

groupByFields (ProjectV2FieldConfigurationConnection)

The view's group-by field.

Arguments for groupByFields

  • 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 (ProjectV2FieldOrder)

    Ordering options for the project v2 fields returned from the connection.

id (ID!)

The Node ID of the ProjectV2View object.

layout (ProjectV2ViewLayout!)

The project view's layout.

name (String!)

The project view's name.

number (Int!)

The project view's number.

project (ProjectV2!)

The project that contains this view.

sortBy (ProjectV2SortByConnection)

The view's sort-by config.

Warning

sortBy is deprecated.

The ProjectV2View#sort_by API is deprecated in favour of the more capable ProjectV2View#sort_by_fields API. Check out the ProjectV2View#sort_by_fields API as an example for the more capable alternative. Removal on 2023-04-01 UTC.

Arguments for sortBy

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

sortByFields (ProjectV2SortByFieldConnection)

The view's sort-by config.

Arguments for sortByFields

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

updatedAt (DateTime!)

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

verticalGroupBy (ProjectV2FieldConnection)

The view's vertical-group-by field.

Warning

verticalGroupBy is deprecated.

The ProjectV2View#vertical_group_by API is deprecated in favour of the more capable ProjectV2View#vertical_group_by_fields API. Check out the ProjectV2View#vertical_group_by_fields API as an example for the more capable alternative. Removal on 2023-04-01 UTC.

Arguments for verticalGroupBy

  • 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 (ProjectV2FieldOrder)

    Ordering options for the project v2 fields returned from the connection.

verticalGroupByFields (ProjectV2FieldConfigurationConnection)

The view's vertical-group-by field.

Arguments for verticalGroupByFields

  • 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 (ProjectV2FieldOrder)

    Ordering options for the project v2 fields returned from the connection.

visibleFields (ProjectV2FieldConnection)

The view's visible fields.

Warning

visibleFields is deprecated.

The ProjectV2View#visibleFields API is deprecated in favour of the more capable ProjectV2View#fields API. Check out the ProjectV2View#fields API as an example for the more capable alternative. Removal on 2023-01-01 UTC.

Arguments for visibleFields

  • 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 (ProjectV2FieldOrder)

    Ordering options for the project v2 fields returned from the connection.

ProjectV2ViewConnection

Object

The connection type for ProjectV2View.

Fields for ProjectV2ViewConnection

NameDescription

edges ([ProjectV2ViewEdge])

A list of edges.

nodes ([ProjectV2View])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2ViewEdge

Object

An edge in a connection.

Fields for ProjectV2ViewEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2View)

The item at the end of the edge.

ProjectV2Workflow

Object

A workflow inside a project.

ProjectV2Workflow Implements

Fields for ProjectV2Workflow

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

databaseId (Int)

Identifies the primary key from the database.

Warning

databaseId is deprecated.

databaseId will be removed because it does not support 64-bit signed integer identifiers. Use fullDatabaseId instead. Removal on 2025-04-01 UTC.

enabled (Boolean!)

Whether the workflow is enabled.

fullDatabaseId (BigInt)

Identifies the primary key from the database as a BigInt.

id (ID!)

The Node ID of the ProjectV2Workflow object.

name (String!)

The name of the workflow.

number (Int!)

The number of the workflow.

project (ProjectV2!)

The project that contains this workflow.

updatedAt (DateTime!)

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

ProjectV2WorkflowConnection

Object

The connection type for ProjectV2Workflow.

Fields for ProjectV2WorkflowConnection

NameDescription

edges ([ProjectV2WorkflowEdge])

A list of edges.

nodes ([ProjectV2Workflow])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectV2WorkflowEdge

Object

An edge in a connection.

Fields for ProjectV2WorkflowEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (ProjectV2Workflow)

The item at the end of the edge.

RemovedFromProjectV2Event

Object

Represents aremoved_from_project_v2event on a given issue or pull request.

RemovedFromProjectV2Event Implements

Fields for RemovedFromProjectV2Event

NameDescription

actor (Actor)

Identifies the actor who performed the event.

createdAt (DateTime!)

Identifies the date and time when the object was created.

id (ID!)

The Node ID of the RemovedFromProjectV2Event object.

project (ProjectV2)

Project referenced by event.

wasAutomated (Boolean!)

Did this event result from workflow automation?.

Interfaces

ProjectV2Event

Interface

Represents an event related to a project on the timeline of an issue or pull request.

ProjectV2Event is implemented by

Fields for ProjectV2Event

NameDescription

project (ProjectV2)

Project referenced by event.

wasAutomated (Boolean!)

Did this event result from workflow automation?.

ProjectV2FieldCommon

Interface

Common fields across different project field types.

ProjectV2FieldCommon is implemented by

Fields for ProjectV2FieldCommon

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

dataType (ProjectV2FieldType!)

The field's type.

databaseId (Int)

Identifies the primary key from the database.

id (ID!)

The Node ID of the ProjectV2FieldCommon object.

name (String!)

The project field's name.

project (ProjectV2!)

The project that contains this field.

updatedAt (DateTime!)

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

ProjectV2ItemFieldValueCommon

Interface

Common fields across different project field value types.

ProjectV2ItemFieldValueCommon is implemented by

Fields for ProjectV2ItemFieldValueCommon

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created the item.

databaseId (Int)

Identifies the primary key from the database.

field (ProjectV2FieldConfiguration!)

The project field that contains this value.

id (ID!)

The Node ID of the ProjectV2ItemFieldValueCommon object.

item (ProjectV2Item!)

The project item that contains this value.

updatedAt (DateTime!)

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

ProjectV2Owner

Interface

Represents an owner of a project.

ProjectV2Owner is implemented by

Fields for ProjectV2Owner

NameDescription

id (ID!)

The Node ID of the ProjectV2Owner object.

projectV2 (ProjectV2)

Find a project by number.

Arguments for projectV2

  • number (Int!)

    The project number.

projectsV2 (ProjectV2Connection!)

A list of projects under the owner.

Arguments for projectsV2

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

    A project to search for under the owner.

ProjectV2Recent

Interface

Recent projects for the owner.

ProjectV2Recent is implemented by

Fields for ProjectV2Recent

NameDescription

recentProjects (ProjectV2Connection!)

Recent projects that this user has modified in the context of the owner.

Arguments for recentProjects

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

Enums

ProjectV2CustomFieldType

Enum

The type of a project field.

Values for ProjectV2CustomFieldType

NameDescription
DATE

Date.

ITERATION

Iteration.

NUMBER

Number.

SINGLE_SELECT

Single Select.

TEXT

Text.

ProjectV2FieldOrderField

Enum

Properties by which project v2 field connections can be ordered.

Values for ProjectV2FieldOrderField

NameDescription
CREATED_AT

Order project v2 fields by creation time.

NAME

Order project v2 fields by name.

POSITION

Order project v2 fields by position.

ProjectV2FieldType

Enum

The type of a project field.

Values for ProjectV2FieldType

NameDescription
ASSIGNEES

Assignees.

CLOSED

Closed.

CREATED

Created.

DATE

Date.

ISSUE_TYPE

Issue type.

ITERATION

Iteration.

LABELS

Labels.

LINKED_PULL_REQUESTS

Linked Pull Requests.

MILESTONE

Milestone.

NUMBER

Number.

PARENT_ISSUE

Parent issue.

REPOSITORY

Repository.

REVIEWERS

Reviewers.

SINGLE_SELECT

Single Select.

SUB_ISSUES_PROGRESS

Sub-issues progress.

TEXT

Text.

TITLE

Title.

TRACKED_BY

Tracked by.

TRACKS

Tracks.

UPDATED

Updated.

ProjectV2ItemFieldValueOrderField

Enum

Properties by which project v2 item field value connections can be ordered.

Values for ProjectV2ItemFieldValueOrderField

NameDescription
POSITION

Order project v2 item field values by the their position in the project.

ProjectV2ItemOrderField

Enum

Properties by which project v2 item connections can be ordered.

Values for ProjectV2ItemOrderField

NameDescription
POSITION

Order project v2 items by the their position in the project.

ProjectV2ItemType

Enum

The type of a project item.

Values for ProjectV2ItemType

NameDescription
DRAFT_ISSUE

Draft Issue.

ISSUE

Issue.

PULL_REQUEST

Pull Request.

REDACTED

Redacted Item.

ProjectV2OrderField

Enum

Properties by which projects can be ordered.

Values for ProjectV2OrderField

NameDescription
CREATED_AT

The project's date and time of creation.

NUMBER

The project's number.

TITLE

The project's title.

UPDATED_AT

The project's date and time of update.

ProjectV2PermissionLevel

Enum

The possible roles of a collaborator on a project.

Values for ProjectV2PermissionLevel

NameDescription
ADMIN

The collaborator can view, edit, and maange the settings of the project.

READ

The collaborator can view the project.

WRITE

The collaborator can view and edit the project.

ProjectV2Roles

Enum

The possible roles of a collaborator on a project.

Values for ProjectV2Roles

NameDescription
ADMIN

The collaborator can view, edit, and maange the settings of the project.

NONE

The collaborator has no direct access to the project.

READER

The collaborator can view the project.

WRITER

The collaborator can view and edit the project.

ProjectV2SingleSelectFieldOptionColor

Enum

The display color of a single-select field option.

Values for ProjectV2SingleSelectFieldOptionColor

NameDescription
BLUE

BLUE.

GRAY

GRAY.

GREEN

GREEN.

ORANGE

ORANGE.

PINK

PINK.

PURPLE

PURPLE.

RED

RED.

YELLOW

YELLOW.

ProjectV2State

Enum

The possible states of a project v2.

Values for ProjectV2State

NameDescription
CLOSED

A project v2 that has been closed.

OPEN

A project v2 that is still open.

ProjectV2StatusUpdateOrderField

Enum

Properties by which project v2 status updates can be ordered.

Values for ProjectV2StatusUpdateOrderField

NameDescription
CREATED_AT

Allows chronological ordering of project v2 status updates.

ProjectV2StatusUpdateStatus

Enum

The possible statuses of a project v2.

Values for ProjectV2StatusUpdateStatus

NameDescription
AT_RISK

A project v2 that is at risk and encountering some challenges.

COMPLETE

A project v2 that is complete.

INACTIVE

A project v2 that is inactive.

OFF_TRACK

A project v2 that is off track and needs attention.

ON_TRACK

A project v2 that is on track with no risks.

ProjectV2ViewLayout

Enum

The layout of a project v2 view.

Values for ProjectV2ViewLayout

NameDescription
BOARD_LAYOUT

Board layout.

ROADMAP_LAYOUT

Roadmap layout.

TABLE_LAYOUT

Table layout.

ProjectV2ViewOrderField

Enum

Properties by which project v2 view connections can be ordered.

Values for ProjectV2ViewOrderField

NameDescription
CREATED_AT

Order project v2 views by creation time.

NAME

Order project v2 views by name.

POSITION

Order project v2 views by position.

ProjectV2WorkflowsOrderField

Enum

Properties by which project workflows can be ordered.

Values for ProjectV2WorkflowsOrderField

NameDescription
CREATED_AT

The date and time of the workflow creation.

NAME

The name of the workflow.

NUMBER

The number of the workflow.

UPDATED_AT

The date and time of the workflow update.

Unions

OrganizationOrUser

Union

Used for argument of CreateProjectV2 mutation.

Possible types for OrganizationOrUser

ProjectV2Actor

Union

Possible collaborators for a project.

Possible types for ProjectV2Actor

ProjectV2FieldConfiguration

Union

Configurations for project fields.

Possible types for ProjectV2FieldConfiguration

ProjectV2IssueFieldValues

Union

Possible issue field values for a Project item.

Possible types for ProjectV2IssueFieldValues

ProjectV2ItemContent

Union

Types that can be inside Project Items.

Possible types for ProjectV2ItemContent

ProjectV2ItemFieldValue

Union

Project field values.

Possible types for ProjectV2ItemFieldValue

Input objects

AddProjectV2DraftIssueInput

Input object

Autogenerated input type of AddProjectV2DraftIssue.

Input fields for AddProjectV2DraftIssueInput

NameDescription

assigneeIds ([ID!])

The IDs of the assignees of the draft issue.

body (String)

The body of the draft issue.

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the Project to add the draft issue to.

title (String!)

The title of the draft issue. A project item can also be created by providing the URL of an Issue or Pull Request if you have access.

AddProjectV2ItemByIdInput

Input object

Autogenerated input type of AddProjectV2ItemById.

Input fields for AddProjectV2ItemByIdInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

contentId (ID!)

The id of the Issue or Pull Request to add.

projectId (ID!)

The ID of the Project to add the item to.

ArchiveProjectV2ItemInput

Input object

Autogenerated input type of ArchiveProjectV2Item.

Input fields for ArchiveProjectV2ItemInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

itemId (ID!)

The ID of the ProjectV2Item to archive.

projectId (ID!)

The ID of the Project to archive the item from.

ClearProjectV2ItemFieldValueInput

Input object

Autogenerated input type of ClearProjectV2ItemFieldValue.

Input fields for ClearProjectV2ItemFieldValueInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

fieldId (ID!)

The ID of the field to be cleared.

itemId (ID!)

The ID of the item to be cleared.

projectId (ID!)

The ID of the Project.

ConvertProjectV2DraftIssueItemToIssueInput

Input object

Autogenerated input type of ConvertProjectV2DraftIssueItemToIssue.

Input fields for ConvertProjectV2DraftIssueItemToIssueInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

itemId (ID!)

The ID of the draft issue ProjectV2Item to convert.

repositoryId (ID!)

The ID of the repository to create the issue in.

CopyProjectV2Input

Input object

Autogenerated input type of CopyProjectV2.

Input fields for CopyProjectV2Input

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

includeDraftIssues (Boolean)

Include draft issues in the new project.

ownerId (ID!)

The owner ID of the new project.

projectId (ID!)

The ID of the source Project to copy.

title (String!)

The title of the project.

CreateProjectV2FieldInput

Input object

Autogenerated input type of CreateProjectV2Field.

Input fields for CreateProjectV2FieldInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

dataType (ProjectV2CustomFieldType!)

The data type of the field.

iterationConfiguration (ProjectV2IterationFieldConfigurationInput)

Configuration for an iteration field.

name (String!)

The name of the field.

projectId (ID!)

The ID of the Project to create the field in.

singleSelectOptions ([ProjectV2SingleSelectFieldOptionInput!])

Options for a single select field. At least one value is required if data_type is SINGLE_SELECT.

CreateProjectV2Input

Input object

Autogenerated input type of CreateProjectV2.

Input fields for CreateProjectV2Input

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

ownerId (ID!)

The owner ID to create the project under.

repositoryId (ID)

The repository to link the project to.

teamId (ID)

The team to link the project to. The team will be granted read permissions.

title (String!)

The title of the project.

CreateProjectV2IssueFieldInput

Input object

Autogenerated input type of CreateProjectV2IssueField.

Input fields for CreateProjectV2IssueFieldInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

issueFieldId (ID!)

The ID of the IssueField to create the field for.

projectId (ID!)

The ID of the Project to create the field in.

CreateProjectV2StatusUpdateInput

Input object

Autogenerated input type of CreateProjectV2StatusUpdate.

Input fields for CreateProjectV2StatusUpdateInput

NameDescription

body (String)

The body of the status update.

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the Project to create the status update in.

startDate (Date)

The start date of the status update.

status (ProjectV2StatusUpdateStatus)

The status of the status update.

targetDate (Date)

The target date of the status update.

DeleteProjectV2FieldInput

Input object

Autogenerated input type of DeleteProjectV2Field.

Input fields for DeleteProjectV2FieldInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

fieldId (ID!)

The ID of the field to delete.

DeleteProjectV2Input

Input object

Autogenerated input type of DeleteProjectV2.

Input fields for DeleteProjectV2Input

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the Project to delete.

DeleteProjectV2ItemInput

Input object

Autogenerated input type of DeleteProjectV2Item.

Input fields for DeleteProjectV2ItemInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

itemId (ID!)

The ID of the item to be removed.

projectId (ID!)

The ID of the Project from which the item should be removed.

DeleteProjectV2StatusUpdateInput

Input object

Autogenerated input type of DeleteProjectV2StatusUpdate.

Input fields for DeleteProjectV2StatusUpdateInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

statusUpdateId (ID!)

The ID of the status update to be removed.

DeleteProjectV2WorkflowInput

Input object

Autogenerated input type of DeleteProjectV2Workflow.

Input fields for DeleteProjectV2WorkflowInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

workflowId (ID!)

The ID of the workflow to be removed.

LinkProjectV2ToRepositoryInput

Input object

Autogenerated input type of LinkProjectV2ToRepository.

Input fields for LinkProjectV2ToRepositoryInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the project to link to the repository.

repositoryId (ID!)

The ID of the repository to link to the project.

LinkProjectV2ToTeamInput

Input object

Autogenerated input type of LinkProjectV2ToTeam.

Input fields for LinkProjectV2ToTeamInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the project to link to the team.

teamId (ID!)

The ID of the team to link to the project.

MarkProjectV2AsTemplateInput

Input object

Autogenerated input type of MarkProjectV2AsTemplate.

Input fields for MarkProjectV2AsTemplateInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the Project to mark as a template.

ProjectV2Collaborator

Input object

A collaborator to update on a project. Only one of the userId or teamId should be provided.

Input fields for ProjectV2Collaborator

NameDescription

role (ProjectV2Roles!)

The role to grant the collaborator.

teamId (ID)

The ID of the team as a collaborator.

userId (ID)

The ID of the user as a collaborator.

ProjectV2FieldOrder

Input object

Ordering options for project v2 field connections.

Input fields for ProjectV2FieldOrder

NameDescription

direction (OrderDirection!)

The ordering direction.

field (ProjectV2FieldOrderField!)

The field to order the project v2 fields by.

ProjectV2FieldValue

Input object

The values that can be used to update a field of an item inside a Project. Only 1 value can be updated at a time.

Input fields for ProjectV2FieldValue

NameDescription

date (Date)

The ISO 8601 date to set on the field.

iterationId (String)

The id of the iteration to set on the field.

number (Float)

The number to set on the field.

singleSelectOptionId (String)

The id of the single select option to set on the field.

text (String)

The text to set on the field.

ProjectV2Filters

Input object

Ways in which to filter lists of projects.

Input fields for ProjectV2Filters

NameDescription

state (ProjectV2State)

List project v2 filtered by the state given.

ProjectV2ItemFieldValueOrder

Input object

Ordering options for project v2 item field value connections.

Input fields for ProjectV2ItemFieldValueOrder

NameDescription

direction (OrderDirection!)

The ordering direction.

field (ProjectV2ItemFieldValueOrderField!)

The field to order the project v2 item field values by.

ProjectV2ItemOrder

Input object

Ordering options for project v2 item connections.

Input fields for ProjectV2ItemOrder

NameDescription

direction (OrderDirection!)

The ordering direction.

field (ProjectV2ItemOrderField!)

The field to order the project v2 items by.

ProjectV2Iteration

Input object

Represents an iteration.

Input fields for ProjectV2Iteration

NameDescription

duration (Int!)

The duration of the iteration, in days.

startDate (Date!)

The start date for the iteration.

title (String!)

The title for the iteration.

ProjectV2IterationFieldConfigurationInput

Input object

Represents an iteration field configuration.

Input fields for ProjectV2IterationFieldConfigurationInput

NameDescription

duration (Int!)

The duration of each iteration, in days.

iterations ([ProjectV2Iteration!]!)

Zero or more iterations for the field.

startDate (Date!)

The start date for the first iteration.

ProjectV2Order

Input object

Ways in which lists of projects can be ordered upon return.

Input fields for ProjectV2Order

NameDescription

direction (OrderDirection!)

The direction in which to order projects by the specified field.

field (ProjectV2OrderField!)

The field in which to order projects by.

ProjectV2SingleSelectFieldOptionInput

Input object

Represents a single select field option.

Input fields for ProjectV2SingleSelectFieldOptionInput

NameDescription

color (ProjectV2SingleSelectFieldOptionColor!)

The display color of the option.

description (String!)

The description text of the option.

id (String)

The ID of an existing single select option. Include this to preserve the option's identity during updates, preventing item field values from being cleared.

name (String!)

The name of the option.

ProjectV2StatusOrder

Input object

Ways in which project v2 status updates can be ordered.

Input fields for ProjectV2StatusOrder

NameDescription

direction (OrderDirection!)

The direction in which to order nodes.

field (ProjectV2StatusUpdateOrderField!)

The field by which to order nodes.

ProjectV2ViewOrder

Input object

Ordering options for project v2 view connections.

Input fields for ProjectV2ViewOrder

NameDescription

direction (OrderDirection!)

The ordering direction.

field (ProjectV2ViewOrderField!)

The field to order the project v2 views by.

ProjectV2WorkflowOrder

Input object

Ordering options for project v2 workflows connections.

Input fields for ProjectV2WorkflowOrder

NameDescription

direction (OrderDirection!)

The ordering direction.

field (ProjectV2WorkflowsOrderField!)

The field to order the project v2 workflows by.

UnarchiveProjectV2ItemInput

Input object

Autogenerated input type of UnarchiveProjectV2Item.

Input fields for UnarchiveProjectV2ItemInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

itemId (ID!)

The ID of the ProjectV2Item to unarchive.

projectId (ID!)

The ID of the Project to archive the item from.

UnlinkProjectV2FromRepositoryInput

Input object

Autogenerated input type of UnlinkProjectV2FromRepository.

Input fields for UnlinkProjectV2FromRepositoryInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the project to unlink from the repository.

repositoryId (ID!)

The ID of the repository to unlink from the project.

UnlinkProjectV2FromTeamInput

Input object

Autogenerated input type of UnlinkProjectV2FromTeam.

Input fields for UnlinkProjectV2FromTeamInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the project to unlink from the team.

teamId (ID!)

The ID of the team to unlink from the project.

UnmarkProjectV2AsTemplateInput

Input object

Autogenerated input type of UnmarkProjectV2AsTemplate.

Input fields for UnmarkProjectV2AsTemplateInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the Project to unmark as a template.

UpdateProjectV2CollaboratorsInput

Input object

Autogenerated input type of UpdateProjectV2Collaborators.

Input fields for UpdateProjectV2CollaboratorsInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

collaborators ([ProjectV2Collaborator!]!)

The collaborators to update.

projectId (ID!)

The ID of the project to update the collaborators for.

UpdateProjectV2DraftIssueInput

Input object

Autogenerated input type of UpdateProjectV2DraftIssue.

Input fields for UpdateProjectV2DraftIssueInput

NameDescription

assigneeIds ([ID!])

The IDs of the assignees of the draft issue.

body (String)

The body of the draft issue.

clientMutationId (String)

A unique identifier for the client performing the mutation.

draftIssueId (ID!)

The ID of the draft issue to update.

title (String)

The title of the draft issue.

UpdateProjectV2FieldInput

Input object

Autogenerated input type of UpdateProjectV2Field.

Input fields for UpdateProjectV2FieldInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

fieldId (ID!)

The ID of the field to update.

iterationConfiguration (ProjectV2IterationFieldConfigurationInput)

Configuration for a field of type ITERATION. Empty input is ignored, provided values overwrite the existing configuration, and existing configuration should be fetched for partial updates.

name (String)

The name to update.

singleSelectOptions ([ProjectV2SingleSelectFieldOptionInput!])

Options for a field of type SINGLE_SELECT. Empty input is ignored, provided values overwrite existing options, and existing options should be fetched for partial updates.

UpdateProjectV2Input

Input object

Autogenerated input type of UpdateProjectV2.

Input fields for UpdateProjectV2Input

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

closed (Boolean)

Set the project to closed or open.

projectId (ID!)

The ID of the Project to update.

public (Boolean)

Set the project to public or private.

readme (String)

Set the readme description of the project.

shortDescription (String)

Set the short description of the project.

title (String)

Set the title of the project.

UpdateProjectV2ItemFieldValueInput

Input object

Autogenerated input type of UpdateProjectV2ItemFieldValue.

Input fields for UpdateProjectV2ItemFieldValueInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

fieldId (ID!)

The ID of the field to be updated.

itemId (ID!)

The ID of the item to be updated.

projectId (ID!)

The ID of the Project.

value (ProjectV2FieldValue!)

The value which will be set on the field.

UpdateProjectV2ItemPositionInput

Input object

Autogenerated input type of UpdateProjectV2ItemPosition.

Input fields for UpdateProjectV2ItemPositionInput

NameDescription

afterId (ID)

The ID of the item to position this item after. If omitted or set to null the item will be moved to top.

clientMutationId (String)

A unique identifier for the client performing the mutation.

itemId (ID!)

The ID of the item to be moved.

projectId (ID!)

The ID of the Project.

UpdateProjectV2StatusUpdateInput

Input object

Autogenerated input type of UpdateProjectV2StatusUpdate.

Input fields for UpdateProjectV2StatusUpdateInput

NameDescription

body (String)

The body of the status update.

clientMutationId (String)

A unique identifier for the client performing the mutation.

startDate (Date)

The start date of the status update.

status (ProjectV2StatusUpdateStatus)

The status of the status update.

statusUpdateId (ID!)

The ID of the status update to be updated.

targetDate (Date)

The target date of the status update.