GraphQL API Resources

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

The API can be explored interactively using the GraphiQL IDE.

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.

Fields that are deprecated are marked with . Items (fields, enums, etc) that have been removed according to our deprecation process can be found in Removed Items.

`Query` type

The Query type contains the API’s top-level entry points for all executable queries.

`Query.aiMessages`

Find AI messages.

Introduced in 16.1. This feature is an Experiment. It can be changed or removed at any time.

Returns AiCachedMessageTypeConnection!.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`requestIds`	`[ID!]`	Array of request IDs to fetch.
`roles`	`[AiCachedMessageRole!]`	Array of roles to fetch.

`Query.auditEventDefinitions`

Definitions for all audit events available on the instance.

Returns AuditEventDefinitionConnection!.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

`Query.boardList`

Find an issue board list.

Returns BoardList.

Arguments

Name	Type	Description
`id`	`ListID!`	Global ID of the list.
`issueFilters`	`BoardIssueInput`	Filters applied when getting issue metadata in the board list.

`Query.ciApplicationSettings`

CI related settings that apply to the entire instance.

Returns CiApplicationSettings.

`Query.ciCatalogResource`

A single CI/CD Catalog resource visible to an authorized user.

Introduced in 16.1. This feature is an Experiment. It can be changed or removed at any time.

Returns CiCatalogResource.

Arguments

Name	Type	Description
`id`	`CiCatalogResourceID!`	CI/CD Catalog resource global ID.

`Query.ciCatalogResources`

All CI/CD Catalog resources under a common namespace, visible to an authorized user.

Introduced in 15.11. This feature is an Experiment. It can be changed or removed at any time.

Returns CiCatalogResourceConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`projectPath`	`ID`	Project with the namespace catalog.
`sort`	`CiCatalogResourceSort`	Sort Catalog Resources by given criteria.

`Query.ciConfig`

Linted and processed contents of a CI config. Should not be requested more than once per request.

Returns CiConfig.

Arguments

Name	Type	Description
`content`	`String!`	Contents of `.gitlab-ci.yml`.
`dryRun`	`Boolean`	Run pipeline creation simulation, or only do static check.
`projectPath`	`ID!`	Project of the CI config.
`sha`	`String`	Sha for the pipeline.

`Query.ciMinutesUsage`

Compute usage data for a namespace.

Returns CiMinutesNamespaceMonthlyUsageConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`date`	`Date`	Date for which to retrieve the usage data, should be the first day of a month.
`namespaceId`	`NamespaceID`	Global ID of the Namespace for the monthly compute usage.

`Query.ciPipelineStage`

Stage belonging to a CI pipeline.

Returns CiStage.

Arguments

Name	Type	Description
`id`	`CiStageID!`	Global ID of the CI stage.

`Query.ciVariables`

List of the instance’s CI/CD variables.

Returns CiInstanceVariableConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`sort`	`CiVariableSort`	Sort order of results.

`Query.containerRepository`

Find a container repository.

Returns ContainerRepositoryDetails.

Arguments

Name	Type	Description
`id`	`ContainerRepositoryID!`	Global ID of the container repository.

`Query.currentLicense`

Fields related to the current license.

Returns CurrentLicense.

`Query.currentUser`

Get information about current user.

Returns UserCore.

`Query.designManagement`

Fields related to design management.

Returns DesignManagement!.

`Query.devopsAdoptionEnabledNamespaces`

Get configured DevOps adoption namespaces. BETA This endpoint is subject to change without notice.

Returns DevopsAdoptionEnabledNamespaceConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`displayNamespaceId`	`NamespaceID`	Filter by display namespace.

`Query.echo`

Testing endpoint to validate the API with.

Returns String!.

Arguments

Name	Type	Description
`text`	`String!`	Text to echo back.

`Query.epicBoardList`

Returns EpicList.

Arguments

Name	Type	Description
`epicFilters`	`EpicFilters`	Filters applied when getting epic metadata in the epic board list.
`id`	`BoardsEpicListID!`	Global ID of the list.

`Query.geoNode`

Find a Geo node.

Returns GeoNode.

Arguments

Name	Type	Description
`name`	`String`	Name of the Geo node. Defaults to the current Geo node name.

`Query.gitpodEnabled`

Whether Gitpod is enabled in application settings.

Returns Boolean.

`Query.group`

Find a group.

Returns Group.

Arguments

Name	Type	Description
`fullPath`	`ID!`	Full path of the project, group, or namespace. For example, `gitlab-org/gitlab-foss`.

`Query.groups`

Find groups.

Returns GroupConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`search`	`String`	Search query for group name or group full path.

`Query.instanceExternalAuditEventDestinations`

Instance level external audit event destinations.

Returns InstanceExternalAuditEventDestinationConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

`Query.instanceSecurityDashboard`

Fields related to Instance Security Dashboard.

Returns InstanceSecurityDashboard.

`Query.issue`

Find an issue.

Returns Issue.

Arguments

Name	Type	Description
`id`	`IssueID!`	Global ID of the issue.

`Query.issues`

Find issues visible to the current user. At least one filter must be provided.

Introduced in 15.6. This feature is an Experiment. It can be changed or removed at any time.

Returns IssueConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`assigneeId`	`String`	ID of a user assigned to the issues. Wildcard values “NONE” and “ANY” are supported.
`assigneeUsername`	`String`	Deprecated in 13.11. Use `assigneeUsernames`.
`assigneeUsernames`	`[String!]`	Usernames of users assigned to the issue.
`authorUsername`	`String`	Username of the author of the issue.
`closedAfter`	`Time`	Issues closed after this date.
`closedBefore`	`Time`	Issues closed before this date.
`confidential`	`Boolean`	Filter for confidential issues. If “false”, excludes confidential issues. If “true”, returns only confidential issues.
`createdAfter`	`Time`	Issues created after this date.
`createdBefore`	`Time`	Issues created before this date.
`crmContactId`	`String`	ID of a contact assigned to the issues.
`crmOrganizationId`	`String`	ID of an organization assigned to the issues.
`epicId`	`String`	ID of an epic associated with the issues, “none” and “any” values are supported.
`healthStatusFilter`	`HealthStatusFilter`	Health status of the issue, “none” and “any” values are supported.
`iid`	`String`	IID of the issue. For example, “1”.
`iids`	`[String!]`	List of IIDs of issues. For example, `["1", "2"]`.
`in`	`[IssuableSearchableField!]`	Specify the fields to perform the search in. Defaults to `[TITLE, DESCRIPTION]`. Requires the `search` argument.’.
`includeArchived`	`Boolean`	Whether to include issues from archived projects. Defaults to `false`.
`includeSubepics`	`Boolean`	Whether to include subepics when filtering issues by epicId.
`iterationId`	`[ID]`	List of iteration Global IDs applied to the issue.
`iterationWildcardId`	`IterationWildcardId`	Filter by iteration ID wildcard.
`labelName`	`[String]`	Labels applied to this issue.
`milestoneTitle`	`[String]`	Milestone applied to this issue.
`milestoneWildcardId`	`MilestoneWildcardId`	Filter issues by milestone ID wildcard.
`myReactionEmoji`	`String`	Filter by reaction emoji applied by the current user. Wildcard values “NONE” and “ANY” are supported.
`not`	`NegatedIssueFilterInput`	Negated arguments.
`or`	`UnionedIssueFilterInput`	List of arguments with inclusive OR.
`search`	`String`	Search query for title or description.
`sort`	`IssueSort`	Sort issues by this criteria.
`state`	`IssuableState`	Current state of this issue.
`types`	`[IssueType!]`	Filter issues by the given issue types.
`updatedAfter`	`Time`	Issues updated after this date.
`updatedBefore`	`Time`	Issues updated before this date.
`weight`	`String`	Weight applied to the issue, “none” and “any” values are supported.

