Эта версия GitHub Enterprise Server будет прекращена 2026-06-02. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, повышения безопасности и новых функций выполните обновление до последней версии GitHub Enterprise Server. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

Reference documentation for GraphQL schema types in the Projects (classic) category.

В этой статье

Mutations

addProjectCard

Mutation

Adds a card to a ProjectColumn. Either contentId or note must be provided but not both.

Поля ввода для addProjectCard

Возвращаемые поля для addProjectCard

Имя.Description

cardEdge (ProjectCardEdge)

The edge from the ProjectColumn's card connection.

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectColumn (ProjectColumn)

The ProjectColumn.

addProjectColumn

Mutation

Adds a column to a Project.

Поля ввода для addProjectColumn

Возвращаемые поля для addProjectColumn

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

columnEdge (ProjectColumnEdge)

The edge from the project's column connection.

project (Project)

The project.

cloneProject

Mutation

Creates a new project by cloning configuration from an existing project.

Поля ввода для cloneProject

Возвращаемые поля для cloneProject

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

jobStatusId (String)

The id of the JobStatus for populating cloned fields.

project (Project)

The new cloned project.

convertProjectCardNoteToIssue

Mutation

Convert a project note card to one associated with a newly created issue.

Поля ввода для convertProjectCardNoteToIssue

Возвращаемые поля для convertProjectCardNoteToIssue

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectCard (ProjectCard)

The updated ProjectCard.

createProject

Mutation

Creates a new project.

Поля ввода для createProject

Возвращаемые поля для createProject

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

project (Project)

The new project.

deleteProject

Mutation

Deletes a project.

Поля ввода для deleteProject

Возвращаемые поля для deleteProject

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

owner (ProjectOwner)

The repository or organization the project was removed from.

deleteProjectCard

Mutation

Deletes a project card.

Поля ввода для deleteProjectCard

Возвращаемые поля для deleteProjectCard

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

column (ProjectColumn)

The column the deleted card was in.

deletedCardId (ID)

The deleted card ID.

deleteProjectColumn

Mutation

Deletes a project column.

Поля ввода для deleteProjectColumn

Возвращаемые поля для deleteProjectColumn

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

deletedColumnId (ID)

The deleted column ID.

project (Project)

The project the deleted column was in.

linkRepositoryToProject

Mutation

Creates a repository link for a project.

Поля ввода для linkRepositoryToProject

Возвращаемые поля для linkRepositoryToProject

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

project (Project)

The linked Project.

repository (Repository)

The linked Repository.

moveProjectCard

Mutation

Moves a project card to another place.

Поля ввода для moveProjectCard

Возвращаемые поля для moveProjectCard

Имя.Description

cardEdge (ProjectCardEdge)

The new edge of the moved card.

clientMutationId (String)

A unique identifier for the client performing the mutation.

moveProjectColumn

Mutation

Moves a project column to another place.

Поля ввода для moveProjectColumn

Возвращаемые поля для moveProjectColumn

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

columnEdge (ProjectColumnEdge)

The new edge of the moved column.

unlinkRepositoryFromProject

Mutation

Deletes a repository link from a project.

Поля ввода для unlinkRepositoryFromProject

Возвращаемые поля для unlinkRepositoryFromProject

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

project (Project)

The linked Project.

repository (Repository)

The linked Repository.

updateProject

Mutation

Updates an existing project.

Поля ввода для updateProject

Возвращаемые поля для updateProject

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

project (Project)

The updated project.

updateProjectCard

Mutation

Updates an existing project card.

Поля ввода для updateProjectCard

Возвращаемые поля для updateProjectCard

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectCard (ProjectCard)

The updated ProjectCard.

updateProjectColumn

Mutation

Updates an existing project column.

Поля ввода для updateProjectColumn

Возвращаемые поля для updateProjectColumn

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectColumn (ProjectColumn)

The updated project column.

Objects

AddedToProjectEvent

Object

Represents aadded_to_projectevent on a given issue or pull request.

AddedToProjectEvent Реализует

Поля для AddedToProjectEvent

Имя.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.

id (ID!)

The Node ID of the AddedToProjectEvent object.

project (Project)

Project referenced by event.

projectCard (ProjectCard)

Project card referenced by this project event.

projectColumnName (String!)

Column name referenced by this project event.

MovedColumnsInProjectEvent

Object

Represents amoved_columns_in_projectevent on a given issue or pull request.

