debian-mirror-gitlab/doc/api/graphql/reference/index.md
2019-09-30 21:07:59 +05:30

19 KiB

GraphQL API Resources

This documentation is self-generated based on GitLab current GraphQL schema.

The API can be explored interactively using the GraphiQL IDE.

Objects

AddAwardEmojiPayload

Name Type Description
clientMutationId String A unique identifier for the client performing the mutation.
errors String! => Array Reasons why the mutation failed.
awardEmoji AwardEmoji The award emoji after mutation

AwardEmoji

Name Type Description
name String! The emoji name
description String! The emoji description
unicode String! The emoji in unicode
emoji String! The emoji as an icon
unicodeVersion String! The unicode version for this emoji
user User! The user who awarded the emoji

Blob

Name Type Description
id ID!
name String!
type EntryType!
path String!
flatPath String!
webUrl String
lfsOid String

Commit

Name Type Description
id ID!
sha String!
title String
description String
message String
authoredDate Time
webUrl String!
author User
latestPipeline Pipeline Latest pipeline for this commit

DetailedStatus

Name Type Description
group String!
icon String!
favicon String!
detailsPath String!
hasDetails Boolean!
label String!
text String!
tooltip String!

DiffPosition

Name Type Description
headSha String! The sha of the head at the time the comment was made
baseSha String The merge base of the branch the comment was made on
startSha String! The sha of the branch being compared against
filePath String! The path of the file that was changed
oldPath String The path of the file on the start sha.
newPath String The path of the file on the head sha.
positionType DiffPositionType!
oldLine Int The line on start sha that was changed
newLine Int The line on head sha that was changed
x Int The X postion on which the comment was made
y Int The Y position on which the comment was made
width Int The total width of the image
height Int The total height of the image

Discussion

Name Type Description
id ID!
createdAt Time!

Group

Name Type Description
id ID!
name String!
path String!
fullName String!
fullPath ID!
description String
descriptionHtml String The GitLab Flavored Markdown rendering of description
visibility String
lfsEnabled Boolean
requestAccessEnabled Boolean
userPermissions GroupPermissions! Permissions for the current user on the resource
webUrl String!
avatarUrl String
parent Group

GroupPermissions

Name Type Description
readGroup Boolean! Whether or not a user can perform read_group on this resource

Issue

Name Type Description
userPermissions IssuePermissions! Permissions for the current user on the resource
iid ID!
title String!
titleHtml String The GitLab Flavored Markdown rendering of title
description String
descriptionHtml String The GitLab Flavored Markdown rendering of description
state IssueState!
reference String!
author User!
milestone Milestone
dueDate Time
confidential Boolean!
discussionLocked Boolean!
upvotes Int!
downvotes Int!
userNotesCount Int!
webPath String!
webUrl String!
relativePosition Int
closedAt Time
createdAt Time!
updatedAt Time!
taskCompletionStatus TaskCompletionStatus!

IssuePermissions

Name Type Description
readIssue Boolean! Whether or not a user can perform read_issue on this resource
adminIssue Boolean! Whether or not a user can perform admin_issue on this resource
updateIssue Boolean! Whether or not a user can perform update_issue on this resource
createNote Boolean! Whether or not a user can perform create_note on this resource
reopenIssue Boolean! Whether or not a user can perform reopen_issue on this resource

Label

Name Type Description
description String
descriptionHtml String The GitLab Flavored Markdown rendering of description
title String!
color String!
textColor String!

MergeRequest

Name Type Description
userPermissions MergeRequestPermissions! Permissions for the current user on the resource
id ID!
iid String!
title String!
titleHtml String The GitLab Flavored Markdown rendering of title
description String
descriptionHtml String The GitLab Flavored Markdown rendering of description
state MergeRequestState!
createdAt Time!
updatedAt Time!
sourceProject Project
targetProject Project!
project Project!
projectId Int!
sourceProjectId Int
targetProjectId Int!
sourceBranch String!
targetBranch String!
workInProgress Boolean!
mergeWhenPipelineSucceeds Boolean
diffHeadSha String
mergeCommitSha String
userNotesCount Int
shouldRemoveSourceBranch Boolean
forceRemoveSourceBranch Boolean
mergeStatus String
inProgressMergeCommitSha String
mergeError String
allowCollaboration Boolean
shouldBeRebased Boolean!
rebaseCommitSha String
rebaseInProgress Boolean!
mergeCommitMessage String
defaultMergeCommitMessage String
mergeOngoing Boolean!
sourceBranchExists Boolean!
mergeableDiscussionsState Boolean
webUrl String
upvotes Int!
downvotes Int!
subscribed Boolean!
headPipeline Pipeline
taskCompletionStatus TaskCompletionStatus!