`Query.iteration`

Find an iteration.

Returns Iteration.

Arguments

Name	Type	Description
`id`	`IterationID!`	Find an iteration by its ID.

`Query.jobs`

All jobs on this GitLab instance.

Returns CiJobConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`statuses`	`[CiJobStatus!]`	Filter jobs by status.

`Query.licenseHistoryEntries`

Fields related to entries in the license history.

Returns LicenseHistoryEntryConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

`Query.mergeRequest`

Find a merge request.

Returns MergeRequest.

Arguments

Name	Type	Description
`id`	`MergeRequestID!`	Global ID of the merge request.

`Query.metadata`

Metadata about GitLab.

Returns Metadata.

`Query.milestone`

Find a milestone.

Returns Milestone.

Arguments

Name	Type	Description
`id`	`MilestoneID!`	Find a milestone by its ID.

`Query.namespace`

Find a namespace.

Returns Namespace.

Arguments

Name	Type	Description
`fullPath`	`ID!`	Full path of the project, group, or namespace. For example, `gitlab-org/gitlab-foss`.

`Query.note`

Find a note.

Introduced in 15.9. This feature is an Experiment. It can be changed or removed at any time.

Returns Note.

Arguments

Name	Type	Description
`id`	`NoteID!`	Global ID of the note.

`Query.package`

Find a package. This field can only be resolved for one query in any single request. Returns null if a package has no default status.

Returns PackageDetailsType.

Arguments

Name	Type	Description
`id`	`PackagesPackageID!`	Global ID of the package.

`Query.project`

Find a project.

Returns Project.

Arguments

Name	Type	Description
`fullPath`	`ID!`	Full path of the project, group, or namespace. For example, `gitlab-org/gitlab-foss`.

`Query.projects`

Find projects visible to the current user.

Returns ProjectConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`ids`	`[ID!]`	Filter projects by IDs.
`membership`	`Boolean`	Return only projects that the current user is a member of.
`search`	`String`	Search query, which can be for the project name, a path, or a description.
`searchNamespaces`	`Boolean`	Include namespace in project search.
`sort`	`String`	Sort order of results. Format: `<field_name>_<sort_direction>`, for example: `id_desc` or `name_asc`.
`topics`	`[String!]`	Filter projects by topics.
`withIssuesEnabled`	`Boolean`	Return only projects with issues enabled.
`withMergeRequestsEnabled`	`Boolean`	Return only projects with merge requests enabled.

`Query.queryComplexity`

Information about the complexity of the GraphQL query.

Returns QueryComplexity.

`Query.runner`

Find a runner.

Returns CiRunner.

Arguments

Name	Type	Description
`id`	`CiRunnerID!`	Runner ID.

`Query.runnerPlatforms`

Supported runner platforms.

Deprecated in 15.9. No longer used, use gitlab-runner documentation to learn about supported platforms.

Returns RunnerPlatformConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

`Query.runnerSetup`

Runner setup instructions.

Deprecated in 15.9. No longer used, use gitlab-runner documentation to learn about runner registration commands.

Returns RunnerSetup.

Arguments

Name	Type	Description
`architecture`	`String!`	Architecture to generate the instructions for.
`groupId`	`GroupID`	Deprecated in 13.11. No longer used.
`platform`	`String!`	Platform to generate the instructions for.
`projectId`	`ProjectID`	Deprecated in 13.11. No longer used.

`Query.runners`

Find runners visible to the current user.

Returns CiRunnerConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`active`	`Boolean`	Deprecated in 14.8. This was renamed. Use: `paused`.
`paused`	`Boolean`	Filter runners by `paused` (true) or `active` (false) status.
`search`	`String`	Filter by full token or partial text in description field.
`sort`	`CiRunnerSort`	Sort order of results.
`status`	`CiRunnerStatus`	Filter runners by status.
`tagList`	`[String!]`	Filter by tags associated with the runner (comma-separated or array).
`type`	`CiRunnerType`	Filter runners by type.
`upgradeStatus`	`CiRunnerUpgradeStatus`	Filter by upgrade status.

`Query.snippets`

Find Snippets visible to the current user.

Returns SnippetConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`authorId`	`UserID`	ID of an author.
`explore`	`Boolean`	Explore personal snippets.
`ids`	`[SnippetID!]`	Array of global snippet IDs. For example, `gid://gitlab/ProjectSnippet/1`.
`projectId`	`ProjectID`	ID of a project.
`type`	`TypeEnum`	Type of snippet.
`visibility`	`VisibilityScopesEnum`	Visibility of the snippet.

`Query.subscriptionFutureEntries`

Fields related to entries in future subscriptions.

Returns SubscriptionFutureEntryConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

`Query.syntheticNote`

Find a synthetic note.

Introduced in 15.9. This feature is an Experiment. It can be changed or removed at any time.

Returns Note.

Arguments

Name	Type	Description
`noteableId`	`NoteableID!`	Global ID of the resource to search synthetic note on.
`sha`	`String!`	Global ID of the note.

`Query.timelogs`

Find timelogs visible to the current user.