MovedColumnsInProjectEvent Реализует

Поля для MovedColumnsInProjectEvent

Имя.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.

id (ID!)

The Node ID of the MovedColumnsInProjectEvent object.

previousProjectColumnName (String!)

Column name the issue or pull request was moved from.

project (Project)

Project referenced by event.

projectCard (ProjectCard)

Project card referenced by this project event.

projectColumnName (String!)

Column name the issue or pull request was moved to.

Project

Object

Projects manage issues, pull requests and notes within a project owner.

Project Реализует

Поля для Project

Имя.Description

body (String)

The project's description body.

bodyHTML (HTML!)

The projects description body rendered to HTML.

closed (Boolean!)

Indicates if the object is closed (definition of closed may depend on type).

closedAt (DateTime)

Identifies the date and time when the object was closed.

columns (ProjectColumnConnection!)

List of columns in the project.

Аргументы для columns

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

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.

id (ID!)

The Node ID of the Project object.

name (String!)

The project's name.

number (Int!)

The project's number.

owner (ProjectOwner!)

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

pendingCards (ProjectCardConnection!)

List of pending cards in this project.

Аргументы для pendingCards

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

progress (ProjectProgress!)

Project progress details.

resourcePath (URI!)

The HTTP path for this project.

state (ProjectState!)

Whether the project is open or closed.

updatedAt (DateTime!)

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

url (URI!)

The HTTP URL for this 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.

ProjectCard

Object

A card in a project.

ProjectCard Реализует

Поля для ProjectCard

Имя.Description

column (ProjectColumn)

The project column this card is associated under. A card may only belong to one project column at a time. The column field will be null if the card is created in a pending state and has yet to be associated with a column. Once cards are associated with a column, they will not become pending in the future.

content (ProjectCardItem)

The card content item.

createdAt (DateTime!)

Identifies the date and time when the object was created.

creator (Actor)

The actor who created this card.

databaseId (Int)

Identifies the primary key from the database.

id (ID!)

The Node ID of the ProjectCard object.

isArchived (Boolean!)

Whether the card is archived.

note (String)

The card note.

project (Project!)

The project that contains this card.

resourcePath (URI!)

The HTTP path for this card.

state (ProjectCardState)

The state of ProjectCard.

updatedAt (DateTime!)

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

url (URI!)

The HTTP URL for this card.

ProjectCardConnection

Object

The connection type for ProjectCard.

Поля для ProjectCardConnection

Имя.Description

edges ([ProjectCardEdge])

A list of edges.

nodes ([ProjectCard])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectCardEdge

Object

An edge in a connection.

Поля для ProjectCardEdge

Имя.Description

cursor (String!)

A cursor for use in pagination.

node (ProjectCard)

The item at the end of the edge.

ProjectColumn

Object

A column inside a project.

ProjectColumn Реализует

Поля для ProjectColumn

Имя.Description

cards (ProjectCardConnection!)

List of cards in the column.

Аргументы для cards

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

createdAt (DateTime!)

Identifies the date and time when the object was created.

databaseId (Int)

Identifies the primary key from the database.

id (ID!)

The Node ID of the ProjectColumn object.

name (String!)

The project column's name.

project (Project!)

The project that contains this column.

purpose (ProjectColumnPurpose)

The semantic purpose of the column.

resourcePath (URI!)

The HTTP path for this project column.

updatedAt (DateTime!)

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

url (URI!)

The HTTP URL for this project column.

ProjectColumnConnection

Object

The connection type for ProjectColumn.

Поля для ProjectColumnConnection

Имя.Description

edges ([ProjectColumnEdge])

A list of edges.

nodes ([ProjectColumn])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectColumnEdge

Object

An edge in a connection.

Поля для ProjectColumnEdge

Имя.Description

cursor (String!)

A cursor for use in pagination.

node (ProjectColumn)

The item at the end of the edge.

ProjectConnection

Object

A list of projects associated with the owner.

Поля для ProjectConnection

Имя.Description

edges ([ProjectEdge])

A list of edges.

nodes ([Project])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

ProjectEdge

Object

An edge in a connection.

Поля для ProjectEdge

Имя.Description

cursor (String!)

A cursor for use in pagination.

node (Project)

The item at the end of the edge.

ProjectProgress

Object

Project progress stats.

Поля для ProjectProgress

Имя.Description

doneCount (Int!)