MergeRequestPermissions

Name Type Description
readMergeRequest Boolean! Whether or not a user can perform read_merge_request on this resource
adminMergeRequest Boolean! Whether or not a user can perform admin_merge_request on this resource
updateMergeRequest Boolean! Whether or not a user can perform update_merge_request on this resource
createNote Boolean! Whether or not a user can perform create_note on this resource
pushToSourceBranch Boolean! Whether or not a user can perform push_to_source_branch on this resource
removeSourceBranch Boolean! Whether or not a user can perform remove_source_branch on this resource
cherryPickOnCurrentMergeRequest Boolean! Whether or not a user can perform cherry_pick_on_current_merge_request on this resource
revertOnCurrentMergeRequest Boolean! Whether or not a user can perform revert_on_current_merge_request on this resource

MergeRequestSetWipPayload

Name Type Description
clientMutationId String A unique identifier for the client performing the mutation.
errors String! => Array Reasons why the mutation failed.
mergeRequest MergeRequest The merge request after mutation

Metadata

Name Type Description
version String!
revision String!

Milestone

Name Type Description
description String
title String!
state String!
dueDate Time
startDate Time
createdAt Time!
updatedAt Time!

Namespace

Name Type Description
id ID!
name String!
path String!
fullName String!
fullPath ID!
description String
descriptionHtml String The GitLab Flavored Markdown rendering of description
visibility String
lfsEnabled Boolean
requestAccessEnabled Boolean

Note

Name Type Description
userPermissions NotePermissions! Permissions for the current user on the resource
id ID!
project Project The project this note is associated to
author User! The user who wrote this note
resolvedBy User The user that resolved the discussion
system Boolean! Whether or not this note was created by the system or by a user
body String! The content note itself
bodyHtml String The GitLab Flavored Markdown rendering of note
createdAt Time!
updatedAt Time!
discussion Discussion The discussion this note is a part of
resolvable Boolean!
resolvedAt Time The time the discussion was resolved
position DiffPosition The position of this note on a diff

NotePermissions

Name Type Description
readNote Boolean! Whether or not a user can perform read_note on this resource
createNote Boolean! Whether or not a user can perform create_note on this resource
adminNote Boolean! Whether or not a user can perform admin_note on this resource
resolveNote Boolean! Whether or not a user can perform resolve_note on this resource
awardEmoji Boolean! Whether or not a user can perform award_emoji on this resource

PageInfo

Name Type Description
hasNextPage Boolean! When paginating forwards, are there more items?
hasPreviousPage Boolean! When paginating backwards, are there more items?
startCursor String When paginating backwards, the cursor to continue.
endCursor String When paginating forwards, the cursor to continue.

Pipeline

Name Type Description
userPermissions PipelinePermissions! Permissions for the current user on the resource
id ID!
iid String!
sha String!
beforeSha String
status PipelineStatusEnum!
detailedStatus DetailedStatus!
duration Int Duration of the pipeline in seconds
coverage Float Coverage percentage
createdAt Time!
updatedAt Time!
startedAt Time
finishedAt Time
committedAt Time

PipelinePermissions

Name Type Description
updatePipeline Boolean! Whether or not a user can perform update_pipeline on this resource
adminPipeline Boolean! Whether or not a user can perform admin_pipeline on this resource
destroyPipeline Boolean! Whether or not a user can perform destroy_pipeline on this resource

Project

Name Type Description
userPermissions ProjectPermissions! Permissions for the current user on the resource
id ID!
fullPath ID!
path String!
nameWithNamespace String!
name String!
description String
descriptionHtml String The GitLab Flavored Markdown rendering of description
tagList String
sshUrlToRepo String
httpUrlToRepo String
webUrl String
starCount Int!
forksCount Int!
createdAt Time
lastActivityAt Time
archived Boolean
visibility String
containerRegistryEnabled Boolean
sharedRunnersEnabled Boolean
lfsEnabled Boolean
mergeRequestsFfOnlyEnabled Boolean
avatarUrl String
issuesEnabled Boolean
mergeRequestsEnabled Boolean
wikiEnabled Boolean
snippetsEnabled Boolean
jobsEnabled Boolean
publicJobs Boolean
openIssuesCount Int
importStatus String
onlyAllowMergeIfPipelineSucceeds Boolean
requestAccessEnabled Boolean
onlyAllowMergeIfAllDiscussionsAreResolved Boolean
printingMergeRequestLinkEnabled Boolean
namespace Namespace
group Group
statistics ProjectStatistics
repository Repository
mergeRequest MergeRequest
issue Issue