Returns TimelogConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`endDate`	`Time`	List timelogs within a date range where the logged date is equal to or before endDate.
`endTime`	`Time`	List timelogs within a time range where the logged time is equal to or before endTime.
`groupId`	`GroupID`	List timelogs for a group.
`projectId`	`ProjectID`	List timelogs for a project.
`sort`	`TimelogSort`	List timelogs in a particular order.
`startDate`	`Time`	List timelogs within a date range where the logged date is equal to or after startDate.
`startTime`	`Time`	List timelogs within a time range where the logged time is equal to or after startTime.
`username`	`String`	List timelogs for a user.

`Query.todo`

Retrieve a single to-do item.

Returns Todo.

Arguments

Name	Type	Description
`id`	`TodoID!`	ID of the to-do item.

`Query.topics`

Find project topics.

Returns TopicConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`search`	`String`	Search query for topic name.

`Query.usageTrendsMeasurements`

Get statistics on the instance.

Returns UsageTrendsMeasurementConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`identifier`	`MeasurementIdentifier!`	Type of measurement or statistics to retrieve.
`recordedAfter`	`Time`	Measurement recorded after this date.
`recordedBefore`	`Time`	Measurement recorded before this date.

`Query.user`

Find a user.

Returns UserCore.

Arguments

Name	Type	Description
`id`	`UserID`	ID of the User.
`username`	`String`	Username of the User.

`Query.users`

Find users.

Returns UserCoreConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`admins`	`Boolean`	Return only admin users.
`ids`	`[ID!]`	List of user Global IDs.
`search`	`String`	Query to search users by name, username, or primary email.
`sort`	`Sort`	Sort users by this criteria.
`usernames`	`[String!]`	List of usernames.

`Query.vulnerabilities`

Vulnerabilities reported on projects on the current user’s instance security dashboard.

Returns VulnerabilityConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`clusterAgentId`	`[ClustersAgentID!]`	Filter vulnerabilities by `cluster_agent_id`. Vulnerabilities with a `reportType` of `cluster_image_scanning` are only included with this filter.
`clusterId`	`[ClustersClusterID!]`	Filter vulnerabilities by `cluster_id`. Vulnerabilities with a `reportType` of `cluster_image_scanning` are only included with this filter.
`hasIssues`	`Boolean`	Returns only the vulnerabilities which have linked issues.
`hasResolution`	`Boolean`	Returns only the vulnerabilities which have been resolved on default branch.
`image`	`[String!]`	Filter vulnerabilities by location image. When this filter is present, the response only matches entries for a `reportType` that includes `container_scanning`, `cluster_image_scanning`.
`projectId`	`[ID!]`	Filter vulnerabilities by project.
`reportType`	`[VulnerabilityReportType!]`	Filter vulnerabilities by report type.
`scanner`	`[String!]`	Filter vulnerabilities by VulnerabilityScanner.externalId.
`scannerId`	`[VulnerabilitiesScannerID!]`	Filter vulnerabilities by scanner ID.
`severity`	`[VulnerabilitySeverity!]`	Filter vulnerabilities by severity.
`sort`	`VulnerabilitySort`	List vulnerabilities by sort order.
`state`	`[VulnerabilityState!]`	Filter vulnerabilities by state.

`Query.vulnerabilitiesCountByDay`

The historical number of vulnerabilities per day for the projects on the current user’s instance security dashboard.

Returns VulnerabilitiesCountByDayConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`endDate`	`ISO8601Date!`	Last day for which to fetch vulnerability history.
`startDate`	`ISO8601Date!`	First day for which to fetch vulnerability history.

`Query.vulnerability`

Find a vulnerability.

Returns Vulnerability.

Arguments

Name	Type	Description
`id`	`VulnerabilityID!`	Global ID of the Vulnerability.

`Query.workItem`

Find a work item.

Introduced in 15.1. This feature is an Experiment. It can be changed or removed at any time.

Returns WorkItem.

Arguments

Name	Type	Description
`id`	`WorkItemID!`	Global ID of the work item.

`Query.workspace`

Find a workspace.

Introduced in 16.0. This feature is an Experiment. It can be changed or removed at any time.

Returns Workspace.

Arguments

Name	Type	Description
`id`	`RemoteDevelopmentWorkspaceID!`	Find a workspace by its ID.

`Query.workspaces`

Find workspaces owned by the current user by their IDs.

Introduced in 16.0. This feature is an Experiment. It can be changed or removed at any time.

Returns WorkspaceConnection.

This field returns a connection. It accepts the four standard pagination arguments: before: String, after: String, first: Int, last: Int.

Arguments

Name	Type	Description
`ids`	`[RemoteDevelopmentWorkspaceID!]`	Array of global workspace IDs. For example, `["gid://gitlab/RemoteDevelopment::Workspace/1"]`.

`Mutation` type

The Mutation type contains all the mutations you can execute.

All mutations receive their arguments in a single input object named input, and all mutations support at least a return field errors containing a list of error messages.

All input objects may have a clientMutationId: String field, identifying the mutation.

For example:

mutation($id: NoteableID!, $body: String!) {
  createNote(input: { noteableId: $id, body: $body }) {
    errors
  }
}

`Mutation.achievementsAward`

Introduced in 15.10. This feature is an Experiment. It can be changed or removed at any time.

Input type: AchievementsAwardInput

Arguments

Name	Type	Description
`achievementId`	`AchievementsAchievementID!`	Global ID of the achievement being awarded.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`userId`	`UserID!`	Global ID of the user being awarded the achievement.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`userAchievement`	`UserAchievement`	Achievement award.

`Mutation.achievementsCreate`

Introduced in 15.8. This feature is an Experiment. It can be changed or removed at any time.

Input type: AchievementsCreateInput

Arguments

Name	Type	Description
`avatar`	`Upload`	Avatar for the achievement.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`description`	`String`	Description of or notes for the achievement.
`name`	`String!`	Name for the achievement.
`namespaceId`	`NamespaceID!`	Namespace for the achievement.

Fields

Name	Type	Description
`achievement`	`Achievement`	Achievement created.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.achievementsDelete`

Introduced in 15.11. This feature is an Experiment. It can be changed or removed at any time.

Input type: AchievementsDeleteInput

Arguments

Name	Type	Description
`achievementId`	`AchievementsAchievementID!`	Global ID of the achievement being deleted.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.

Fields

Name	Type	Description
`achievement`	`Achievement`	Achievement.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.achievementsRevoke`

Introduced in 15.10. This feature is an Experiment. It can be changed or removed at any time.

Input type: AchievementsRevokeInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`userAchievementId`	`AchievementsUserAchievementID!`	Global ID of the user achievement being revoked.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`userAchievement`	`UserAchievement`	Achievement award.

