debian-mirror-gitlab/doc/api/graphql/reference/index.md

2663 lines
118 KiB
Markdown
Raw Normal View History

2019-09-30 21:07:59 +05:30
<!---
This documentation is auto generated by a script.
Please do not edit this file directly, check compile_docs task on lib/tasks/gitlab/graphql.rake.
--->
# GraphQL API Resources
This documentation is self-generated based on GitLab current GraphQL schema.
The API can be explored interactively using the [GraphiQL IDE](../index.md#graphiql).
2020-03-13 15:44:24 +05:30
Each table below documents a GraphQL type. Types match loosely to models, but not all
fields and methods on a model are available via GraphQL.
2019-09-30 21:07:59 +05:30
2020-04-08 14:13:33 +05:30
CAUTION: **Caution:**
Fields that are deprecated are marked with **{warning-solid}**.
2020-06-23 00:09:42 +05:30
## AccessLevel
Represents the access level of a relationship between a User and object that it is related to
| Name | Type | Description |
| --- | ---- | ---------- |
| `integerValue` | Int | Integer representation of access level |
| `stringValue` | AccessLevelEnum | String representation of access level |
2020-03-13 15:44:24 +05:30
## AddAwardEmojiPayload
Autogenerated return type of AddAwardEmoji
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `awardEmoji` | AwardEmoji | The award emoji after mutation |
2019-09-30 21:07:59 +05:30
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
## AddProjectToSecurityDashboardPayload
Autogenerated return type of AddProjectToSecurityDashboard
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `project` | Project | Project that was added to the Instance Security Dashboard |
2019-09-30 21:07:59 +05:30
2020-04-08 14:13:33 +05:30
## AdminSidekiqQueuesDeleteJobsPayload
Autogenerated return type of AdminSidekiqQueuesDeleteJobs
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-04-08 14:13:33 +05:30
| `result` | DeleteJobsResponse | Information about the status of the deletion request |
2020-05-24 23:13:21 +05:30
## AlertManagementAlert
Describes an alert from the project's Alert Management
| Name | Type | Description |
| --- | ---- | ---------- |
| `createdAt` | Time | Timestamp the alert was created |
| `description` | String | Description of the alert |
| `details` | JSON | Alert details |
2020-10-24 23:57:45 +05:30
| `detailsUrl` | String! | The URL of the alert detail page |
2020-05-24 23:13:21 +05:30
| `endedAt` | Time | Timestamp the alert ended |
| `eventCount` | Int | Number of events of this alert |
| `hosts` | String! => Array | List of hosts the alert came from |
| `iid` | ID! | Internal ID of the alert |
| `issueIid` | ID | Internal ID of the GitLab issue attached to the alert |
2020-07-28 23:09:34 +05:30
| `metricsDashboardUrl` | String | URL for metrics embed for the alert |
2020-05-24 23:13:21 +05:30
| `monitoringTool` | String | Monitoring tool the alert came from |
2020-10-24 23:57:45 +05:30
| `prometheusAlert` | PrometheusAlert | The alert condition for Prometheus |
| `runbook` | String | Runbook for the alert as defined in alert details |
2020-05-24 23:13:21 +05:30
| `service` | String | Service the alert came from |
| `severity` | AlertManagementSeverity | Severity of the alert |
| `startedAt` | Time | Timestamp the alert was raised |
| `status` | AlertManagementStatus | Status of the alert |
| `title` | String | Title of the alert |
| `updatedAt` | Time | Timestamp the alert was last updated |
## AlertManagementAlertStatusCountsType
Represents total number of alerts for the represented categories
| Name | Type | Description |
| --- | ---- | ---------- |
| `acknowledged` | Int | Number of alerts with status ACKNOWLEDGED for the project |
| `all` | Int | Total number of alerts for the project |
| `ignored` | Int | Number of alerts with status IGNORED for the project |
| `open` | Int | Number of alerts with status TRIGGERED or ACKNOWLEDGED for the project |
| `resolved` | Int | Number of alerts with status RESOLVED for the project |
| `triggered` | Int | Number of alerts with status TRIGGERED for the project |
2020-06-23 00:09:42 +05:30
## AlertSetAssigneesPayload
Autogenerated return type of AlertSetAssignees
| Name | Type | Description |
| --- | ---- | ---------- |
| `alert` | AlertManagementAlert | The alert after mutation |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue created after mutation |
2020-07-28 23:09:34 +05:30
| `todo` | Todo | The todo after mutation |
## AlertTodoCreatePayload
Autogenerated return type of AlertTodoCreate
| Name | Type | Description |
| --- | ---- | ---------- |
| `alert` | AlertManagementAlert | The alert after mutation |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue created after mutation |
| `todo` | Todo | The todo after mutation |
2020-06-23 00:09:42 +05:30
2020-03-13 15:44:24 +05:30
## AwardEmoji
An emoji awarded by a user.
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `description` | String! | The emoji description |
| `emoji` | String! | The emoji as an icon |
2020-03-13 15:44:24 +05:30
| `name` | String! | The emoji name |
| `unicode` | String! | The emoji in unicode |
2019-09-30 21:07:59 +05:30
| `unicodeVersion` | String! | The unicode version for this emoji |
| `user` | User! | The user who awarded the emoji |
2020-07-28 23:09:34 +05:30
## AwardEmojiAddPayload
Autogenerated return type of AwardEmojiAdd
| Name | Type | Description |
| --- | ---- | ---------- |
| `awardEmoji` | AwardEmoji | The award emoji after mutation |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
## AwardEmojiRemovePayload
Autogenerated return type of AwardEmojiRemove
| Name | Type | Description |
| --- | ---- | ---------- |
| `awardEmoji` | AwardEmoji | The award emoji after mutation |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
## AwardEmojiTogglePayload
Autogenerated return type of AwardEmojiToggle
| Name | Type | Description |
| --- | ---- | ---------- |
| `awardEmoji` | AwardEmoji | The award emoji after mutation |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `toggledOn` | Boolean! | Indicates the status of the emoji. True if the toggle awarded the emoji, and false if the toggle removed the emoji. |
2020-04-22 19:07:51 +05:30
## BaseService
| Name | Type | Description |
| --- | ---- | ---------- |
| `active` | Boolean | Indicates if the service is active |
| `type` | String | Class name of the service |
2020-03-13 15:44:24 +05:30
## Blob
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `flatPath` | String! | Flat path of the entry |
| `id` | ID! | ID of the entry |
| `lfsOid` | String | LFS ID of the blob |
2020-07-28 23:09:34 +05:30
| `mode` | String | Blob mode in numeric format |
2020-03-13 15:44:24 +05:30
| `name` | String! | Name of the entry |
| `path` | String! | Path of the entry |
| `sha` | String! | Last commit sha for the entry |
| `type` | EntryType! | Type of tree entry |
2020-10-24 23:57:45 +05:30
| `webPath` | String | Web path of the blob |
2020-03-13 15:44:24 +05:30
| `webUrl` | String | Web URL of the blob |
2019-09-30 21:07:59 +05:30
2020-04-08 14:13:33 +05:30
## Board
Represents a project or group board
| Name | Type | Description |
| --- | ---- | ---------- |
2020-10-24 23:57:45 +05:30
| `assignee` | User | The board assignee. |
| `hideBacklogList` | Boolean | Whether or not backlog list is hidden. |
| `hideClosedList` | Boolean | Whether or not closed list is hidden. |
2020-04-08 14:13:33 +05:30
| `id` | ID! | ID (global ID) of the board |
2020-10-24 23:57:45 +05:30
| `milestone` | Milestone | The board milestone. |
2020-04-08 14:13:33 +05:30
| `name` | String | Name of the board |
2020-10-24 23:57:45 +05:30
| `weight` | Int | Weight of the board. |
2020-04-08 14:13:33 +05:30
2020-05-24 23:13:21 +05:30
## BoardList
Represents a list for an issue board
| Name | Type | Description |
| --- | ---- | ---------- |
| `assignee` | User | Assignee in the list |
| `collapsed` | Boolean | Indicates if list is collapsed for this user |
| `id` | ID! | ID (global ID) of the list |
2020-10-24 23:57:45 +05:30
| `issuesCount` | Int | Count of issues in the list |
2020-05-24 23:13:21 +05:30
| `label` | Label | Label of the list |
| `limitMetric` | ListLimitMetric | The current limit metric for the list |
| `listType` | String! | Type of the list |
| `maxIssueCount` | Int | Maximum number of issues in the list |
| `maxIssueWeight` | Int | Maximum weight of issues in the list |
| `milestone` | Milestone | Milestone of the list |
| `position` | Int | Position of list within the board |
| `title` | String! | Title of the list |
2020-10-24 23:57:45 +05:30
| `totalWeight` | Int | Total weight of all issues in the list |
## BoardListCreatePayload
Autogenerated return type of BoardListCreate
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `list` | BoardList | List of the issue board |
2020-05-24 23:13:21 +05:30
## BoardListUpdateLimitMetricsPayload
Autogenerated return type of BoardListUpdateLimitMetrics
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `list` | BoardList | The updated list |
## Branch
| Name | Type | Description |
| --- | ---- | ---------- |
| `commit` | Commit | Commit for the branch |
| `name` | String! | Name of the branch |
2020-10-24 23:57:45 +05:30
## CiGroup
| Name | Type | Description |
| --- | ---- | ---------- |
| `name` | String | Name of the job group |
| `size` | Int | Size of the group |
## CiJob
| Name | Type | Description |
| --- | ---- | ---------- |
| `name` | String | Name of the job |
## CiStage
| Name | Type | Description |
| --- | ---- | ---------- |
| `name` | String | Name of the stage |
## ClusterAgent
| Name | Type | Description |
| --- | ---- | ---------- |
| `createdAt` | Time | Timestamp the cluster agent was created |
| `id` | ID! | ID of the cluster agent |
| `name` | String | Name of the cluster agent |
| `project` | Project | The project this cluster agent is associated with |
| `updatedAt` | Time | Timestamp the cluster agent was updated |
2020-03-13 15:44:24 +05:30
## Commit
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `author` | User | Author of the commit |
| `authorGravatar` | String | Commit authors gravatar |
| `authorName` | String | Commit authors name |
| `authoredDate` | Time | Timestamp of when the commit was authored |
| `description` | String | Description of the commit message |
2020-10-24 23:57:45 +05:30
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
2019-12-26 22:10:19 +05:30
| `id` | ID! | ID (global ID) of the commit |
2020-04-22 19:07:51 +05:30
| `latestPipeline` **{warning-solid}** | Pipeline | **Deprecated:** Use `pipelines`. Deprecated in 12.5 |
2020-03-13 15:44:24 +05:30
| `message` | String | Raw commit message |
2019-12-26 22:10:19 +05:30
| `sha` | String! | SHA1 ID of the commit |
2020-03-13 15:44:24 +05:30
| `signatureHtml` | String | Rendered HTML of the commit signature |
2019-12-26 22:10:19 +05:30
| `title` | String | Title of the commit message |
2020-05-24 23:13:21 +05:30
| `titleHtml` | String | The GitLab Flavored Markdown rendering of `title` |
2020-10-24 23:57:45 +05:30
| `webPath` | String! | Web path of the commit |
2019-12-26 22:10:19 +05:30
| `webUrl` | String! | Web URL of the commit |
2019-09-30 21:07:59 +05:30
2020-06-23 00:09:42 +05:30
## CommitCreatePayload
Autogenerated return type of CommitCreate
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `commit` | Commit | The commit after mutation |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-07-28 23:09:34 +05:30
## ComplianceFramework
Represents a ComplianceFramework associated with a Project
| Name | Type | Description |
| --- | ---- | ---------- |
| `name` | ProjectSettingEnum! | Name of the compliance framework |
2020-10-24 23:57:45 +05:30
## ConfigureSastPayload
Autogenerated return type of ConfigureSast
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `result` | JSON | JSON containing the status of MR creation. |
2020-06-23 00:09:42 +05:30
## ContainerExpirationPolicy
A tag expiration policy designed to keep only the images that matter most
| Name | Type | Description |
| --- | ---- | ---------- |
| `cadence` | ContainerExpirationPolicyCadenceEnum! | This container expiration policy schedule |
| `createdAt` | Time! | Timestamp of when the container expiration policy was created |
| `enabled` | Boolean! | Indicates whether this container expiration policy is enabled |
| `keepN` | ContainerExpirationPolicyKeepEnum | Number of tags to retain |
2020-07-28 23:09:34 +05:30
| `nameRegex` | UntrustedRegexp | Tags with names matching this regex pattern will expire |
| `nameRegexKeep` | UntrustedRegexp | Tags with names matching this regex pattern will be preserved |
2020-06-23 00:09:42 +05:30
| `nextRunAt` | Time | Next time that this container expiration policy will get executed |
| `olderThan` | ContainerExpirationPolicyOlderThanEnum | Tags older that this will expire |
| `updatedAt` | Time! | Timestamp of when the container expiration policy was updated |
2020-05-24 23:13:21 +05:30
## CreateAlertIssuePayload
Autogenerated return type of CreateAlertIssue
| Name | Type | Description |
| --- | ---- | ---------- |
| `alert` | AlertManagementAlert | The alert after mutation |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue created after mutation |
2020-07-28 23:09:34 +05:30
| `todo` | Todo | The todo after mutation |
2020-05-24 23:13:21 +05:30
## CreateAnnotationPayload
Autogenerated return type of CreateAnnotation
| Name | Type | Description |
| --- | ---- | ---------- |
| `annotation` | MetricsDashboardAnnotation | The created annotation |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
## CreateBranchPayload
Autogenerated return type of CreateBranch
| Name | Type | Description |
| --- | ---- | ---------- |
| `branch` | Branch | Branch after mutation |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-10-24 23:57:45 +05:30
## CreateClusterAgentPayload
Autogenerated return type of CreateClusterAgent
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `clusterAgent` | ClusterAgent | Cluster agent created after mutation |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-03-13 15:44:24 +05:30
## CreateDiffNotePayload
Autogenerated return type of CreateDiffNote
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
| `note` | Note | The note after mutation |
2020-03-13 15:44:24 +05:30
## CreateEpicPayload
Autogenerated return type of CreateEpic
2019-12-26 22:10:19 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `epic` | Epic | The created epic |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-26 22:10:19 +05:30
2020-03-13 15:44:24 +05:30
## CreateImageDiffNotePayload
Autogenerated return type of CreateImageDiffNote
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
| `note` | Note | The note after mutation |
2020-05-24 23:13:21 +05:30
## CreateIterationPayload
Autogenerated return type of CreateIteration
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `iteration` | Iteration | The created iteration |
2020-03-13 15:44:24 +05:30
## CreateNotePayload
Autogenerated return type of CreateNote
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
| `note` | Note | The note after mutation |
2020-04-08 14:13:33 +05:30
## CreateRequirementPayload
Autogenerated return type of CreateRequirement
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-04-08 14:13:33 +05:30
| `requirement` | Requirement | The requirement after mutation |
2020-03-13 15:44:24 +05:30
## CreateSnippetPayload
Autogenerated return type of CreateSnippet
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-01-01 13:55:28 +05:30
| `snippet` | Snippet | The snippet after mutation |
2020-10-24 23:57:45 +05:30
## DastOnDemandScanCreatePayload
Autogenerated return type of DastOnDemandScanCreate
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `pipelineUrl` | String | URL of the pipeline that was created. |
## DastScannerProfile
Represents a DAST scanner profile.
| Name | Type | Description |
| --- | ---- | ---------- |
| `id` | ID! | ID of the DAST scanner profile |
| `profileName` | String | Name of the DAST scanner profile |
| `spiderTimeout` | Int | The maximum number of seconds allowed for the spider to traverse the site |
| `targetTimeout` | Int | The maximum number of seconds allowed for the site under test to respond to a request |
## DastScannerProfileCreatePayload
Autogenerated return type of DastScannerProfileCreate
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `id` | ID | ID of the scanner profile. |
## DastSiteProfile
Represents a DAST Site Profile.
| Name | Type | Description |
| --- | ---- | ---------- |
| `editPath` | String | Relative web path to the edit page of a site profile |
| `id` | DastSiteProfileID! | ID of the site profile |
| `profileName` | String | The name of the site profile |
| `targetUrl` | String | The URL of the target to be scanned |
| `userPermissions` | DastSiteProfilePermissions! | Permissions for the current user on the resource |
| `validationStatus` | DastSiteProfileValidationStatusEnum | The current validation status of the site profile |
2020-07-28 23:09:34 +05:30
## DastSiteProfileCreatePayload
Autogenerated return type of DastSiteProfileCreate
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-10-24 23:57:45 +05:30
| `id` | DastSiteProfileID | ID of the site profile. |
## DastSiteProfileDeletePayload
Autogenerated return type of DastSiteProfileDelete
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
## DastSiteProfilePermissions
Check permissions for the current user on site profile
| Name | Type | Description |
| --- | ---- | ---------- |
| `createOnDemandDastScan` | Boolean! | Indicates the user can perform `create_on_demand_dast_scan` on this resource |
## DastSiteProfileUpdatePayload
Autogenerated return type of DastSiteProfileUpdate
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `id` | DastSiteProfileID | ID of the site profile. |
2020-07-28 23:09:34 +05:30
2020-06-23 00:09:42 +05:30
## DeleteAnnotationPayload
Autogenerated return type of DeleteAnnotation
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-04-08 14:13:33 +05:30
## DeleteJobsResponse
The response from the AdminSidekiqQueuesDeleteJobs mutation.
| Name | Type | Description |
| --- | ---- | ---------- |
| `completed` | Boolean | Whether or not the entire queue was processed in time; if not, retrying the same request is safe |
| `deletedJobs` | Int | The number of matching jobs deleted |
| `queueSize` | Int | The queue size after processing |
2020-03-13 15:44:24 +05:30
## Design
A single design
| Name | Type | Description |
| --- | ---- | ---------- |
| `diffRefs` | DiffRefs! | The diff refs for this design |
| `event` | DesignVersionEvent! | How this design was changed in the current version |
| `filename` | String! | The filename of the design |
| `fullPath` | String! | The full path to the design file |
| `id` | ID! | The ID of this design |
2020-04-22 19:07:51 +05:30
| `image` | String! | The URL of the full-sized image |
| `imageV432x230` | String | The URL of the design resized to fit within the bounds of 432x230. This will be `null` if the image has not been generated |
2020-03-13 15:44:24 +05:30
| `issue` | Issue! | The issue the design belongs to |
| `notesCount` | Int! | The total count of user-created notes for this design |
| `project` | Project! | The project the design belongs to |
## DesignAtVersion
A design pinned to a specific version. The image field reflects the design as of the associated version.
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `design` | Design! | The underlying design. |
| `diffRefs` | DiffRefs! | The diff refs for this design |
| `event` | DesignVersionEvent! | How this design was changed in the current version |
| `filename` | String! | The filename of the design |
| `fullPath` | String! | The full path to the design file |
| `id` | ID! | The ID of this design |
2020-04-22 19:07:51 +05:30
| `image` | String! | The URL of the full-sized image |
| `imageV432x230` | String | The URL of the design resized to fit within the bounds of 432x230. This will be `null` if the image has not been generated |
2020-03-13 15:44:24 +05:30
| `issue` | Issue! | The issue the design belongs to |
2019-12-21 20:55:43 +05:30
| `notesCount` | Int! | The total count of user-created notes for this design |
2020-03-13 15:44:24 +05:30
| `project` | Project! | The project the design belongs to |
| `version` | DesignVersion! | The version this design-at-versions is pinned to |
## DesignCollection
A collection of designs.
| Name | Type | Description |
| --- | ---- | ---------- |
| `design` | Design | Find a specific design |
| `designAtVersion` | DesignAtVersion | Find a design as of a version |
| `issue` | Issue! | Issue associated with the design collection |
| `project` | Project! | Project associated with the design collection |
| `version` | DesignVersion | A specific version |
2019-12-21 20:55:43 +05:30
2020-03-13 15:44:24 +05:30
## DesignManagement
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `designAtVersion` | DesignAtVersion | Find a design as of a version |
| `version` | DesignVersion | Find a version |
## DesignManagementDeletePayload
2019-12-21 20:55:43 +05:30
2020-03-13 15:44:24 +05:30
Autogenerated return type of DesignManagementDelete
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
| `version` | DesignVersion | The new version in which the designs are deleted |
2020-10-24 23:57:45 +05:30
## DesignManagementMovePayload
Autogenerated return type of DesignManagementMove
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `designCollection` | DesignCollection | The current state of the collection |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-03-13 15:44:24 +05:30
## DesignManagementUploadPayload
Autogenerated return type of DesignManagementUpload
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `designs` | Design! => Array | The designs that were uploaded by the mutation |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
| `skippedDesigns` | Design! => Array | Any designs that were skipped from the upload due to there being no change to their content since their last version |
2020-03-13 15:44:24 +05:30
## DesignVersion
A specific version in which designs were added, modified or deleted
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `designAtVersion` | DesignAtVersion! | A particular design as of this version, provided it is visible at this version |
| `id` | ID! | ID of the design version |
| `sha` | ID! | SHA of the design version |
2019-12-21 20:55:43 +05:30
2020-03-13 15:44:24 +05:30
## DestroyNotePayload
Autogenerated return type of DestroyNote
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
| `note` | Note | The note after mutation |
2020-03-13 15:44:24 +05:30
## DestroySnippetPayload
Autogenerated return type of DestroySnippet
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-01-01 13:55:28 +05:30
| `snippet` | Snippet | The snippet after mutation |
2020-03-13 15:44:24 +05:30
## DetailedStatus
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `detailsPath` | String! | Path of the details for the pipeline status |
| `favicon` | String! | Favicon of the pipeline status |
| `group` | String! | Group of the pipeline status |
| `hasDetails` | Boolean! | Indicates if the pipeline status has further details |
| `icon` | String! | Icon of the pipeline status |
| `label` | String! | Label of the pipeline status |
| `text` | String! | Text of the pipeline status |
| `tooltip` | String! | Tooltip associated with the pipeline status |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## DiffPosition
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-01-01 13:55:28 +05:30
| `diffRefs` | DiffRefs! | Information about the branch, HEAD, and base at the time of commenting |
| `filePath` | String! | Path of the file that was changed |
2020-03-13 15:44:24 +05:30
| `height` | Int | Total height of the image |
| `newLine` | Int | Line on HEAD SHA that was changed |
2020-01-01 13:55:28 +05:30
| `newPath` | String | Path of the file on the HEAD SHA |
| `oldLine` | Int | Line on start SHA that was changed |
2020-03-13 15:44:24 +05:30
| `oldPath` | String | Path of the file on the start SHA |
| `positionType` | DiffPositionType! | Type of file the position refers to |
2020-01-01 13:55:28 +05:30
| `width` | Int | Total width of the image |
2020-03-13 15:44:24 +05:30
| `x` | Int | X position of the note |
| `y` | Int | Y position of the note |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## DiffRefs
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-07 23:17:34 +05:30
| `baseSha` | String | Merge base of the branch the comment was made on |
2020-03-13 15:44:24 +05:30
| `headSha` | String! | SHA of the HEAD at the time the comment was made |
2020-01-01 13:55:28 +05:30
| `startSha` | String! | SHA of the branch being compared against |
2019-12-21 20:55:43 +05:30
2020-07-28 23:09:34 +05:30
## DiffStats
Changes to a single file
| Name | Type | Description |
| --- | ---- | ---------- |
| `additions` | Int! | Number of lines added to this file |
| `deletions` | Int! | Number of lines deleted from this file |
| `path` | String! | File path, relative to repository root |
## DiffStatsSummary
Aggregated summary of changes
| Name | Type | Description |
| --- | ---- | ---------- |
| `additions` | Int! | Number of lines added |
| `changes` | Int! | Number of lines changed |
| `deletions` | Int! | Number of lines deleted |
| `fileCount` | Int! | Number of files changed |
2020-03-13 15:44:24 +05:30
## Discussion
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `createdAt` | Time! | Timestamp of the discussion's creation |
2020-01-01 13:55:28 +05:30
| `id` | ID! | ID of this discussion |
| `replyId` | ID! | ID used to reply to this discussion |
2020-06-23 00:09:42 +05:30
| `resolvable` | Boolean! | Indicates if the object can be resolved |
| `resolved` | Boolean! | Indicates if the object is resolved |
| `resolvedAt` | Time | Timestamp of when the object was resolved |
| `resolvedBy` | User | User who resolved the object |
## DiscussionToggleResolvePayload
Autogenerated return type of DiscussionToggleResolve
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `discussion` | Discussion | The discussion after mutation |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-09-30 21:07:59 +05:30
2020-04-22 19:07:51 +05:30
## DismissVulnerabilityPayload
Autogenerated return type of DismissVulnerability
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-04-22 19:07:51 +05:30
| `vulnerability` | Vulnerability | The vulnerability after dismissal |
2020-03-13 15:44:24 +05:30
## Environment
Describes where code is deployed for a project
| Name | Type | Description |
| --- | ---- | ---------- |
| `id` | ID! | ID of the environment |
2020-10-24 23:57:45 +05:30
| `latestOpenedMostSevereAlert` | AlertManagementAlert | The most severe open alert for the environment. If multiple alerts have equal severity, the most recent is returned. |
2020-04-22 19:07:51 +05:30
| `metricsDashboard` | MetricsDashboard | Metrics dashboard schema for the environment |
2020-03-13 15:44:24 +05:30
| `name` | String! | Human-readable name of the environment |
2020-04-22 19:07:51 +05:30
| `state` | String! | State of the environment, for example: available/stopped |
2020-03-13 15:44:24 +05:30
## Epic
Represents an epic.
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-01-01 13:55:28 +05:30
| `author` | User! | Author of the epic |
2020-03-13 15:44:24 +05:30
| `closedAt` | Time | Timestamp of the epic's closure |
2020-04-22 19:07:51 +05:30
| `confidential` | Boolean | Indicates if the epic is confidential |
2020-03-13 15:44:24 +05:30
| `createdAt` | Time | Timestamp of the epic's creation |
| `descendantCounts` | EpicDescendantCount | Number of open and closed descendant epics and issues |
2020-04-08 14:13:33 +05:30
| `descendantWeightSum` | EpicDescendantWeights | Total weight of open and closed issues in the epic and its descendants |
2020-03-13 15:44:24 +05:30
| `description` | String | Description of the epic |
| `downvotes` | Int! | Number of downvotes the epic has received |
2020-01-01 13:55:28 +05:30
| `dueDate` | Time | Due date of the epic |
| `dueDateFixed` | Time | Fixed due date of the epic |
| `dueDateFromMilestones` | Time | Inherited due date of the epic from milestones |
2020-03-13 15:44:24 +05:30
| `dueDateIsFixed` | Boolean | Indicates if the due date has been manually set |
| `group` | Group! | Group to which the epic belongs |
2020-01-01 13:55:28 +05:30
| `hasChildren` | Boolean! | Indicates if the epic has children |
| `hasIssues` | Boolean! | Indicates if the epic has direct issues |
2020-04-22 19:07:51 +05:30
| `hasParent` | Boolean! | Indicates if the epic has a parent epic |
2020-04-08 14:13:33 +05:30
| `healthStatus` | EpicHealthStatus | Current health status of the epic |
2020-03-13 15:44:24 +05:30
| `id` | ID! | ID of the epic |
| `iid` | ID! | Internal ID of the epic |
| `parent` | Epic | Parent epic of the epic |
| `reference` | String! | Internal reference of the epic. Returned in shortened format by default |
| `relationPath` | String | URI path of the epic-issue relationship |
2020-01-01 13:55:28 +05:30
| `relativePosition` | Int | The relative position of the epic in the epic tree |
2020-03-13 15:44:24 +05:30
| `startDate` | Time | Start date of the epic |
| `startDateFixed` | Time | Fixed start date of the epic |
| `startDateFromMilestones` | Time | Inherited start date of the epic from milestones |
| `startDateIsFixed` | Boolean | Indicates if the start date has been manually set |
| `state` | EpicState! | State of the epic |
| `subscribed` | Boolean! | Indicates the currently logged in user is subscribed to the epic |
| `title` | String | Title of the epic |
| `updatedAt` | Time | Timestamp of the epic's last activity |
| `upvotes` | Int! | Number of upvotes the epic has received |
| `userPermissions` | EpicPermissions! | Permissions for the current user on the resource |
| `webPath` | String! | Web path of the epic |
| `webUrl` | String! | Web URL of the epic |
2019-12-26 22:10:19 +05:30
2020-04-08 14:13:33 +05:30
## EpicAddIssuePayload
Autogenerated return type of EpicAddIssue
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `epic` | Epic | The epic after mutation |
| `epicIssue` | EpicIssue | The epic-issue relation |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-04-08 14:13:33 +05:30
2020-03-13 15:44:24 +05:30
## EpicDescendantCount
Counts of descendent epics.
2019-12-26 22:10:19 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-10-24 23:57:45 +05:30
| `closedEpics` | Int | Number of closed child epics |
2019-12-26 22:10:19 +05:30
| `closedIssues` | Int | Number of closed epic issues |
2020-10-24 23:57:45 +05:30
| `openedEpics` | Int | Number of opened child epics |
2020-03-13 15:44:24 +05:30
| `openedIssues` | Int | Number of opened epic issues |
2020-04-08 14:13:33 +05:30
## EpicDescendantWeights
Total weight of open and closed descendant issues
| Name | Type | Description |
| --- | ---- | ---------- |
| `closedIssues` | Int | Total weight of completed (closed) issues in this epic, including epic descendants |
| `openedIssues` | Int | Total weight of opened issues in this epic, including epic descendants |
## EpicHealthStatus
Health status of child issues
| Name | Type | Description |
| --- | ---- | ---------- |
| `issuesAtRisk` | Int | Number of issues at risk |
| `issuesNeedingAttention` | Int | Number of issues that need attention |
| `issuesOnTrack` | Int | Number of issues on track |
2020-03-13 15:44:24 +05:30
## EpicIssue
2019-12-21 20:55:43 +05:30
2020-03-13 15:44:24 +05:30
Relationship between an epic and an issue
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2019-12-26 22:10:19 +05:30
| `author` | User! | User that created the issue |
2020-10-24 23:57:45 +05:30
| `blocked` | Boolean! | Indicates the issue is blocked |
2020-03-13 15:44:24 +05:30
| `closedAt` | Time | Timestamp of when the issue was closed |
2019-12-26 22:10:19 +05:30
| `confidential` | Boolean! | Indicates the issue is confidential |
2020-03-13 15:44:24 +05:30
| `createdAt` | Time! | Timestamp of when the issue was created |
| `description` | String | Description of the issue |
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
| `designCollection` | DesignCollection | Collection of design images associated with this issue |
2020-04-22 19:07:51 +05:30
| `designs` **{warning-solid}** | DesignCollection | **Deprecated:** Use `designCollection`. Deprecated in 12.2 |
2019-12-26 22:10:19 +05:30
| `discussionLocked` | Boolean! | Indicates discussion is locked on the issue |
| `downvotes` | Int! | Number of downvotes the issue has received |
2020-03-13 15:44:24 +05:30
| `dueDate` | Time | Due date of the issue |
| `epic` | Epic | Epic to which this issue belongs |
| `epicIssueId` | ID! | ID of the epic-issue relation |
2020-04-22 19:07:51 +05:30
| `healthStatus` | HealthStatus | Current health status. Returns null if `save_issuable_health_status` feature flag is disabled. |
2020-03-13 15:44:24 +05:30
| `id` | ID | Global ID of the epic-issue relation |
| `iid` | ID! | Internal ID of the issue |
2020-05-24 23:13:21 +05:30
| `iteration` | Iteration | Iteration of the issue |
2020-03-13 15:44:24 +05:30
| `milestone` | Milestone | Milestone of the issue |
| `reference` | String! | Internal reference of the issue. Returned in shortened format by default |
| `relationPath` | String | URI path of the epic-issue relation |
2019-12-26 22:10:19 +05:30
| `relativePosition` | Int | Relative position of the issue (used for positioning in epic tree and issue boards) |
2020-03-13 15:44:24 +05:30
| `state` | IssueState! | State of the issue |
2020-10-24 23:57:45 +05:30
| `statusPagePublishedIncident` | Boolean | Indicates whether an issue is published to the status page |
2020-03-13 15:44:24 +05:30
| `subscribed` | Boolean! | Indicates the currently logged in user is subscribed to the issue |
| `taskCompletionStatus` | TaskCompletionStatus! | Task completion status of the issue |
2019-12-26 22:10:19 +05:30
| `timeEstimate` | Int! | Time estimate of the issue |
2020-03-13 15:44:24 +05:30
| `title` | String! | Title of the issue |
| `titleHtml` | String | The GitLab Flavored Markdown rendering of `title` |
2019-12-21 20:55:43 +05:30
| `totalTimeSpent` | Int! | Total time reported as spent on the issue |
2020-10-24 23:57:45 +05:30
| `type` | IssueType | Type of the issue |
2019-12-26 22:10:19 +05:30
| `updatedAt` | Time! | Timestamp of when the issue was last updated |
2020-03-13 15:44:24 +05:30
| `upvotes` | Int! | Number of upvotes the issue has received |
| `userNotesCount` | Int! | Number of user notes of the issue |
| `userPermissions` | IssuePermissions! | Permissions for the current user on the resource |
| `webPath` | String! | Web path of the issue |
| `webUrl` | String! | Web URL of the issue |
2020-01-01 13:55:28 +05:30
| `weight` | Int | Weight of the issue |
2019-12-21 20:55:43 +05:30
2020-03-13 15:44:24 +05:30
## EpicPermissions
Check permissions for the current user on an epic
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `adminEpic` | Boolean! | Indicates the user can perform `admin_epic` on this resource |
| `awardEmoji` | Boolean! | Indicates the user can perform `award_emoji` on this resource |
| `createEpic` | Boolean! | Indicates the user can perform `create_epic` on this resource |
| `createNote` | Boolean! | Indicates the user can perform `create_note` on this resource |
| `destroyEpic` | Boolean! | Indicates the user can perform `destroy_epic` on this resource |
| `readEpic` | Boolean! | Indicates the user can perform `read_epic` on this resource |
| `readEpicIid` | Boolean! | Indicates the user can perform `read_epic_iid` on this resource |
| `updateEpic` | Boolean! | Indicates the user can perform `update_epic` on this resource |
## EpicSetSubscriptionPayload
2019-12-21 20:55:43 +05:30
2020-03-13 15:44:24 +05:30
Autogenerated return type of EpicSetSubscription
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2019-12-26 22:10:19 +05:30
| `epic` | Epic | The epic after mutation |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
2020-03-13 15:44:24 +05:30
## EpicTreeReorderPayload
Autogenerated return type of EpicTreeReorder
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2019-12-26 22:10:19 +05:30
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
2020-04-22 19:07:51 +05:30
## GeoNode
| Name | Type | Description |
| --- | ---- | ---------- |
| `containerRepositoriesMaxCapacity` | Int | The maximum concurrency of container repository sync for this secondary node |
| `enabled` | Boolean | Indicates whether this Geo node is enabled |
| `filesMaxCapacity` | Int | The maximum concurrency of LFS/attachment backfill for this secondary node |
| `id` | ID! | ID of this GeoNode |
| `internalUrl` | String | The URL defined on the primary node that secondary nodes should use to contact it |
| `minimumReverificationInterval` | Int | The interval (in days) in which the repository verification is valid. Once expired, it will be reverified |
| `name` | String | The unique identifier for this Geo node |
| `primary` | Boolean | Indicates whether this Geo node is the primary |
| `reposMaxCapacity` | Int | The maximum concurrency of repository backfill for this secondary node |
| `selectiveSyncShards` | String! => Array | The repository storages whose projects should be synced, if `selective_sync_type` == `shards` |
| `selectiveSyncType` | String | Indicates if syncing is limited to only specific groups, or shards |
| `syncObjectStorage` | Boolean | Indicates if this secondary node will replicate blobs in Object Storage |
| `url` | String | The user-facing URL for this Geo node |
| `verificationMaxCapacity` | Int | The maximum concurrency of repository verification for this secondary node |
2020-03-13 15:44:24 +05:30
## GrafanaIntegration
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `createdAt` | Time! | Timestamp of the issue's creation |
| `enabled` | Boolean! | Indicates whether Grafana integration is enabled |
2020-05-24 23:13:21 +05:30
| `grafanaUrl` | String! | URL for the Grafana host for the Grafana integration |
2020-03-13 15:44:24 +05:30
| `id` | ID! | Internal ID of the Grafana integration |
2020-04-22 19:07:51 +05:30
| `token` **{warning-solid}** | String! | **Deprecated:** Plain text token has been masked for security reasons. Deprecated in 12.7 |
2020-03-13 15:44:24 +05:30
| `updatedAt` | Time! | Timestamp of the issue's last activity |
## Group
| Name | Type | Description |
| --- | ---- | ---------- |
| `autoDevopsEnabled` | Boolean | Indicates whether Auto DevOps is enabled for all projects within this group |
| `avatarUrl` | String | Avatar URL of the group |
2020-04-08 14:13:33 +05:30
| `board` | Board | A single board of the group |
2019-12-26 22:10:19 +05:30
| `description` | String | Description of the namespace |
2019-09-30 21:07:59 +05:30
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
2020-03-13 15:44:24 +05:30
| `emailsDisabled` | Boolean | Indicates if a group has email notifications disabled |
| `epic` | Epic | Find a single epic |
| `epicsEnabled` | Boolean | Indicates if Epics are enabled for namespace |
| `fullName` | String! | Full name of the namespace |
| `fullPath` | ID! | Full path of the namespace |
| `groupTimelogsEnabled` | Boolean | Indicates if Group timelogs are enabled for namespace |
| `id` | ID! | ID of the namespace |
2020-10-24 23:57:45 +05:30
| `isTemporaryStorageIncreaseEnabled` | Boolean! | Status of the temporary storage increase |
2020-06-23 00:09:42 +05:30
| `label` | Label | A label available on this group |
2019-12-26 22:10:19 +05:30
| `lfsEnabled` | Boolean | Indicates if Large File Storage (LFS) is enabled for namespace |
2020-03-13 15:44:24 +05:30
| `mentionsDisabled` | Boolean | Indicates if a group is disabled from getting mentioned |
| `name` | String! | Name of the namespace |
| `parent` | Group | Parent group |
| `path` | String! | Path of the namespace |
| `projectCreationLevel` | String | The permission level required to create projects in the group |
2019-12-26 22:10:19 +05:30
| `requestAccessEnabled` | Boolean | Indicates if users can request access to namespace |
2020-03-13 15:44:24 +05:30
| `requireTwoFactorAuthentication` | Boolean | Indicates if all users in this group are required to set up two-factor authentication |
2019-12-26 22:10:19 +05:30
| `rootStorageStatistics` | RootStorageStatistics | Aggregated storage statistics of the namespace. Only available for root namespaces |
2020-03-13 15:44:24 +05:30
| `shareWithGroupLock` | Boolean | Indicates if sharing a project with another group within this group is prevented |
2020-07-28 23:09:34 +05:30
| `storageSizeLimit` | Float | Total storage limit of the root namespace in bytes |
2020-03-13 15:44:24 +05:30
| `subgroupCreationLevel` | String | The permission level required to create subgroups within the group |
2020-07-28 23:09:34 +05:30
| `temporaryStorageIncreaseEndsOn` | Time | Date until the temporary storage increase is active |
2020-03-13 15:44:24 +05:30
| `twoFactorGracePeriod` | Int | Time before two-factor authentication is enforced |
2019-09-30 21:07:59 +05:30
| `userPermissions` | GroupPermissions! | Permissions for the current user on the resource |
2020-03-13 15:44:24 +05:30
| `visibility` | String | Visibility of the namespace |
2020-10-24 23:57:45 +05:30
| `vulnerabilityGrades` | VulnerableProjectsByGrade! => Array | Represents vulnerable project counts for each grade |
2019-12-26 22:10:19 +05:30
| `webUrl` | String! | Web URL of the group |
2019-09-30 21:07:59 +05:30
2020-06-23 00:09:42 +05:30
## GroupMember
Represents a Group Member
| Name | Type | Description |
| --- | ---- | ---------- |
| `accessLevel` | AccessLevel | GitLab::Access level |
| `createdAt` | Time | Date and time the membership was created |
| `createdBy` | User | User that authorized membership |
| `expiresAt` | Time | Date and time the membership expires |
| `group` | Group | Group that a User is a member of |
| `updatedAt` | Time | Date and time the membership was last updated |
| `userPermissions` | GroupPermissions! | Permissions for the current user on the resource |
2020-03-13 15:44:24 +05:30
## GroupPermissions
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `readGroup` | Boolean! | Indicates the user can perform `read_group` on this resource |
2019-09-30 21:07:59 +05:30
2020-10-24 23:57:45 +05:30
## InstanceSecurityDashboard
| Name | Type | Description |
| --- | ---- | ---------- |
| `vulnerabilityGrades` | VulnerableProjectsByGrade! => Array | Represents vulnerable project counts for each grade |
2020-03-13 15:44:24 +05:30
## Issue
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2019-12-26 22:10:19 +05:30
| `author` | User! | User that created the issue |
2020-10-24 23:57:45 +05:30
| `blocked` | Boolean! | Indicates the issue is blocked |
2020-03-13 15:44:24 +05:30
| `closedAt` | Time | Timestamp of when the issue was closed |
2019-12-26 22:10:19 +05:30
| `confidential` | Boolean! | Indicates the issue is confidential |
2020-03-13 15:44:24 +05:30
| `createdAt` | Time! | Timestamp of when the issue was created |
| `description` | String | Description of the issue |
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
| `designCollection` | DesignCollection | Collection of design images associated with this issue |
2020-04-22 19:07:51 +05:30
| `designs` **{warning-solid}** | DesignCollection | **Deprecated:** Use `designCollection`. Deprecated in 12.2 |
2019-12-26 22:10:19 +05:30
| `discussionLocked` | Boolean! | Indicates discussion is locked on the issue |
| `downvotes` | Int! | Number of downvotes the issue has received |
2020-03-13 15:44:24 +05:30
| `dueDate` | Time | Due date of the issue |
| `epic` | Epic | Epic to which this issue belongs |
2020-04-22 19:07:51 +05:30
| `healthStatus` | HealthStatus | Current health status. Returns null if `save_issuable_health_status` feature flag is disabled. |
2020-07-28 23:09:34 +05:30
| `id` | ID! | ID of the issue |
2020-03-13 15:44:24 +05:30
| `iid` | ID! | Internal ID of the issue |
2020-05-24 23:13:21 +05:30
| `iteration` | Iteration | Iteration of the issue |
2020-03-13 15:44:24 +05:30
| `milestone` | Milestone | Milestone of the issue |
| `reference` | String! | Internal reference of the issue. Returned in shortened format by default |
2019-12-26 22:10:19 +05:30
| `relativePosition` | Int | Relative position of the issue (used for positioning in epic tree and issue boards) |
2020-03-13 15:44:24 +05:30
| `state` | IssueState! | State of the issue |
2020-10-24 23:57:45 +05:30
| `statusPagePublishedIncident` | Boolean | Indicates whether an issue is published to the status page |
2020-03-13 15:44:24 +05:30
| `subscribed` | Boolean! | Indicates the currently logged in user is subscribed to the issue |
| `taskCompletionStatus` | TaskCompletionStatus! | Task completion status of the issue |
2019-12-26 22:10:19 +05:30
| `timeEstimate` | Int! | Time estimate of the issue |
2020-03-13 15:44:24 +05:30
| `title` | String! | Title of the issue |
| `titleHtml` | String | The GitLab Flavored Markdown rendering of `title` |
2019-12-21 20:55:43 +05:30
| `totalTimeSpent` | Int! | Total time reported as spent on the issue |
2020-10-24 23:57:45 +05:30
| `type` | IssueType | Type of the issue |
2019-12-26 22:10:19 +05:30
| `updatedAt` | Time! | Timestamp of when the issue was last updated |
2020-03-13 15:44:24 +05:30
| `upvotes` | Int! | Number of upvotes the issue has received |
| `userNotesCount` | Int! | Number of user notes of the issue |
| `userPermissions` | IssuePermissions! | Permissions for the current user on the resource |
| `webPath` | String! | Web path of the issue |
| `webUrl` | String! | Web URL of the issue |
2020-01-01 13:55:28 +05:30
| `weight` | Int | Weight of the issue |
2019-09-30 21:07:59 +05:30
2020-10-24 23:57:45 +05:30
## IssueMoveListPayload
Autogenerated return type of IssueMoveList
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue after mutation |
2020-03-13 15:44:24 +05:30
## IssuePermissions
Check permissions for the current user on a issue
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `adminIssue` | Boolean! | Indicates the user can perform `admin_issue` on this resource |
| `createDesign` | Boolean! | Indicates the user can perform `create_design` on this resource |
| `createNote` | Boolean! | Indicates the user can perform `create_note` on this resource |
| `destroyDesign` | Boolean! | Indicates the user can perform `destroy_design` on this resource |
| `readDesign` | Boolean! | Indicates the user can perform `read_design` on this resource |
| `readIssue` | Boolean! | Indicates the user can perform `read_issue` on this resource |
| `reopenIssue` | Boolean! | Indicates the user can perform `reopen_issue` on this resource |
| `updateIssue` | Boolean! | Indicates the user can perform `update_issue` on this resource |
2019-09-30 21:07:59 +05:30
2020-10-24 23:57:45 +05:30
## IssueSetAssigneesPayload
Autogenerated return type of IssueSetAssignees
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue after mutation |
2020-03-13 15:44:24 +05:30
## IssueSetConfidentialPayload
Autogenerated return type of IssueSetConfidential
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-01-01 13:55:28 +05:30
| `issue` | Issue | The issue after mutation |
2020-03-13 15:44:24 +05:30
## IssueSetDueDatePayload
Autogenerated return type of IssueSetDueDate
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue after mutation |
2020-10-24 23:57:45 +05:30
## IssueSetEpicPayload
Autogenerated return type of IssueSetEpic
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue after mutation |
2020-05-24 23:13:21 +05:30
## IssueSetIterationPayload
Autogenerated return type of IssueSetIteration
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-01-01 13:55:28 +05:30
| `issue` | Issue | The issue after mutation |
2020-07-28 23:09:34 +05:30
## IssueSetLockedPayload
Autogenerated return type of IssueSetLocked
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue after mutation |
2020-10-24 23:57:45 +05:30
## IssueSetSubscriptionPayload
Autogenerated return type of IssueSetSubscription
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue after mutation |
2020-03-13 15:44:24 +05:30
## IssueSetWeightPayload
Autogenerated return type of IssueSetWeight
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-01-01 13:55:28 +05:30
| `issue` | Issue | The issue after mutation |
2020-10-24 23:57:45 +05:30
## IssueStatusCountsType
Represents total number of issues for the represented statuses.
| Name | Type | Description |
| --- | ---- | ---------- |
| `all` | Int | Number of issues with status ALL for the project |
| `closed` | Int | Number of issues with status CLOSED for the project |
| `opened` | Int | Number of issues with status OPENED for the project |
2020-05-24 23:13:21 +05:30
## Iteration
Represents an iteration object.
| Name | Type | Description |
| --- | ---- | ---------- |
| `createdAt` | Time! | Timestamp of iteration creation |
| `description` | String | Description of the iteration |
2020-10-24 23:57:45 +05:30
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
2020-05-24 23:13:21 +05:30
| `dueDate` | Time | Timestamp of the iteration due date |
| `id` | ID! | ID of the iteration |
2020-07-28 23:09:34 +05:30
| `iid` | ID! | Internal ID of the iteration |
2020-10-24 23:57:45 +05:30
| `scopedPath` | String | Web path of the iteration, scoped to the query parent. Only valid for Project parents. Returns null in other contexts |
| `scopedUrl` | String | Web URL of the iteration, scoped to the query parent. Only valid for Project parents. Returns null in other contexts |
2020-05-24 23:13:21 +05:30
| `startDate` | Time | Timestamp of the iteration start date |
| `state` | IterationState! | State of the iteration |
| `title` | String! | Title of the iteration |
| `updatedAt` | Time! | Timestamp of last iteration update |
| `webPath` | String! | Web path of the iteration |
| `webUrl` | String! | Web URL of the iteration |
2020-04-22 19:07:51 +05:30
## JiraImport
| Name | Type | Description |
| --- | ---- | ---------- |
2020-05-24 23:13:21 +05:30
| `createdAt` | Time | Timestamp of when the Jira import was created |
2020-06-23 00:09:42 +05:30
| `failedToImportCount` | Int! | Count of issues that failed to import |
| `importedIssuesCount` | Int! | Count of issues that were successfully imported |
2020-04-22 19:07:51 +05:30
| `jiraProjectKey` | String! | Project key for the imported Jira project |
2020-05-24 23:13:21 +05:30
| `scheduledAt` | Time | Timestamp of when the Jira import was scheduled |
2020-04-22 19:07:51 +05:30
| `scheduledBy` | User | User that started the Jira import |
2020-06-23 00:09:42 +05:30
| `totalIssueCount` | Int! | Total count of issues that were attempted to import |
2020-04-22 19:07:51 +05:30
## JiraImportStartPayload
Autogenerated return type of JiraImportStart
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-04-22 19:07:51 +05:30
| `jiraImport` | JiraImport | The Jira import data after mutation |
2020-06-23 00:09:42 +05:30
## JiraImportUsersPayload
Autogenerated return type of JiraImportUsers
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `jiraUsers` | JiraUser! => Array | Users returned from Jira, matched by email and name if possible. |
## JiraProject
| Name | Type | Description |
| --- | ---- | ---------- |
| `key` | String! | Key of the Jira project |
| `name` | String | Name of the Jira project |
| `projectId` | Int! | ID of the Jira project |
2020-04-22 19:07:51 +05:30
## JiraService
| Name | Type | Description |
| --- | ---- | ---------- |
| `active` | Boolean | Indicates if the service is active |
| `type` | String | Class name of the service |
2020-06-23 00:09:42 +05:30
## JiraUser
| Name | Type | Description |
| --- | ---- | ---------- |
2020-07-28 23:09:34 +05:30
| `gitlabId` | Int | ID of the matched GitLab user |
| `gitlabName` | String | Name of the matched GitLab user |
| `gitlabUsername` | String | Username of the matched GitLab user |
2020-06-23 00:09:42 +05:30
| `jiraAccountId` | String! | Account id of the Jira user |
| `jiraDisplayName` | String! | Display name of the Jira user |
| `jiraEmail` | String | Email of the Jira user, returned only for users with public emails |
2020-03-13 15:44:24 +05:30
## Label
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `color` | String! | Background color of the label |
2020-01-01 13:55:28 +05:30
| `description` | String | Description of the label (Markdown rendered as HTML for caching) |
2019-09-30 21:07:59 +05:30
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
2020-03-13 15:44:24 +05:30
| `id` | ID! | Label ID |
2019-12-26 22:10:19 +05:30
| `textColor` | String! | Text color of the label |
2020-03-13 15:44:24 +05:30
| `title` | String! | Content of the label |
## MarkAsSpamSnippetPayload
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
Autogenerated return type of MarkAsSpamSnippet
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-01-01 13:55:28 +05:30
| `snippet` | Snippet | The snippet after mutation |
2020-03-13 15:44:24 +05:30
## MergeRequest
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `allowCollaboration` | Boolean | Indicates if members of the target project can push to the fork |
2020-06-23 00:09:42 +05:30
| `author` | User | User who created this merge request |
2020-10-24 23:57:45 +05:30
| `commitCount` | Int | Number of commits in the merge request |
2020-03-13 15:44:24 +05:30
| `createdAt` | Time! | Timestamp of when the merge request was created |
| `defaultMergeCommitMessage` | String | Default merge commit message of the merge request |
2020-01-01 13:55:28 +05:30
| `description` | String | Description of the merge request (Markdown rendered as HTML for caching) |
2019-09-30 21:07:59 +05:30
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
2019-12-26 22:10:19 +05:30
| `diffHeadSha` | String | Diff head SHA of the merge request |
2020-03-13 15:44:24 +05:30
| `diffRefs` | DiffRefs | References of the base SHA, the head SHA, and the start SHA for this merge request |
2020-07-28 23:09:34 +05:30
| `diffStats` | DiffStats! => Array | Details about which files were changed in this merge request |
| `diffStatsSummary` | DiffStatsSummary | Summary of which files were changed in this merge request |
2020-03-13 15:44:24 +05:30
| `discussionLocked` | Boolean! | Indicates if comments on the merge request are locked to members only |
| `downvotes` | Int! | Number of downvotes for the merge request |
2019-12-26 22:10:19 +05:30
| `forceRemoveSourceBranch` | Boolean | Indicates if the project settings will lead to source branch deletion after merge |
2020-03-13 15:44:24 +05:30
| `headPipeline` | Pipeline | The pipeline running on the branch HEAD of the merge request |
| `id` | ID! | ID of the merge request |
| `iid` | String! | Internal ID of the merge request |
2019-12-26 22:10:19 +05:30
| `inProgressMergeCommitSha` | String | Commit SHA of the merge request if merge is in progress |
2020-04-22 19:07:51 +05:30
| `mergeCommitMessage` **{warning-solid}** | String | **Deprecated:** Use `defaultMergeCommitMessage`. Deprecated in 11.8 |
2020-03-13 15:44:24 +05:30
| `mergeCommitSha` | String | SHA of the merge request commit (set once merged) |
| `mergeError` | String | Error message due to a merge error |
2019-12-26 22:10:19 +05:30
| `mergeOngoing` | Boolean! | Indicates if a merge is currently occurring |
2020-03-13 15:44:24 +05:30
| `mergeStatus` | String | Status of the merge request |
| `mergeWhenPipelineSucceeds` | Boolean | Indicates if the merge has been set to be merged when its pipeline succeeds (MWPS) |
2019-12-26 22:10:19 +05:30
| `mergeableDiscussionsState` | Boolean | Indicates if all discussions in the merge request have been resolved, allowing the merge request to be merged |
2020-06-23 00:09:42 +05:30
| `mergedAt` | Time | Timestamp of when the merge request was merged, null if not merged |
2019-12-26 22:10:19 +05:30
| `milestone` | Milestone | The milestone of the merge request |
2020-03-13 15:44:24 +05:30
| `project` | Project! | Alias for target_project |
| `projectId` | Int! | ID of the merge request project |
| `rebaseCommitSha` | String | Rebase commit SHA of the merge request |
| `rebaseInProgress` | Boolean! | Indicates if there is a rebase currently in progress for the merge request |
| `reference` | String! | Internal reference of the merge request. Returned in shortened format by default |
| `shouldBeRebased` | Boolean! | Indicates if the merge request will be rebased |
| `shouldRemoveSourceBranch` | Boolean | Indicates if the source branch of the merge request will be deleted after merge |
| `sourceBranch` | String! | Source branch of the merge request |
| `sourceBranchExists` | Boolean! | Indicates if the source branch of the merge request exists |
| `sourceProject` | Project | Source project of the merge request |
| `sourceProjectId` | Int | ID of the merge request source project |
| `state` | MergeRequestState! | State of the merge request |
2019-12-26 22:10:19 +05:30
| `subscribed` | Boolean! | Indicates if the currently logged in user is subscribed to this merge request |
2020-03-13 15:44:24 +05:30
| `targetBranch` | String! | Target branch of the merge request |
2020-06-23 00:09:42 +05:30
| `targetBranchExists` | Boolean! | Indicates if the target branch of the merge request exists |
2020-03-13 15:44:24 +05:30
| `targetProject` | Project! | Target project of the merge request |
| `targetProjectId` | Int! | ID of the merge request target project |
| `taskCompletionStatus` | TaskCompletionStatus! | Completion status of tasks |
2019-12-26 22:10:19 +05:30
| `timeEstimate` | Int! | Time estimate of the merge request |
2020-03-13 15:44:24 +05:30
| `title` | String! | Title of the merge request |
| `titleHtml` | String | The GitLab Flavored Markdown rendering of `title` |
2019-12-21 20:55:43 +05:30
| `totalTimeSpent` | Int! | Total time reported as spent on the merge request |
2020-03-13 15:44:24 +05:30
| `updatedAt` | Time! | Timestamp of when the merge request was last updated |
| `upvotes` | Int! | Number of upvotes for the merge request |
| `userNotesCount` | Int | User notes count of the merge request |
| `userPermissions` | MergeRequestPermissions! | Permissions for the current user on the resource |
| `webUrl` | String | Web URL of the merge request |
| `workInProgress` | Boolean! | Indicates if the merge request is a work in progress (WIP) |
2020-06-23 00:09:42 +05:30
## MergeRequestCreatePayload
Autogenerated return type of MergeRequestCreate
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `mergeRequest` | MergeRequest | The merge request after mutation |
2020-03-13 15:44:24 +05:30
## MergeRequestPermissions
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
Check permissions for the current user on a merge request
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `adminMergeRequest` | Boolean! | Indicates the user can perform `admin_merge_request` on this resource |
| `cherryPickOnCurrentMergeRequest` | Boolean! | Indicates the user can perform `cherry_pick_on_current_merge_request` on this resource |
| `createNote` | Boolean! | Indicates the user can perform `create_note` on this resource |
| `pushToSourceBranch` | Boolean! | Indicates the user can perform `push_to_source_branch` on this resource |
| `readMergeRequest` | Boolean! | Indicates the user can perform `read_merge_request` on this resource |
| `removeSourceBranch` | Boolean! | Indicates the user can perform `remove_source_branch` on this resource |
| `revertOnCurrentMergeRequest` | Boolean! | Indicates the user can perform `revert_on_current_merge_request` on this resource |
| `updateMergeRequest` | Boolean! | Indicates the user can perform `update_merge_request` on this resource |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## MergeRequestSetAssigneesPayload
Autogenerated return type of MergeRequestSetAssignees
2019-12-26 22:10:19 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-26 22:10:19 +05:30
| `mergeRequest` | MergeRequest | The merge request after mutation |
2020-03-13 15:44:24 +05:30
## MergeRequestSetLabelsPayload
Autogenerated return type of MergeRequestSetLabels
2019-12-26 22:10:19 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-26 22:10:19 +05:30
| `mergeRequest` | MergeRequest | The merge request after mutation |
2020-03-13 15:44:24 +05:30
## MergeRequestSetLockedPayload
Autogenerated return type of MergeRequestSetLocked
2019-12-26 22:10:19 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-26 22:10:19 +05:30
| `mergeRequest` | MergeRequest | The merge request after mutation |
2020-03-13 15:44:24 +05:30
## MergeRequestSetMilestonePayload
Autogenerated return type of MergeRequestSetMilestone
2019-12-26 22:10:19 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-26 22:10:19 +05:30
| `mergeRequest` | MergeRequest | The merge request after mutation |
2020-03-13 15:44:24 +05:30
## MergeRequestSetSubscriptionPayload
Autogenerated return type of MergeRequestSetSubscription
2019-12-26 22:10:19 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-26 22:10:19 +05:30
| `mergeRequest` | MergeRequest | The merge request after mutation |
2020-03-13 15:44:24 +05:30
## MergeRequestSetWipPayload
Autogenerated return type of MergeRequestSetWip
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-09-30 21:07:59 +05:30
| `mergeRequest` | MergeRequest | The merge request after mutation |
2020-07-28 23:09:34 +05:30
## MergeRequestUpdatePayload
Autogenerated return type of MergeRequestUpdate
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `mergeRequest` | MergeRequest | The merge request after mutation |
2020-03-13 15:44:24 +05:30
## Metadata
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2019-12-26 22:10:19 +05:30
| `revision` | String! | Revision |
2020-03-13 15:44:24 +05:30
| `version` | String! | Version |
2019-09-30 21:07:59 +05:30
2020-04-22 19:07:51 +05:30
## MetricsDashboard
| Name | Type | Description |
| --- | ---- | ---------- |
| `path` | String | Path to a file with the dashboard definition |
2020-06-23 00:09:42 +05:30
| `schemaValidationWarnings` | String! => Array | Dashboard schema validation warnings |
2020-04-22 19:07:51 +05:30
## MetricsDashboardAnnotation
| Name | Type | Description |
| --- | ---- | ---------- |
| `description` | String | Description of the annotation |
2020-05-24 23:13:21 +05:30
| `endingAt` | Time | Timestamp marking end of annotated time span |
2020-04-22 19:07:51 +05:30
| `id` | ID! | ID of the annotation |
| `panelId` | String | ID of a dashboard panel to which the annotation should be scoped |
2020-05-24 23:13:21 +05:30
| `startingAt` | Time | Timestamp marking start of annotated time span |
2020-04-22 19:07:51 +05:30
2020-03-13 15:44:24 +05:30
## Milestone
Represents a milestone.
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `createdAt` | Time! | Timestamp of milestone creation |
2019-12-26 22:10:19 +05:30
| `description` | String | Description of the milestone |
| `dueDate` | Time | Timestamp of the milestone due date |
2020-06-23 00:09:42 +05:30
| `groupMilestone` | Boolean! | Indicates if milestone is at group level |
2020-03-13 15:44:24 +05:30
| `id` | ID! | ID of the milestone |
2020-06-23 00:09:42 +05:30
| `projectMilestone` | Boolean! | Indicates if milestone is at project level |
2019-12-26 22:10:19 +05:30
| `startDate` | Time | Timestamp of the milestone start date |
2020-03-13 15:44:24 +05:30
| `state` | MilestoneStateEnum! | State of the milestone |
2020-07-28 23:09:34 +05:30
| `stats` | MilestoneStats | Milestone statistics |
2020-06-23 00:09:42 +05:30
| `subgroupMilestone` | Boolean! | Indicates if milestone is at subgroup level |
2020-03-13 15:44:24 +05:30
| `title` | String! | Title of the milestone |
2019-12-26 22:10:19 +05:30
| `updatedAt` | Time! | Timestamp of last milestone update |
2020-03-13 15:44:24 +05:30
| `webPath` | String! | Web path of the milestone |
2019-09-30 21:07:59 +05:30
2020-07-28 23:09:34 +05:30
## MilestoneStats
Contains statistics about a milestone
| Name | Type | Description |
| --- | ---- | ---------- |
| `closedIssuesCount` | Int | Number of closed issues associated with the milestone |
| `totalIssuesCount` | Int | Total number of issues associated with the milestone |
2020-03-13 15:44:24 +05:30
## Namespace
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2019-12-26 22:10:19 +05:30
| `description` | String | Description of the namespace |
2019-09-30 21:07:59 +05:30
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
2020-03-13 15:44:24 +05:30
| `fullName` | String! | Full name of the namespace |
| `fullPath` | ID! | Full path of the namespace |
| `id` | ID! | ID of the namespace |
2020-10-24 23:57:45 +05:30
| `isTemporaryStorageIncreaseEnabled` | Boolean! | Status of the temporary storage increase |
2019-12-26 22:10:19 +05:30
| `lfsEnabled` | Boolean | Indicates if Large File Storage (LFS) is enabled for namespace |
2020-03-13 15:44:24 +05:30
| `name` | String! | Name of the namespace |
| `path` | String! | Path of the namespace |
2019-12-26 22:10:19 +05:30
| `requestAccessEnabled` | Boolean | Indicates if users can request access to namespace |
| `rootStorageStatistics` | RootStorageStatistics | Aggregated storage statistics of the namespace. Only available for root namespaces |
2020-07-28 23:09:34 +05:30
| `storageSizeLimit` | Float | Total storage limit of the root namespace in bytes |
| `temporaryStorageIncreaseEndsOn` | Time | Date until the temporary storage increase is active |
2020-03-13 15:44:24 +05:30
| `visibility` | String | Visibility of the namespace |
2019-09-30 21:07:59 +05:30
2020-10-24 23:57:45 +05:30
## NamespaceIncreaseStorageTemporarilyPayload
Autogenerated return type of NamespaceIncreaseStorageTemporarily
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `namespace` | Namespace | The namespace after mutation |
2020-03-13 15:44:24 +05:30
## Note
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-01-01 13:55:28 +05:30
| `author` | User! | User who wrote this note |
| `body` | String! | Content of the note |
2019-09-30 21:07:59 +05:30
| `bodyHtml` | String | The GitLab Flavored Markdown rendering of `note` |
2020-04-22 19:07:51 +05:30
| `confidential` | Boolean | Indicates if this note is confidential |
2020-01-01 13:55:28 +05:30
| `createdAt` | Time! | Timestamp of the note creation |
2019-09-30 21:07:59 +05:30
| `discussion` | Discussion | The discussion this note is a part of |
2020-03-13 15:44:24 +05:30
| `id` | ID! | ID of the note |
| `position` | DiffPosition | The position of this note on a diff |
| `project` | Project | Project associated with the note |
2020-06-23 00:09:42 +05:30
| `resolvable` | Boolean! | Indicates if the object can be resolved |
| `resolved` | Boolean! | Indicates if the object is resolved |
| `resolvedAt` | Time | Timestamp of when the object was resolved |
| `resolvedBy` | User | User who resolved the object |
2020-03-13 15:44:24 +05:30
| `system` | Boolean! | Indicates whether this note was created by the system or by a user |
2020-07-28 23:09:34 +05:30
| `systemNoteIconName` | String | Name of the icon corresponding to a system note |
2020-03-13 15:44:24 +05:30
| `updatedAt` | Time! | Timestamp of the note's last activity |
| `userPermissions` | NotePermissions! | Permissions for the current user on the resource |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## NotePermissions
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `adminNote` | Boolean! | Indicates the user can perform `admin_note` on this resource |
| `awardEmoji` | Boolean! | Indicates the user can perform `award_emoji` on this resource |
| `createNote` | Boolean! | Indicates the user can perform `create_note` on this resource |
| `readNote` | Boolean! | Indicates the user can perform `read_note` on this resource |
| `resolveNote` | Boolean! | Indicates the user can perform `resolve_note` on this resource |
2019-09-30 21:07:59 +05:30
2020-05-24 23:13:21 +05:30
## Package
Represents a package
| Name | Type | Description |
| --- | ---- | ---------- |
| `createdAt` | Time! | The created date |
| `id` | ID! | The ID of the package |
| `name` | String! | The name of the package |
| `packageType` | PackageTypeEnum! | The type of the package |
| `updatedAt` | Time! | The update date |
| `version` | String | The version of the package |
## PackageFileRegistry
Represents the sync and verification state of a package file
| Name | Type | Description |
| --- | ---- | ---------- |
| `createdAt` | Time | Timestamp when the PackageFileRegistry was created |
| `id` | ID! | ID of the PackageFileRegistry |
| `lastSyncFailure` | String | Error message during sync of the PackageFileRegistry |
| `lastSyncedAt` | Time | Timestamp of the most recent successful sync of the PackageFileRegistry |
| `packageFileId` | ID! | ID of the PackageFile |
| `retryAt` | Time | Timestamp after which the PackageFileRegistry should be resynced |
| `retryCount` | Int | Number of consecutive failed sync attempts of the PackageFileRegistry |
| `state` | RegistryState | Sync state of the PackageFileRegistry |
2020-03-13 15:44:24 +05:30
## PageInfo
Information about pagination in a connection.
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `endCursor` | String | When paginating forwards, the cursor to continue. |
2019-09-30 21:07:59 +05:30
| `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. |
2020-03-13 15:44:24 +05:30
## Pipeline
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `beforeSha` | String | Base SHA of the source branch |
| `committedAt` | Time | Timestamp of the pipeline's commit |
2020-10-24 23:57:45 +05:30
| `configSource` | PipelineConfigSourceEnum | Config source of the pipeline (UNKNOWN_SOURCE, REPOSITORY_SOURCE, AUTO_DEVOPS_SOURCE, WEBIDE_SOURCE, REMOTE_SOURCE, EXTERNAL_PROJECT_SOURCE, BRIDGE_SOURCE, PARAMETER_SOURCE) |
2019-09-30 21:07:59 +05:30
| `coverage` | Float | Coverage percentage |
2020-03-13 15:44:24 +05:30
| `createdAt` | Time! | Timestamp of the pipeline's creation |
| `detailedStatus` | DetailedStatus! | Detailed status of the pipeline |
| `duration` | Int | Duration of the pipeline in seconds |
| `finishedAt` | Time | Timestamp of the pipeline's completion |
| `id` | ID! | ID of the pipeline |
| `iid` | String! | Internal ID of the pipeline |
2020-06-23 00:09:42 +05:30
| `securityReportSummary` | SecurityReportSummary | Vulnerability and scanned resource counts for each security scanner of the pipeline |
2020-03-13 15:44:24 +05:30
| `sha` | String! | SHA of the pipeline's commit |
| `startedAt` | Time | Timestamp when the pipeline was started |
| `status` | PipelineStatusEnum! | Status of the pipeline (CREATED, WAITING_FOR_RESOURCE, PREPARING, PENDING, RUNNING, FAILED, SUCCESS, CANCELED, SKIPPED, MANUAL, SCHEDULED) |
| `updatedAt` | Time! | Timestamp of the pipeline's last activity |
2020-10-24 23:57:45 +05:30
| `user` | User | Pipeline user |
2020-03-13 15:44:24 +05:30
| `userPermissions` | PipelinePermissions! | Permissions for the current user on the resource |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## PipelinePermissions
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `adminPipeline` | Boolean! | Indicates the user can perform `admin_pipeline` on this resource |
| `destroyPipeline` | Boolean! | Indicates the user can perform `destroy_pipeline` on this resource |
| `updatePipeline` | Boolean! | Indicates the user can perform `update_pipeline` on this resource |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## Project
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-05-24 23:13:21 +05:30
| `alertManagementAlert` | AlertManagementAlert | A single Alert Management alert of the project |
| `alertManagementAlertStatusCounts` | AlertManagementAlertStatusCountsType | Counts of alerts by status for the project |
2020-06-23 00:09:42 +05:30
| `allowMergeOnSkippedPipeline` | Boolean | If `only_allow_merge_if_pipeline_succeeds` is true, indicates if merge requests of the project can also be merged with skipped jobs |
2020-03-13 15:44:24 +05:30
| `archived` | Boolean | Indicates the archived status of the project |
| `autocloseReferencedIssues` | Boolean | Indicates if issues referenced by merge requests and commits within the default branch are closed automatically |
| `avatarUrl` | String | URL to avatar image file of the project |
2020-04-08 14:13:33 +05:30
| `board` | Board | A single board of the project |
2020-06-23 00:09:42 +05:30
| `containerExpirationPolicy` | ContainerExpirationPolicy | The container expiration policy of the project |
2020-03-13 15:44:24 +05:30
| `containerRegistryEnabled` | Boolean | Indicates if the project stores Docker container images in a container registry |
| `createdAt` | Time | Timestamp of the project creation |
2019-12-26 22:10:19 +05:30
| `description` | String | Short description of the project |
2019-09-30 21:07:59 +05:30
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
2020-10-24 23:57:45 +05:30
| `environment` | Environment | A single environment of the project |
2019-12-26 22:10:19 +05:30
| `forksCount` | Int! | Number of times the project has been forked |
2020-03-13 15:44:24 +05:30
| `fullPath` | ID! | Full path of the project |
| `grafanaIntegration` | GrafanaIntegration | Grafana integration details for the project |
| `group` | Group | Group of the project |
| `httpUrlToRepo` | String | URL to connect to the project via HTTPS |
| `id` | ID! | ID of the project |
2020-04-22 19:07:51 +05:30
| `importStatus` | String | Status of import background job of the project |
2020-03-13 15:44:24 +05:30
| `issue` | Issue | A single issue of the project |
2020-10-24 23:57:45 +05:30
| `issueStatusCounts` | IssueStatusCountsType | Counts of issues by status for the project |
2020-04-22 19:07:51 +05:30
| `issuesEnabled` | Boolean | Indicates if Issues are enabled for the current user |
| `jiraImportStatus` | String | Status of Jira import background job of the project |
| `jobsEnabled` | Boolean | Indicates if CI/CD pipeline jobs are enabled for the current user |
2020-06-23 00:09:42 +05:30
| `label` | Label | A label available on this project |
2019-12-26 22:10:19 +05:30
| `lastActivityAt` | Time | Timestamp of the project last activity |
| `lfsEnabled` | Boolean | Indicates if the project has Large File Storage (LFS) enabled |
2020-03-13 15:44:24 +05:30
| `mergeRequest` | MergeRequest | A single merge request of the project |
2020-04-22 19:07:51 +05:30
| `mergeRequestsEnabled` | Boolean | Indicates if Merge Requests are enabled for the current user |
2020-03-13 15:44:24 +05:30
| `mergeRequestsFfOnlyEnabled` | Boolean | Indicates if no merge commits should be created and all merges should instead be fast-forwarded, which means that merging is only allowed if the branch could be fast-forwarded. |
| `name` | String! | Name of the project (without namespace) |
| `nameWithNamespace` | String! | Full name of the project with its namespace |
| `namespace` | Namespace | Namespace of the project |
2019-12-26 22:10:19 +05:30
| `onlyAllowMergeIfAllDiscussionsAreResolved` | Boolean | Indicates if merge requests of the project can only be merged when all the discussions are resolved |
2020-03-13 15:44:24 +05:30
| `onlyAllowMergeIfPipelineSucceeds` | Boolean | Indicates if merge requests of the project can only be merged with successful jobs |
| `openIssuesCount` | Int | Number of open issues for the project |
| `path` | String! | Path of the project |
2020-06-23 00:09:42 +05:30
| `pipeline` | Pipeline | Build pipeline of the project |
2019-12-26 22:10:19 +05:30
| `printingMergeRequestLinkEnabled` | Boolean | Indicates if a link to create or view a merge request should display after a push to Git repositories of the project from the command line |
2020-03-13 15:44:24 +05:30
| `publicJobs` | Boolean | Indicates if there is public access to pipelines and job details of the project, including output logs and artifacts |
2020-07-28 23:09:34 +05:30
| `release` | Release | A single release of the project |
2019-12-26 22:10:19 +05:30
| `removeSourceBranchAfterMerge` | Boolean | Indicates if `Delete source branch` option should be enabled by default for all new merge requests of the project |
| `repository` | Repository | Git repository of the project |
2020-03-13 15:44:24 +05:30
| `requestAccessEnabled` | Boolean | Indicates if users can request member access to the project |
2020-04-08 14:13:33 +05:30
| `requirement` | Requirement | Find a single requirement. Available only when feature flag `requirements_management` is enabled. |
2020-04-22 19:07:51 +05:30
| `requirementStatesCount` | RequirementStatesCount | Number of requirements for the project by their state |
2020-07-28 23:09:34 +05:30
| `sastCiConfiguration` | SastCiConfiguration | SAST CI configuration for the project |
2020-10-24 23:57:45 +05:30
| `securityDashboardPath` | String | Path to project's security dashboard |
2020-07-28 23:09:34 +05:30
| `securityScanners` | SecurityScanners | Information about security analyzers used in the project |
2020-01-01 13:55:28 +05:30
| `sentryDetailedError` | SentryDetailedError | Detailed version of a Sentry error on the project |
2020-03-13 15:44:24 +05:30
| `sentryErrors` | SentryErrorCollection | Paginated collection of Sentry errors on the project |
2020-01-01 13:55:28 +05:30
| `serviceDeskAddress` | String | E-mail address of the service desk. |
2020-03-13 15:44:24 +05:30
| `serviceDeskEnabled` | Boolean | Indicates if the project has service desk enabled. |
2020-04-22 19:07:51 +05:30
| `sharedRunnersEnabled` | Boolean | Indicates if Shared Runners are enabled for the project |
| `snippetsEnabled` | Boolean | Indicates if Snippets are enabled for the current user |
2020-03-13 15:44:24 +05:30
| `sshUrlToRepo` | String | URL to connect to the project via SSH |
| `starCount` | Int! | Number of times the project has been starred |
| `statistics` | ProjectStatistics | Statistics of the project |
| `suggestionCommitMessage` | String | The commit message used to apply merge request suggestions |
2020-04-22 19:07:51 +05:30
| `tagList` | String | List of project topics (not Git tags) |
2020-03-13 15:44:24 +05:30
| `userPermissions` | ProjectPermissions! | Permissions for the current user on the resource |
| `visibility` | String | Visibility of the project |
2020-05-24 23:13:21 +05:30
| `vulnerabilitySeveritiesCount` | VulnerabilitySeveritiesCount | Counts for each severity of vulnerability of the project |
2020-03-13 15:44:24 +05:30
| `webUrl` | String | Web URL of the project |
2020-04-22 19:07:51 +05:30
| `wikiEnabled` | Boolean | Indicates if Wikis are enabled for the current user |
2019-09-30 21:07:59 +05:30
2020-06-23 00:09:42 +05:30
## ProjectMember
Represents a Project Member
| Name | Type | Description |
| --- | ---- | ---------- |
| `accessLevel` | AccessLevel | GitLab::Access level |
| `createdAt` | Time | Date and time the membership was created |
| `createdBy` | User | User that authorized membership |
| `expiresAt` | Time | Date and time the membership expires |
| `id` | ID! | ID of the member |
| `project` | Project | Project that User is a member of |
| `updatedAt` | Time | Date and time the membership was last updated |
| `user` | User! | User that is associated with the member object |
| `userPermissions` | ProjectPermissions! | Permissions for the current user on the resource |
2020-03-13 15:44:24 +05:30
## ProjectPermissions
| Name | Type | Description |
| --- | ---- | ---------- |
| `adminOperations` | Boolean! | Indicates the user can perform `admin_operations` on this resource |
| `adminProject` | Boolean! | Indicates the user can perform `admin_project` on this resource |
| `adminRemoteMirror` | Boolean! | Indicates the user can perform `admin_remote_mirror` on this resource |
| `adminWiki` | Boolean! | Indicates the user can perform `admin_wiki` on this resource |
| `archiveProject` | Boolean! | Indicates the user can perform `archive_project` on this resource |
| `changeNamespace` | Boolean! | Indicates the user can perform `change_namespace` on this resource |
| `changeVisibilityLevel` | Boolean! | Indicates the user can perform `change_visibility_level` on this resource |
| `createDeployment` | Boolean! | Indicates the user can perform `create_deployment` on this resource |
| `createDesign` | Boolean! | Indicates the user can perform `create_design` on this resource |
| `createIssue` | Boolean! | Indicates the user can perform `create_issue` on this resource |
| `createLabel` | Boolean! | Indicates the user can perform `create_label` on this resource |
| `createMergeRequestFrom` | Boolean! | Indicates the user can perform `create_merge_request_from` on this resource |
| `createMergeRequestIn` | Boolean! | Indicates the user can perform `create_merge_request_in` on this resource |
| `createPages` | Boolean! | Indicates the user can perform `create_pages` on this resource |
| `createPipeline` | Boolean! | Indicates the user can perform `create_pipeline` on this resource |
| `createPipelineSchedule` | Boolean! | Indicates the user can perform `create_pipeline_schedule` on this resource |
| `createSnippet` | Boolean! | Indicates the user can perform `create_snippet` on this resource |
| `createWiki` | Boolean! | Indicates the user can perform `create_wiki` on this resource |
| `destroyDesign` | Boolean! | Indicates the user can perform `destroy_design` on this resource |
| `destroyPages` | Boolean! | Indicates the user can perform `destroy_pages` on this resource |
| `destroyWiki` | Boolean! | Indicates the user can perform `destroy_wiki` on this resource |
| `downloadCode` | Boolean! | Indicates the user can perform `download_code` on this resource |
| `downloadWikiCode` | Boolean! | Indicates the user can perform `download_wiki_code` on this resource |
| `forkProject` | Boolean! | Indicates the user can perform `fork_project` on this resource |
| `pushCode` | Boolean! | Indicates the user can perform `push_code` on this resource |
| `pushToDeleteProtectedBranch` | Boolean! | Indicates the user can perform `push_to_delete_protected_branch` on this resource |
| `readCommitStatus` | Boolean! | Indicates the user can perform `read_commit_status` on this resource |
| `readCycleAnalytics` | Boolean! | Indicates the user can perform `read_cycle_analytics` on this resource |
| `readDesign` | Boolean! | Indicates the user can perform `read_design` on this resource |
| `readMergeRequest` | Boolean! | Indicates the user can perform `read_merge_request` on this resource |
| `readPagesContent` | Boolean! | Indicates the user can perform `read_pages_content` on this resource |
| `readProject` | Boolean! | Indicates the user can perform `read_project` on this resource |
| `readProjectMember` | Boolean! | Indicates the user can perform `read_project_member` on this resource |
| `readWiki` | Boolean! | Indicates the user can perform `read_wiki` on this resource |
| `removeForkProject` | Boolean! | Indicates the user can perform `remove_fork_project` on this resource |
| `removePages` | Boolean! | Indicates the user can perform `remove_pages` on this resource |
| `removeProject` | Boolean! | Indicates the user can perform `remove_project` on this resource |
| `renameProject` | Boolean! | Indicates the user can perform `rename_project` on this resource |
| `requestAccess` | Boolean! | Indicates the user can perform `request_access` on this resource |
| `updatePages` | Boolean! | Indicates the user can perform `update_pages` on this resource |
| `updateWiki` | Boolean! | Indicates the user can perform `update_wiki` on this resource |
| `uploadFile` | Boolean! | Indicates the user can perform `upload_file` on this resource |
## ProjectStatistics
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-04-22 19:07:51 +05:30
| `buildArtifactsSize` | Float! | Build artifacts size of the project |
| `commitCount` | Float! | Commit count of the project |
| `lfsObjectsSize` | Float! | Large File Storage (LFS) object size of the project |
| `packagesSize` | Float! | Packages size of the project |
| `repositorySize` | Float! | Repository size of the project |
2020-07-28 23:09:34 +05:30
| `snippetsSize` | Float | Snippets size of the project |
2020-04-22 19:07:51 +05:30
| `storageSize` | Float! | Storage size of the project |
| `wikiSize` | Float | Wiki size of the project |
2019-09-30 21:07:59 +05:30
2020-10-24 23:57:45 +05:30
## PrometheusAlert
The alert condition for Prometheus
| Name | Type | Description |
| --- | ---- | ---------- |
| `humanizedText` | String! | The human-readable text of the alert condition |
| `id` | ID! | ID of the alert condition |
2020-05-24 23:13:21 +05:30
## Release
2020-07-28 23:09:34 +05:30
Represents a release
2020-05-24 23:13:21 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-06-23 00:09:42 +05:30
| `assets` | ReleaseAssets | Assets of the release |
2020-05-24 23:13:21 +05:30
| `author` | User | User that created the release |
| `commit` | Commit | The commit associated with the release |
| `createdAt` | Time | Timestamp of when the release was created |
| `description` | String | Description (also known as "release notes") of the release |
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
2020-07-28 23:09:34 +05:30
| `links` | ReleaseLinks | Links of the release |
2020-05-24 23:13:21 +05:30
| `name` | String | Name of the release |
| `releasedAt` | Time | Timestamp of when the release was released |
2020-07-28 23:09:34 +05:30
| `tagName` | String | Name of the tag associated with the release |
2020-05-24 23:13:21 +05:30
| `tagPath` | String | Relative web path to the tag associated with the release |
2020-07-28 23:09:34 +05:30
## ReleaseAssetLink
Represents an asset link associated with a release
| Name | Type | Description |
| --- | ---- | ---------- |
| `external` | Boolean | Indicates the link points to an external resource |
| `id` | ID! | ID of the link |
| `linkType` | ReleaseAssetLinkType | Type of the link: `other`, `runbook`, `image`, `package`; defaults to `other` |
| `name` | String | Name of the link |
| `url` | String | URL of the link |
2020-06-23 00:09:42 +05:30
## ReleaseAssets
2020-07-28 23:09:34 +05:30
A container for all assets associated with a release
2020-06-23 00:09:42 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-07-28 23:09:34 +05:30
| `count` | Int | Number of assets of the release |
2020-06-23 00:09:42 +05:30
## ReleaseEvidence
Evidence for a release
| Name | Type | Description |
| --- | ---- | ---------- |
| `collectedAt` | Time | Timestamp when the evidence was collected |
| `filepath` | String | URL from where the evidence can be downloaded |
| `id` | ID! | ID of the evidence |
| `sha` | String | SHA1 ID of the evidence hash |
2020-07-28 23:09:34 +05:30
## ReleaseLinks
2020-06-23 00:09:42 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-07-28 23:09:34 +05:30
| `editUrl` | String | HTTP URL of the release's edit page |
| `issuesUrl` | String | HTTP URL of the issues page filtered by this release |
| `mergeRequestsUrl` | String | HTTP URL of the merge request page filtered by this release |
| `selfUrl` | String | HTTP URL of the release |
2020-06-23 00:09:42 +05:30
## ReleaseSource
2020-07-28 23:09:34 +05:30
Represents the source code attached to a release in a particular format
2020-06-23 00:09:42 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `format` | String | Format of the source |
| `url` | String | Download URL of the source |
2020-03-13 15:44:24 +05:30
## RemoveAwardEmojiPayload
Autogenerated return type of RemoveAwardEmoji
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `awardEmoji` | AwardEmoji | The award emoji after mutation |
2019-09-30 21:07:59 +05:30
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
## RemoveProjectFromSecurityDashboardPayload
Autogenerated return type of RemoveProjectFromSecurityDashboard
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## Repository
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2019-12-26 22:10:19 +05:30
| `empty` | Boolean! | Indicates repository has no visible content |
| `exists` | Boolean! | Indicates a corresponding Git repository exists on disk |
2020-03-13 15:44:24 +05:30
| `rootRef` | String | Default branch of the repository |
2019-12-26 22:10:19 +05:30
| `tree` | Tree | Tree of the repository |
2019-09-30 21:07:59 +05:30
2020-04-08 14:13:33 +05:30
## Requirement
2020-06-23 00:09:42 +05:30
Represents a requirement
2020-04-08 14:13:33 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `author` | User! | Author of the requirement |
| `createdAt` | Time! | Timestamp of when the requirement was created |
| `id` | ID! | ID of the requirement |
| `iid` | ID! | Internal ID of the requirement |
| `project` | Project! | Project to which the requirement belongs |
| `state` | RequirementState! | State of the requirement |
| `title` | String | Title of the requirement |
| `updatedAt` | Time! | Timestamp of when the requirement was last updated |
| `userPermissions` | RequirementPermissions! | Permissions for the current user on the resource |
## RequirementPermissions
Check permissions for the current user on a requirement
| Name | Type | Description |
| --- | ---- | ---------- |
| `adminRequirement` | Boolean! | Indicates the user can perform `admin_requirement` on this resource |
| `createRequirement` | Boolean! | Indicates the user can perform `create_requirement` on this resource |
| `destroyRequirement` | Boolean! | Indicates the user can perform `destroy_requirement` on this resource |
| `readRequirement` | Boolean! | Indicates the user can perform `read_requirement` on this resource |
| `updateRequirement` | Boolean! | Indicates the user can perform `update_requirement` on this resource |
2020-04-22 19:07:51 +05:30
## RequirementStatesCount
Counts of requirements by their state.
| Name | Type | Description |
| --- | ---- | ---------- |
| `archived` | Int | Number of archived requirements |
| `opened` | Int | Number of opened requirements |
2020-03-13 15:44:24 +05:30
## RootStorageStatistics
2019-12-04 20:38:33 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-04-22 19:07:51 +05:30
| `buildArtifactsSize` | Float! | The CI artifacts size in bytes |
| `lfsObjectsSize` | Float! | The LFS objects size in bytes |
| `packagesSize` | Float! | The packages size in bytes |
| `repositorySize` | Float! | The Git repository size in bytes |
2020-07-28 23:09:34 +05:30
| `snippetsSize` | Float! | The snippets size in bytes |
2020-04-22 19:07:51 +05:30
| `storageSize` | Float! | The total storage in bytes |
| `wikiSize` | Float! | The wiki size in bytes |
2019-12-04 20:38:33 +05:30
2020-06-23 00:09:42 +05:30
## RunDASTScanPayload
Autogenerated return type of RunDASTScan
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `pipelineUrl` | String | URL of the pipeline that was created. |
2020-07-28 23:09:34 +05:30
## SastCiConfigurationAnalyzersEntity
Represents an analyzer entity in SAST CI configuration
| Name | Type | Description |
| --- | ---- | ---------- |
| `description` | String | Analyzer description that is displayed on the form. |
| `enabled` | Boolean | Indicates whether an analyzer is enabled. |
| `label` | String | Analyzer label used in the config UI. |
| `name` | String | Name of the analyzer. |
## SastCiConfigurationEntity
Represents an entity in SAST CI configuration
| Name | Type | Description |
| --- | ---- | ---------- |
| `defaultValue` | String | Default value that is used if value is empty. |
| `description` | String | Entity description that is displayed on the form. |
| `field` | String | CI keyword of entity. |
| `label` | String | Label for entity used in the form. |
2020-10-24 23:57:45 +05:30
| `size` | SastUiComponentSize | Size of the UI component. |
2020-07-28 23:09:34 +05:30
| `type` | String | Type of the field value. |
| `value` | String | Current value of the entity. |
## SastCiConfigurationOptionsEntity
Represents an entity for options in SAST CI configuration
| Name | Type | Description |
| --- | ---- | ---------- |
| `label` | String | Label of option entity. |
| `value` | String | Value of option entity. |
## ScannedResource
Represents a resource scanned by a security scan
| Name | Type | Description |
| --- | ---- | ---------- |
| `requestMethod` | String | The HTTP request method used to access the URL |
| `url` | String | The URL scanned by the scanner |
2020-06-23 00:09:42 +05:30
## SecurityReportSummary
Represents summary of a security report
| Name | Type | Description |
| --- | ---- | ---------- |
| `containerScanning` | SecurityReportSummarySection | Aggregated counts for the container_scanning scan |
2020-07-28 23:09:34 +05:30
| `coverageFuzzing` | SecurityReportSummarySection | Aggregated counts for the coverage_fuzzing scan |
2020-06-23 00:09:42 +05:30
| `dast` | SecurityReportSummarySection | Aggregated counts for the dast scan |
| `dependencyScanning` | SecurityReportSummarySection | Aggregated counts for the dependency_scanning scan |
| `sast` | SecurityReportSummarySection | Aggregated counts for the sast scan |
| `secretDetection` | SecurityReportSummarySection | Aggregated counts for the secret_detection scan |
## SecurityReportSummarySection
Represents a section of a summary of a security report
| Name | Type | Description |
| --- | ---- | ---------- |
| `scannedResourcesCount` | Int | Total number of scanned resources |
2020-07-28 23:09:34 +05:30
| `scannedResourcesCsvPath` | String | Path to download all the scanned resources in CSV format |
2020-06-23 00:09:42 +05:30
| `vulnerabilitiesCount` | Int | Total number of vulnerabilities |
2020-07-28 23:09:34 +05:30
## SecurityScanners
Represents a list of security scanners
| Name | Type | Description |
| --- | ---- | ---------- |
| `available` | SecurityScannerType! => Array | List of analyzers which are available for the project. |
| `enabled` | SecurityScannerType! => Array | List of analyzers which are enabled for the project. |
| `pipelineRun` | SecurityScannerType! => Array | List of analyzers which ran successfully in the latest pipeline. |
2020-03-13 15:44:24 +05:30
## SentryDetailedError
A Sentry error.
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `count` | Int! | Count of occurrences |
| `culprit` | String! | Culprit of the error |
| `externalBaseUrl` | String! | External Base URL of the Sentry Instance |
| `externalUrl` | String! | External URL of the error |
| `firstReleaseLastCommit` | String | Commit the error was first seen |
2020-07-28 23:09:34 +05:30
| `firstReleaseShortVersion` | String | Release short version the error was first seen |
| `firstReleaseVersion` | String | Release version the error was first seen |
2020-03-13 15:44:24 +05:30
| `firstSeen` | Time! | Timestamp when the error was first seen |
| `frequency` | SentryErrorFrequency! => Array | Last 24hr stats of the error |
| `gitlabCommit` | String | GitLab commit SHA attributed to the Error based on the release version |
| `gitlabCommitPath` | String | Path to the GitLab page for the GitLab commit attributed to the error |
| `gitlabIssuePath` | String | URL of GitLab Issue |
2020-01-01 13:55:28 +05:30
| `id` | ID! | ID (global ID) of the error |
2020-03-13 15:44:24 +05:30
| `lastReleaseLastCommit` | String | Commit the error was last seen |
2020-07-28 23:09:34 +05:30
| `lastReleaseShortVersion` | String | Release short version the error was last seen |
| `lastReleaseVersion` | String | Release version the error was last seen |
2020-03-13 15:44:24 +05:30
| `lastSeen` | Time! | Timestamp when the error was last seen |
| `message` | String | Sentry metadata message of the error |
2020-01-01 13:55:28 +05:30
| `sentryId` | String! | ID (Sentry ID) of the error |
2020-03-13 15:44:24 +05:30
| `sentryProjectId` | ID! | ID of the project (Sentry project) |
| `sentryProjectName` | String! | Name of the project affected by the error |
| `sentryProjectSlug` | String! | Slug of the project affected by the error |
| `shortId` | String! | Short ID (Sentry ID) of the error |
| `status` | SentryErrorStatus! | Status of the error |
| `tags` | SentryErrorTags! | Tags associated with the Sentry Error |
2020-01-01 13:55:28 +05:30
| `title` | String! | Title of the error |
| `type` | String! | Type of the error |
| `userCount` | Int! | Count of users affected by the error |
2020-03-13 15:44:24 +05:30
## SentryError
A Sentry error. A simplified version of SentryDetailedError.
| Name | Type | Description |
| --- | ---- | ---------- |
2020-01-01 13:55:28 +05:30
| `count` | Int! | Count of occurrences |
2020-03-13 15:44:24 +05:30
| `culprit` | String! | Culprit of the error |
| `externalUrl` | String! | External URL of the error |
2020-01-01 13:55:28 +05:30
| `firstSeen` | Time! | Timestamp when the error was first seen |
2020-03-13 15:44:24 +05:30
| `frequency` | SentryErrorFrequency! => Array | Last 24hr stats of the error |
| `id` | ID! | ID (global ID) of the error |
2020-01-01 13:55:28 +05:30
| `lastSeen` | Time! | Timestamp when the error was last seen |
| `message` | String | Sentry metadata message of the error |
2020-03-13 15:44:24 +05:30
| `sentryId` | String! | ID (Sentry ID) of the error |
2020-01-01 13:55:28 +05:30
| `sentryProjectId` | ID! | ID of the project (Sentry project) |
| `sentryProjectName` | String! | Name of the project affected by the error |
| `sentryProjectSlug` | String! | Slug of the project affected by the error |
| `shortId` | String! | Short ID (Sentry ID) of the error |
| `status` | SentryErrorStatus! | Status of the error |
2020-03-13 15:44:24 +05:30
| `title` | String! | Title of the error |
| `type` | String! | Type of the error |
| `userCount` | Int! | Count of users affected by the error |
## SentryErrorCollection
2020-01-01 13:55:28 +05:30
2020-03-13 15:44:24 +05:30
An object containing a collection of Sentry errors, and a detailed error.
| Name | Type | Description |
| --- | ---- | ---------- |
| `detailedError` | SentryDetailedError | Detailed version of a Sentry error on the project |
| `errorStackTrace` | SentryErrorStackTrace | Stack Trace of Sentry Error |
| `errors` | SentryErrorConnection | Collection of Sentry Errors |
| `externalUrl` | String | External URL for Sentry |
## SentryErrorFrequency
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `count` | Int! | Count of errors received since the previously recorded time |
2020-03-13 15:44:24 +05:30
| `time` | Time! | Time the error frequency stats were recorded |
2020-01-01 13:55:28 +05:30
2020-03-13 15:44:24 +05:30
## SentryErrorStackTrace
An object containing a stack trace entry for a Sentry error.
| Name | Type | Description |
| --- | ---- | ---------- |
| `dateReceived` | String! | Time the stack trace was received by Sentry |
| `issueId` | String! | ID of the Sentry error |
| `stackTraceEntries` | SentryErrorStackTraceEntry! => Array | Stack trace entries for the Sentry error |
## SentryErrorStackTraceContext
An object context for a Sentry error stack trace
| Name | Type | Description |
| --- | ---- | ---------- |
| `code` | String! | Code number of the context |
| `line` | Int! | Line number of the context |
## SentryErrorStackTraceEntry
An object containing a stack trace entry for a Sentry error.
| Name | Type | Description |
| --- | ---- | ---------- |
| `col` | String | Function in which the Sentry error occurred |
| `fileName` | String | File in which the Sentry error occurred |
| `function` | String | Function in which the Sentry error occurred |
| `line` | String | Function in which the Sentry error occurred |
| `traceContext` | SentryErrorStackTraceContext! => Array | Context of the Sentry error |
## SentryErrorTags
State of a Sentry error
| Name | Type | Description |
| --- | ---- | ---------- |
| `level` | String | Severity level of the Sentry Error |
| `logger` | String | Logger of the Sentry Error |
## Snippet
Represents a snippet entry
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-06-23 00:09:42 +05:30
| `author` | User | The owner of the snippet |
2020-10-24 23:57:45 +05:30
| `blob` **{warning-solid}** | SnippetBlob! | **Deprecated:** Use `blobs`. Deprecated in 13.3 |
2020-06-23 00:09:42 +05:30
| `blobs` | SnippetBlob! => Array | Snippet blobs |
2020-01-01 13:55:28 +05:30
| `createdAt` | Time! | Timestamp this snippet was created |
2020-03-13 15:44:24 +05:30
| `description` | String | Description of the snippet |
| `descriptionHtml` | String | The GitLab Flavored Markdown rendering of `description` |
| `fileName` | String | File Name of the snippet |
2020-04-22 19:07:51 +05:30
| `httpUrlToRepo` | String | HTTP URL to the snippet repository |
2020-05-24 23:13:21 +05:30
| `id` | ID! | ID of the snippet |
2020-03-13 15:44:24 +05:30
| `project` | Project | The project the snippet is associated with |
| `rawUrl` | String! | Raw URL of the snippet |
2020-04-22 19:07:51 +05:30
| `sshUrlToRepo` | String | SSH URL to the snippet repository |
2020-03-13 15:44:24 +05:30
| `title` | String! | Title of the snippet |
2020-01-01 13:55:28 +05:30
| `updatedAt` | Time! | Timestamp this snippet was updated |
2020-03-13 15:44:24 +05:30
| `userPermissions` | SnippetPermissions! | Permissions for the current user on the resource |
| `visibilityLevel` | VisibilityLevelsEnum! | Visibility Level of the snippet |
2020-01-01 13:55:28 +05:30
| `webUrl` | String! | Web URL of the snippet |
2020-03-13 15:44:24 +05:30
## SnippetBlob
Represents the snippet blob
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `binary` | Boolean! | Shows whether the blob is binary |
2020-05-24 23:13:21 +05:30
| `externalStorage` | String | Blob external storage |
2020-03-13 15:44:24 +05:30
| `mode` | String | Blob mode |
| `name` | String | Blob name |
| `path` | String | Blob path |
| `plainData` | String | Blob plain highlighted data |
| `rawPath` | String! | Blob raw content endpoint path |
2020-05-24 23:13:21 +05:30
| `renderedAsText` | Boolean! | Shows whether the blob is rendered as text |
2020-03-13 15:44:24 +05:30
| `richData` | String | Blob highlighted data |
| `richViewer` | SnippetBlobViewer | Blob content rich viewer |
| `simpleViewer` | SnippetBlobViewer! | Blob content simple viewer |
| `size` | Int! | Blob size |
## SnippetBlobViewer
2020-01-01 13:55:28 +05:30
2020-03-13 15:44:24 +05:30
Represents how the blob content should be displayed
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `collapsed` | Boolean! | Shows whether the blob should be displayed collapsed |
| `fileType` | String! | Content file type |
| `loadAsync` | Boolean! | Shows whether the blob content is loaded async |
| `loadingPartialName` | String! | Loading partial name |
| `renderError` | String | Error rendering the blob content |
| `tooLarge` | Boolean! | Shows whether the blob too large to be displayed |
| `type` | BlobViewersType! | Type of blob viewer |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## SnippetPermissions
| Name | Type | Description |
| --- | ---- | ---------- |
| `adminSnippet` | Boolean! | Indicates the user can perform `admin_snippet` on this resource |
| `awardEmoji` | Boolean! | Indicates the user can perform `award_emoji` on this resource |
| `createNote` | Boolean! | Indicates the user can perform `create_note` on this resource |
| `readSnippet` | Boolean! | Indicates the user can perform `read_snippet` on this resource |
| `reportSnippet` | Boolean! | Indicates the user can perform `report_snippet` on this resource |
| `updateSnippet` | Boolean! | Indicates the user can perform `update_snippet` on this resource |
## Submodule
| Name | Type | Description |
| --- | ---- | ---------- |
| `flatPath` | String! | Flat path of the entry |
| `id` | ID! | ID of the entry |
| `name` | String! | Name of the entry |
| `path` | String! | Path of the entry |
| `sha` | String! | Last commit sha for the entry |
| `treeUrl` | String | Tree URL for the sub-module |
| `type` | EntryType! | Type of tree entry |
| `webUrl` | String | Web URL for the sub-module |
## TaskCompletionStatus
Completion status of tasks
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2019-12-26 22:10:19 +05:30
| `completedCount` | Int! | Number of completed tasks |
2020-03-13 15:44:24 +05:30
| `count` | Int! | Number of total tasks |
2019-09-30 21:07:59 +05:30
2020-06-23 00:09:42 +05:30
## TestReport
Represents a requirement test report.
| Name | Type | Description |
| --- | ---- | ---------- |
| `author` | User | Author of the test report |
| `createdAt` | Time! | Timestamp of when the test report was created |
| `id` | ID! | ID of the test report |
| `state` | TestReportState! | State of the test report |
2020-03-13 15:44:24 +05:30
## Timelog
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-04-22 19:07:51 +05:30
| `date` **{warning-solid}** | Time! | **Deprecated:** Use `spentAt`. Deprecated in 12.10 |
2020-03-13 15:44:24 +05:30
| `issue` | Issue | The issue that logged time was added to |
2020-04-22 19:07:51 +05:30
| `spentAt` | Time | Timestamp of when the time tracked was spent at |
2020-01-01 13:55:28 +05:30
| `timeSpent` | Int! | The time spent displayed in seconds |
| `user` | User! | The user that logged the time |
2020-03-13 15:44:24 +05:30
## Todo
Representing a todo entry
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `action` | TodoActionEnum! | Action of the todo |
2020-03-13 15:44:24 +05:30
| `author` | User! | The owner of this todo |
2019-12-21 20:55:43 +05:30
| `body` | String! | Body of the todo |
| `createdAt` | Time! | Timestamp this todo was created |
2020-03-13 15:44:24 +05:30
| `group` | Group | Group this todo is associated with |
2020-05-24 23:13:21 +05:30
| `id` | ID! | ID of the todo |
2020-03-13 15:44:24 +05:30
| `project` | Project | The project this todo is associated with |
| `state` | TodoStateEnum! | State of the todo |
| `targetType` | TodoTargetEnum! | Target type of the todo |
## TodoMarkDonePayload
2019-12-21 20:55:43 +05:30
2020-03-13 15:44:24 +05:30
Autogenerated return type of TodoMarkDone
2019-12-26 22:10:19 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-26 22:10:19 +05:30
| `todo` | Todo! | The requested todo |
2020-03-13 15:44:24 +05:30
## TodoRestoreManyPayload
Autogenerated return type of TodoRestoreMany
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-07-28 23:09:34 +05:30
| `todos` | Todo! => Array | Updated todos |
| `updatedIds` **{warning-solid}** | ID! => Array | **Deprecated:** Use todos. Deprecated in 13.2 |
2020-03-13 15:44:24 +05:30
## TodoRestorePayload
Autogenerated return type of TodoRestore
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-01-01 13:55:28 +05:30
| `todo` | Todo! | The requested todo |
2020-03-13 15:44:24 +05:30
## TodosMarkAllDonePayload
Autogenerated return type of TodosMarkAllDone
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-07-28 23:09:34 +05:30
| `todos` | Todo! => Array | Updated todos |
| `updatedIds` **{warning-solid}** | ID! => Array | **Deprecated:** Use todos. Deprecated in 13.2 |
2020-01-01 13:55:28 +05:30
2020-03-13 15:44:24 +05:30
## ToggleAwardEmojiPayload
Autogenerated return type of ToggleAwardEmoji
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `awardEmoji` | AwardEmoji | The award emoji after mutation |
2019-09-30 21:07:59 +05:30
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-03-13 15:44:24 +05:30
| `toggledOn` | Boolean! | Indicates the status of the emoji. True if the toggle awarded the emoji, and false if the toggle removed the emoji. |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## Tree
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2019-12-21 20:55:43 +05:30
| `lastCommit` | Commit | Last commit for the tree |
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
## TreeEntry
Represents a directory
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `flatPath` | String! | Flat path of the entry |
| `id` | ID! | ID of the entry |
| `name` | String! | Name of the entry |
| `path` | String! | Path of the entry |
| `sha` | String! | Last commit sha for the entry |
| `type` | EntryType! | Type of tree entry |
2020-10-24 23:57:45 +05:30
| `webPath` | String | Web path for the tree entry (directory) |
2020-03-13 15:44:24 +05:30
| `webUrl` | String | Web URL for the tree entry (directory) |
2020-05-24 23:13:21 +05:30
## UpdateAlertStatusPayload
Autogenerated return type of UpdateAlertStatus
| Name | Type | Description |
| --- | ---- | ---------- |
| `alert` | AlertManagementAlert | The alert after mutation |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `issue` | Issue | The issue created after mutation |
2020-07-28 23:09:34 +05:30
| `todo` | Todo | The todo after mutation |
2020-05-24 23:13:21 +05:30
2020-10-24 23:57:45 +05:30
## UpdateBoardListPayload
Autogenerated return type of UpdateBoardList
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `list` | BoardList | Mutated list |
## UpdateBoardPayload
Autogenerated return type of UpdateBoard
| Name | Type | Description |
| --- | ---- | ---------- |
| `board` | Board | The board after mutation. |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-06-23 00:09:42 +05:30
## UpdateContainerExpirationPolicyPayload
Autogenerated return type of UpdateContainerExpirationPolicy
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `containerExpirationPolicy` | ContainerExpirationPolicy | The container expiration policy after mutation |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-03-13 15:44:24 +05:30
## UpdateEpicPayload
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
Autogenerated return type of UpdateEpic
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `epic` | Epic | The epic after mutation |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
2020-03-13 15:44:24 +05:30
## UpdateImageDiffNotePayload
Autogenerated return type of UpdateImageDiffNote
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-03-13 15:44:24 +05:30
| `note` | Note | The note after mutation |
## UpdateIssuePayload
Autogenerated return type of UpdateIssue
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-03-13 15:44:24 +05:30
| `issue` | Issue | The issue after mutation |
2020-07-28 23:09:34 +05:30
## UpdateIterationPayload
Autogenerated return type of UpdateIteration
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
| `iteration` | Iteration | The updated iteration |
2020-03-13 15:44:24 +05:30
## UpdateNotePayload
Autogenerated return type of UpdateNote
2019-12-21 20:55:43 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2019-12-21 20:55:43 +05:30
| `note` | Note | The note after mutation |
2020-04-22 19:07:51 +05:30
## UpdateRequirementPayload
Autogenerated return type of UpdateRequirement
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-04-22 19:07:51 +05:30
| `requirement` | Requirement | The requirement after mutation |
2020-03-13 15:44:24 +05:30
## UpdateSnippetPayload
Autogenerated return type of UpdateSnippet
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
| `clientMutationId` | String | A unique identifier for the client performing the mutation. |
2020-05-24 23:13:21 +05:30
| `errors` | String! => Array | Errors encountered during execution of the mutation. |
2020-01-01 13:55:28 +05:30
| `snippet` | Snippet | The snippet after mutation |
2020-03-13 15:44:24 +05:30
## User
2019-09-30 21:07:59 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `avatarUrl` | String | URL of the user's avatar |
2020-10-24 23:57:45 +05:30
| `email` | String | User email |
2020-05-24 23:13:21 +05:30
| `id` | ID! | ID of the user |
2019-12-26 22:10:19 +05:30
| `name` | String! | Human-readable name of the user |
2020-06-23 00:09:42 +05:30
| `state` | UserState! | State of the user |
2020-10-24 23:57:45 +05:30
| `status` | UserStatus | User status |
2020-03-13 15:44:24 +05:30
| `userPermissions` | UserPermissions! | Permissions for the current user on the resource |
2019-12-26 22:10:19 +05:30
| `username` | String! | Username of the user. Unique within this instance of GitLab |
2020-10-24 23:57:45 +05:30
| `webPath` | String! | Web path of the user |
2019-12-26 22:10:19 +05:30
| `webUrl` | String! | Web URL of the user |
2020-01-01 13:55:28 +05:30
2020-03-13 15:44:24 +05:30
## UserPermissions
2020-01-01 13:55:28 +05:30
| Name | Type | Description |
| --- | ---- | ---------- |
2020-03-13 15:44:24 +05:30
| `createSnippet` | Boolean! | Indicates the user can perform `create_snippet` on this resource |
2020-04-08 14:13:33 +05:30
2020-10-24 23:57:45 +05:30
## UserStatus
| Name | Type | Description |
| --- | ---- | ---------- |
| `emoji` | String | String representation of emoji |
| `message` | String | User status message |
| `messageHtml` | String | HTML of the user status message |
## VulnerabilitiesCountByDay
Represents the count of vulnerabilities by severity on a particular day
| Name | Type | Description |
| --- | ---- | ---------- |
| `critical` | Int! | Total number of vulnerabilities on a particular day with critical severity |
| `date` | ISO8601Date! | Date for the count |
| `high` | Int! | Total number of vulnerabilities on a particular day with high severity |
| `info` | Int! | Total number of vulnerabilities on a particular day with info severity |
| `low` | Int! | Total number of vulnerabilities on a particular day with low severity |
| `medium` | Int! | Total number of vulnerabilities on a particular day with medium severity |
| `total` | Int! | Total number of vulnerabilities on a particular day |
| `unknown` | Int! | Total number of vulnerabilities on a particular day with unknown severity |
2020-05-24 23:13:21 +05:30
## VulnerabilitiesCountByDayAndSeverity
Represents the number of vulnerabilities for a particular severity on a particular day
| Name | Type | Description |
| --- | ---- | ---------- |
| `count` | Int | Number of vulnerabilities |
| `day` | ISO8601Date | Date for the count |
| `severity` | VulnerabilitySeverity | Severity of the counted vulnerabilities |
2020-04-08 14:13:33 +05:30
## Vulnerability
Represents a vulnerability.
| Name | Type | Description |
| --- | ---- | ---------- |
| `description` | String | Description of the vulnerability |
| `id` | ID! | GraphQL ID of the vulnerability |
2020-07-28 23:09:34 +05:30
| `identifiers` | VulnerabilityIdentifier! => Array | Identifiers of the vulnerability. |
2020-05-24 23:13:21 +05:30
| `location` | VulnerabilityLocation | Location metadata for the vulnerability. Its fields depend on the type of security scan that found the vulnerability |
2020-07-28 23:09:34 +05:30
| `primaryIdentifier` | VulnerabilityIdentifier | Primary identifier of the vulnerability. |
2020-04-22 19:07:51 +05:30
| `project` | Project | The project on which the vulnerability was found |
2020-07-28 23:09:34 +05:30
| `reportType` | VulnerabilityReportType | Type of the security report that found the vulnerability (SAST, DEPENDENCY_SCANNING, CONTAINER_SCANNING, DAST, SECRET_DETECTION, COVERAGE_FUZZING) |
2020-10-24 23:57:45 +05:30
| `resolvedOnDefaultBranch` | Boolean! | Indicates whether the vulnerability is fixed on the default branch or not |
2020-07-28 23:09:34 +05:30
| `scanner` | VulnerabilityScanner | Scanner metadata for the vulnerability. |
2020-04-08 14:13:33 +05:30
| `severity` | VulnerabilitySeverity | Severity of the vulnerability (INFO, UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL) |
| `state` | VulnerabilityState | State of the vulnerability (DETECTED, DISMISSED, RESOLVED, CONFIRMED) |
| `title` | String | Title of the vulnerability |
2020-06-23 00:09:42 +05:30
| `userNotesCount` | Int! | Number of user notes attached to the vulnerability |
2020-04-22 19:07:51 +05:30
| `userPermissions` | VulnerabilityPermissions! | Permissions for the current user on the resource |
2020-04-08 14:13:33 +05:30
| `vulnerabilityPath` | String | URL to the vulnerability's details page |
2020-04-22 19:07:51 +05:30
2020-07-28 23:09:34 +05:30
## VulnerabilityIdentifier
Represents a vulnerability identifier.
| Name | Type | Description |
| --- | ---- | ---------- |
| `externalId` | String | External ID of the vulnerability identifier |
| `externalType` | String | External type of the vulnerability identifier |
| `name` | String | Name of the vulnerability identifier |
| `url` | String | URL of the vulnerability identifier |
2020-06-23 00:09:42 +05:30
## VulnerabilityIssueLink
Represents an issue link of a vulnerability.
| Name | Type | Description |
| --- | ---- | ---------- |
| `id` | ID! | GraphQL ID of the vulnerability |
| `issue` | Issue! | The issue attached to issue link |
| `linkType` | VulnerabilityIssueLinkType! | Type of the issue link |
2020-05-24 23:13:21 +05:30
## VulnerabilityLocationContainerScanning
Represents the location of a vulnerability found by a container security scan
| Name | Type | Description |
| --- | ---- | ---------- |
| `dependency` | VulnerableDependency | Dependency containing the vulnerability |
| `image` | String | Name of the vulnerable container image |
| `operatingSystem` | String | Operating system that runs on the vulnerable container image |
2020-10-24 23:57:45 +05:30
## VulnerabilityLocationCoverageFuzzing
Represents the location of a vulnerability found by a Coverage Fuzzing scan
| Name | Type | Description |
| --- | ---- | ---------- |
| `endLine` | String | Number of the last relevant line in the vulnerable file |
| `file` | String | Path to the vulnerable file |
| `startLine` | String | Number of the first relevant line in the vulnerable file |
| `vulnerableClass` | String | Class containing the vulnerability |
| `vulnerableMethod` | String | Method containing the vulnerability |
2020-05-24 23:13:21 +05:30
## VulnerabilityLocationDast
Represents the location of a vulnerability found by a DAST scan
| Name | Type | Description |
| --- | ---- | ---------- |
| `hostname` | String | Domain name of the vulnerable request |
| `param` | String | Query parameter for the URL on which the vulnerability occurred |
| `path` | String | URL path and query string of the vulnerable request |
| `requestMethod` | String | HTTP method of the vulnerable request |
## VulnerabilityLocationDependencyScanning
Represents the location of a vulnerability found by a dependency security scan
| Name | Type | Description |
| --- | ---- | ---------- |
| `dependency` | VulnerableDependency | Dependency containing the vulnerability |
| `file` | String | Path to the vulnerable file |
## VulnerabilityLocationSast
Represents the location of a vulnerability found by a SAST scan
| Name | Type | Description |
| --- | ---- | ---------- |
| `endLine` | String | Number of the last relevant line in the vulnerable file |
| `file` | String | Path to the vulnerable file |
| `startLine` | String | Number of the first relevant line in the vulnerable file |
| `vulnerableClass` | String | Class containing the vulnerability |
| `vulnerableMethod` | String | Method containing the vulnerability |
2020-06-23 00:09:42 +05:30
## VulnerabilityLocationSecretDetection
Represents the location of a vulnerability found by a secret detection scan
| Name | Type | Description |
| --- | ---- | ---------- |
| `endLine` | String | Number of the last relevant line in the vulnerable file |
| `file` | String | Path to the vulnerable file |
| `startLine` | String | Number of the first relevant line in the vulnerable file |
| `vulnerableClass` | String | Class containing the vulnerability |
| `vulnerableMethod` | String | Method containing the vulnerability |
2020-04-22 19:07:51 +05:30
## VulnerabilityPermissions
Check permissions for the current user on a vulnerability
| Name | Type | Description |
| --- | ---- | ---------- |
| `adminVulnerability` | Boolean! | Indicates the user can perform `admin_vulnerability` on this resource |
| `adminVulnerabilityIssueLink` | Boolean! | Indicates the user can perform `admin_vulnerability_issue_link` on this resource |
| `createVulnerability` | Boolean! | Indicates the user can perform `create_vulnerability` on this resource |
| `createVulnerabilityExport` | Boolean! | Indicates the user can perform `create_vulnerability_export` on this resource |
| `createVulnerabilityFeedback` | Boolean! | Indicates the user can perform `create_vulnerability_feedback` on this resource |
| `destroyVulnerabilityFeedback` | Boolean! | Indicates the user can perform `destroy_vulnerability_feedback` on this resource |
| `readVulnerabilityFeedback` | Boolean! | Indicates the user can perform `read_vulnerability_feedback` on this resource |
| `updateVulnerabilityFeedback` | Boolean! | Indicates the user can perform `update_vulnerability_feedback` on this resource |
2020-07-28 23:09:34 +05:30
## VulnerabilityScanner
Represents a vulnerability scanner.
| Name | Type | Description |
| --- | ---- | ---------- |
| `externalId` | String | External ID of the vulnerability scanner |
| `name` | String | Name of the vulnerability scanner |
| `reportType` | VulnerabilityReportType | Type of the vulnerability report |
| `vendor` | String | Vendor of the vulnerability scanner |
2020-04-22 19:07:51 +05:30
## VulnerabilitySeveritiesCount
Represents vulnerability counts by severity
| Name | Type | Description |
| --- | ---- | ---------- |
| `critical` | Int | Number of vulnerabilities of CRITICAL severity of the project |
| `high` | Int | Number of vulnerabilities of HIGH severity of the project |
| `info` | Int | Number of vulnerabilities of INFO severity of the project |
| `low` | Int | Number of vulnerabilities of LOW severity of the project |
| `medium` | Int | Number of vulnerabilities of MEDIUM severity of the project |
| `unknown` | Int | Number of vulnerabilities of UNKNOWN severity of the project |
2020-05-24 23:13:21 +05:30
## VulnerableDependency
Represents a vulnerable dependency. Used in vulnerability location data
| Name | Type | Description |
| --- | ---- | ---------- |
| `package` | VulnerablePackage | The package associated with the vulnerable dependency |
| `version` | String | The version of the vulnerable dependency |
## VulnerablePackage
Represents a vulnerable package. Used in vulnerability dependency data
| Name | Type | Description |
| --- | ---- | ---------- |
| `name` | String | The name of the vulnerable package |
2020-10-24 23:57:45 +05:30
## VulnerableProjectsByGrade
Represents vulnerability letter grades with associated projects
| Name | Type | Description |
| --- | ---- | ---------- |
| `count` | Int! | Number of projects within this grade |
| `grade` | VulnerabilityGrade! | Grade based on the highest severity vulnerability present |