The number of done cards.

donePercentage (Float!)

The percentage of done cards.

enabled (Boolean!)

Whether progress tracking is enabled and cards with purpose exist for this project.

inProgressCount (Int!)

The number of in-progress cards.

inProgressPercentage (Float!)

The percentage of in-progress cards.

todoCount (Int!)

The number of to do cards.

todoPercentage (Float!)

The percentage of to do cards.

RemovedFromProjectEvent

Object

Represents aremoved_from_projectevent on a given issue or pull request.

RemovedFromProjectEvent Реализует

Поля для RemovedFromProjectEvent

Имя.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.

id (ID!)

The Node ID of the RemovedFromProjectEvent object.

project (Project)

Project referenced by event.

projectColumnName (String!)

Column name referenced by this project event.

Interfaces

ProjectOwner

Interface

Represents an owner of a Project.

ProjectOwner реализуется с помощью

Поля для ProjectOwner

Имя.Description

id (ID!)

The Node ID of the ProjectOwner object.

project (Project)

Find project by number.

Аргументы для project

  • number (Int!)

    The project number to find.

projects (ProjectConnection!)

A list of projects under the owner.

Аргументы для projects

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

    Ordering options for projects returned from the connection.

  • search (String)

    Query to search projects by, currently only searching by name.

projectsResourcePath (URI!)

The HTTP path listing owners projects.

projectsUrl (URI!)

The HTTP URL listing owners projects.

viewerCanCreateProjects (Boolean!)

Can the current viewer create new projects on this owner.

Enums

ProjectCardArchivedState

Enum

The possible archived states of a project card.

Значения для ProjectCardArchivedState

Имя.Description
ARCHIVED

A project card that is archived.

NOT_ARCHIVED

A project card that is not archived.

ProjectCardState

Enum

Various content states of a ProjectCard.

Значения для ProjectCardState

Имя.Description
CONTENT_ONLY

The card has content only.

NOTE_ONLY

The card has a note only.

REDACTED

The card is redacted.

ProjectColumnPurpose

Enum

The semantic purpose of the column - todo, in progress, or done.

Значения для ProjectColumnPurpose

Имя.Description
DONE

The column contains cards which are complete.

IN_PROGRESS

The column contains cards which are currently being worked on.

TODO

The column contains cards still to be worked on.

ProjectOrderField

Enum

Properties by which project connections can be ordered.

Значения для ProjectOrderField

Имя.Description
CREATED_AT

Order projects by creation time.

NAME

Order projects by name.

UPDATED_AT

Order projects by update time.

ProjectState

Enum

State of the project; eitheropenor 'closed'.

Значения для ProjectState

Имя.Description
CLOSED

The project is closed.

OPEN

The project is open.

ProjectTemplate

Enum

GitHub-provided templates for Projects.

Значения для ProjectTemplate

Имя.Description
AUTOMATED_KANBAN_V2

Create a board with v2 triggers to automatically move cards across To do, In progress and Done columns.

AUTOMATED_REVIEWS_KANBAN

Create a board with triggers to automatically move cards across columns with review automation.

BASIC_KANBAN

Create a board with columns for To do, In progress and Done.

BUG_TRIAGE

Create a board to triage and prioritize bugs with To do, priority, and Done columns.

Unions

ProjectCardItem

Union

Types that can be inside Project Cards.

Возможные типы для ProjectCardItem

Input objects

AddProjectCardInput

Input object

Autogenerated input type of AddProjectCard.

Поля ввода для AddProjectCardInput

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

contentId (ID)

The content of the card. Must be a member of the ProjectCardItem union.

note (String)

The note on the card.

projectColumnId (ID!)

The Node ID of the ProjectColumn.

AddProjectColumnInput

Input object

Autogenerated input type of AddProjectColumn.

Поля ввода для AddProjectColumnInput

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The name of the column.

projectId (ID!)

The Node ID of the project.

CloneProjectInput

Input object

Autogenerated input type of CloneProject.

Поля ввода для CloneProjectInput

Имя.Description

body (String)

The description of the project.

clientMutationId (String)

A unique identifier for the client performing the mutation.

includeWorkflows (Boolean!)

Whether or not to clone the source project's workflows.

name (String!)

The name of the project.

public (Boolean)

The visibility of the project, defaults to false (private).

sourceId (ID!)

The source project to clone.

targetOwnerId (ID!)

The owner ID to create the project under.