`Mutation.achievementsUpdate`

Introduced in 15.11. This feature is an Experiment. It can be changed or removed at any time.

Input type: AchievementsUpdateInput

Arguments

Name	Type	Description
`achievementId`	`AchievementsAchievementID!`	Global ID of the achievement being updated.
`avatar`	`Upload`	Avatar for the achievement.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`description`	`String`	Description of or notes for the achievement.
`name`	`String`	Name for the achievement.

Fields

Name	Type	Description
`achievement`	`Achievement`	Achievement.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.addProjectToSecurityDashboard`

Input type: AddProjectToSecurityDashboardInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`id`	`ProjectID!`	ID of the project to be added to Instance Security Dashboard.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`project`	`Project`	Project that was added to the Instance Security Dashboard.

`Mutation.adminSidekiqQueuesDeleteJobs`

Input type: AdminSidekiqQueuesDeleteJobsInput

Arguments

Name	Type	Description
`artifactSize`	`String`	Delete jobs matching artifact_size in the context metadata.
`artifactUsedCdn`	`String`	Delete jobs matching artifact_used_cdn in the context metadata.
`artifactsDependenciesCount`	`String`	Delete jobs matching artifacts_dependencies_count in the context metadata.
`artifactsDependenciesSize`	`String`	Delete jobs matching artifacts_dependencies_size in the context metadata.
`callerId`	`String`	Delete jobs matching caller_id in the context metadata.
`clientId`	`String`	Delete jobs matching client_id in the context metadata.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`featureCategory`	`String`	Delete jobs matching feature_category in the context metadata.
`jobId`	`String`	Delete jobs matching job_id in the context metadata.
`mergeActionStatus`	`String`	Delete jobs matching merge_action_status in the context metadata.
`pipelineId`	`String`	Delete jobs matching pipeline_id in the context metadata.
`project`	`String`	Delete jobs matching project in the context metadata.
`queueName`	`String!`	Name of the queue to delete jobs from.
`relatedClass`	`String`	Delete jobs matching related_class in the context metadata.
`remoteIp`	`String`	Delete jobs matching remote_ip in the context metadata.
`rootCallerId`	`String`	Delete jobs matching root_caller_id in the context metadata.
`rootNamespace`	`String`	Delete jobs matching root_namespace in the context metadata.
`subscriptionPlan`	`String`	Delete jobs matching subscription_plan in the context metadata.
`user`	`String`	Delete jobs matching user in the context metadata.
`userId`	`String`	Delete jobs matching user_id in the context metadata.
`workerClass`	`String`	Delete jobs with the given worker class.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`result`	`DeleteJobsResponse`	Information about the status of the deletion request.

`Mutation.aiAction`

Introduced in 15.11. This feature is an Experiment. It can be changed or removed at any time.

Input type: AiActionInput

Arguments

Name	Type	Description
`analyzeCiJobFailure`	`AnalyzeCiJobFailureInput`	Input for analyze_ci_job_failure AI action.
`chat`	`AiChatInput`	Input for chat AI action.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`explainCode`	`AiExplainCodeInput`	Input for explain_code AI action.
`explainVulnerability`	`AiExplainVulnerabilityInput`	Input for explain_vulnerability AI action.
`fillInMergeRequestTemplate`	`AiFillInMergeRequestTemplateInput`	Input for fill_in_merge_request_template AI action.
`generateCommitMessage`	`AiGenerateCommitMessageInput`	Input for generate_commit_message AI action.
`generateDescription`	`AiGenerateDescriptionInput`	Input for generate_description AI action.
`generateTestFile`	`GenerateTestFileInput`	Input for generate_test_file AI action.
`markupFormat`	`MarkupFormat`	Indicates the response format.
`summarizeComments`	`AiSummarizeCommentsInput`	Input for summarize_comments AI action.
`summarizeReview`	`AiSummarizeReviewInput`	Input for summarize_review AI action.
`tanukiBot`	`AiTanukiBotInput`	Input for tanuki_bot AI action.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`requestId`	`String`	ID of the request.

`Mutation.alertSetAssignees`

Input type: AlertSetAssigneesInput

Arguments

Name	Type	Description
`assigneeUsernames`	`[String!]!`	Usernames to assign to the alert. Replaces existing assignees by default.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`iid`	`String!`	IID of the alert to mutate.
`operationMode`	`MutationOperationMode`	Operation to perform. Defaults to REPLACE.
`projectPath`	`ID!`	Project the alert to mutate is in.

Fields

Name	Type	Description
`alert`	`AlertManagementAlert`	Alert after mutation.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`issue`	`Issue`	Issue created after mutation.
`todo`	`Todo`	To-do item after mutation.

`Mutation.alertTodoCreate`

Input type: AlertTodoCreateInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`iid`	`String!`	IID of the alert to mutate.
`projectPath`	`ID!`	Project the alert to mutate is in.

Fields

Name	Type	Description
`alert`	`AlertManagementAlert`	Alert after mutation.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`issue`	`Issue`	Issue created after mutation.
`todo`	`Todo`	To-do item after mutation.

`Mutation.approveDeployment`

Input type: ApproveDeploymentInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`comment`	`String`	Comment to go with the approval.
`id`	`DeploymentID!`	ID of the deployment.
`representedAs`	`String`	Name of the User/Group/Role to use for the approval, when the user belongs to multiple approval rules.
`status`	`DeploymentsApprovalStatus!`	Status of the approval (either `APPROVED` or `REJECTED`).

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`deploymentApproval`	`DeploymentApproval!`	DeploymentApproval after mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.artifactDestroy`

Input type: ArtifactDestroyInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`id`	`CiJobArtifactID!`	ID of the artifact to delete.

Fields

Name	Type	Description
`artifact`	`CiJobArtifact`	Deleted artifact.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.auditEventsStreamingDestinationEventsAdd`

Input type: AuditEventsStreamingDestinationEventsAddInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`destinationId`	`AuditEventsExternalAuditEventDestinationID!`	Destination id.
`eventTypeFilters`	`[String!]!`	List of event type filters to add for streaming.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`eventTypeFilters`	`[String!]`	Event type filters present.

`Mutation.auditEventsStreamingDestinationEventsRemove`

Input type: AuditEventsStreamingDestinationEventsRemoveInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`destinationId`	`AuditEventsExternalAuditEventDestinationID!`	Destination URL.
`eventTypeFilters`	`[String!]!`	List of event type filters to remove from streaming.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.auditEventsStreamingHeadersCreate`

Input type: AuditEventsStreamingHeadersCreateInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`destinationId`	`AuditEventsExternalAuditEventDestinationID!`	Destination to associate header with.
`key`	`String!`	Header key.
`value`	`String!`	Header value.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`header`	`AuditEventStreamingHeader`	Created header.

`Mutation.auditEventsStreamingHeadersDestroy`

Input type: AuditEventsStreamingHeadersDestroyInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`headerId`	`AuditEventsStreamingHeaderID!`	Header to delete.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.auditEventsStreamingHeadersUpdate`

Input type: AuditEventsStreamingHeadersUpdateInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`headerId`	`AuditEventsStreamingHeaderID!`	Header to update.
`key`	`String!`	Header key.
`value`	`String!`	Header value.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`header`	`AuditEventStreamingHeader`	Updates header.

`Mutation.awardEmojiAdd`

Input type: AwardEmojiAddInput

Arguments

Name	Type	Description
`awardableId`	`AwardableID!`	Global ID of the awardable resource.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`name`	`String!`	Emoji name.

Fields

Name	Type	Description
`awardEmoji`	`AwardEmoji`	Award emoji after mutation.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.awardEmojiRemove`

Input type: AwardEmojiRemoveInput

Arguments

Name	Type	Description
`awardableId`	`AwardableID!`	Global ID of the awardable resource.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`name`	`String!`	Emoji name.

Fields

Name	Type	Description
`awardEmoji`	`AwardEmoji`	Award emoji after mutation.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.awardEmojiToggle`

Input type: AwardEmojiToggleInput

Arguments

Name	Type	Description
`awardableId`	`AwardableID!`	Global ID of the awardable resource.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`name`	`String!`	Emoji name.

Fields

Name	Type	Description
`awardEmoji`	`AwardEmoji`	Award emoji after mutation.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	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.

`Mutation.boardEpicCreate`

Input type: BoardEpicCreateInput

Arguments

Name	Type	Description
`boardId`	`BoardsEpicBoardID!`	Global ID of the board that the epic is in.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`groupPath`	`ID!`	Group the epic to create is in.
`listId`	`BoardsEpicListID!`	Global ID of the epic board list in which epic will be created.
`title`	`String!`	Title of the epic.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`epic`	`Epic`	Epic after creation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.boardListCreate`

Input type: BoardListCreateInput

Arguments

Name	Type	Description
`assigneeId`	`UserID`	Global ID of an existing user.
`backlog`	`Boolean`	Create the backlog list.
`boardId`	`BoardID!`	Global ID of the issue board to mutate.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`iterationId`	`IterationID`	Global ID of an existing iteration.
`labelId`	`LabelID`	Global ID of an existing label.
`milestoneId`	`MilestoneID`	Global ID of an existing milestone.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`list`	`BoardList`	Issue list in the issue board.

`Mutation.boardListUpdateLimitMetrics`

Input type: BoardListUpdateLimitMetricsInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`limitMetric`	`ListLimitMetric`	New limit metric type for the list.
`listId`	`ListID!`	Global ID of the list.
`maxIssueCount`	`Int`	New maximum issue count limit.
`maxIssueWeight`	`Int`	New maximum issue weight limit.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`list`	`BoardList`	Updated list.

`Mutation.buildForecast`

Introduced in 16.0. This feature is an Experiment. It can be changed or removed at any time.

Input type: BuildForecastInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`contextId`	`GlobalID!`	Global ID of the context for the forecast to pick an appropriate model.
`horizon`	`Int!`	Number of data points to forecast.
`type`	`String!`	Type of the forecast.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`forecast`	`Forecast!`	Created forecast.

`Mutation.bulkDestroyJobArtifacts`

Introduced in 15.10. This feature is an Experiment. It can be changed or removed at any time.

Input type: BulkDestroyJobArtifactsInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`ids`	`[CiJobArtifactID!]!`	Global IDs of the job artifacts to destroy.
`projectId`	`ProjectID!`	Global Project ID of the job artifacts to destroy. Incompatible with projectPath.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`destroyedCount`	`Int`	Number of job artifacts deleted.
`destroyedIds`	`[CiJobArtifactID!]`	IDs of job artifacts that were deleted.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.bulkEnableDevopsAdoptionNamespaces`

BETA This endpoint is subject to change without notice.

Input type: BulkEnableDevopsAdoptionNamespacesInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`displayNamespaceId`	`NamespaceID`	Display namespace ID.
`namespaceIds`	`[NamespaceID!]!`	List of Namespace IDs.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`enabledNamespaces`	`[DevopsAdoptionEnabledNamespace!]`	Enabled namespaces after mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.bulkRunnerDelete`

Introduced in 15.3. This feature is an Experiment. It can be changed or removed at any time.

Input type: BulkRunnerDeleteInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`ids`	`[CiRunnerID!]`	IDs of the runners to delete.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`deletedCount`	`Int`	Number of records effectively deleted. Only present if operation was performed synchronously.
`deletedIds`	`[CiRunnerID!]`	IDs of records effectively deleted. Only present if operation was performed synchronously.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.catalogResourcesCreate`

Introduced in 15.11. This feature is an Experiment. It can be changed or removed at any time.

Input type: CatalogResourcesCreateInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`projectPath`	`ID!`	Project to convert to a catalog resource.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.ciAiGenerateConfig`

Introduced in 16.0. This feature is an Experiment. It can be changed or removed at any time.

Input type: CiAiGenerateConfigInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`projectPath`	`ID!`	Project path for the project related to the open config editor.
`userContent`	`String!`	Content of the user message to be sent to the language model.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`userMessage`	`AiMessageType`	User chat message.

`Mutation.ciJobTokenScopeAddProject`

Input type: CiJobTokenScopeAddProjectInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`direction`	`CiJobTokenScopeDirection`	Deprecated: Outbound job token scope is being removed. This field can now only be set to INBOUND. Deprecated in 16.0.
`projectPath`	`ID!`	Project that the CI job token scope belongs to.
`targetProjectPath`	`ID!`	Project to be added to the CI job token scope.

Fields

Name	Type	Description
`ciJobTokenScope`	`CiJobTokenScopeType`	CI job token’s access scope.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.ciJobTokenScopeRemoveProject`

Input type: CiJobTokenScopeRemoveProjectInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`direction`	`CiJobTokenScopeDirection`	Direction of access, which defaults to outbound.
`projectPath`	`ID!`	Project that the CI job token scope belongs to.
`targetProjectPath`	`ID!`	Project to be removed from the CI job token scope.

Fields

Name	Type	Description
`ciJobTokenScope`	`CiJobTokenScopeType`	CI job token’s scope of access.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.clusterAgentDelete`