ProjectPermissions

Name Type Description
changeNamespace Boolean! Whether or not a user can perform change_namespace on this resource
changeVisibilityLevel Boolean! Whether or not a user can perform change_visibility_level on this resource
renameProject Boolean! Whether or not a user can perform rename_project on this resource
removeProject Boolean! Whether or not a user can perform remove_project on this resource
archiveProject Boolean! Whether or not a user can perform archive_project on this resource
removeForkProject Boolean! Whether or not a user can perform remove_fork_project on this resource
removePages Boolean! Whether or not a user can perform remove_pages on this resource
readProject Boolean! Whether or not a user can perform read_project on this resource
createMergeRequestIn Boolean! Whether or not a user can perform create_merge_request_in on this resource
readWiki Boolean! Whether or not a user can perform read_wiki on this resource
readProjectMember Boolean! Whether or not a user can perform read_project_member on this resource
createIssue Boolean! Whether or not a user can perform create_issue on this resource
uploadFile Boolean! Whether or not a user can perform upload_file on this resource
readCycleAnalytics Boolean! Whether or not a user can perform read_cycle_analytics on this resource
downloadCode Boolean! Whether or not a user can perform download_code on this resource
downloadWikiCode Boolean! Whether or not a user can perform download_wiki_code on this resource
forkProject Boolean! Whether or not a user can perform fork_project on this resource
createProjectSnippet Boolean! Whether or not a user can perform create_project_snippet on this resource
readCommitStatus Boolean! Whether or not a user can perform read_commit_status on this resource
requestAccess Boolean! Whether or not a user can perform request_access on this resource
createPipeline Boolean! Whether or not a user can perform create_pipeline on this resource
createPipelineSchedule Boolean! Whether or not a user can perform create_pipeline_schedule on this resource
createMergeRequestFrom Boolean! Whether or not a user can perform create_merge_request_from on this resource
createWiki Boolean! Whether or not a user can perform create_wiki on this resource
pushCode Boolean! Whether or not a user can perform push_code on this resource
createDeployment Boolean! Whether or not a user can perform create_deployment on this resource
pushToDeleteProtectedBranch Boolean! Whether or not a user can perform push_to_delete_protected_branch on this resource
adminWiki Boolean! Whether or not a user can perform admin_wiki on this resource
adminProject Boolean! Whether or not a user can perform admin_project on this resource
updatePages Boolean! Whether or not a user can perform update_pages on this resource
adminRemoteMirror Boolean! Whether or not a user can perform admin_remote_mirror on this resource
createLabel Boolean! Whether or not a user can perform create_label on this resource
updateWiki Boolean! Whether or not a user can perform update_wiki on this resource
destroyWiki Boolean! Whether or not a user can perform destroy_wiki on this resource
createPages Boolean! Whether or not a user can perform create_pages on this resource
destroyPages Boolean! Whether or not a user can perform destroy_pages on this resource
readPagesContent Boolean! Whether or not a user can perform read_pages_content on this resource

ProjectStatistics

Name Type Description
commitCount Int!
storageSize Int!
repositorySize Int!
lfsObjectsSize Int!
buildArtifactsSize Int!
packagesSize Int!
wikiSize Int

RemoveAwardEmojiPayload

Name Type Description
clientMutationId String A unique identifier for the client performing the mutation.
errors String! => Array Reasons why the mutation failed.
awardEmoji AwardEmoji The award emoji after mutation

Repository

Name Type Description
rootRef String
empty Boolean!
exists Boolean!
tree Tree

Submodule

Name Type Description
id ID!
name String!
type EntryType!
path String!
flatPath String!

TaskCompletionStatus

Name Type Description
count Int!
completedCount Int!

ToggleAwardEmojiPayload

Name Type Description
clientMutationId String A unique identifier for the client performing the mutation.
errors String! => Array Reasons why the mutation failed.
awardEmoji AwardEmoji The award emoji after mutation
toggledOn Boolean! True when the emoji was awarded, false when it was removed

Tree

Name Type Description
lastCommit Commit

TreeEntry

Name Type Description
id ID!
name String!
type EntryType!
path String!
flatPath String!
webUrl String

User

Name Type Description
name String!
username String!
avatarUrl String!
webUrl String!