ConvertProjectCardNoteToIssueInput

Input object

Autogenerated input type of ConvertProjectCardNoteToIssue.

Поля ввода для ConvertProjectCardNoteToIssueInput

Имя.Description

body (String)

The body of the newly created issue.

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectCardId (ID!)

The ProjectCard ID to convert.

repositoryId (ID!)

The ID of the repository to create the issue in.

title (String)

The title of the newly created issue. Defaults to the card's note text.

CreateProjectInput

Input object

Autogenerated input type of CreateProject.

Поля ввода для CreateProjectInput

Имя.Description

body (String)

The description of project.

clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The name of project.

ownerId (ID!)

The owner ID to create the project under.

repositoryIds ([ID!])

A list of repository IDs to create as linked repositories for the project.

template (ProjectTemplate)

The name of the GitHub-provided template.

DeleteProjectCardInput

Input object

Autogenerated input type of DeleteProjectCard.

Поля ввода для DeleteProjectCardInput

Имя.Description

cardId (ID!)

The id of the card to delete.

clientMutationId (String)

A unique identifier for the client performing the mutation.

DeleteProjectColumnInput

Input object

Autogenerated input type of DeleteProjectColumn.

Поля ввода для DeleteProjectColumnInput

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

columnId (ID!)

The id of the column to delete.

DeleteProjectInput

Input object

Autogenerated input type of DeleteProject.

Поля ввода для DeleteProjectInput

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The Project ID to update.

LinkRepositoryToProjectInput

Input object

Autogenerated input type of LinkRepositoryToProject.

Поля ввода для LinkRepositoryToProjectInput

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the Project to link to a Repository.

repositoryId (ID!)

The ID of the Repository to link to a Project.

MoveProjectCardInput

Input object

Autogenerated input type of MoveProjectCard.

Поля ввода для MoveProjectCardInput

Имя.Description

afterCardId (ID)

Place the new card after the card with this id. Pass null to place it at the top.

cardId (ID!)

The id of the card to move.

clientMutationId (String)

A unique identifier for the client performing the mutation.

columnId (ID!)

The id of the column to move it into.

MoveProjectColumnInput

Input object

Autogenerated input type of MoveProjectColumn.

Поля ввода для MoveProjectColumnInput

Имя.Description

afterColumnId (ID)

Place the new column after the column with this id. Pass null to place it at the front.

clientMutationId (String)

A unique identifier for the client performing the mutation.

columnId (ID!)

The id of the column to move.

ProjectCardImport

Input object

An issue or PR and its owning repository to be used in a project card.

Поля ввода для ProjectCardImport

Имя.Description

number (Int!)

The issue or pull request number.

repository (String!)

Repository name with owner (owner/repository).

ProjectColumnImport

Input object

A project column and a list of its issues and PRs.

Поля ввода для ProjectColumnImport

Имя.Description

columnName (String!)

The name of the column.

issues ([ProjectCardImport!])

A list of issues and pull requests in the column.

position (Int!)

The position of the column, starting from 0.

ProjectOrder

Input object

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

Поля ввода для ProjectOrder

Имя.Description

direction (OrderDirection!)

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

field (ProjectOrderField!)

The field in which to order projects by.

UnlinkRepositoryFromProjectInput

Input object

Autogenerated input type of UnlinkRepositoryFromProject.

Поля ввода для UnlinkRepositoryFromProjectInput

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the Project linked to the Repository.

repositoryId (ID!)

The ID of the Repository linked to the Project.

UpdateProjectCardInput

Input object

Autogenerated input type of UpdateProjectCard.

Поля ввода для UpdateProjectCardInput

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

isArchived (Boolean)

Whether or not the ProjectCard should be archived.

note (String)

The note of ProjectCard.

projectCardId (ID!)

The ProjectCard ID to update.

UpdateProjectColumnInput

Input object

Autogenerated input type of UpdateProjectColumn.

Поля ввода для UpdateProjectColumnInput

Имя.Description

clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The name of project column.

projectColumnId (ID!)

The ProjectColumn ID to update.

UpdateProjectInput

Input object

Autogenerated input type of UpdateProject.

Поля ввода для UpdateProjectInput

Имя.Description

body (String)

The description of project.

clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String)

The name of project.

projectId (ID!)

The Project ID to update.

public (Boolean)

Whether the project is public or not.

state (ProjectState)

Whether the project is open or closed.