Input type: ClusterAgentDeleteInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`id`	`ClustersAgentID!`	Global ID of the cluster agent that will be deleted.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.clusterAgentTokenCreate`

Input type: ClusterAgentTokenCreateInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`clusterAgentId`	`ClustersAgentID!`	Global ID of the cluster agent that will be associated with the new token.
`description`	`String`	Description of the token.
`name`	`String!`	Name of the token.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`secret`	`String`	Token secret value. Make sure you save it - you won’t be able to access it again.
`token`	`ClusterAgentToken`	Token created after mutation.

`Mutation.clusterAgentTokenRevoke`

Input type: ClusterAgentTokenRevokeInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`id`	`ClustersAgentTokenID!`	Global ID of the agent token that will be revoked.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.commitCreate`

Input type: CommitCreateInput

Arguments

Name	Type	Description
`actions`	`[CommitAction!]!`	Array of action hashes to commit as a batch.
`branch`	`String!`	Name of the branch to commit into, it can be a new branch.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`message`	`String!`	Raw commit message.
`projectPath`	`ID!`	Project full path the branch is associated with.
`startBranch`	`String`	If on a new branch, name of the original branch.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`commit`	`Commit`	Commit after mutation.
`commitPipelinePath`	`String`	ETag path for the commit’s pipeline.
`content`	`[String!]`	Contents of the commit.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.configureContainerScanning`

Configure Container Scanning for a project by enabling Container Scanning in a new or modified .gitlab-ci.yml file in a new branch. The new branch and a URL to create a merge request are part of the response.

Input type: ConfigureContainerScanningInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`projectPath`	`ID!`	Full path of the project.

Fields

Name	Type	Description
`branch`	`String`	Branch that has the new/modified `.gitlab-ci.yml` file.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`successPath`	`String`	Redirect path to use when the response is successful.

`Mutation.configureDependencyScanning`

Configure Dependency Scanning for a project by enabling Dependency Scanning in a new or modified .gitlab-ci.yml file in a new branch. The new branch and a URL to create a Merge Request are a part of the response.

Input type: ConfigureDependencyScanningInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`projectPath`	`ID!`	Full path of the project.

Fields

Name	Type	Description
`branch`	`String`	Branch that has the new/modified `.gitlab-ci.yml` file.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`successPath`	`String`	Redirect path to use when the response is successful.

`Mutation.configureSast`

Configure SAST for a project by enabling SAST in a new or modified .gitlab-ci.yml file in a new branch. The new branch and a URL to create a Merge Request are a part of the response.

Input type: ConfigureSastInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`configuration`	`SastCiConfigurationInput!`	SAST CI configuration for the project.
`projectPath`	`ID!`	Full path of the project.

Fields

Name	Type	Description
`branch`	`String`	Branch that has the new/modified `.gitlab-ci.yml` file.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`successPath`	`String`	Redirect path to use when the response is successful.

`Mutation.configureSastIac`

Enable SAST IaC for a project in a new or modified .gitlab-ci.yml file in a new branch. The new branch and a URL to create a merge request are a part of the response.

Input type: ConfigureSastIacInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`projectPath`	`ID!`	Full path of the project.

Fields

Name	Type	Description
`branch`	`String`	Branch that has the new/modified `.gitlab-ci.yml` file.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`successPath`	`String`	Redirect path to use when the response is successful.

`Mutation.configureSecretDetection`

Configure Secret Detection for a project by enabling Secret Detection in a new or modified .gitlab-ci.yml file in a new branch. The new branch and a URL to create a Merge Request are a part of the response.

Input type: ConfigureSecretDetectionInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`projectPath`	`ID!`	Full path of the project.

Fields

Name	Type	Description
`branch`	`String`	Branch that has the new/modified `.gitlab-ci.yml` file.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`successPath`	`String`	Redirect path to use when the response is successful.

`Mutation.corpusCreate`

Input type: CorpusCreateInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`fullPath`	`ID!`	Project the corpus belongs to.
`packageId`	`PackagesPackageID!`	ID of the corpus package.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.createAlertIssue`

Input type: CreateAlertIssueInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`iid`	`String!`	IID of the alert to mutate.
`projectPath`	`ID!`	Project the alert to mutate is in.

Fields

Name	Type	Description
`alert`	`AlertManagementAlert`	Alert after mutation.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`issue`	`Issue`	Issue created after mutation.
`todo`	`Todo`	To-do item after mutation.

`Mutation.createAnnotation`

Deprecated in 16.0. Underlying feature was removed in 16.0.

Input type: CreateAnnotationInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`clusterId`	`ClustersClusterID`	Global ID of the cluster to add an annotation to.
`dashboardPath`	`String!`	Path to a file defining the dashboard on which the annotation should be added.
`description`	`String!`	Description of the annotation.
`endingAt`	`Time`	Timestamp indicating ending moment to which the annotation relates.
`environmentId`	`EnvironmentID`	Global ID of the environment to add an annotation to.
`startingAt`	`Time!`	Timestamp indicating starting moment to which the annotation relates.

Fields

Name	Type	Description
`annotation`	`MetricsDashboardAnnotation`	Created annotation.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.createBoard`

Input type: CreateBoardInput

Arguments

Name	Type	Description
`assigneeId`	`UserID`	ID of user to be assigned to the board.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`groupPath`	`ID`	Full path of the group with which the resource is associated.
`hideBacklogList`	`Boolean`	Whether or not backlog list is hidden.
`hideClosedList`	`Boolean`	Whether or not closed list is hidden.
`iterationCadenceId`	`IterationsCadenceID`	ID of iteration cadence to be assigned to the board.
`iterationId`	`IterationID`	ID of iteration to be assigned to the board.
`labelIds`	`[LabelID!]`	IDs of labels to be added to the board.
`labels`	`[String!]`	Labels of the issue.
`milestoneId`	`MilestoneID`	ID of milestone to be assigned to the board.
`name`	`String`	Board name.
`projectPath`	`ID`	Full path of the project with which the resource is associated.
`weight`	`Int`	Weight value to be assigned to the board.

Fields

Name	Type	Description
`board`	`Board`	Board after mutation.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.createBranch`

Input type: CreateBranchInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`name`	`String!`	Name of the branch.
`projectPath`	`ID!`	Project full path the branch is associated with.
`ref`	`String!`	Branch name or commit SHA to create branch from.

Fields

Name	Type	Description
`branch`	`Branch`	Branch after mutation.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.createClusterAgent`

Input type: CreateClusterAgentInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`name`	`String!`	Name of the cluster agent.
`projectPath`	`ID!`	Full path of the associated project for the cluster agent.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`clusterAgent`	`ClusterAgent`	Cluster agent created after mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.createComplianceFramework`

Input type: CreateComplianceFrameworkInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`namespacePath`	`ID!`	Full path of the namespace to add the compliance framework to.
`params`	`ComplianceFrameworkInput!`	Parameters to update the compliance framework with.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`framework`	`ComplianceFramework`	Created compliance framework.

`Mutation.createCustomEmoji`

Introduced in 13.6. This feature is an Experiment. It can be changed or removed at any time.

Input type: CreateCustomEmojiInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`groupPath`	`ID!`	Namespace full path the emoji is associated with.
`name`	`String!`	Name of the emoji.
`url`	`String!`	Location of the emoji file.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`customEmoji`	`CustomEmoji`	New custom emoji.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.createDiffNote`

Input type: CreateDiffNoteInput

Arguments

Name	Type	Description
`body`	`String!`	Content of the note.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`confidential`	`Boolean`	Deprecated: This was renamed. Please use `internal`. Deprecated in 15.3.
`internal`	`Boolean`	Internal flag for a note. Default is false.
`noteableId`	`NoteableID!`	Global ID of the resource to add a note to.
`position`	`DiffPositionInput!`	Position of this note on a diff.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`note`	`Note`	Note after mutation.

`Mutation.createEpic`

Input type: CreateEpicInput

Arguments

Name	Type	Description
`addLabelIds`	`[ID!]`	IDs of labels to be added to the epic.
`addLabels`	`[String!]`	Array of labels to be added to the epic.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`color`	`Color`	Color of the epic. Available only when feature flag `epic_color_highlight` is enabled. This flag is disabled by default, because the feature is experimental and is subject to change without notice.
`confidential`	`Boolean`	Indicates if the epic is confidential.
`description`	`String`	Description of the epic.
`dueDateFixed`	`String`	End date of the epic.
`dueDateIsFixed`	`Boolean`	Indicates end date should be sourced from due_date_fixed field not the issue milestones.
`groupPath`	`ID!`	Group the epic to mutate is in.
`removeLabelIds`	`[ID!]`	IDs of labels to be removed from the epic.
`startDateFixed`	`String`	Start date of the epic.
`startDateIsFixed`	`Boolean`	Indicates start date should be sourced from start_date_fixed field not the issue milestones.
`title`	`String`	Title of the epic.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`epic`	`Epic`	Created epic.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.createImageDiffNote`

Input type: CreateImageDiffNoteInput

Arguments

Name	Type	Description
`body`	`String!`	Content of the note.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`confidential`	`Boolean`	Deprecated: This was renamed. Please use `internal`. Deprecated in 15.3.
`internal`	`Boolean`	Internal flag for a note. Default is false.
`noteableId`	`NoteableID!`	Global ID of the resource to add a note to.
`position`	`DiffImagePositionInput!`	Position of this note on a diff.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`note`	`Note`	Note after mutation.

`Mutation.createIssue`

Input type: CreateIssueInput

Arguments

Name	Type	Description
`assigneeIds`	`[UserID!]`	Array of user IDs to assign to the issue.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`confidential`	`Boolean`	Indicates the issue is confidential.
`createdAt`	`Time`	Timestamp when the issue was created. Available only for admins and project owners.
`description`	`String`	Description of the issue.
`discussionToResolve`	`String`	ID of a discussion to resolve. Also pass `merge_request_to_resolve_discussions_of`.
`dueDate`	`ISO8601Date`	Due date of the issue.
`epicId`	`EpicID`	ID of an epic to associate the issue with.
`healthStatus`	`HealthStatus`	Desired health status.
`iid`	`Int`	IID (internal ID) of a project issue. Only admins and project owners can modify.
`iterationCadenceId`	`IterationsCadenceID`	Global iteration cadence ID. Required when `iterationWildcardId` is provided.
`iterationId`	`IterationID`	Global iteration ID. Mutually exlusive argument with `iterationWildcardId`.
`iterationWildcardId`	`IssueCreationIterationWildcardId`	Iteration wildcard ID. Supported values are: `CURRENT`. Mutually exclusive argument with `iterationId`. iterationCadenceId also required when this argument is provided.
`labelIds`	`[LabelID!]`	IDs of labels to be added to the issue.
`labels`	`[String!]`	Labels of the issue.
`locked`	`Boolean`	Indicates discussion is locked on the issue.
`mergeRequestToResolveDiscussionsOf`	`MergeRequestID`	IID of a merge request for which to resolve discussions.
`milestoneId`	`MilestoneID`	ID of the milestone to assign to the issue. On update milestone will be removed if set to null.
`moveAfterId`	`IssueID`	Global ID of issue that should be placed after the current issue.
`moveBeforeId`	`IssueID`	Global ID of issue that should be placed before the current issue.
`projectPath`	`ID!`	Project full path the issue is associated with.
`title`	`String!`	Title of the issue.
`type`	`IssueType`	Type of the issue.
`weight`	`Int`	Weight of the issue.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`issue`	`Issue`	Issue after mutation.

`Mutation.createIteration`

Deprecated in 14.0. Use iterationCreate.

Input type: CreateIterationInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`description`	`String`	Description of the iteration.
`dueDate`	`String`	End date of the iteration.
`groupPath`	`ID`	Full path of the group with which the resource is associated.
`iterationsCadenceId`	`IterationsCadenceID`	Global ID of the iteration cadence to be assigned to the new iteration.
`projectPath`	`ID`	Full path of the project with which the resource is associated.
`startDate`	`String`	Start date of the iteration.
`title`	`String`	Title of the iteration.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`iteration`	`Iteration`	Created iteration.

`Mutation.createNote`

Creates a Note. If the body of the Note contains only quick actions, the Note will be destroyed during an update, and no Note will be returned.

Input type: CreateNoteInput

Arguments

Name	Type	Description
`body`	`String!`	Content of the note.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`confidential`	`Boolean`	Deprecated: This was renamed. Please use `internal`. Deprecated in 15.3.
`discussionId`	`DiscussionID`	Global ID of the discussion the note is in reply to.
`internal`	`Boolean`	Internal flag for a note. Default is false.
`mergeRequestDiffHeadSha`	`String`	SHA of the head commit which is used to ensure that the merge request has not been updated since the request was sent.
`noteableId`	`NoteableID!`	Global ID of the resource to add a note to.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`note`	`Note`	Note after mutation.

`Mutation.createRequirement`

Input type: CreateRequirementInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`description`	`String`	Description of the requirement.
`projectPath`	`ID!`	Full project path the requirement is associated with.
`title`	`String`	Title of the requirement.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`requirement`	`Requirement`	Requirement after mutation.

`Mutation.createSnippet`

Input type: CreateSnippetInput

Arguments

Name	Type	Description
`blobActions`	`[SnippetBlobActionInputType!]`	Actions to perform over the snippet repository and blobs.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`description`	`String`	Description of the snippet.
`projectPath`	`ID`	Full path of the project the snippet is associated with.
`title`	`String!`	Title of the snippet.
`uploadedFiles`	`[String!]`	Paths to files uploaded in the snippet description.
`visibilityLevel`	`VisibilityLevelsEnum!`	Visibility level of the snippet.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`snippet`	`Snippet`	Snippet after mutation.

`Mutation.createTestCase`

Input type: CreateTestCaseInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`description`	`String`	Test case description.
`labelIds`	`[ID!]`	IDs of labels to be added to the test case.
`projectPath`	`ID!`	Project full path to create the test case in.
`title`	`String!`	Test case title.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.
`testCase`	`Issue`	Test case created.

`Mutation.customerRelationsContactCreate`

Input type: CustomerRelationsContactCreateInput

Arguments

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`description`	`String`	Description of or notes for the contact.
`email`	`String`	Email address of the contact.
`firstName`	`String!`	First name of the contact.
`groupId`	`GroupID!`	Group for the contact.
`lastName`	`String!`	Last name of the contact.
`organizationId`	`CustomerRelationsOrganizationID`	Organization for the contact.
`phone`	`String`	Phone number of the contact.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`contact`	`CustomerRelationsContact`	Contact after the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

`Mutation.customerRelationsContactUpdate`

Input type: CustomerRelationsContactUpdateInput

Arguments

Name	Type	Description
`active`	`Boolean`	State of the contact.
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`description`	`String`	Description of or notes for the contact.
`email`	`String`	Email address of the contact.
`firstName`	`String`	First name of the contact.
`id`	`CustomerRelationsContactID!`	Global ID of the contact.
`lastName`	`String`	Last name of the contact.
`organizationId`	`CustomerRelationsOrganizationID`	Organization of the contact.
`phone`	`String`	Phone number of the contact.

Fields

Name	Type	Description
`clientMutationId`	`String`	A unique identifier for the client performing the mutation.
`contact`	`CustomerRelationsContact`	Contact after the mutation.
`errors`	`[String!]!`	Errors encountered during execution of the mutation.

GraphQL API Resources

Query type

Query.aiMessages

Arguments

Query.auditEventDefinitions

Query.boardList

Arguments

Query.ciApplicationSettings

Query.ciCatalogResource

Arguments

Query.ciCatalogResources

Arguments

Query.ciConfig

Arguments

Query.ciMinutesUsage

Arguments

Query.ciPipelineStage

Arguments

Query.ciVariables

Arguments

Query.containerRepository

Arguments

Query.currentLicense

Query.currentUser

Query.designManagement

Query.devopsAdoptionEnabledNamespaces

Arguments

Query.echo

Arguments

Query.epicBoardList

Arguments

Query.geoNode

Arguments

Query.gitpodEnabled

Query.group

Arguments

Query.groups

Arguments

Query.instanceExternalAuditEventDestinations

Query.instanceSecurityDashboard

Query.issue

Arguments

Query.issues

Arguments

Query.iteration

Arguments

Query.jobs

Arguments

Query.licenseHistoryEntries

Query.mergeRequest

Arguments

Query.metadata

Query.milestone

Arguments

Query.namespace

Arguments

Query.note

Arguments

Query.package

Arguments

Query.project

Arguments

Query.projects

Arguments

Query.queryComplexity

Query.runner

Arguments

Query.runnerPlatforms

Query.runnerSetup

Arguments

Query.runners

Arguments

Query.snippets

Arguments

Query.subscriptionFutureEntries

Query.syntheticNote

Arguments

Query.timelogs

Arguments

Query.todo

`Query` type

`Query.aiMessages`

`Query.auditEventDefinitions`

`Query.boardList`

`Query.ciApplicationSettings`

`Query.ciCatalogResource`

`Query.ciCatalogResources`

`Query.ciConfig`

`Query.ciMinutesUsage`

`Query.ciPipelineStage`

`Query.ciVariables`

`Query.containerRepository`

`Query.currentLicense`

`Query.currentUser`

`Query.designManagement`

`Query.devopsAdoptionEnabledNamespaces`

`Query.echo`

`Query.epicBoardList`

`Query.geoNode`

`Query.gitpodEnabled`

`Query.group`

`Query.groups`

`Query.instanceExternalAuditEventDestinations`

`Query.instanceSecurityDashboard`

`Query.issue`

`Query.issues`

`Query.iteration`

`Query.jobs`

`Query.licenseHistoryEntries`

`Query.mergeRequest`

`Query.metadata`

`Query.milestone`

`Query.namespace`

`Query.note`

`Query.package`

`Query.project`

`Query.projects`

`Query.queryComplexity`

`Query.runner`

`Query.runnerPlatforms`

`Query.runnerSetup`

`Query.runners`

`Query.snippets`

`Query.subscriptionFutureEntries`

`Query.syntheticNote`

`Query.timelogs`

`Query.todo`

`Query.topics`

`Query.usageTrendsMeasurements`

`Query.user`

`Query.users`

`Query.vulnerabilities`

`Query.vulnerabilitiesCountByDay`

`Query.vulnerability`

`Query.workItem`

`Query.workspace`

`Query.workspaces`

`Mutation` type

`Mutation.achievementsAward`

`Mutation.achievementsCreate`

`Mutation.achievementsDelete`

`Mutation.achievementsRevoke`

`Mutation.achievementsUpdate`

`Mutation.addProjectToSecurityDashboard`

`Mutation.adminSidekiqQueuesDeleteJobs`

`Mutation.aiAction`

`Mutation.alertSetAssignees`

`Mutation.alertTodoCreate`

`Mutation.approveDeployment`

`Mutation.artifactDestroy`

`Mutation.auditEventsStreamingDestinationEventsAdd`

`Mutation.auditEventsStreamingDestinationEventsRemove`

`Mutation.auditEventsStreamingHeadersCreate`

`Mutation.auditEventsStreamingHeadersDestroy`