正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。
ドキュメントに関する現在のご利用体験についてお聞かせください。アンケートにご協力ください

GraphQL API Input types

Input types are structured arguments passed to queries, mutations, and other fields. For more information, see the GraphQL input types documentation.

WARNING: Deprecated items are marked with warning . They will be removed in a future release according to the GitLab deprecation process. Items that are experiments are marked with work-item-test-case . Experimental items can change at any time and are not recommended for use in production.

AchievementsAwardInput

Autogenerated input type of AchievementsAward.

Arguments

NameTypeDescription
achievementIdAchievementsAchievementID!Global ID of the achievement being awarded.
awardMessageStringMessage to associate with the awarded achievement.
clientMutationIdStringA unique identifier for the client performing the mutation.
userIdUserID!Global ID of the user being awarded the achievement.

AchievementsCreateInput

Autogenerated input type of AchievementsCreate.

Arguments

NameTypeDescription
avatarUploadAvatar for the achievement.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of or notes for the achievement.
nameString!Name for the achievement.
namespaceIdNamespaceID!Namespace for the achievement.

AchievementsDeleteInput

Autogenerated input type of AchievementsDelete.

Arguments

NameTypeDescription
achievementIdAchievementsAchievementID!Global ID of the achievement being deleted.
clientMutationIdStringA unique identifier for the client performing the mutation.

AchievementsRevokeInput

Autogenerated input type of AchievementsRevoke.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
userAchievementIdAchievementsUserAchievementID!Global ID of the user achievement being revoked.

AchievementsUpdateInput

Autogenerated input type of AchievementsUpdate.

Arguments

NameTypeDescription
achievementIdAchievementsAchievementID!Global ID of the achievement being updated.
avatarUploadAvatar for the achievement.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of or notes for the achievement.
nameStringName for the achievement.

AddProjectToSecurityDashboardInput

Autogenerated input type of AddProjectToSecurityDashboard.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idProjectID!ID of the project to be added to Instance Security Dashboard.

AdminClearDuoAvailabilityInput

Autogenerated input type of AdminClearDuoAvailability.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupIdGroupID!Group to clear the GitLab Duo availability override from.

AdminRolesLdapSyncInput

Autogenerated input type of AdminRolesLdapSync.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.

AdminSetDuoAvailabilityInput

Autogenerated input type of AdminSetDuoAvailability.

Arguments

NameTypeDescriptionDefault
availabilityDuoAvailability!GitLab Duo availability state to lock on the group.
clearDescendantsBooleanClear conflicting admin-locked overrides on descendant groups instead of rejecting.false
clientMutationIdStringA unique identifier for the client performing the mutation.
groupIdGroupID!Group to set the GitLab Duo availability override on.

AdminSidekiqQueuesDeleteJobsInput

Autogenerated input type of AdminSidekiqQueuesDeleteJobs.

Arguments

NameTypeDescription
aiResourceStringDelete jobs matching ai_resource in the context metadata.
artifactSizeStringDelete jobs matching artifact_size in the context metadata.
artifactUsedCdnStringDelete jobs matching artifact_used_cdn in the context metadata.
artifactsDependenciesCountStringDelete jobs matching artifacts_dependencies_count in the context metadata.
artifactsDependenciesSizeStringDelete jobs matching artifacts_dependencies_size in the context metadata.
bulkImportEntityIdStringDelete jobs matching bulk_import_entity_id in the context metadata.
callerIdStringDelete jobs matching caller_id in the context metadata.
clientIdStringDelete jobs matching client_id in the context metadata.
clientMutationIdStringA unique identifier for the client performing the mutation.
featureCategoryStringDelete jobs matching feature_category in the context metadata.
glRootNamespaceIdStringDelete jobs matching gl_root_namespace_id in the context metadata.
glUserIdStringDelete jobs matching gl_user_id in the context metadata.
jobIdStringDelete jobs matching job_id in the context metadata.
kubernetesAgentIdStringDelete jobs matching kubernetes_agent_id in the context metadata.
mergeActionStatusStringDelete jobs matching merge_action_status in the context metadata.
mvccManifestStringDelete jobs matching mvcc_manifest in the context metadata.
organizationIdStringDelete jobs matching organization_id in the context metadata.
pipelineIdStringDelete jobs matching pipeline_id in the context metadata.
projectStringDelete jobs matching project in the context metadata.
queueNameString!Name of the queue to delete jobs from.
relatedClassStringDelete jobs matching related_class in the context metadata.
remoteIpStringDelete jobs matching remote_ip in the context metadata.
rootCallerIdStringDelete jobs matching root_caller_id in the context metadata.
rootNamespaceStringDelete jobs matching root_namespace in the context metadata.
scopedUserStringDelete jobs matching scoped_user in the context metadata.
scopedUserIdStringDelete jobs matching scoped_user_id in the context metadata.
sidekiqDestinationShardRedisStringDelete jobs matching sidekiq_destination_shard_redis in the context metadata.
subscriptionPlanStringDelete jobs matching subscription_plan in the context metadata.
userStringDelete jobs matching user in the context metadata.
userIdStringDelete jobs matching user_id in the context metadata.
workerClassStringDelete jobs with the given worker class.

AgentPlatformMetricsNotInput

Arguments

NameTypeDescription
flowTypes[String!]List of flow types to exclude.

AggregationOrder

Arguments

NameTypeDescription
directionSortDirectionEnum!Sorting direction.
identifierString!Dimension or metric identifier.
parametersJSONParameters for parameterized dimensions.

AggregationScopeInput

Arguments

NameTypeDescription
groupFullPaths[ID!]Full paths of groups to aggregate data for. Combined with projectFullPaths, at most 20 sources can be requested.
projectFullPaths[ID!]Full paths of projects to aggregate data for. Combined with groupFullPaths, at most 20 sources can be requested.

AiActionInput

Autogenerated input type of AiAction.

Arguments

NameTypeDescription
agenticChatAiAgenticChatInputInput for agentic_chat AI action.
chatAiChatInputInput for chat AI action.
clientMutationIdStringA unique identifier for the client performing the mutation.
clientSubscriptionIdStringClient generated ID that can be subscribed to, to receive a response for the mutation.
conversationTypeAiConversationsThreadsConversationTypeConversation type of the thread.
explainVulnerabilityAiExplainVulnerabilityInputInput for explain_vulnerability AI action.
generateCommitMessageAiGenerateCommitMessageInputInput for generate_commit_message AI action.
generateDescriptionAiGenerateDescriptionInputInput for generate_description AI action.
measureCommentTemperatureAiMeasureCommentTemperatureInputInput for measure_comment_temperature AI action.
platformOriginStringSpecifies the origin platform of the request.
projectIdProjectIDGlobal ID of the project the user is acting on.
resolveVulnerabilityAiResolveVulnerabilityInputInput for resolve_vulnerability AI action.
rootNamespaceIdNamespaceIDGlobal ID of the top-level namespace the user is acting on.
summarizeNewMergeRequestAiSummarizeNewMergeRequestInputInput for summarize_new_merge_request AI action.
summarizeReviewAiSummarizeReviewInputInput for summarize_review AI action.
threadIdAiConversationThreadIDGlobal Id of the existing thread to continue the conversation. If it is not specified, a new thread will be created for the specified conversation_type.

AiAdditionalContextInput

Arguments

NameTypeDescription
categoryAiAdditionalContextCategory!Category of the additional context.
contentString!Content of the additional context.
idString!ID of the additional context.
metadataJSONMetadata of the additional context.

AiAgenticChatInput

Arguments

NameTypeDescription
additionalContext[AiAdditionalContextInput!]Additional context to be passed for the chat.
contentString!Content of the message.
currentFileAiCurrentFileInputInformation about currently selected text which can be passed for additional context.
namespaceIdNamespaceIDGlobal ID of the namespace the user is acting on.
resourceIdAiModelID!Global ID of the resource to mutate.

AiCatalogAgentCreateInput

Autogenerated input type of AiCatalogAgentCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionString!Description for the agent.
mcpServers[AiCatalogMcpServerID!]Status: Experiment. Introduced in GitLab 18.10.

MCP servers to associate with the agent.
mcpTools[String!]Status: Experiment. Introduced in GitLab 18.11.

List of MCP tools enabled for the agent.
nameString!Name for the agent.
projectIdProjectID!Project for the agent.
publicBooleanDeprecated in GitLab 19.2. Use visibility.
releaseBooleanWhether to release the latest version of the agent.
systemPromptString!System prompt for the agent.
tools[AiCatalogBuiltInToolID!]List of GitLab built-in tools enabled for the agent.
userPromptStringUser prompt for the agent.
visibilityAiCatalogItemVisibilityStatus: Experiment. Introduced in GitLab 19.2.

Visibility of the agent in the catalog.

AiCatalogAgentDeleteInput

Autogenerated input type of AiCatalogAgentDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
forceHardDeleteBooleanWhen true, the flow will always be hard deleted and never soft deleted. Can only be used by instance admins.
idAiCatalogItemID!Global ID of the catalog Agent to delete.

AiCatalogAgentUpdateInput

Autogenerated input type of AiCatalogAgentUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription for the agent.
idAiCatalogItemID!Global ID of the catalog Agent to update.
mcpServers[AiCatalogMcpServerID!]Status: Experiment. Introduced in GitLab 18.10.

MCP servers to associate with the agent.
mcpTools[String!]Status: Experiment. Introduced in GitLab 18.11.

List of MCP tools enabled for the agent.
nameStringName for the agent.
publicBooleanDeprecated in GitLab 19.2. Use visibility.
releaseBooleanWhether to release the latest version of the agent.
systemPromptStringSystem prompt for the agent.
tools[AiCatalogBuiltInToolID!]List of GitLab built-in tools enabled for the agent.
userPromptStringUser prompt for the agent.
versionBumpAiCatalogVersionBumpBump version, calculated from the last released version name.
visibilityAiCatalogItemVisibilityStatus: Experiment. Introduced in GitLab 19.2.

Visibility of the agent in the catalog.

AiCatalogFlowCreateInput

Autogenerated input type of AiCatalogFlowCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
definitionStringYAML definition for the flow.
descriptionString!Description for the flow.
nameString!Name for the flow.
projectIdProjectID!Project for the flow.
publicBooleanDeprecated in GitLab 19.2. Use visibility.
releaseBooleanWhether to release the latest version of the flow.
visibilityAiCatalogItemVisibilityStatus: Experiment. Introduced in GitLab 19.2.

Visibility of the flow in the catalog.

AiCatalogFlowDeleteInput

Autogenerated input type of AiCatalogFlowDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
forceHardDeleteBooleanWhen true, the flow will always be hard deleted and never soft deleted. Can only be used by instance admins.
idAiCatalogItemID!Global ID of the catalog flow to delete.

AiCatalogFlowUpdateInput

Autogenerated input type of AiCatalogFlowUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
definitionStringYAML definition for the Flow.
descriptionStringDescription for the flow.
idAiCatalogItemID!Global ID of the catalog flow to update.
nameStringName for the flow.
publicBooleanDeprecated in GitLab 19.2. Use visibility.
releaseBooleanWhether to release the latest version of the flow.
versionBumpAiCatalogVersionBumpBump version, calculated from the last released version name.
visibilityAiCatalogItemVisibilityStatus: Experiment. Introduced in GitLab 19.2.

Visibility of the flow in the catalog.

AiCatalogItemConsumerBulkCreateInput

Autogenerated input type of AiCatalogItemConsumerBulkCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
itemIdAiCatalogItemID!Global ID of the catalog item to enable.
pinnedVersionAiCatalogPinnedVersionVersion to pin the item to, in the format n.n.n. Must be a released version. Defaults to the latest released version. Ignored when enabling within the item’s managing project, which always tracks the latest released version.
projectIds[ProjectID!]!Global IDs of the projects to enable the catalog item in (maximum 100).
triggerConditionsAiCatalogTriggerConditionsInputStatus: Experiment. Introduced in GitLab 19.3.

Filter conditions for the auto-created AI Catalog triggers, keyed by event type.
triggerFilterJSONDeprecated in GitLab 19.3. Use triggerConditions.
triggerTypes[String!]List of event types to create AI Catalog triggers for.

AiCatalogItemConsumerCreateInput

Autogenerated input type of AiCatalogItemConsumerCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
itemIdAiCatalogItemID!Item to configure.
parentItemConsumerIdAiCatalogItemConsumerIDParent item consumer belonging to the top-level group.
pinnedVersionAiCatalogPinnedVersionVersion to pin the item to, in the format n.n.n. Must be a released version. Defaults to the latest released version. Ignored when enabling within the item’s managing project, which always tracks the latest released version.
targetItemConsumerTargetInput!Target project or top-level group in which the catalog item is configured.
triggerConditionsAiCatalogTriggerConditionsInputStatus: Experiment. Introduced in GitLab 19.3.

Filter conditions for the auto-created AI Catalog triggers, keyed by event type.
triggerFilterJSONDeprecated in GitLab 19.3. Use triggerConditions.
triggerTypes[String!]List of event types to create AI Catalog triggers for (values can be mention, assign or assign_reviewer).

AiCatalogItemConsumerDeleteInput

Autogenerated input type of AiCatalogItemConsumerDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAiCatalogItemConsumerID!Global ID of the catalog item consumer to delete.

AiCatalogItemConsumerUpdateInput

Autogenerated input type of AiCatalogItemConsumerUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAiCatalogItemConsumerID!Global ID of the catalog item consumer to update.
pinnedVersionAiCatalogPinnedVersionVersion the item is pinned to, in the format n.n.n.
pinnedVersionPrefixAiCatalogPinnedVersionDeprecated in GitLab 19.0. Use pinnedVersion instead.
serviceAccountIdUserIDService account to associate with the item consumer.
triggerTypes[String!]List of event types to create flow triggers for (values can be mention, assign or assign_reviewer).

AiCatalogItemReportInput

Autogenerated input type of AiCatalogItemReport.

Arguments

NameTypeDescription
bodyStringAdditional details about the report. Limited to 1000 characters.
clientMutationIdStringA unique identifier for the client performing the mutation.
idAiCatalogItemID!Global ID of the catalog item to report.
reasonAiCatalogItemReportReason!Reason for reporting the catalog item.

AiCatalogItemStarInput

Autogenerated input type of AiCatalogItemStar.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAiCatalogItemID!Global ID of the catalog item to star or unstar.
starredBoolean!Indicates whether to star or unstar the catalog item.

AiCatalogItemVersionRestoreInput

Autogenerated input type of AiCatalogItemVersionRestore.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
deprecateCurrentBooleanWhether to mark the current latest version as deprecated.false
idAiCatalogItemVersionID!Global ID of the item version to restore from.

AiCatalogMcpServerCreateInput

Autogenerated input type of AiCatalogMcpServerCreate.

Arguments

NameTypeDescription
authTypeAiCatalogMcpServerAuthType!Authentication type for the MCP server.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription for the MCP server.
homepageUrlStringHomepage URL for the MCP server.
nameString!Name for the MCP server.
oauthClientIdStringOAuth client ID for the MCP server.
oauthClientSecretStringOAuth client secret for the MCP server.
transportAiCatalogMcpServerTransport!Transport type for the MCP server.
urlString!URL for the MCP server.

AiCatalogMcpServerSetBlockInput

Autogenerated input type of AiCatalogMcpServerSetBlock.

Arguments

NameTypeDescription
blockedBoolean!Set to true to block the MCP server, false to allow it.
clientMutationIdStringA unique identifier for the client performing the mutation.
groupFullPathIDFull path of the group to block or allow the MCP server for. Provide exactly one of groupFullPath or projectFullPath.
idAiCatalogMcpServerID!Global ID of the MCP server.
projectFullPathIDFull path of the project to block or allow the MCP server for. Provide exactly one of groupFullPath or projectFullPath.

AiCatalogMcpServerUpdateInput

Autogenerated input type of AiCatalogMcpServerUpdate.

Arguments

NameTypeDescription
authTypeAiCatalogMcpServerAuthTypeAuthentication type for the MCP server.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription for the MCP server.
homepageUrlStringHomepage URL for the MCP server.
idAiCatalogMcpServerID!Global ID of the MCP server to update.
nameStringName for the MCP server.
oauthClientIdStringOAuth client ID for the MCP server.
oauthClientSecretStringOAuth client secret for the MCP server.
transportAiCatalogMcpServerTransportTransport type for the MCP server.
urlStringURL for the MCP server.

AiCatalogThirdPartyFlowCreateInput

Autogenerated input type of AiCatalogThirdPartyFlowCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
definitionString!YAML definition for the Flow.
descriptionString!Description for the Flow.
nameString!Name for the Flow.
projectIdProjectID!Project for the Flow.
publicBooleanDeprecated in GitLab 19.2. Use visibility.
releaseBooleanWhether to release the latest version of the Flow.
visibilityAiCatalogItemVisibilityStatus: Experiment. Introduced in GitLab 19.2.

Visibility of the Flow in the catalog.

AiCatalogThirdPartyFlowDeleteInput

Autogenerated input type of AiCatalogThirdPartyFlowDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
forceHardDeleteBooleanWhen true, the Third Party Flow will always be hard deleted and never soft deleted. Can only be used by instance admins.
idAiCatalogItemID!Global ID of the catalog Third Party Flow to delete.

AiCatalogThirdPartyFlowUpdateInput

Autogenerated input type of AiCatalogThirdPartyFlowUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
definitionStringYAML definition for the Flow.
descriptionStringDescription for the Flow.
idAiCatalogItemID!Global ID of the catalog Flow to update.
nameStringName for the Flow.
publicBooleanDeprecated in GitLab 19.2. Use visibility.
releaseBooleanWhether to release the latest version of the Flow.
versionBumpAiCatalogVersionBumpBump version, calculated from the last released version name.
visibilityAiCatalogItemVisibilityStatus: Experiment. Introduced in GitLab 19.2.

Visibility of the Flow in the catalog.

AiCatalogTriggerConditionsGroupInput

Group of rules for a set of trigger conditions.

Arguments

NameTypeDescription
matchAiCatalogTriggerConditionsMatchStrategy used to match the rules in the group.
rules[AiCatalogTriggerConditionsRuleItemInput!]!Rules in the group.

AiCatalogTriggerConditionsInput

Conditions for AI Catalog triggers.

Arguments

NameTypeDescription
assignAiCatalogTriggerConditionsGroupInputTrigger condition rules for the assign event.
assignReviewerAiCatalogTriggerConditionsGroupInputTrigger condition rules for the assign_reviewer event.
commitToDefaultBranchAiCatalogTriggerConditionsGroupInputTrigger condition rules for the commit_to_default_branch event.
mentionAiCatalogTriggerConditionsGroupInputTrigger condition rules for the mention event.
mergeRequestAiCatalogTriggerConditionsGroupInputTrigger condition rules for the merge_request event.
mergeRequestCodeConflictAiCatalogTriggerConditionsGroupInputTrigger condition rules for the merge_request_code_conflict event.
mergeRequestReadyAiCatalogTriggerConditionsGroupInputTrigger condition rules for the merge_request_ready event.
pipelineHooksAiCatalogTriggerConditionsGroupInputTrigger condition rules for the pipeline_hooks event.
scheduledAiCatalogTriggerConditionsGroupInputStatus: Experiment. Introduced in GitLab 19.4.

Trigger condition rules for the scheduled event.
workItemAiCatalogTriggerConditionsGroupInputTrigger condition rules for the work_item event.

AiCatalogTriggerConditionsRuleItemInput

Item within a trigger conditions group. Provide either the rule fields (field, operator, value) or rules for a nested group, but not both. match can only be provided with rules.

Arguments

NameTypeDescription
fieldStringField the rule applies to.
matchAiCatalogTriggerConditionsMatchStrategy used to match the rules in the nested group.
operatorAiCatalogTriggerConditionsOperatorOperator used to compare the field to the value.
rules[AiCatalogTriggerConditionsRuleItemInput!]Rules in the nested group.
valueJSONValue to compare the field against.

AiChatInput

Arguments

NameTypeDescription
additionalContext[AiAdditionalContextInput!]Additional context to be passed for the chat.
contentString!Content of the message.
currentFileAiCurrentFileInputInformation about currently selected text which can be passed for additional context.
namespaceIdNamespaceIDGlobal ID of the namespace the user is acting on.
resourceIdAiModelIDGlobal ID of the resource to mutate.

AiCurrentFileInput

Arguments

NameTypeDescription
contentAboveCursorStringContent above cursor.
contentBelowCursorStringContent below cursor.
fileNameString!File name.
selectedTextString!Selected text.

AiDomainSettingsInstanceUpdateInput

Autogenerated input type of AiDomainSettingsInstanceUpdate.

Arguments

NameTypeDescription
actionAiDomainSettingAction!Action to perform on the domain list.
clientMutationIdStringA unique identifier for the client performing the mutation.
domainSettingTypeAiDomainSettingType!Type of domain setting to update.
domains[String!]!List of domains to add or remove.

AiDomainSettingsNamespaceUpdateInput

Autogenerated input type of AiDomainSettingsNamespaceUpdate.

Arguments

NameTypeDescription
actionAiDomainSettingAction!Action to perform on the domain list.
clientMutationIdStringA unique identifier for the client performing the mutation.
domainSettingTypeAiDomainSettingType!Type of domain setting to update.
domains[String!]!List of domains to add or remove.
namespaceIdNamespaceID!Global ID of the root namespace to update.

AiDuoWorkflowCreateInput

Autogenerated input type of AiDuoWorkflowCreate.

Arguments

NameTypeDescription
agentPrivileges[Int!]Actions the agent is allowed to perform.
aiCatalogItemVersionIdAiCatalogItemVersionIDID of the catalog item the workflow is triggered from.
allowAgentToRequestUserBooleanWhen enabled, Duo Agent Platform may stop to ask the user questions before proceeding.
clientMutationIdStringA unique identifier for the client performing the mutation.
environmentWorkflowEnvironmentEnvironment for the workflow.
goalStringGoal of the workflow.
issueIdBigIntIID of the noteable (Issue) that the workflow is associated with.
mergeRequestIdBigIntIID of the noteable (MergeRequest) that the workflow is associated with.
namespaceIdNamespaceIDGlobal ID of the namespace the user is acting on.
preApprovedAgentPrivileges[Int!]Actions the agent can perform without asking for approval.
projectIdProjectIDGlobal ID of the project the user is acting on.
webSearchEnabledBooleanEnable web search for the session.
workflowDefinitionStringWorkflow type based on its capability.

AiExplainVulnerabilityInput

Arguments

NameTypeDescription
includeSourceCodeBooleanInclude vulnerability source code in the AI prompt.
resourceIdAiModelID!Global ID of the resource to mutate.

AiFeatureSettingModelAllowlistUpdateInput

Autogenerated input type of AiFeatureSettingModelAllowlistUpdate.

Arguments

NameTypeDescription
allowlistEnabledBoolean!Whether the model selection allowlist is enabled for the feature.
allowlistModelRefs[String!]!Identifiers of the GitLab-managed models allowed for the feature. Ignored when allowlistEnabled is false.
clientMutationIdStringA unique identifier for the client performing the mutation.
featureAiFeatures!AI feature whose model allowlist is being configured.

AiFeatureSettingUpdateInput

Autogenerated input type of AiFeatureSettingUpdate.

Arguments

NameTypeDescription
aiSelfHostedModelIdAiSelfHostedModelIDGlobal ID of the self-hosted model providing the AI setting.
clientMutationIdStringA unique identifier for the client performing the mutation.
features[AiFeatures!]!Array of AI features being configured (for single or batch update).
offeredModelRefStringIdentifier of the selected model for the feature.
providerAiFeatureProviders!Provider for AI setting.

AiFlowScheduleCreateInput

Autogenerated input type of AiFlowScheduleCreate.

Arguments

NameTypeDescriptionDefault
activeBooleanIndicates whether the schedule should be active.true
clientMutationIdStringA unique identifier for the client performing the mutation.
cronString!Cron expression defining the schedule frequency.
cronTimezoneString!IANA timezone for the cron expression.
descriptionString!Description of the schedule.
flowTriggerIdAiFlowTriggerID!Global ID of the flow trigger to schedule.

AiFlowScheduleDeleteInput

Autogenerated input type of AiFlowScheduleDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAiFlowScheduleID!Global ID of the flow schedule to delete.

AiFlowScheduleUpdateInput

Autogenerated input type of AiFlowScheduleUpdate.

Arguments

NameTypeDescription
activeBooleanIndicates whether the schedule should be active.
clientMutationIdStringA unique identifier for the client performing the mutation.
cronStringCron expression defining the schedule frequency.
cronTimezoneStringIANA timezone for the cron expression.
descriptionStringDescription of the schedule.
idAiFlowScheduleID!Global ID of the flow schedule to update.

AiFlowTriggerCreateInput

Autogenerated input type of AiFlowTriggerCreate.

Arguments

NameTypeDescription
activeBooleanStatus: Experiment. Introduced in GitLab 19.4.

Indicates whether the AI flow trigger is active. Defaults to true.
aiCatalogItemConsumerIdAiCatalogItemConsumerIDAI catalog item consumer to use instead of config_path.
clientMutationIdStringA unique identifier for the client performing the mutation.
configPathStringPath to the configuration file for the AI flow trigger.
descriptionString!Description of the AI flow trigger.
eventTypes[Int!]Event types that triggers the AI flow.
filterJSONStatus: Experiment. Introduced in GitLab 19.0.

Filter conditions for the AI flow trigger.
projectPathID!Full path of the project the AI flow trigger is associated with.
userIdUserIDService account for the AI flow trigger.

AiFlowTriggerDeleteInput

Autogenerated input type of AiFlowTriggerDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAiFlowTriggerID!ID of the flow trigger to delete.

AiFlowTriggerUpdateInput

Autogenerated input type of AiFlowTriggerUpdate.

Arguments

NameTypeDescription
activeBooleanStatus: Experiment. Introduced in GitLab 19.4.

Indicates whether the AI flow trigger is active. Inactive triggers do not run automatically.
aiCatalogItemConsumerIdAiCatalogItemConsumerIDAI catalog item consumer to use instead of config_path.
clientMutationIdStringA unique identifier for the client performing the mutation.
configPathStringPath to the configuration file for the AI flow trigger.
descriptionStringDescription of the AI flow trigger.
eventTypes[Int!]Event types that triggers the AI flow.
filterJSONStatus: Experiment. Introduced in GitLab 18.11.

Filter conditions for the AI flow trigger.
idAiFlowTriggerID!ID of the flow trigger to update.
userIdUserIDService account for the AI flow trigger.

AiGenerateCommitMessageInput

Arguments

NameTypeDescription
resourceIdAiModelID!Global ID of the resource to mutate.

AiGenerateDescriptionInput

Arguments

NameTypeDescription
contentString!Content of the message.
descriptionTemplateNameStringName of the description template to use to generate message off of.
resourceIdAiModelID!Global ID of the resource to mutate.

AiMeasureCommentTemperatureInput

Arguments

NameTypeDescription
contentString!Content of the message.
resourceIdAiModelID!Global ID of the resource to mutate.

AiModelSelectionNamespaceModelAllowlistUpdateInput

Autogenerated input type of AiModelSelectionNamespaceModelAllowlistUpdate.

Arguments

NameTypeDescription
allowlistEnabledBoolean!Whether the model selection allowlist is enabled for the feature.
allowlistModelRefs[String!]!Identifiers of the GitLab-managed models allowed for the feature. Ignored when allowlistEnabled is false.
clientMutationIdStringA unique identifier for the client performing the mutation.
featureAiFeatures!AI feature whose model allowlist is being configured.
groupIdGroupID!Group whose model allowlist is being configured.

AiModelSelectionNamespaceUpdateInput

Autogenerated input type of AiModelSelectionNamespaceUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
features[AiModelSelectionFeatures!]!Array of AI features being configured (for single or batch update).
groupIdGroupID!Group for the model selection.
offeredModelRefString!Identifier of the selected model for the feature.

AiResolveVulnerabilityInput

Arguments

NameTypeDescription
resourceIdAiModelID!Global ID of the resource to mutate.
vulnerableMergeRequestIdMergeRequestIDGlobal ID of the merge request which the merge request containing the vulnerability resolution will target.

AiSelfHostedModelConnectionCheckInput

Autogenerated input type of AiSelfHostedModelConnectionCheck.

Arguments

NameTypeDescription
apiTokenStringAPI token to access the self-hosted model, if any.
clientMutationIdStringA unique identifier for the client performing the mutation.
endpointStringEndpoint of the self-hosted model.
identifierStringIdentifier for 3rd party model provider.
modelAiAcceptedSelfHostedModels!AI model deployed.
nameString!Deployment name of the self-hosted model.
providerAiSelfHostedModelProvider!Provider for the self-hosted model.

AiSelfHostedModelCreateInput

Autogenerated input type of AiSelfHostedModelCreate.

Arguments

NameTypeDescription
apiTokenStringAPI token to access the self-hosted model, if any.
clientMutationIdStringA unique identifier for the client performing the mutation.
endpointStringEndpoint of the self-hosted model.
identifierStringIdentifier for 3rd party model provider.
modelAiAcceptedSelfHostedModels!AI model deployed.
nameString!Deployment name of the self-hosted model.
providerAiSelfHostedModelProvider!Provider for the self-hosted model.

AiSelfHostedModelDeleteInput

Autogenerated input type of AiSelfHostedModelDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAiSelfHostedModelID!Global ID of the self-hosted model to delete.

AiSelfHostedModelUpdateInput

Autogenerated input type of AiSelfHostedModelUpdate.

Arguments

NameTypeDescription
apiTokenStringAPI token to access the self-hosted model, if any.
clientMutationIdStringA unique identifier for the client performing the mutation.
endpointStringEndpoint of the self-hosted model.
idAiSelfHostedModelID!Global ID of the self-hosted model to update.
identifierStringIdentifier for 3rd party model provider.
modelAiAcceptedSelfHostedModels!AI model deployed.
nameString!Deployment name of the self-hosted model.
providerAiSelfHostedModelProvider!Provider for the self-hosted model.

AiSummarizeNewMergeRequestInput

Summarize a new merge request based on two branches. Returns null if the add_ai_summary_for_new_mr feature flag is disabled.

Arguments

NameTypeDescription
resourceIdAiModelID!Global ID of the resource to mutate.
sourceBranchString!Source branch of the changes.
sourceProjectIdIDID of the project where the changes are from.
targetBranchString!Target branch of where the changes will be merged into.

AiSummarizeReviewInput

Arguments

NameTypeDescription
resourceIdAiModelID!Global ID of the resource to mutate.

AlertManagementPayloadAlertFieldInput

Field that are available while modifying the custom mapping attributes for an HTTP integration.

Arguments

NameTypeDescription
fieldNameAlertManagementPayloadAlertFieldName!GitLab alert field name.
labelStringHuman-readable label of the payload path.
path[PayloadAlertFieldPathSegment!]!Path to value inside payload JSON.
typeAlertManagementPayloadAlertFieldType!Type of the parsed value.

AlertSetAssigneesInput

Autogenerated input type of AlertSetAssignees.

Arguments

NameTypeDescription
assigneeUsernames[String!]!Usernames to assign to the alert. Replaces existing assignees by default.
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the alert to mutate.
operationModeMutationOperationModeOperation to perform. Defaults to REPLACE.
projectPathID!Project the alert to mutate is in.

AlertTodoCreateInput

Autogenerated input type of AlertTodoCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the alert to mutate.
projectPathID!Project the alert to mutate is in.

AnalyzerFilterInput

Input type for filtering projects by analyzer type and status.

Arguments

NameTypeDescription
analyzerTypeAnalyzerTypeEnum!Type of analyzer to filter by.
statusAnalyzerStatusEnum!Status of the analyzer to filter by.

ApproveDeploymentInput

Autogenerated input type of ApproveDeployment.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentStringComment to go with the approval.
idDeploymentID!ID of the deployment.
representedAsStringName of the User/Group/Role to use for the approval, when the user belongs to multiple approval rules.
statusDeploymentsApprovalStatus!Status of the approval (either APPROVED or REJECTED).

ArtifactDestroyInput

Autogenerated input type of ArtifactDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiJobArtifactID!ID of the artifact to delete.

ArtifactRegistryActivateInput

Autogenerated input type of ArtifactRegistryActivate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
slugString!Slug to claim, Artifact Registry’s immutable identifier for the namespace.

ArtifactRegistryArtifactDeleteInput

Autogenerated input type of ArtifactRegistryArtifactDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idID!ID of the artifact in Artifact Registry, as returned by the id field on a package or image. Not a GitLab global ID.
nameString!Name of the repository holding the artifact, unique within the organization.

ArtifactRegistryContainerTagDeleteInput

Autogenerated input type of ArtifactRegistryContainerTagDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
imageIdID!ID of the image holding the tag in Artifact Registry, as returned by the id field on an image. Not a GitLab global ID.
nameString!Name of the repository holding the tag, unique within the organization.
tagNameString!Name of the tag to delete. Limited to 1024 characters.

ArtifactRegistryDisableInput

Autogenerated input type of ArtifactRegistryDisable.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.

ArtifactRegistryEnableInput

Autogenerated input type of ArtifactRegistryEnable.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.

ArtifactRegistryManifestDeleteInput

Autogenerated input type of ArtifactRegistryManifestDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
digestString!Content-addressable digest of the manifest, as returned by the digest field on a manifest. Limited to 512 characters.
imageIdID!ID of the image holding the manifest in Artifact Registry, as returned by the id field on an image. Not a GitLab global ID.
nameString!Name of the repository holding the manifest, unique within the organization.

ArtifactRegistryNpmDistTagDeleteInput

Autogenerated input type of ArtifactRegistryNpmDistTagDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idID!ID of the dist-tag in Artifact Registry. Not a GitLab global ID.
nameString!Name of the repository holding the dist-tag, unique within the organization.

ArtifactRegistryRemoteCredentialsInput

Upstream credentials for a remote Artifact Registry repository. Write-only: no field returns them.

Arguments

NameTypeDescription
authTokenStringStatus: Experiment. Introduced in GitLab 19.4.

Bearer token for the upstream. npm only.
passwordStringStatus: Experiment. Introduced in GitLab 19.4.

Password for the upstream. Maven and the container formats only; pair it with a username.
usernameStringStatus: Experiment. Introduced in GitLab 19.4.

Username for the upstream. Maven and the container formats only; pair it with a password.

ArtifactRegistryRemoteSettingsInput

Writable upstream configuration of a remote Artifact Registry repository.

Arguments

NameTypeDescription
cacheValidityHoursIntStatus: Experiment. Introduced in GitLab 19.4.

Revalidation window for cached artifacts, in hours. Between 0 and 32767, where 0 means cached artifacts never revalidate.
credentialsArtifactRegistryRemoteCredentialsInputStatus: Experiment. Introduced in GitLab 19.4.

Upstream credentials. Omit to leave the stored ones unchanged, supply an object to replace them, or, on an update, supply null to clear them.
metadataCacheValidityHoursIntStatus: Experiment. Introduced in GitLab 19.4.

Revalidation window for cached metadata, in hours. Between 1 and 32767, so metadata always revalidates on a schedule. Maven and npm only; other formats reject it.
snapshotMetadataAlwaysRevalidateBooleanStatus: Experiment. Introduced in GitLab 19.4.

Whether snapshot metadata revalidates on every read instead of on the metadata window. Maven only; other formats reject it.
urlStringStatus: Experiment. Introduced in GitLab 19.4.

Base URL of the upstream registry, at most 1024 characters. Changing it resets the health fields, evicts the cached artifacts, and clears the stored credentials unless the same request supplies new ones.

ArtifactRegistryRepositoryArtifactsDeleteInput

Autogenerated input type of ArtifactRegistryRepositoryArtifactsDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the repository whose artifacts are deleted, unique within the organization.

ArtifactRegistryRepositoryCreateInput

Autogenerated input type of ArtifactRegistryRepositoryCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringHuman-readable description of the repository.
formatArtifactRegistryRepositoryFormat!Package format the repository holds. Cannot be changed after creation.
kindArtifactRegistryRepositoryKindHow the repository sources its artifacts. Defaults to hosted in Artifact Registry.
nameString!Name of the repository, unique within the organization.
settingsArtifactRegistryRemoteSettingsInputStatus: Experiment. Introduced in GitLab 19.4.

Upstream configuration. Required on a remote repository create, rejected on any other kind.
visibilityArtifactRegistryRepositoryVisibilityWho can read the repository.

ArtifactRegistryRepositoryDeleteInput

Autogenerated input type of ArtifactRegistryRepositoryDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the repository to delete, unique within the organization.

ArtifactRegistryRepositoryTestConnectionInput

Autogenerated input type of ArtifactRegistryRepositoryTestConnection.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the repository to test, unique within the organization.

ArtifactRegistryRepositoryUpdateInput

Autogenerated input type of ArtifactRegistryRepositoryUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringHuman-readable description of the repository.
nameString!Name of the repository to update, unique within the organization. Cannot be changed.
settingsArtifactRegistryRemoteSettingsInputStatus: Experiment. Introduced in GitLab 19.4.

Upstream configuration. Required on a remote repository create, rejected on any other kind.
visibilityArtifactRegistryRepositoryVisibilityWho can read the repository.

ArtifactRegistryRoleAssignmentInput

Single Artifact Registry role assignment.

Arguments

NameTypeDescription
assigneeIdUserID!Global ID of the user to grant the role to.
resourceIdString!UUID of the Artifact Registry resource (repository or namespace) the role applies to.
roleArtifactRegistryRole!Artifact Registry role to grant.

ArtifactRegistryRoleBulkGrantInput

Autogenerated input type of ArtifactRegistryRoleBulkGrant.

Arguments

NameTypeDescription
assignments[ArtifactRegistryRoleAssignmentInput!]!Role assignments to grant. All succeed or none are written. A maximum of 1000 assignments is allowed per request.
clientMutationIdStringA unique identifier for the client performing the mutation.

ArtifactRegistryRoleBulkRevokeInput

Autogenerated input type of ArtifactRegistryRoleBulkRevoke.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
revocations[ArtifactRegistryRoleRevocationInput!]!Role revocations to apply. All succeed or none are applied. A maximum of 1000 revocations is allowed per request.

ArtifactRegistryRoleGrantInput

Autogenerated input type of ArtifactRegistryRoleGrant.

Arguments

NameTypeDescription
assigneeIdUserID!Global ID of the user to grant the role to.
clientMutationIdStringA unique identifier for the client performing the mutation.
resourceIdString!UUID of the Artifact Registry resource (repository or namespace) the role applies to.
roleArtifactRegistryRole!Artifact Registry role to grant.

ArtifactRegistryRoleRevocationInput

Single Artifact Registry role revocation. Names no role: a user holds one role per resource, and revoking removes it.

Arguments

NameTypeDescription
assigneeIdUserID!Global ID of the user to revoke the role from.
resourceIdString!UUID of the Artifact Registry resource (repository or namespace) the role is assigned on.

ArtifactRegistryRoleRevokeInput

Autogenerated input type of ArtifactRegistryRoleRevoke.

Arguments

NameTypeDescription
assigneeIdUserID!Global ID of the user to revoke the role from.
clientMutationIdStringA unique identifier for the client performing the mutation.
resourceIdString!UUID of the Artifact Registry resource (repository or namespace) the role is assigned on.

ArtifactRegistryUpstreamTestConnectionInput

Autogenerated input type of ArtifactRegistryUpstreamTestConnection.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
credentialsArtifactRegistryRemoteCredentialsInputUpstream credentials to probe with. Omit or pass null to probe unauthenticated. Accepted for every format, but ignored when probing a container upstream (docker or oci), whose probe is always unauthenticated.
formatArtifactRegistryRepositoryFormat!Package format of the upstream to probe. Decides the credential shape and the probe auth.
urlString!Base URL of the upstream to probe.

ArtifactRegistryVersionDeleteInput

Autogenerated input type of ArtifactRegistryVersionDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idID!ID of the version in Artifact Registry, as returned by the id field on a version. Not a GitLab global ID.
nameString!Name of the repository holding the version, unique within the organization.

AscpComponentCreateInput

Autogenerated input type of AscpComponentCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringComponent description.
expectedUserBehaviorStringExpected user behavior for the component.
projectPathID!Full path of the project.
scanIdSecurityAscpScanID!ID of the scan when the component was discovered.
subDirectoryString!Sub-directory path containing the component.
titleString!Component title.

AscpScanCreateInput

Autogenerated input type of AscpScanCreate.

Arguments

NameTypeDescriptionDefault
baseCommitShaStringBase commit SHA for incremental scans.
baseScanIdSecurityAscpScanIDID of the base scan for incremental scans.
clientMutationIdStringA unique identifier for the client performing the mutation.
commitShaString!Git commit SHA that was scanned.
projectPathID!Full path of the project.
scanTypeAscpScanTypeType of scan (default: full).FULL

AscpSecurityContextCreateInput

Autogenerated input type of AscpSecurityContextCreate.

Arguments

NameTypeDescription
authenticationModelStringHow users authenticate to the component.
authorizationModelStringHow access is controlled.
clientMutationIdStringA unique identifier for the client performing the mutation.
componentIdSecurityAscpComponentID!ID of the component.
dataSensitivityStringTypes of sensitive data handled.
guidelines[AscpSecurityGuidelineInput!]!List of security guidelines.
projectPathID!Full path of the project.
scanIdSecurityAscpScanID!ID of the scan when the security context was created.
summaryStringHigh-level threat model summary.

AscpSecurityGuidelineInput

Input type for creating a security guideline.

Arguments

NameTypeDescriptionDefault
businessContextStringHow to assess business impact if violated.
legitimateUseStringWhen the operation is expected and acceptable.
nameString!Policy name.
operationString!Security-sensitive operation.
securityBoundaryStringWhen the operation becomes a security risk.
severityIfViolatedAscpSeveritySeverity level if the guideline is violated.MEDIUM

AttributeFilterInput

Input type for filtering projects by security attributes.

Arguments

NameTypeDescription
attributes[SecurityAttributeID!]!Global IDs of the security attributes to filter by. Up to 20 values.
operatorAttributeFilterOperator!Operator to apply for the attribute filter.

AuditEventsAmazonS3ConfigurationCreateInput

Autogenerated input type of AuditEventsAmazonS3ConfigurationCreate.

Arguments

NameTypeDescription
accessKeyXidString!Access key ID of the Amazon S3 account.
awsRegionString!AWS region where the bucket is created.
bucketNameString!Name of the bucket where the audit events would be logged.
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Group path.
nameStringDestination name.
secretAccessKeyString!Secret access key of the Amazon S3 account.

AuditEventsAmazonS3ConfigurationDeleteInput

Autogenerated input type of AuditEventsAmazonS3ConfigurationDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsAmazonS3ConfigurationID!ID of the Amazon S3 configuration to destroy.

AuditEventsAmazonS3ConfigurationUpdateInput

Autogenerated input type of AuditEventsAmazonS3ConfigurationUpdate.

Arguments

NameTypeDescription
accessKeyXidStringAccess key ID of the Amazon S3 account.
activeBooleanActive status of the destination.
awsRegionStringAWS region where the bucket is created.
bucketNameStringName of the bucket where the audit events would be logged.
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsAmazonS3ConfigurationID!ID of the Amazon S3 configuration to update.
nameStringDestination name.
secretAccessKeyStringSecret access key of the Amazon S3 account.

AuditEventsGroupDestinationDenylistEventsAddInput

Autogenerated input type of AuditEventsGroupDestinationDenylistEventsAdd.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsGroupExternalStreamingDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to add to the denylist.

AuditEventsGroupDestinationDenylistEventsDeleteInput

Autogenerated input type of AuditEventsGroupDestinationDenylistEventsDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsGroupExternalStreamingDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to remove from the denylist.

AuditEventsGroupDestinationEventsAddInput

Autogenerated input type of AuditEventsGroupDestinationEventsAdd.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsGroupExternalStreamingDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to add for streaming.

AuditEventsGroupDestinationEventsDeleteInput

Autogenerated input type of AuditEventsGroupDestinationEventsDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsGroupExternalStreamingDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to remove from streaming.

AuditEventsGroupDestinationNamespaceFilterCreateInput

Autogenerated input type of AuditEventsGroupDestinationNamespaceFilterCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsGroupExternalStreamingDestinationID!Destination ID.
namespacePathStringFull path of the namespace(only project or group).

AuditEventsGroupDestinationNamespaceFilterDeleteInput

Autogenerated input type of AuditEventsGroupDestinationNamespaceFilterDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespaceFilterIdAuditEventsGroupNamespaceFilterID!Namespace filter ID.

AuditEventsInstanceAmazonS3ConfigurationCreateInput

Autogenerated input type of AuditEventsInstanceAmazonS3ConfigurationCreate.

Arguments

NameTypeDescription
accessKeyXidString!Access key ID of the Amazon S3 account.
awsRegionString!AWS region where the bucket is created.
bucketNameString!Name of the bucket where the audit events would be logged.
clientMutationIdStringA unique identifier for the client performing the mutation.
nameStringDestination name.
secretAccessKeyString!Secret access key of the Amazon S3 account.

AuditEventsInstanceAmazonS3ConfigurationDeleteInput

Autogenerated input type of AuditEventsInstanceAmazonS3ConfigurationDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsInstanceAmazonS3ConfigurationID!ID of the instance-level Amazon S3 configuration to delete.

AuditEventsInstanceAmazonS3ConfigurationUpdateInput

Autogenerated input type of AuditEventsInstanceAmazonS3ConfigurationUpdate.

Arguments

NameTypeDescription
accessKeyXidStringAccess key ID of the Amazon S3 account.
activeBooleanActive status of the destination.
awsRegionStringAWS region where the bucket is created.
bucketNameStringName of the bucket where the audit events would be logged.
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsInstanceAmazonS3ConfigurationID!ID of the instance-level Amazon S3 configuration to update.
nameStringDestination name.
secretAccessKeyStringSecret access key of the Amazon S3 account.

AuditEventsInstanceDestinationEventsAddInput

Autogenerated input type of AuditEventsInstanceDestinationEventsAdd.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsInstanceExternalStreamingDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to add for streaming.

AuditEventsInstanceDestinationEventsDeleteInput

Autogenerated input type of AuditEventsInstanceDestinationEventsDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsInstanceExternalStreamingDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to remove from streaming.

AuditEventsInstanceDestinationNamespaceFilterCreateInput

Autogenerated input type of AuditEventsInstanceDestinationNamespaceFilterCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsInstanceExternalStreamingDestinationID!Destination ID.
namespacePathStringFull path of the namespace. Project or group namespaces only.

AuditEventsInstanceDestinationNamespaceFilterDeleteInput

Autogenerated input type of AuditEventsInstanceDestinationNamespaceFilterDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespaceFilterIdAuditEventsInstanceNamespaceFilterID!Namespace filter ID.

AuditEventsStreamingDestinationEventsAddInput

Autogenerated input type of AuditEventsStreamingDestinationEventsAdd.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsExternalAuditEventDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to add for streaming.

AuditEventsStreamingDestinationEventsRemoveInput

Autogenerated input type of AuditEventsStreamingDestinationEventsRemove.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsExternalAuditEventDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to remove from streaming.

AuditEventsStreamingDestinationInstanceEventsAddInput

Autogenerated input type of AuditEventsStreamingDestinationInstanceEventsAdd.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsInstanceExternalAuditEventDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to add for streaming.

AuditEventsStreamingDestinationInstanceEventsRemoveInput

Autogenerated input type of AuditEventsStreamingDestinationInstanceEventsRemove.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsInstanceExternalAuditEventDestinationID!Destination id.
eventTypeFilters[String!]!List of event type filters to remove from streaming.

AuditEventsStreamingHTTPNamespaceFiltersAddInput

Autogenerated input type of AuditEventsStreamingHTTPNamespaceFiltersAdd.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsExternalAuditEventDestinationID!Destination ID.
groupPathIDFull path of the group.
projectPathIDFull path of the project.

AuditEventsStreamingHTTPNamespaceFiltersDeleteInput

Autogenerated input type of AuditEventsStreamingHTTPNamespaceFiltersDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespaceFilterIdAuditEventsStreamingHTTPNamespaceFilterID!Namespace filter ID.

AuditEventsStreamingHeadersCreateInput

Autogenerated input type of AuditEventsStreamingHeadersCreate.

Arguments

NameTypeDescriptionDefault
activeBooleanBoolean option determining whether header is active or not.true
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsExternalAuditEventDestinationID!Destination to associate header with.
keyString!Header key.
valueString!Header value.

AuditEventsStreamingHeadersDestroyInput

Autogenerated input type of AuditEventsStreamingHeadersDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
headerIdAuditEventsStreamingHeaderID!Header to delete.

AuditEventsStreamingHeadersUpdateInput

Autogenerated input type of AuditEventsStreamingHeadersUpdate.

Arguments

NameTypeDescriptionDefault
activeBooleanBoolean option determining whether header is active or not.null
clientMutationIdStringA unique identifier for the client performing the mutation.
headerIdAuditEventsStreamingHeaderID!Header to update.
keyStringHeader key.null
valueStringHeader value.null

AuditEventsStreamingInstanceHeadersCreateInput

Autogenerated input type of AuditEventsStreamingInstanceHeadersCreate.

Arguments

NameTypeDescriptionDefault
activeBooleanBoolean option determining whether header is active or not.true
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationIdAuditEventsInstanceExternalAuditEventDestinationID!Instance level external destination to associate header with.
keyString!Header key.
valueString!Header value.

AuditEventsStreamingInstanceHeadersDestroyInput

Autogenerated input type of AuditEventsStreamingInstanceHeadersDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
headerIdAuditEventsStreamingInstanceHeaderID!Header to delete.

AuditEventsStreamingInstanceHeadersUpdateInput

Autogenerated input type of AuditEventsStreamingInstanceHeadersUpdate.

Arguments

NameTypeDescriptionDefault
activeBooleanBoolean option determining whether header is active or not.null
clientMutationIdStringA unique identifier for the client performing the mutation.
headerIdAuditEventsStreamingInstanceHeaderID!Header to update.
keyStringHeader key.null
valueStringHeader value.null

AwardEmojiAddInput

Autogenerated input type of AwardEmojiAdd.

Arguments

NameTypeDescription
awardableIdAwardableID!Global ID of the awardable resource.
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Emoji name.

AwardEmojiRemoveInput

Autogenerated input type of AwardEmojiRemove.

Arguments

NameTypeDescription
awardableIdAwardableID!Global ID of the awardable resource.
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Emoji name.

AwardEmojiToggleInput

Autogenerated input type of AwardEmojiToggle.

Arguments

NameTypeDescription
awardableIdAwardableID!Global ID of the awardable resource.
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Emoji name.

BaseGroupsResolverNegatedParams

Arguments

NameTypeDescription
ids[GroupID!]Filters groups to exclude the group IDs provided in the given array. Up to 10 values.

BoardEpicCreateInput

Autogenerated input type of BoardEpicCreate.

Arguments

NameTypeDescription
boardIdBoardsEpicBoardID!Global ID of the board that the epic is in.
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Group the epic to create is in.
listIdBoardsEpicListID!Global ID of the epic board list in which epic will be created.
titleString!Title of the epic.

BoardIssueInput

Arguments

NameTypeDescription
assigneeUsername[String]Filter by assignee username.
assigneeWildcardIdAssigneeWildcardIdFilter by assignee wildcard. Incompatible with assigneeUsername and assigneeUsernames.
authorUsernameStringFilter by author username.
confidentialBooleanFilter by confidentiality.
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 17.10.

Filter by custom fields.
epicIdEpicIDDeprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
epicWildcardIdEpicWildcardIdFilter by epic ID wildcard. Incompatible with epicId.
healthStatusFilterHealthStatusFilterHealth status of the issue, “none” and “any” values are supported.
iids[String!]List of IIDs of issues. For example ["1", "2"].
includeSubepicsBooleanWhether to include subepics when filtering issues by epicId.
iterationCadenceId[IterationsCadenceID!]Filter by a list of iteration cadence IDs.
iterationId[IterationID!]Filter by a list of iteration IDs. Incompatible with iterationWildcardId.
iterationTitleStringFilter by iteration title.
iterationWildcardIdIterationWildcardIdFilter by iteration ID wildcard.
labelName[String]Filter by label name.
milestoneTitleStringFilter by milestone title.
milestoneWildcardIdMilestoneWildcardIdFilter by milestone ID wildcard.
myReactionEmojiStringFilter by reaction emoji applied by the current user. Wildcard values “NONE” and “ANY” are supported.
notNegatedBoardIssueInputList of negated arguments.
orUnionedIssueFilterInputList of arguments with inclusive OR.
releaseTagStringFilter by release tag.
searchStringSearch query for issue title or description.
statusWorkItemWidgetStatusFilterInputStatus: Experiment. Introduced in GitLab 18.0.

Filter by status.
types[IssueType!]Filter by the given issue types.
weightStringFilter by weight.
weightWildcardIdWeightWildcardIdFilter by weight ID wildcard. Incompatible with weight.
workItemTypeIds[WorkItemsTypeID!]Filter by work item type global IDs.

BoardListCreateInput

Autogenerated input type of BoardListCreate.

Arguments

NameTypeDescription
assigneeIdUserIDGlobal ID of an existing user.
backlogBooleanCreate the backlog list.
boardIdBoardID!Global ID of the issue board to mutate.
clientMutationIdStringA unique identifier for the client performing the mutation.
iterationIdIterationIDGlobal ID of an existing iteration.
labelIdLabelIDGlobal ID of an existing label.
milestoneIdMilestoneIDGlobal ID of an existing milestone.
positionIntPosition of the list.
statusIdWorkItemsStatusesStatusIDStatus: Experiment. Introduced in GitLab 18.0.

Global ID of an existing status.

BoardListUpdateLimitMetricsInput

Autogenerated input type of BoardListUpdateLimitMetrics.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
limitMetricListLimitMetricNew limit metric type for the list.
listIdListID!Global ID of the list.
maxIssueCountIntNew maximum issue count limit.
maxIssueWeightIntNew maximum issue weight limit.

BranchDeleteInput

Autogenerated input type of BranchDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the branch.
projectPathID!Project full path the branch is associated with.

BranchProtectionInput

Arguments

NameTypeDescriptionDefault
allowForcePushBooleanAllows users with write access to the branch rule target to force push changes.false
codeOwnerApprovalRequiredBooleanEnforce code owner approvals before allowing a merge.true
mergeAccessLevels[MergeAccessLevelInput!]Details about who can merge into the branch rule target.[]
pushAccessLevels[PushAccessLevelInput!]Details about who can push to the branch rule target.[]

BranchRuleCreateInput

Autogenerated input type of BranchRuleCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Branch name, with wildcards, for the branch rules.
projectPathID!Full path to the project that the branch is associated with.

BranchRuleDeleteInput

Autogenerated input type of BranchRuleDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idProjectsBranchRuleID!Global ID of the branch rule to destroy.

BranchRuleExternalStatusCheckCreateInput

Autogenerated input type of BranchRuleExternalStatusCheckCreate.

Arguments

NameTypeDescription
branchRuleIdProjectsBranchRuleID!Global ID of the branch rule to update.
clientMutationIdStringA unique identifier for the client performing the mutation.
externalUrlString!URL of external status check resource.
nameString!Name of the external status check.
sharedSecretStringHMAC shared secret for authenticating external status check requests.

BranchRuleExternalStatusCheckDestroyInput

Autogenerated input type of BranchRuleExternalStatusCheckDestroy.

Arguments

NameTypeDescription
branchRuleIdProjectsBranchRuleID!Global ID of the branch rule.
clientMutationIdStringA unique identifier for the client performing the mutation.
idMergeRequestsExternalStatusCheckID!Global ID of the external status check to destroy.

BranchRuleExternalStatusCheckUpdateInput

Autogenerated input type of BranchRuleExternalStatusCheckUpdate.

Arguments

NameTypeDescription
branchRuleIdProjectsBranchRuleID!Global ID of the branch rule.
clientMutationIdStringA unique identifier for the client performing the mutation.
externalUrlString!External URL of the external status check.
idMergeRequestsExternalStatusCheckID!Global ID of the external status check to update.
nameString!Name of the external status check.
sharedSecretStringHMAC shared secret for authenticating external status check requests.

BranchRuleSquashOptionCreateInput

Autogenerated input type of BranchRuleSquashOptionCreate.

Arguments

NameTypeDescription
branchRuleIdProjectsBranchRuleID!Global ID of the branch rule.
clientMutationIdStringA unique identifier for the client performing the mutation.
squashOptionSquashOptionSetting!Squash option to set for the branch rule.

BranchRuleSquashOptionDeleteInput

Autogenerated input type of BranchRuleSquashOptionDelete.

Arguments

NameTypeDescription
branchRuleIdProjectsBranchRuleID!Global ID of the branch rule.
clientMutationIdStringA unique identifier for the client performing the mutation.

BranchRuleSquashOptionUpdateInput

Autogenerated input type of BranchRuleSquashOptionUpdate.

Arguments

NameTypeDescription
branchRuleIdProjectsBranchRuleID!Global ID of the branch rule.
clientMutationIdStringA unique identifier for the client performing the mutation.
squashOptionSquashOptionSetting!Squash option after mutation.

BranchRuleUpdateInput

Autogenerated input type of BranchRuleUpdate.

Arguments

NameTypeDescription
branchProtectionBranchProtectionInputBranch protections configured for the branch rule.
clientMutationIdStringA unique identifier for the client performing the mutation.
idProjectsBranchRuleID!Global ID of the branch rule to update.
nameString!Branch name, with wildcards, for the branch rules.

BudgetCapUserOverrideInput

Input for a per-user budget cap override.

Arguments

NameTypeDescription
capFloat!Budget cap amount for the user.
enabledBoolean!Whether the budget cap is enabled for the user.
userIdUserID!Global ID of the user.

BulkDestroyJobArtifactsInput

Autogenerated input type of BulkDestroyJobArtifacts.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[CiJobArtifactID!]!Global IDs of the job artifacts to destroy.
projectIdProjectID!Global Project ID of the job artifacts to destroy. Incompatible with projectPath.

BulkEnableDevopsAdoptionNamespacesInput

Autogenerated input type of BulkEnableDevopsAdoptionNamespaces.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
displayNamespaceIdNamespaceIDDisplay namespace ID.
namespaceIds[NamespaceID!]!List of Namespace IDs.

BulkRunnerDeleteInput

Autogenerated input type of BulkRunnerDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[CiRunnerID!]IDs of the runners to delete.

BulkSetVulnerabilityFindingsDueDatesInput

Autogenerated input type of BulkSetVulnerabilityFindingsDueDates.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectFullPathString!Full path of the project.
updates[FindingDueDatesSetInput!]!List of finding UUIDs with due dates. A maximum of 1000 updates is allowed per request.

BulkToolRuleInput

Input for a single tool rule update within a bulk operation.

Arguments

NameTypeDescription
backgroundAccessAiBackgroundToolPermissionStatus: Experiment. Introduced in GitLab 19.3.

Permission mode for the background-flow surface. Omitting the field sets it to null, clearing any existing value.
localAccessAiToolPermissionPermission mode for local or IDE surface. Omitting the field sets it to null, clearing any existing value.
toolIdString!Tool name string identifying the tool to update. For example, “create_issue”.
webAccessAiToolPermissionPermission mode for web surface. Omitting the field sets it to null, clearing any existing value.

BulkUpdateAiToolRulesInput

Autogenerated input type of BulkUpdateAiToolRules.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Full path of the root namespace to update tool rules for.
projectPathIDFull path of the project to update tool rules for. When provided, rules can only be stricter than the namespace rule.
toolRules[BulkToolRuleInput!]!Tool rules to update (maximum 100 entries).

BulkUpdateSecurityAttributesInput

Autogenerated input type of BulkUpdateSecurityAttributes.

Arguments

NameTypeDescription
attributes[SecurityAttributeID!]!Global IDs of security attributes to apply.
clientMutationIdStringA unique identifier for the client performing the mutation.
items[ID!]!Global IDs of groups and projects to update.
modeSecurityAttributeBulkUpdateMode!Update mode: add, remove, or replace attributes.

CancelVulnerabilityWorkflowInput

Autogenerated input type of CancelVulnerabilityWorkflow.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectIdProjectID!Global ID of the project.
workflowVulnerabilityDuoWorkflow!Workflow to cancel.

CatalogResourcesCreateInput

Autogenerated input type of CatalogResourcesCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Project path belonging to the catalog resource.

CatalogResourcesDestroyInput

Autogenerated input type of CatalogResourcesDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Project path belonging to the catalog resource.

CdApplicationCreateInput

Autogenerated input type of CdApplicationCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the application.
nameString!Name of the application.
organizationIdOrganizationsOrganizationID!Global ID of the organization to create the application in.
services[CdServiceInput!]Services to create in the application, up to 1000.

CdApplicationFlowDefinitionCreateInput

Autogenerated input type of CdApplicationFlowDefinitionCreate.

Arguments

NameTypeDescription
applicationIdCdApplicationID!Global ID of the application to create the flow definition for.
clientMutationIdStringA unique identifier for the client performing the mutation.
definitionString!Body of the flow definition.

CdApplicationLinkCreateInput

Autogenerated input type of CdApplicationLinkCreate.

Arguments

NameTypeDescription
applicationIdCdApplicationID!Global ID of the application to create the link in.
clientMutationIdStringA unique identifier for the client performing the mutation.
linkTypeCdApplicationLinkType!Type of the link.
nameString!Name of the link.
urlString!URL of the link.

CdApplicationLinkDeleteInput

Autogenerated input type of CdApplicationLinkDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCdApplicationLinkID!Global ID of the link to delete.

CdApplicationLinkUpdateInput

Autogenerated input type of CdApplicationLinkUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCdApplicationLinkID!Global ID of the link to update.
linkTypeCdApplicationLinkTypeType of the link.
nameStringName of the link.
urlStringURL of the link.

CdApplicationUpdateInput

Autogenerated input type of CdApplicationUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the application.
idCdApplicationID!Global ID of the application to update.
nameStringName of the application.

CdArtifactSourceCreateInput

Autogenerated input type of CdArtifactSourceCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the artifact source.
serviceIdCdServiceID!Global ID of the service to create the artifact source for.
sourceConfigJSONConfiguration of the artifact source, defined by the consuming driver.
sourceRefString!Reference of the artifact source.

CdArtifactSourceInput

Attributes for a continuous deployment artifact source.

Arguments

NameTypeDescription
nameString!Name of the artifact source.
sourceConfigJSONConfiguration of the artifact source, defined by the consuming driver.
sourceRefString!Reference of the artifact source.

CdEnvironmentCreateInput

Autogenerated input type of CdEnvironmentCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the environment.
environmentDriverBindingCdEnvironmentDriverBindingInput!Driver binding to create for the environment.
nameString!Name of the environment.
organizationIdOrganizationsOrganizationID!Global ID of the organization to create the environment in.
tierCdEnvironmentTier!Tier of the environment.

CdEnvironmentDriverBindingCreateInput

Autogenerated input type of CdEnvironmentDriverBindingCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
environmentDriverBindingCdEnvironmentDriverBindingInput!Driver binding to create for the environment.
environmentIdCdEnvironmentID!Global ID of the environment to bind the driver to.

CdEnvironmentDriverBindingInput

Attributes for a continuous deployment environment driver binding.

Arguments

NameTypeDescription
driverConfigJSON!Configuration of the environment driver binding, defined by the driver’s own schema.
driverRefString!Reference of the driver.

CdEnvironmentUpdateInput

Autogenerated input type of CdEnvironmentUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the environment.
idCdEnvironmentID!Global ID of the environment to update.
nameStringName of the environment.
tierCdEnvironmentTierTier of the environment.

CdRolloutCreateInput

Autogenerated input type of CdRolloutCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
organizationIdOrganizationsOrganizationID!Global ID of the organization to create the rollout in.
versionSetIdCdVersionSetID!Global ID of the version set the rollout deploys.

CdRolloutGateResolveInput

Autogenerated input type of CdRolloutGateResolve.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCdRolloutID!Global ID of the rollout whose approval gate is being resolved.
resolutionReasonStringReason for the decision.
statusCdRolloutGateStatus!Decision to record for the approval gate.

CdServiceCreateInput

Autogenerated input type of CdServiceCreate.

Arguments

NameTypeDescription
applicationIdCdApplicationID!Global ID of the application to create the service in.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the service.
nameString!Name of the service.

CdServiceInput

Attributes for a continuous deployment service.

Arguments

NameTypeDescription
artifactSources[CdArtifactSourceInput!]Artifact sources to create for the service, up to 1000.
descriptionStringDescription of the service.
nameString!Name of the service.

CdServiceUpdateInput

Autogenerated input type of CdServiceUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the service.
idCdServiceID!Global ID of the service to update.
nameStringName of the service.

CdVersionCreateInput

Autogenerated input type of CdVersionCreate.

Arguments

NameTypeDescription
artifactSourceIdCdArtifactSourceID!Global ID of the artifact source to create the version for.
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the version.

CdVersionSetCreateInput

Autogenerated input type of CdVersionSetCreate.

Arguments

NameTypeDescription
applicationIdCdApplicationID!Global ID of the application to create the version set in.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the version set.
nameString!Name of the version set.
versionIds[CdVersionID!]!Global IDs of the versions that make up the version set, one per service. A version set must contain at least one version.

CiInputsInput

Attributes for defining an input.

Arguments

NameTypeDescription
destroyBooleanSet to true to delete the input.
nameString!Name of the input.
valueCiInputsValue!Value of the input.

CiJobTokenScopeAddGroupOrProjectInput

Autogenerated input type of CiJobTokenScopeAddGroupOrProject.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
defaultPermissionsBooleanStatus: Experiment. Introduced in GitLab 17.8.

Indicates whether default permissions are enabled (true) or fine-grained permissions are enabled (false).
true
jobTokenPolicies[CiJobTokenScopePolicies!]Status: Experiment. Introduced in GitLab 17.5.

List of policies added to the CI job token scope. Is ignored if job token policies are disabled.
[]
projectPathID!Project that the CI job token scope belongs to.
targetPathID!Group or project to be added to the CI job token scope.

CiJobTokenScopeAddProjectInput

Autogenerated input type of CiJobTokenScopeAddProject.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
directionCiJobTokenScopeDirectionDeprecated in GitLab 16.0. Outbound job token scope is being removed. This field can now only be set to INBOUND.
projectPathID!Project that the CI job token scope belongs to.
targetProjectPathID!Project to be added to the CI job token scope.

CiJobTokenScopeRemoveGroupInput

Autogenerated input type of CiJobTokenScopeRemoveGroup.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Project that the CI job token scope belongs to.
targetGroupPathID!Group to be removed from the CI job token scope.

CiJobTokenScopeRemoveProjectInput

Autogenerated input type of CiJobTokenScopeRemoveProject.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
directionCiJobTokenScopeDirectionDeprecated in GitLab 16.9. Outbound job token scope is being removed. This field can now only be set to INBOUND.
projectPathID!Project that the CI job token scope belongs to.
targetProjectPathID!Project to be removed from the CI job token scope.

CiJobTokenScopeUpdatePoliciesInput

Autogenerated input type of CiJobTokenScopeUpdatePolicies.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
defaultPermissionsBoolean!Indicates whether default permissions are enabled (true) or fine-grained permissions are enabled (false).
jobTokenPolicies[CiJobTokenScopePolicies!]!List of policies added to the CI job token scope.
projectPathID!Project that the CI job token scope belongs to.
targetPathID!Group or project that the CI job token targets.

CiLintInput

Autogenerated input type of CiLint.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
contentString!Contents of .gitlab-ci.yml.
dryRunBooleanRun pipeline creation simulation, or only do static check.
projectPathID!Project of the CI config.
refStringRef to use when linting. Default is the project default branch.

CiVariableInput

Attributes for defining a CI/CD variable.

Arguments

NameTypeDescription
keyString!Name of the variable.
valueString!Value of the variable.
variableTypeCiVariableTypeType of variable.

ClusterAgentDeleteInput

Autogenerated input type of ClusterAgentDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idClustersAgentID!Global ID of the cluster agent that will be deleted.

ClusterAgentTokenCreateInput

Autogenerated input type of ClusterAgentTokenCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterAgentIdClustersAgentID!Global ID of the cluster agent that will be associated with the new token.
descriptionStringDescription of the token.
nameString!Name of the token.

ClusterAgentTokenRevokeInput

Autogenerated input type of ClusterAgentTokenRevoke.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idClustersAgentTokenID!Global ID of the agent token that will be revoked.

ClusterAgentUrlConfigurationCreateInput

Autogenerated input type of ClusterAgentUrlConfigurationCreate.

Arguments

NameTypeDescription
caCertStringBase64-encoded CA certificate in PEM format to verify the agent endpoint.
clientCertStringBase64-encoded client certificate in PEM format if mTLS authentication should be used. Must be provided with client_key.
clientKeyStringBase64-encoded client key in PEM format if mTLS authentication should be used. Must be provided with client_cert.
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterAgentIdClustersAgentID!Global ID of the cluster agent that will be associated with the new URL configuration.
tlsHostStringTLS host name to verify the server name in agent endpoint certificate.
urlString!URL for the new URL configuration.

ClusterAgentUrlConfigurationDeleteInput

Autogenerated input type of ClusterAgentUrlConfigurationDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idClustersAgentsUrlConfigurationID!Global ID of the agent URL configuration that will be deleted.

CommitAction

Arguments

NameTypeDescription
actionCommitActionMode!Action to perform: create, delete, move, update, or chmod.
contentStringContent of the file.
encodingCommitEncodingEncoding of the file. Default is text.
executeFilemodeBooleanEnables/disables the execute flag on the file.
filePathString!Full path to the file.
lastCommitIdStringLast known file commit ID.
previousPathStringOriginal full path to the file being moved.

CommitCreateInput

Autogenerated input type of CommitCreate.

Arguments

NameTypeDescriptionDefault
actions[CommitAction!]Array of action hashes to commit as a batch.[]
allowEmptyBooleanIndicates whether an empty commit can be created. Defaults to false.false
branchString!Name of the branch to commit into, it can be a new branch.
clientMutationIdStringA unique identifier for the client performing the mutation.
messageString!Raw commit message.
projectPathID!Project full path the branch is associated with.
startBranchStringIf on a new branch, name of the original branch.
startProjectPathIDFull path of the project to start the commit from. Must be the project itself or a project it was forked from.
startShaStringSHA of the commit to start the new branch from. Mutually exclusive with startBranch.

ComplianceFrameworkFilters

Arguments

NameTypeDescription
idComplianceManagementFrameworkIDID of the compliance framework.
ids[ComplianceManagementFrameworkID!]IDs of the compliance framework.
notNegatedComplianceFrameworkFiltersNegated compliance framework filter input.
presenceFilterComplianceFrameworkPresenceFilterChecks presence of compliance framework of the project, “none” and “any” values are supported.

ComplianceFrameworkInput

Arguments

NameTypeDescription
colorStringNew color representation of the compliance framework in hex format. e.g. #FCA121.
defaultBooleanSet the compliance framework as the default framework for the group.
descriptionStringNew description for the compliance framework.
nameStringNew name for the compliance framework.
pipelineConfigurationFullPathStringDeprecated in GitLab 17.4. Use pipeline execution policies instead.
projectsComplianceFrameworkProjectInputProjects to add or remove from the compliance framework.

ComplianceFrameworkProjectInput

Arguments

NameTypeDescription
addProjects[Int!]!IDs of the projects to add to the compliance framework.
removeProjects[Int!]!IDs of the projects to remove from the compliance framework.

ComplianceRequirementInput

Arguments

NameTypeDescription
complianceRequirementsControls[ComplianceRequirementsControlInput!]Compliance controls of the compliance requirement.
descriptionStringNew description for the compliance requirement.
nameStringNew name for the compliance requirement.

ComplianceRequirementsControlInput

Arguments

NameTypeDescription
controlTypeStringType of the compliance control.
expressionStringExpression of the compliance control. Derived from the name of the control when omitted for an internal control.
externalControlNameStringName of the external control.
externalUrlStringURL of the external control.
nameString!New name for the compliance requirement control.
pingEnabledBooleanWhether ping is enabled for external controls.
secretTokenStringSecret token for an external control.

ComplianceStandardsAdherenceInput

Arguments

NameTypeDescription
checkNameComplianceStandardsAdherenceCheckNameName of the check for the compliance standard.
projectIds[ProjectID!]Filter compliance standards adherence by project.
standardComplianceStandardsAdherenceStandardName of the compliance standard.

ComplianceStandardsProjectAdherenceInput

Arguments

NameTypeDescription
checkNameComplianceStandardsAdherenceCheckNameName of the check for the compliance standard.
standardComplianceStandardsAdherenceStandardName of the compliance standard.

ComplianceViolationInput

Arguments

NameTypeDescription
mergedAfterDateMerge requests merged after the date (inclusive).
mergedBeforeDateMerge requests merged before the date (inclusive).
projectIds[ProjectID!]Filter compliance violations by project.
targetBranchStringFilter compliance violations by target branch.

ComplianceViolationProjectInput

Arguments

NameTypeDescription
mergedAfterDateMerge requests merged after the date (inclusive).
mergedBeforeDateMerge requests merged before the date (inclusive).
targetBranchStringFilter compliance violations by target branch.

ConfigureContainerScanningInput

Autogenerated input type of ConfigureContainerScanning.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project.

ConfigureDependencyScanningInput

Autogenerated input type of ConfigureDependencyScanning.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project.

ConfigureSastIacInput

Autogenerated input type of ConfigureSastIac.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project.

ConfigureSastInput

Autogenerated input type of ConfigureSast.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
configurationSastCiConfigurationInput!SAST CI configuration for the project.
projectPathID!Full path of the project.

ConfigureSecretDetectionInput

Autogenerated input type of ConfigureSecretDetection.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project.

ContainerCacheEntryDeleteInput

Autogenerated input type of ContainerCacheEntryDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idString!ID of the cache entry.

ContainerUpstreamCacheDeleteInput

Autogenerated input type of ContainerUpstreamCacheDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesContainerUpstreamID!ID of the container virtual registry upstream.

ContainerUpstreamCreateInput

Autogenerated input type of ContainerUpstreamCreate.

Arguments

NameTypeDescriptionDefault
cacheValidityHoursIntCache validity period. Defaults to 24 hours.24
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the upstream registry.
idVirtualRegistriesContainerRegistryID!ID of the upstream registry.
nameString!Name of upstream registry.
passwordStringPassword of the upstream registry.
urlString!URL of the upstream registry.
usernameStringUsername of the upstream registry.

ContainerUpstreamDeleteInput

Autogenerated input type of ContainerUpstreamDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesContainerUpstreamID!ID of the upstream to be deleted.

ContainerUpstreamTestInput

Autogenerated input type of ContainerUpstreamTest.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathIDFull path of the group to test the upstream registry against. Required when id is not provided.
idVirtualRegistriesContainerUpstreamIDID of the upstream registry to test. When provided, groupPath, url, username, and password are ignored.
passwordStringPassword for authenticating with the upstream registry. Used when id is not provided.
urlStringURL of the upstream registry to test. Required when GraphqlExplorerControllerid is not provided.
usernameStringUsername for authenticating with the upstream registry. Used when id is not provided.

ContainerUpstreamUpdateInput

Autogenerated input type of ContainerUpstreamUpdate.

Arguments

NameTypeDescription
cacheValidityHoursIntCache validity period.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the upstream registry.
idVirtualRegistriesContainerUpstreamID!ID of the container virtual registry upstream.
nameStringName of upstream registry.
passwordStringPassword of the upstream registry.
urlStringURL of the upstream registry.
usernameStringUsername of the upstream registry.

ContainerVirtualRegistryCacheDeleteInput

Autogenerated input type of ContainerVirtualRegistryCacheDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesContainerRegistryID!ID of the container virtual registry.

ContainerVirtualRegistryCreateInput

Autogenerated input type of ContainerVirtualRegistryCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the virtual registry.
groupPathIDFull path of the group with which the resource is associated.
nameString!Name of virtual registry.

ContainerVirtualRegistryDeleteInput

Autogenerated input type of ContainerVirtualRegistryDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesContainerRegistryID!ID of the container virtual registry to be deleted.

ContainerVirtualRegistryUpdateInput

Autogenerated input type of ContainerVirtualRegistryUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the virtual registry.
idVirtualRegistriesContainerRegistryID!ID of the container virtual registry to be updated.
nameStringName of virtual registry.

ContainerVirtualRegistryUpstreamCreateInput

Autogenerated input type of ContainerVirtualRegistryUpstreamCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
registryIdVirtualRegistriesContainerRegistryID!ID of the container virtual registry.
upstreamIdVirtualRegistriesContainerUpstreamID!ID of the upstream.

ContainerVirtualRegistryUpstreamDeleteInput

Autogenerated input type of ContainerVirtualRegistryUpstreamDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
upstreamIdVirtualRegistriesContainerRegistryUpstreamID!ID of the container virtual registry upstream.

ContainerVirtualRegistryUpstreamUpdateInput

Autogenerated input type of ContainerVirtualRegistryUpstreamUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesContainerRegistryUpstreamID!ID of the container virtual registry upstream.
positionInt!Priority order of an upstream within a virtual registry.

CorpusCreateInput

Autogenerated input type of CorpusCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Project the corpus belongs to.
packageIdPackagesPackageID!ID of the corpus package.

CreateAlertIssueInput

Autogenerated input type of CreateAlertIssue.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the alert to mutate.
projectPathID!Project the alert to mutate is in.

CreateAnnotationInput

Autogenerated input type of CreateAnnotation.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterIdClustersClusterIDGlobal ID of the cluster to add an annotation to.
dashboardPathString!Path to a file defining the dashboard on which the annotation should be added.
descriptionString!Description of the annotation.
endingAtTimeTimestamp indicating ending moment to which the annotation relates.
environmentIdEnvironmentIDGlobal ID of the environment to add an annotation to.
startingAtTime!Timestamp indicating starting moment to which the annotation relates.

CreateBoardInput

Autogenerated input type of CreateBoard.

Arguments

NameTypeDescription
assigneeIdUserIDID of user to be assigned to the board.
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathIDFull path of the group with which the resource is associated.
hideBacklogListBooleanWhether or not backlog list is hidden.
hideClosedListBooleanWhether or not closed list is hidden.
iterationCadenceIdIterationsCadenceIDID of iteration cadence to be assigned to the board.
iterationIdIterationIDID 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.
milestoneIdMilestoneIDID of milestone to be assigned to the board.
nameStringBoard name.
projectPathIDFull path of the project with which the resource is associated.
weightIntWeight value to be assigned to the board.

CreateBranchInput

Autogenerated input type of CreateBranch.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the branch.
projectPathID!Project full path the branch is associated with.
refString!Branch name or commit SHA to create branch from.

CreateClusterAgentInput

Autogenerated input type of CreateClusterAgent.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the cluster agent.
projectPathID!Full path of the associated project for the cluster agent.

CreateComplianceFrameworkFromTemplateInput

Autogenerated input type of CreateComplianceFrameworkFromTemplate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
colorStringOverride the color of the compliance framework in hex format. e.g. #FCA121.
defaultBooleanSet the compliance framework as the default framework for the group.
descriptionStringOverride the description of the compliance framework.
nameStringOverride the name of the compliance framework.
namespacePathID!Full path of the namespace to add the compliance framework to.
templateIdComplianceManagementFrameworksTemplateRegistryTemplateID!Unique identifier of the template to create the framework from.

CreateComplianceFrameworkInput

Autogenerated input type of CreateComplianceFramework.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespacePathID!Full path of the namespace to add the compliance framework to.
paramsComplianceFrameworkInput!Parameters to update the compliance framework with.

CreateComplianceRequirementInput

Autogenerated input type of CreateComplianceRequirement.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
complianceFrameworkIdComplianceManagementFrameworkID!Global ID of the compliance framework of the new requirement.
controls[ComplianceRequirementsControlInput!]Controls to add to the compliance requirement.
paramsComplianceRequirementInput!Parameters to update the compliance requirement with.

CreateComplianceRequirementsControlInput

Autogenerated input type of CreateComplianceRequirementsControl.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
complianceRequirementIdComplianceManagementComplianceFrameworkComplianceRequirementID!Global ID of the compliance requirement of the new control.
paramsComplianceRequirementsControlInput!Parameters to create the compliance requirement control.

CreateContainerProtectionRepositoryRuleInput

Autogenerated input type of CreateContainerProtectionRepositoryRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
minimumAccessLevelForDeleteContainerProtectionRepositoryRuleAccessLevelStatus: Experiment. Introduced in GitLab 17.11.

Minimum GitLab access level required to delete container images from the container repository. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, the default minimum access level is DEVELOPER. Valid only when feature flag container_registry_protected_containers_delete is enabled.
minimumAccessLevelForPushContainerProtectionRepositoryRuleAccessLevelMinimum GitLab access level required to push container images to the container repository. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, the default minimum access level is DEVELOPER.
projectPathID!Full path of the project where a protection rule is located.
repositoryPathPatternString!Container repository path pattern protected by the protection rule. Must start with the project’s full path. For example: my-project/*-prod-*. Wildcard character * is allowed anywhere after the project’s full path.

CreateCustomDashboardInput

Autogenerated input type of CreateCustomDashboard.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
configCustomDashboardConfigInput!Dashboard layout/config.
descriptionStringDashboard description.
nameString!Dashboard name.
namespaceIdNamespaceIDNamespace to scope the dashboard to.
organizationIdOrganizationsOrganizationIDOrganization the dashboard belongs to. Defaults to the current organization if not provided.

CreateCustomEmojiInput

Autogenerated input type of CreateCustomEmoji.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Namespace full path the emoji is associated with.
nameString!Name of the emoji.
urlString!Location of the emoji file.

CreateDiffNoteInput

Autogenerated input type of CreateDiffNote.

Arguments

NameTypeDescription
bodyString!Content of the note.
clientMutationIdStringA unique identifier for the client performing the mutation.
internalBooleanInternal flag for a note. Default is false.
noteableIdNoteableID!Global ID of the resource to add a note to.
positionDiffPositionInput!Position of the note on a diff.

CreateDiscussionInput

Autogenerated input type of CreateDiscussion.

Arguments

NameTypeDescription
bodyString!Content of the note.
clientMutationIdStringA unique identifier for the client performing the mutation.
internalBooleanInternal flag for a note. Default is false.
noteableIdNoteableID!Global ID of the resource to add a note to.

CreateEpicInput

Autogenerated input type of CreateEpic.

Arguments

NameTypeDescription
addLabelIds[ID!]IDs of labels to be added to the epic.
addLabels[String!]Array of labels to be added to the epic.
clientMutationIdStringA unique identifier for the client performing the mutation.
colorColorColor of the epic.
confidentialBooleanIndicates if the epic is confidential.
descriptionStringDescription of the epic.
dueDateFixedStringEnd date of the epic.
dueDateIsFixedBooleanIndicates end date should be sourced from due_date_fixed field not the issue milestones.
groupPathID!Group the epic to mutate is in.
removeLabelIds[ID!]IDs of labels to be removed from the epic.
startDateFixedStringStart date of the epic.
startDateIsFixedBooleanIndicates start date should be sourced from start_date_fixed field not the issue milestones.
titleStringTitle of the epic.

CreateImageDiffNoteInput

Autogenerated input type of CreateImageDiffNote.

Arguments

NameTypeDescription
bodyString!Content of the note.
clientMutationIdStringA unique identifier for the client performing the mutation.
internalBooleanInternal flag for a note. Default is false.
noteableIdNoteableID!Global ID of the resource to add a note to.
positionDiffImagePositionInput!Position of the note on a diff.

CreateIssueInput

Autogenerated input type of CreateIssue.

Arguments

NameTypeDescription
assigneeIds[UserID!]Array of user IDs to assign to the issue.
clientMutationIdStringA unique identifier for the client performing the mutation.
confidentialBooleanIndicates the issue is confidential.
createdAtTimeTimestamp when the issue was created. Available only for admins and project owners.
descriptionStringDescription of the issue.
discussionToResolveStringID of a discussion to resolve. Also pass merge_request_to_resolve_discussions_of.
dueDateISO8601DateDue date of the issue.
epicIdEpicIDDeprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
healthStatusHealthStatusDesired health status.
iidIntIID (internal ID) of a project issue. Only admins and project owners can modify.
iterationCadenceIdIterationsCadenceIDGlobal iteration cadence ID. Required when iterationWildcardId is provided.
iterationIdIterationIDGlobal iteration ID. Mutually exclusive argument with iterationWildcardId.
iterationWildcardIdIssueCreationIterationWildcardIdIteration 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.
lockedBooleanIndicates discussion is locked on the issue.
mergeRequestToResolveDiscussionsOfMergeRequestIDIID of a merge request for which to resolve discussions.
milestoneIdMilestoneIDID of the milestone to assign to the issue. On update milestone will be removed if set to null.
moveAfterIdIssueIDGlobal ID of issue that should be placed after the current issue.
moveBeforeIdIssueIDGlobal ID of issue that should be placed before the current issue.
projectPathID!Project full path the issue is associated with.
statusIdWorkItemsStatusesStatusIDGlobal ID of the status.
titleString!Title of the issue.
typeIssueTypeType of the issue.
weightIntWeight of the issue.

CreateIterationInput

Autogenerated input type of CreateIteration.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the iteration.
dueDateStringEnd date of the iteration.
groupPathIDFull path of the group with which the resource is associated.
iterationsCadenceIdIterationsCadenceIDGlobal ID of the iteration cadence to be assigned to the new iteration.
projectPathIDFull path of the project with which the resource is associated.
startDateStringStart date of the iteration.
titleStringTitle of the iteration.

CreateLatestDiffNoteInput

Autogenerated input type of CreateLatestDiffNote.

Arguments

NameTypeDescription
bodyString!Content of the note.
clientMutationIdStringA unique identifier for the client performing the mutation.
endNewLineIntEnd line number on the new version of the file for a multiline note. When provided, newLine is required and marks the start of the comment range.
endOldLineIntEnd line number on the old version of the file for a multiline note. When provided, oldLine is required and marks the start of the comment range.
filePathString!Path of the file to comment on. For renamed files, either the old or new path can be used.
headShaString!HEAD SHA of the merge request diff. The request fails if it does not match the current diff, guarding against commenting on a stale diff.
internalBooleanInternal flag for a note. Default is false.
newLineIntLine number on the new version of the file. Use alone for added lines, with oldLine for unchanged context lines. At least one of newLine or oldLine is required.
noteableIdMergeRequestID!Global ID of the merge request to add a diff note to.
oldLineIntLine number on the old version of the file. Use alone for removed lines, with newLine for unchanged context lines. At least one of newLine or oldLine is required.

CreateNoteInput

Autogenerated input type of CreateNote.

Arguments

NameTypeDescription
bodyString!Content of the note.
clientMutationIdStringA unique identifier for the client performing the mutation.
discussionIdDiscussionIDGlobal ID of the discussion the note is in reply to.
internalBooleanInternal flag for a note. Default is false.
mergeRequestDiffHeadShaStringSHA of the head commit which is used to ensure that the merge request has not been updated since the request was sent.
noteableIdNoteableID!Global ID of the resource to add a note to.

CreatePackagesProtectionRuleInput

Autogenerated input type of CreatePackagesProtectionRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
minimumAccessLevelForDeletePackagesProtectionRuleAccessLevelForDeleteStatus: Experiment. Introduced in GitLab 17.10.

Minimum GitLab access required to delete packages from the package registry. Valid values include OWNER or ADMIN. If the value is nil, the default minimum access level is MAINTAINER. Available only when feature flag packages_protected_packages_delete is enabled.
minimumAccessLevelForPushPackagesProtectionRuleAccessLevelMinimum GitLab access required to push packages to the package registry. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, the default minimum access level is DEVELOPER.
packageNamePatternString!Package name protected by the protection rule. For example, @my-scope/my-package-*. Wildcard character * allowed.
packageTypePackagesProtectionRulePackageType!Package type protected by the protection rule. For example, NPM, PYPI.
projectPathID!Full path of the project where a protection rule is located.

CreateRequirementInput

Autogenerated input type of CreateRequirement.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the requirement.
projectPathID!Full project path the requirement is associated with.
titleStringTitle of the requirement.

CreateSnippetInput

Autogenerated input type of CreateSnippet.

Arguments

NameTypeDescription
blobActions[SnippetBlobActionInputType!]Actions to perform over the snippet repository and blobs.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the snippet.
projectPathIDFull path of the project the snippet is associated with.
titleString!Title of the snippet.
uploadedFiles[String!]Paths to files uploaded in the snippet description.
visibilityLevelVisibilityLevelsEnum!Visibility level of the snippet.

CreateTerraformStateProtectionRuleInput

Autogenerated input type of CreateTerraformStateProtectionRule.

Arguments

NameTypeDescriptionDefault
allowedFromTerraformStateProtectionRuleAllowedFromStatus: Experiment. Introduced in GitLab 19.1.

Restriction on the source of write requests. ANYWHERE allows all sources, CI_ONLY requires a CI job token, CI_ON_PROTECTED_BRANCH_ONLY requires a CI job on a protected branch.
ANYWHERE
clientMutationIdStringA unique identifier for the client performing the mutation.
minimumAccessLevelForWriteTerraformStateProtectionRuleAccessLevel!Minimum GitLab access level required to perform write operations on the Terraform state. Valid values include DEVELOPER, MAINTAINER, OWNER, or ADMIN.
projectPathID!Full path of the project where the protection rule is located.
stateNameString!Terraform state name protected by the rule.

CreateTestCaseInput

Autogenerated input type of CreateTestCase.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
confidentialBooleanSets the test case confidentiality.
descriptionStringTest case description.
labelIds[ID!]IDs of labels to be added to the test case.
projectPathID!Project full path to create the test case in.
titleString!Test case title.

CreateValueStreamStageInput

Attributes to create value stream stage.

Arguments

NameTypeDescriptionDefault
customBooleanWhether the stage is customized. If false, it assigns a built-in default stage by name.true
endEventIdentifierValueStreamStageEventEnd event identifier.
endEventLabelIdLabelIDLabel ID associated with the end event identifier.
hiddenBooleanWhether the stage is hidden.
nameString!Name of the stage.
startEventIdentifierValueStreamStageEventStart event identifier.
startEventLabelIdLabelIDLabel ID associated with the start event identifier.

CustomDashboardConfigInput

Configuration input for a custom analytics dashboard.

Arguments

NameTypeDescription
descriptionStringDescription of the dashboard.
filtersCustomDashboardFiltersInputFilter controls available on the dashboard.
gridHeightCustomDashboardGridHeightGrid height display mode.
panels[CustomDashboardPanelInput!]!Panels to display on the dashboard.
statusCustomDashboardStatusMaturity status of the dashboard.
titleString!Display title of the dashboard.

CustomDashboardDateRangeFilterInput

Date range filter configuration for the dashboard.

Arguments

NameTypeDescription
defaultOptionCustomDashboardDateRangeOptionDefault selected date range option.
enabledBooleanWhether the date range filter is enabled.
numberOfDaysLimitFloatMaximum number of days allowed in a custom range.
options[CustomDashboardDateRangeOption!]Preset date range options to display.

CustomDashboardFilterInput

Toggleable dashboard-level filter.

Arguments

NameTypeDescription
enabledBooleanWhether the filter is enabled.

CustomDashboardFilteredSearchFilterInput

Filtered search filter configuration for the dashboard.

Arguments

NameTypeDescription
enabledBooleanWhether filtered search is enabled.
options[CustomDashboardFilteredSearchFilterOptionInput!]Token options available in the filtered search.

CustomDashboardFilteredSearchFilterOptionInput

Configuration for a single filtered search token.

Arguments

NameTypeDescription
maxSuggestionsFloatMaximum number of suggestions to display.
operatorCustomDashboardFilteredSearchOperatorComparison operator for the token.
tokenCustomDashboardFilteredSearchToken!Token type for the filter option.
uniqueBooleanWhether only one value can be selected for the token.

CustomDashboardFiltersInput

Filter controls available on the dashboard.

Arguments

NameTypeDescription
dateRangeCustomDashboardDateRangeFilterInputDate range filter configuration.
excludeAnonymousUsersCustomDashboardFilterInputFilter to exclude anonymous users from metrics.
filteredSearchCustomDashboardFilteredSearchFilterInputFiltered search configuration.
projectsCustomDashboardFilterInputProject filter configuration.

CustomDashboardGridAttributesInput

Position and size of a panel within the dashboard grid.

Arguments

NameTypeDescription
heightInt!Number of grid rows the panel spans.
maxHeightIntMaximum height the panel can be resized to.
maxWidthIntMaximum width the panel can be resized to.
minHeightIntMinimum height the panel can be resized to.
minWidthIntMinimum width the panel can be resized to.
widthInt!Number of grid columns the panel spans.
xPosIntHorizontal grid position of the panel.
yPosIntVertical grid position of the panel.

CustomDashboardPanelInput

Single panel within a custom dashboard.

Arguments

NameTypeDescription
gridAttributesCustomDashboardGridAttributesInput!Grid position and size of the panel.
optionsCustomDashboardPanelOptionsInputDisplay options for the panel.
queryOverridesCustomDashboardQueryOverridesInputQuery overrides applied to the visualization.
titleString!Display title of the panel.
tooltipCustomDashboardTooltipInputTooltip for the panel.
visualizationStringID of an existing visualization to render.
visualizationConfigJSONInline visualization config object to render.

CustomDashboardPanelOptionsInput

Display options for a dashboard panel.

Arguments

NameTypeDescription
decimalPlacesIntNumber of decimal places to display for numeric values.

CustomDashboardQueryFiltersInput

Filters applied to the underlying visualization query.

Arguments

NameTypeDescription
excludeMetrics[String!]Metrics to exclude from the query.
include[String!]Additional include filters.
includeMetrics[String!]Metrics to include in the query.
labels[String!]Labels to filter by.
projectTopics[String!]Project topics to filter by.

CustomDashboardQueryOverridesInput

Overrides applied to the visualization query at the panel level.

Arguments

NameTypeDescription
filtersCustomDashboardQueryFiltersInputQuery filter overrides.
namespaceStringNamespace override for the query.
timeDimensionsJSONTime dimension overrides for the query.

CustomDashboardTooltipInput

Tooltip displayed on a dashboard panel.

Arguments

NameTypeDescription
descriptionString!Tooltip text. Must include %{linkStart} and %{linkEnd} if descriptionLink is set.
descriptionLinkStringURI linked from within the tooltip description.

CustomFieldArchiveInput

Autogenerated input type of CustomFieldArchive.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIssuablesCustomFieldID!Global ID of the custom field.

CustomFieldCreateInput

Autogenerated input type of CustomFieldCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fieldTypeCustomFieldType!Type of custom field.
groupPathID!Group path where the custom field is created.
nameString!Name of the custom field.
selectOptions[CustomFieldSelectOptionInput!]Available options for a select field.
workItemTypeIds[WorkItemsTypeID!]Work item type global IDs associated to the custom field.

CustomFieldSelectOptionInput

Attributes for the custom field select option.

Arguments

NameTypeDescription
idIssuablesCustomFieldSelectOptionIDGlobal ID of the custom field select option to update. Creates a new record if not provided.
valueString!Value of the custom field select option.

CustomFieldUnarchiveInput

Autogenerated input type of CustomFieldUnarchive.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIssuablesCustomFieldID!Global ID of the custom field.

CustomFieldUpdateInput

Autogenerated input type of CustomFieldUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIssuablesCustomFieldID!Global ID of the custom field.
nameStringName of the custom field.
selectOptions[CustomFieldSelectOptionInput!]Available options for a select field.
workItemTypeIds[WorkItemsTypeID!]Work item type global IDs associated to the custom field.

CustomerRelationsContactCreateInput

Autogenerated input type of CustomerRelationsContactCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of or notes for the contact.
emailStringEmail address of the contact.
firstNameString!First name of the contact.
groupIdGroupID!Group for the contact.
lastNameString!Last name of the contact.
organizationIdCustomerRelationsOrganizationIDOrganization for the contact.
phoneStringPhone number of the contact.

CustomerRelationsContactUpdateInput

Autogenerated input type of CustomerRelationsContactUpdate.

Arguments

NameTypeDescription
activeBooleanState of the contact.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of or notes for the contact.
emailStringEmail address of the contact.
firstNameStringFirst name of the contact.
idCustomerRelationsContactID!Global ID of the contact.
lastNameStringLast name of the contact.
organizationIdCustomerRelationsOrganizationIDOrganization of the contact.
phoneStringPhone number of the contact.

CustomerRelationsOrganizationCreateInput

Autogenerated input type of CustomerRelationsOrganizationCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
defaultRateFloatStandard billing rate for the organization.
descriptionStringDescription of or notes for the organization.
groupIdGroupID!Group for the organization.
nameString!Name of the organization.

CustomerRelationsOrganizationUpdateInput

Autogenerated input type of CustomerRelationsOrganizationUpdate.

Arguments

NameTypeDescription
activeBooleanState of the organization.
clientMutationIdStringA unique identifier for the client performing the mutation.
defaultRateFloatStandard billing rate for the organization.
descriptionStringDescription of or notes for the organization.
idCustomerRelationsOrganizationID!Global ID of the organization.
nameStringName of the organization.

DastOnDemandScanCreateInput

Autogenerated input type of DastOnDemandScanCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
dastScannerProfileIdDastScannerProfileIDID of the scanner profile to be used for the scan.
dastSiteProfileIdDastSiteProfileID!ID of the site profile to be used for the scan.
fullPathID!Project the site profile belongs to.

DastProfileCadenceInput

Represents DAST Profile Cadence.

Arguments

NameTypeDescription
durationIntDuration of the DAST Profile Cadence.
unitDastProfileCadenceUnitUnit for the duration of DAST Profile Cadence.

DastProfileCreateInput

Autogenerated input type of DastProfileCreate.

Arguments

NameTypeDescriptionDefault
branchNameStringAssociated branch.
clientMutationIdStringA unique identifier for the client performing the mutation.
dastProfileScheduleDastProfileScheduleInputRepresents a DAST Profile Schedule.
dastScannerProfileIdDastScannerProfileID!ID of the scanner profile to be associated.
dastSiteProfileIdDastSiteProfileID!ID of the site profile to be associated.
descriptionStringDescription of the profile. Defaults to an empty string.""
fullPathID!Project the profile belongs to.
nameString!Name of the profile.
runAfterCreateBooleanRun scan using profile after creation. Defaults to false.false
tagList[String!]Indicates the runner tags associated with the profile.

DastProfileDeleteInput

Autogenerated input type of DastProfileDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idDastProfileID!ID of the profile to be deleted.

DastProfileRunInput

Autogenerated input type of DastProfileRun.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathIDDeprecated in GitLab 14.5. Full path not required to qualify Global ID.
idDastProfileID!ID of the profile to be used for the scan.

DastProfileScheduleInput

Input type for DAST Profile Schedules.

Arguments

NameTypeDescription
activeBooleanStatus of a Dast Profile Schedule.
cadenceDastProfileCadenceInputCadence of a Dast Profile Schedule.
startsAtTimeStart time of a Dast Profile Schedule.
timezoneStringTime Zone for the Start time of a Dast Profile Schedule.

DastProfileUpdateInput

Autogenerated input type of DastProfileUpdate.

Arguments

NameTypeDescriptionDefault
branchNameStringAssociated branch.
clientMutationIdStringA unique identifier for the client performing the mutation.
dastProfileScheduleDastProfileScheduleInputRepresents a DAST profile schedule.
dastScannerProfileIdDastScannerProfileIDID of the scanner profile to be associated.
dastSiteProfileIdDastSiteProfileIDID of the site profile to be associated.
descriptionStringDescription of the profile. Defaults to an empty string.""
fullPathIDDeprecated in GitLab 14.5. Full path not required to qualify Global ID.
idDastProfileID!ID of the profile to be deleted.
nameStringName of the profile.
runAfterUpdateBooleanRun scan using profile after update. Defaults to false.false
tagList[String!]Indicates the runner tags associated with the profile.

DastScannerProfileCreateInput

Autogenerated input type of DastScannerProfileCreate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Project the scanner profile belongs to.
profileNameString!Name of the scanner profile.
scanTypeDastScanTypeEnumIndicates the type of DAST scan that will run. Either a Passive Scan or an Active Scan.PASSIVE
showDebugMessagesBooleanIndicates if debug messages should be included in DAST console output. True to include the debug messages.false
spiderTimeoutIntMaximum number of minutes allowed for the spider to traverse the site.
tagList[String!]Deprecated in GitLab 15.8. Moved to DastProfile.
targetTimeoutIntMaximum number of seconds allowed for the site under test to respond to a request.
useAjaxSpiderBooleanIndicates if the AJAX spider should be used to crawl the target site. True to run the AJAX spider in addition to the traditional spider, and false to run only the traditional spider.false

DastScannerProfileDeleteInput

Autogenerated input type of DastScannerProfileDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathIDDeprecated in GitLab 14.5. Full path not required to qualify Global ID.
idDastScannerProfileID!ID of the scanner profile to be deleted.

DastScannerProfileUpdateInput

Autogenerated input type of DastScannerProfileUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathIDDeprecated in GitLab 14.5. Full path not required to qualify Global ID.
idDastScannerProfileID!ID of the scanner profile to be updated.
profileNameString!Name of the scanner profile.
scanTypeDastScanTypeEnumIndicates the type of DAST scan that will run. Either a Passive Scan or an Active Scan.
showDebugMessagesBooleanIndicates if debug messages should be included in DAST console output. True to include the debug messages.
spiderTimeoutInt!Maximum number of minutes allowed for the spider to traverse the site.
tagList[String!]Deprecated in GitLab 15.8. Moved to DastProfile.
targetTimeoutInt!Maximum number of seconds allowed for the site under test to respond to a request.
useAjaxSpiderBooleanIndicates if the AJAX spider should be used to crawl the target site. True to run the AJAX spider in addition to the traditional spider, and false to run only the traditional spider.

DastSiteProfileAuthInput

Input type for DastSiteProfile authentication.

Arguments

NameTypeDescription
enabledBooleanIndicates whether authentication is enabled.
passwordStringPassword to authenticate with on the target.
passwordFieldStringName of password field at the sign-in HTML form.
submitFieldStringName or ID of sign-in submit button at the sign-in HTML form.
urlStringThe URL of the page containing the sign-in HTML form on the target website.
usernameStringUsername to authenticate with on the target.
usernameFieldStringName of username field at the sign-in HTML form.

DastSiteProfileCreateInput

Autogenerated input type of DastSiteProfileCreate.

Arguments

NameTypeDescriptionDefault
authDastSiteProfileAuthInputParameters for authentication.
clientMutationIdStringA unique identifier for the client performing the mutation.
excludedUrls[String!]URLs to skip during an authenticated scan. Defaults to [].[]
fullPathID!Project the site profile belongs to.
optionalVariables[JSON!]Optional variables that can be configured for DAST scans.[]
profileNameString!Name of the site profile.
requestHeadersStringComma-separated list of request header names and values to be added to every request made by DAST.
scanFilePathStringFile Path or URL used as input for the scan method.
scanMethodDastScanMethodTypeScan method by the scanner.
targetTypeDastTargetTypeEnumType of target to be scanned.
targetUrlStringURL of the target to be scanned.

DastSiteProfileDeleteInput

Autogenerated input type of DastSiteProfileDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathIDDeprecated in GitLab 14.5. Full path not required to qualify Global ID.
idDastSiteProfileID!ID of the site profile to be deleted.

DastSiteProfileUpdateInput

Autogenerated input type of DastSiteProfileUpdate.

Arguments

NameTypeDescription
authDastSiteProfileAuthInputParameters for authentication.
clientMutationIdStringA unique identifier for the client performing the mutation.
excludedUrls[String!]URLs to skip during an authenticated scan.
fullPathIDDeprecated in GitLab 14.5. Full path not required to qualify Global ID.
idDastSiteProfileID!ID of the site profile to be updated.
optionalVariables[JSON!]Optional variables that can be configured for DAST scans.
profileNameString!Name of the site profile.
requestHeadersStringComma-separated list of request header names and values to be added to every request made by DAST.
scanFilePathStringFile Path or URL used as input for the scan method.
scanMethodDastScanMethodTypeScan method by the scanner.
targetTypeDastTargetTypeEnumType of target to be scanned.
targetUrlStringURL of the target to be scanned.

DastSiteTokenCreateInput

Autogenerated input type of DastSiteTokenCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Project the site token belongs to.
targetUrlStringURL of the target to be validated.

DastSiteValidationCreateInput

Autogenerated input type of DastSiteValidationCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
dastSiteTokenIdDastSiteTokenID!ID of the site token.
fullPathID!Project the site profile belongs to.
strategyDastSiteValidationStrategyEnumValidation strategy to be used.
validationPathString!Path to be requested during validation.

DastSiteValidationRevokeInput

Autogenerated input type of DastSiteValidationRevoke.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Project the site validation belongs to.
normalizedTargetUrlString!Normalized URL of the target to be revoked.

DeleteAnnotationInput

Autogenerated input type of DeleteAnnotation.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idString!Global ID of the annotation to delete.

DeleteContainerProtectionRepositoryRuleInput

Autogenerated input type of DeleteContainerProtectionRepositoryRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idContainerRegistryProtectionRuleID!Global ID of the container repository protection rule to delete.

DeleteContainerProtectionTagRuleInput

Autogenerated input type of DeleteContainerProtectionTagRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idContainerRegistryProtectionTagRuleID!Global ID of the tag protection rule to delete.

DeleteConversationThreadInput

Autogenerated input type of DeleteConversationThread.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
threadIdAiConversationThreadID!Global ID of the thread to delete.

DeleteCustomDashboardInput

Autogenerated input type of DeleteCustomDashboard.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAnalyticsCustomDashboardsDashboardID!Global ID of the dashboard to delete.

DeleteDuoWorkflowsWorkflowInput

Autogenerated input type of DeleteDuoWorkflowsWorkflow.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
workflowIdAiDuoWorkflowsWorkflowID!Global ID of the workflow to delete.

DeleteGroupCustomAttributeInput

Autogenerated input type of DeleteGroupCustomAttribute.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Full path of the group.
keyString!Key of the custom attribute to delete.

DeletePackagesProtectionRuleInput

Autogenerated input type of DeletePackagesProtectionRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idPackagesProtectionRuleID!Global ID of the package protection rule to delete.

DeletePagesDeploymentInput

Autogenerated input type of DeletePagesDeployment.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idPagesDeploymentID!ID of the Pages Deployment.

DeleteProjectCustomAttributeInput

Autogenerated input type of DeleteProjectCustomAttribute.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
keyString!Key of the custom attribute to delete.
projectPathID!Full path of the project.

DeleteTerraformStateProtectionRuleInput

Autogenerated input type of DeleteTerraformStateProtectionRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idTerraformStateProtectionRuleID!Global ID of the Terraform state protection rule to delete.

DeleteUserCustomAttributeInput

Autogenerated input type of DeleteUserCustomAttribute.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
keyString!Key of the custom attribute to delete.
userIdUserID!Global ID of the user.

DeploymentsOrderByInput

Values for ordering deployments by a specific field.

Arguments

NameTypeDescription
createdAtSortDirectionEnumOrder by Created time.
finishedAtSortDirectionEnumOrder by Finished time.

DesignManagementDeleteInput

Autogenerated input type of DesignManagementDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
filenames[String!]!Filenames of the designs to delete.
iidID!IID of the issue to modify designs for.
projectPathID!Project where the issue is to upload designs for.

DesignManagementMoveInput

Autogenerated input type of DesignManagementMove.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idDesignManagementDesignID!ID of the design to move.
nextDesignManagementDesignIDID of the immediately following design.
previousDesignManagementDesignIDID of the immediately preceding design.

DesignManagementUpdateInput

Autogenerated input type of DesignManagementUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the design.
idDesignManagementDesignID!ID of the design to update.

DesignManagementUploadInput

Autogenerated input type of DesignManagementUpload.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
files[Upload!]!Files to upload.
iidID!IID of the issue to modify designs for.
projectPathID!Project where the issue is to upload designs for.

DestroyBoardInput

Autogenerated input type of DestroyBoard.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idBoardID!Global ID of the board to destroy.

DestroyBoardListInput

Autogenerated input type of DestroyBoardList.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
listIdListID!Global ID of the list to destroy. Only label lists are accepted.

DestroyComplianceFrameworkInput

Autogenerated input type of DestroyComplianceFramework.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idComplianceManagementFrameworkID!Global ID of the compliance framework to destroy.

DestroyComplianceRequirementInput

Autogenerated input type of DestroyComplianceRequirement.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idComplianceManagementComplianceFrameworkComplianceRequirementID!Global ID of the compliance requirement to destroy.

DestroyComplianceRequirementsControlInput

Autogenerated input type of DestroyComplianceRequirementsControl.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idComplianceManagementComplianceFrameworkComplianceRequirementsControlID!Global ID of the compliance requirement control to destroy.

DestroyContainerRepositoryInput

Autogenerated input type of DestroyContainerRepository.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idContainerRepositoryID!ID of the container repository.

DestroyContainerRepositoryTagsInput

Autogenerated input type of DestroyContainerRepositoryTags.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idContainerRepositoryID!ID of the container repository.
tagNames[String!]!Container repository tag(s) to delete. Total number can’t be greater than 20.

DestroyCustomEmojiInput

Autogenerated input type of DestroyCustomEmoji.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCustomEmojiID!Global ID of the custom emoji to destroy.

DestroyEpicBoardInput

Autogenerated input type of DestroyEpicBoard.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idBoardsEpicBoardID!Global ID of the board to destroy.

DestroyNoteInput

Autogenerated input type of DestroyNote.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idNoteID!Global ID of the note to destroy.

DestroyPackageFileInput

Autogenerated input type of DestroyPackageFile.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idPackagesPackageFileID!ID of the Package file.

DestroyPackageFilesInput

Autogenerated input type of DestroyPackageFiles.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[PackagesPackageFileID!]!IDs of the Package file.
projectPathID!Project path where the packages cleanup policy is located.

DestroyPackageInput

Autogenerated input type of DestroyPackage.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idPackagesPackageID!ID of the Package.

DestroyPackagesInput

Autogenerated input type of DestroyPackages.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[PackagesPackageID!]!Global IDs of the Packages. Max 100.

DestroySnippetInput

Autogenerated input type of DestroySnippet.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idSnippetID!Global ID of the snippet to destroy.

DevfileValidateInput

Autogenerated input type of DevfileValidate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
devfileYamlString!Input devfile.

DiffImagePositionInput

Arguments

NameTypeDescription
baseShaStringMerge base of the branch the comment was made on.
headShaString!SHA of the HEAD at the time the comment was made.
heightInt!Total height of the image.
pathsDiffPathsInput!The paths of the file that was changed. Both of the properties of this input are optional, but at least one of them is required.
startShaString!SHA of the branch being compared against.
widthInt!Total width of the image.
xInt!X position of the note.
yInt!Y position of the note.

DiffPathsInput

Arguments

NameTypeDescription
newPathStringPath of the file on the HEAD SHA.
oldPathStringPath of the file on the start SHA.

DiffPositionInput

Arguments

NameTypeDescription
baseShaStringMerge base of the branch the comment was made on.
headShaString!SHA of the HEAD at the time the comment was made.
newLineIntLine on HEAD SHA that was changed. Please see the REST API Documentation for more information on how to use this field.
oldLineIntLine on start SHA that was changed. Please see the REST API Documentation for more information on how to use this field.
pathsDiffPathsInput!The paths of the file that was changed. Both of the properties of this input are optional, but at least one of them is required.
startShaString!SHA of the branch being compared against.

DisableDevopsAdoptionNamespaceInput

Autogenerated input type of DisableDevopsAdoptionNamespace.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
id[AnalyticsDevopsAdoptionEnabledNamespaceID!]!One or many IDs of the enabled namespaces to disable.

DiscussionToggleResolveInput

Autogenerated input type of DiscussionToggleResolve.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idDiscussionID!Global ID of the discussion.
resolveBoolean!Will resolve the discussion when true, and unresolve the discussion when false.

DismissPolicyViolationsInput

Autogenerated input type of DismissPolicyViolations.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentString!Comment explaining the dismissal of the policy violations.
dismissalTypes[DismissalType!]!Type of dismissal for the policy violations.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.
securityPolicyIds[ID!]!IDs of warn mode policies with violations to dismiss.

DoraProjectFilterInput

Filter parameters for projects to be aggregated for DORA metrics.

Arguments

NameTypeDescription
topic[String!]Filter projects by topic.

DuoContextExclusionSettingsInput

Input for Duo context exclusion settings.

Arguments

NameTypeDescription
exclusionRules[String!]!List of rules for excluding files from Duo context.

DuoSettingsUpdateInput

Autogenerated input type of DuoSettingsUpdate.

Arguments

NameTypeDescription
aiGatewayTimeoutSecondsIntTimeout for the AI Gateway request.
aiGatewayUrlStringURL for the local AI Gateway server.
allowAllUnixSocketsBooleanStatus: Experiment. Introduced in GitLab 19.0.

Whether to allow all Unix sockets for network access.
allowProjectExtensionBooleanStatus: Experiment. Introduced in GitLab 19.0.

Whether to allow projects to extend the network access domain allowlist.
clientMutationIdStringA unique identifier for the client performing the mutation.
duoAgentPlatformServiceUrlStringURL for the local Duo Agent Platform service.
duoCliEnabledBooleanStatus: Experiment. Introduced in GitLab 19.0.

Indicates whether GitLab Duo CLI access is enabled.
duoCoreFeaturesEnabledBooleanIndicates whether GitLab Duo Core features are enabled.
includeRecommendedAllowedBooleanStatus: Experiment. Introduced in GitLab 19.0.

Whether to include recommended domains in the network access allowlist.
minimumAccessLevelEnableOnProjectsAccessLevelEnumStatus: Experiment. Introduced in GitLab 18.7.

Minimum access level for enable on Duo Agent Platform. Ignored if dap_instance_customizable_permissions feature flag is disabled.
minimumAccessLevelExecuteAccessLevelEnumStatus: Experiment. Introduced in GitLab 18.7.

Minimum access level for execute on Duo Agent Platform. Ignored if dap_instance_customizable_permissions feature flag is disabled.
minimumAccessLevelExecuteAsyncAccessLevelEnumStatus: Experiment. Introduced in GitLab 18.7.

Minimum access level to execute Duo Agent Platform features in CI/CD. Ignored if dap_instance_customizable_permissions feature flag is disabled.
minimumAccessLevelManageAccessLevelEnumStatus: Experiment. Introduced in GitLab 18.7.

Minimum access level for manage on Duo Agent Platform. Ignored if dap_instance_customizable_permissions feature flag is disabled.
selfHostedDuoAgentPlatformServiceSecureBooleanWhether to use secure transport (TLS) for the local Duo Agent Platform service.

DuoUserFeedbackInput

Autogenerated input type of DuoUserFeedback.

Arguments

NameTypeDescription
aiMessageIdString!ID of the AI Message.
clientMutationIdStringA unique identifier for the client performing the mutation.
trackingEventTrackingEventInputTracking event data.

DuoWorkflowSessionArtifactNegatedFilterInput

Negated filter arguments for Duo Agent Platform session artifacts.

Arguments

NameTypeDescription
projectPathStringExclude session artifacts belonging to the project full path.
triggeredByUserIdUserIDExclude session artifacts triggered by the user with the given global ID.
workflowDefinitionStringExclude session artifacts with the workflow definition.

EchoCreateInput

Autogenerated input type of EchoCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
errors[String!]Errors to return to the user.
messages[String!]Messages to return to the user.

EnableDevopsAdoptionNamespaceInput

Autogenerated input type of EnableDevopsAdoptionNamespace.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
displayNamespaceIdNamespaceIDDisplay namespace ID.
namespaceIdNamespaceID!Namespace ID.

EnvironmentCreateInput

Autogenerated input type of EnvironmentCreate.

Arguments

NameTypeDescription
autoStopSettingAutoStopSettingAuto stop setting of the environment.
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterAgentIdClustersAgentIDCluster agent of the environment.
descriptionStringDescription of the environment.
externalUrlStringExternal URL of the environment.
fluxResourcePathStringFlux resource path of the environment.
kubernetesNamespaceStringKubernetes namespace of the environment.
nameString!Name of the environment.
projectPathID!Full path of the project.
tierDeploymentTierTier of the environment.

EnvironmentDeleteInput

Autogenerated input type of EnvironmentDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idEnvironmentID!Global ID of the environment to Delete.

EnvironmentStopInput

Autogenerated input type of EnvironmentStop.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
forceBooleanForce environment to stop without executing on_stop actions.
idEnvironmentID!Global ID of the environment to stop.

EnvironmentUpdateInput

Autogenerated input type of EnvironmentUpdate.

Arguments

NameTypeDescription
autoStopSettingAutoStopSettingAuto stop setting of the environment.
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterAgentIdClustersAgentIDCluster agent of the environment.
descriptionStringDescription of the environment.
externalUrlStringExternal URL of the environment.
fluxResourcePathStringFlux resource path of the environment.
idEnvironmentID!Global ID of the environment to update.
kubernetesNamespaceStringKubernetes namespace of the environment.
tierDeploymentTierTier of the environment.

EnvironmentsCanaryIngressUpdateInput

Autogenerated input type of EnvironmentsCanaryIngressUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idEnvironmentID!Global ID of the environment to update.
weightInt!Weight of the Canary Ingress.

EpicAddIssueInput

Autogenerated input type of EpicAddIssue.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Group the epic to mutate belongs to.
iidID!IID of the epic to mutate.
issueIidString!IID of the issue to be added.
projectPathID!Full path of the project the issue belongs to.

EpicBoardCreateInput

Autogenerated input type of EpicBoardCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
displayColorsBooleanWhether or not display epic colors.
groupPathIDFull path of the group with which the resource is associated.
hideBacklogListBooleanWhether or not backlog list is hidden.
hideClosedListBooleanWhether or not closed list is hidden.
labelIds[LabelID!]IDs of labels to be added to the board.
labels[String!]Labels of the issue.
nameStringBoard name.

EpicBoardListCreateInput

Autogenerated input type of EpicBoardListCreate.

Arguments

NameTypeDescription
backlogBooleanCreate the backlog list.
boardIdBoardsEpicBoardID!Global ID of the issue board to mutate.
clientMutationIdStringA unique identifier for the client performing the mutation.
labelIdLabelIDGlobal ID of an existing label.

EpicBoardListDestroyInput

Autogenerated input type of EpicBoardListDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
listIdBoardsEpicListID!Global ID of the epic board list to destroy.

EpicBoardUpdateInput

Autogenerated input type of EpicBoardUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
displayColorsBooleanWhether or not display epic colors.
hideBacklogListBooleanWhether or not backlog list is hidden.
hideClosedListBooleanWhether or not closed list is hidden.
idBoardsEpicBoardID!Epic board global ID.
labelIds[LabelID!]IDs of labels to be added to the board.
labels[String!]Labels of the issue.
nameStringBoard name.

EpicFilters

Arguments

NameTypeDescription
authorUsernameStringFilter by author username.
confidentialBooleanFilter by confidentiality.
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 17.10.

Filter by custom fields.
labelName[String]Filter by label name.
myReactionEmojiStringFilter by reaction emoji applied by the current user. Wildcard values “NONE” and “ANY” are supported.
notNegatedEpicBoardIssueInputNegated epic arguments.
orUnionedEpicFilterInputList of arguments with inclusive OR.
searchStringSearch query for epic title or description.

EpicMoveListInput

Autogenerated input type of EpicMoveList.

Arguments

NameTypeDescription
boardIdBoardsEpicBoardID!Global ID of the board that the epic is in.
clientMutationIdStringA unique identifier for the client performing the mutation.
epicIdEpicID!ID of the epic to mutate.
fromListIdBoardsEpicListIDID of the board list that the epic will be moved from. Required if moving between lists.
moveAfterIdEpicIDID of epic that should be placed after the current epic.
moveBeforeIdEpicIDID of epic that should be placed before the current epic.
positionInListIntPosition of epics within the board list. Positions start at 0. Use -1 to move to the end of the list.
toListIdBoardsEpicListID!ID of the list the epic will be in after mutation.

EpicSetSubscriptionInput

Autogenerated input type of EpicSetSubscription.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Group the epic to mutate belongs to.
iidID!IID of the epic to mutate.
subscribedStateBoolean!Desired state of the subscription.

EpicTreeNodeFieldsInputType

A node of an epic tree.

Arguments

NameTypeDescription
adjacentReferenceIdEpicTreeSortingIDID of the epic issue or issue the epic or issue is switched with.
idEpicTreeSortingID!ID of the epic issue or epic that is being moved.
newParentIdEpicIDID of the new parent epic.
relativePositionMoveTypeType of switch. Valid values are after or before.

EpicTreeReorderInput

Autogenerated input type of EpicTreeReorder.

Arguments

NameTypeDescription
baseEpicIdEpicID!ID of the base epic of the tree.
clientMutationIdStringA unique identifier for the client performing the mutation.
movedEpicTreeNodeFieldsInputType!Parameters for updating the tree positions.

EscalationPolicyCreateInput

Autogenerated input type of EscalationPolicyCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the escalation policy.
nameString!Name of the escalation policy.
projectPathID!Project to create the escalation policy for.
rules[EscalationRuleInput!]!Steps of the escalation policy.

EscalationPolicyDestroyInput

Autogenerated input type of EscalationPolicyDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIncidentManagementEscalationPolicyID!Escalation policy internal ID to remove.

EscalationPolicyUpdateInput

Autogenerated input type of EscalationPolicyUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the escalation policy.
idIncidentManagementEscalationPolicyID!ID of the on-call schedule to create the on-call rotation in.
nameStringName of the escalation policy.
rules[EscalationRuleInput!]Steps of the escalation policy.

EscalationRuleInput

Represents an escalation rule.

Arguments

NameTypeDescription
elapsedTimeSecondsInt!Time in seconds before the rule is activated.
oncallScheduleIidIDOn-call schedule to notify.
statusEscalationRuleStatus!Status required to prevent the rule from activating.
usernameStringUsername of the user to notify.

ExportRequirementsInput

Autogenerated input type of ExportRequirements.

Arguments

NameTypeDescription
authorUsername[String!]Filter requirements by author username.
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full project path the requirements are associated with.
searchStringSearch query for requirement title.
selectedFields[String!]List of selected requirements fields to be exported.
sortSortList requirements by sort order.
stateRequirementStateFilter requirements by state.

ExternalAuditEventDestinationCreateInput

Autogenerated input type of ExternalAuditEventDestinationCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationUrlString!Destination URL.
groupPathID!Group path.
nameStringDestination name.
verificationTokenStringVerification token.

ExternalAuditEventDestinationDestroyInput

Autogenerated input type of ExternalAuditEventDestinationDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsExternalAuditEventDestinationID!ID of external audit event destination to destroy.

ExternalAuditEventDestinationUpdateInput

Autogenerated input type of ExternalAuditEventDestinationUpdate.

Arguments

NameTypeDescription
activeBooleanActive status of the destination.
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationUrlStringDestination URL to change.
idAuditEventsExternalAuditEventDestinationID!ID of external audit event destination to update.
nameStringDestination name.

FindingDueDatesSetInput

Arguments

NameTypeDescription
dueDateDateDue date for the finding. Pass null to remove.
findingUuidString!UUID of the vulnerability finding.

GeoRegistriesBulkUpdateInput

Autogenerated input type of GeoRegistriesBulkUpdate.

Arguments

NameTypeDescription
actionGeoRegistriesBulkAction!Action to be executed on Geo registries.
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[GeoBaseRegistryID!]Execute the action on registries selected by their ID.
registryClassGeoRegistryClass!Class of the Geo registries to be updated.
replicationStateReplicationStateEnumExecute the action on registries selected by their replication state.
verificationStateVerificationStateEnumExecute the action on registries selected by their verification state.

GeoRegistriesUpdateInput

Autogenerated input type of GeoRegistriesUpdate.

Arguments

NameTypeDescription
actionGeoRegistryAction!Action to be executed on a Geo registry.
clientMutationIdStringA unique identifier for the client performing the mutation.
registryIdGeoBaseRegistryID!ID of the Geo registry entry to be updated.

GitlabSubscriptionActivateInput

Autogenerated input type of GitlabSubscriptionActivate.

Arguments

NameTypeDescription
activationCodeString!Activation code received after purchasing a GitLab subscription.
clientMutationIdStringA unique identifier for the client performing the mutation.

GoogleCloudLoggingConfigurationCreateInput

Autogenerated input type of GoogleCloudLoggingConfigurationCreate.

Arguments

NameTypeDescriptionDefault
clientEmailString!Email address associated with the service account that will be used to authenticate and interact with the Google Cloud Logging service. This is part of the IAM credentials.
clientMutationIdStringA unique identifier for the client performing the mutation.
googleProjectIdNameString!Unique identifier of the Google Cloud project to which the logging configuration belongs.
groupPathID!Group path.
logIdNameStringUnique identifier used to distinguish and manage different logs within the same Google Cloud project.(defaults to audit_events)."audit_events"
nameStringDestination name.
privateKeyString!Private Key associated with the service account. This key is used to authenticate the service account and authorize it to interact with the Google Cloud Logging service.

GoogleCloudLoggingConfigurationDestroyInput

Autogenerated input type of GoogleCloudLoggingConfigurationDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsGoogleCloudLoggingConfigurationID!ID of the Google Cloud logging configuration to destroy.

GoogleCloudLoggingConfigurationUpdateInput

Autogenerated input type of GoogleCloudLoggingConfigurationUpdate.

Arguments

NameTypeDescription
activeBooleanActive status of the destination.
clientEmailStringEmail address associated with the service account that will be used to authenticate and interact with the Google Cloud Logging service. This is part of the IAM credentials.
clientMutationIdStringA unique identifier for the client performing the mutation.
googleProjectIdNameStringUnique identifier of the Google Cloud project to which the logging configuration belongs.
idAuditEventsGoogleCloudLoggingConfigurationID!ID of the google Cloud configuration to update.
logIdNameStringUnique identifier used to distinguish and manage different logs within the same Google Cloud project.
nameStringDestination name.
privateKeyStringPrivate Key associated with the service account. This key is used to authenticate the service account and authorize it to interact with the Google Cloud Logging service.

GoogleCloudNodePool

Attributes for defining Node Pool in GKE.

Arguments

NameTypeDescriptionDefault
imageTypeGoogleCloudImage!Image to use on the pool.
labels[GoogleCloudNodePoolLabel!]Labels for the node pool of the runner.[]
machineTypeGoogleCloudMachineType!Machine type to use.
nameString!Name of the node pool.
nodeCountInt!Node count of the pool.

GoogleCloudNodePoolLabel

Labels for the Node Pool of a GKE cluster.

Arguments

NameTypeDescription
keyString!Key of the label.
valueString!Value of the label.

GovernPolicyCreateInput

Autogenerated input type of GovernPolicyCreate.

Arguments

NameTypeDescription
actions[JSON!]Actions the policy takes. No more than 1000 actions.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the policy.
lifecycleStateStringLifecycle state of the policy.
modeStringEnforcement mode of the policy.
nameString!Name of the policy.
organizationIdOrganizationsOrganizationID!Global ID of the organization to create the policy in.
policyScopeJSONAuthored scope of the policy. Mutually exclusive with scopeRego.
rules[JSON!]!Rules of the policy, at least one. No more than 1000 rules.
scopeRegoStringRego expression scoping the policy. Mutually exclusive with policyScope.
triggerTypeString!Trigger the policy responds to.

GovernPolicyDeleteInput

Autogenerated input type of GovernPolicyDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idInt!ID of the policy to delete.
organizationIdOrganizationsOrganizationID!Global ID of the organization the policy belongs to.

GovernPolicyUpdateInput

Autogenerated input type of GovernPolicyUpdate.

Arguments

NameTypeDescription
actions[JSON!]Actions the policy takes. No more than 1000 actions.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the policy.
lifecycleStateStringLifecycle state of the policy.
modeStringEnforcement mode of the policy.
nameStringName of the policy.
organizationIdOrganizationsOrganizationID!Global ID of the organization the policy belongs to.
policyIdInt!ID of the policy.
policyScopeJSONAuthored scope of the policy. Mutually exclusive with scopeRego.
rules[JSON!]Rules of the policy, at least one when supplied. No more than 1000 rules.
scopeRegoStringRego expression scoping the policy. Mutually exclusive with policyScope.
triggerTypeStringTrigger the policy responds to.

GranularScopeInput

Attributes for a granular scope of an access token.

Arguments

NameTypeDescription
accessAccessTokenGranularScopeAccess!Access to configure for the granular scope.
permissions[String!]!List of permissions for the granular scope.
resourceIds[GlobalID!]IDs of groups or projects to associate with each granular scope.

GroupAuditEventStreamingDestinationsCreateInput

Autogenerated input type of GroupAuditEventStreamingDestinationsCreate.

Arguments

NameTypeDescription
categoryString!Destination category.
clientMutationIdStringA unique identifier for the client performing the mutation.
configJSON!Destination config.
groupPathID!Group path.
nameStringDestination name.
secretTokenStringSecret token.

GroupAuditEventStreamingDestinationsDeleteInput

Autogenerated input type of GroupAuditEventStreamingDestinationsDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsGroupExternalStreamingDestinationID!ID of the audit events external streaming destination to delete.

GroupAuditEventStreamingDestinationsUpdateInput

Autogenerated input type of GroupAuditEventStreamingDestinationsUpdate.

Arguments

NameTypeDescription
activeBooleanActive status of the destination.
categoryStringDestination category.
clientMutationIdStringA unique identifier for the client performing the mutation.
configJSONDestination config.
idAuditEventsGroupExternalStreamingDestinationID!ID of external audit event destination to update.
nameStringDestination name.
secretTokenStringSecret token.

GroupMemberBulkUpdateInput

Autogenerated input type of GroupMemberBulkUpdate.

Arguments

NameTypeDescription
accessLevelMemberAccessLevel!Access level to update the members to.
clientMutationIdStringA unique identifier for the client performing the mutation.
expiresAtTimeDate and time the membership expires.
groupIdGroupID!Global ID of the group.
userIds[UserID!]!Global IDs of the members.

GroupMembersExportInput

Autogenerated input type of GroupMembersExport.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupIdGroupID!Global ID of the group.

GroupProjectRequirementComplianceStatusInput

Arguments

NameTypeDescription
frameworkIdComplianceManagementFrameworkIDFilter compliance requirement statuses by compliance framework.
projectIdProjectIDFilter compliance requirement statuses by project.
requirementIdComplianceManagementComplianceFrameworkComplianceRequirementIDFilter compliance requirement statuses by compliance requirement.

GroupSavedReplyCreateInput

Autogenerated input type of GroupSavedReplyCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
contentString!Content of the saved reply.
groupIdGroupID!Group for the save reply.
nameString!Name of the saved reply.

GroupSavedReplyDestroyInput

Autogenerated input type of GroupSavedReplyDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idGroupsSavedReplyID!Global ID of the group-level saved reply.

GroupSavedReplyUpdateInput

Autogenerated input type of GroupSavedReplyUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
contentString!Content of the saved reply.
idGroupsSavedReplyID!Global ID of the group-level saved reply.
nameString!Name of the saved reply.

GroupSecretCreateInput

Autogenerated input type of GroupSecretCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the group secret.
environmentString!Environment that can access the secret.
groupPathID!Group of the secret.
nameString!Name of the group secret.
protectedBoolean!Whether the secret is only accessible from protected branches.
rotationIntervalDaysIntNumber of days between rotation reminders for the secret.
secretString!Value of the group secret.

GroupSecretDeleteInput

Autogenerated input type of GroupSecretDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Group of the secret.
nameString!Name of the group secret to delete.

GroupSecretUpdateInput

Autogenerated input type of GroupSecretUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringNew description of the group secret.
environmentStringNew environment that can access the secret.
groupPathID!Group of the secret.
metadataCasInt!This should match the current metadata version of the group secret being updated.
nameString!Name of the group secret to update.
protectedBooleanWhether the secret is only accessible from protected branches.
rotationIntervalDaysIntNumber of days between rotation reminders for the secret.
secretStringNew value of the group secret.

GroupSecretsManagerDeprovisionInput

Autogenerated input type of GroupSecretsManagerDeprovision.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Group of the secrets manager.

GroupSecretsManagerInitializeInput

Autogenerated input type of GroupSecretsManagerInitialize.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Group of the secrets manager.

GroupSecretsPermissionDeleteInput

Autogenerated input type of GroupSecretsPermissionDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Group permissions for the secret.
principalPrincipalInput!Whose permission to be deleted.

GroupSecretsPermissionUpdateInput

Autogenerated input type of GroupSecretsPermissionUpdate.

Arguments

NameTypeDescription
actions[SecretsManagementAction!]!Actions that can be performed on secrets.
clientMutationIdStringA unique identifier for the client performing the mutation.
expiredAtISO8601DateExpiration date for Secret Permission (optional).
groupPathID!Group to which the permissions are added.
principalPrincipalInput!User/MemberRole/Role that is provided access.

GroupTransferInput

Autogenerated input type of GroupTransfer.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idGroupID!Global ID of the group to transfer.
targetIdGroupIDGlobal ID of the target parent group. Omit to make group top-level.

GroupUpdateInput

Autogenerated input type of GroupUpdate.

Arguments

NameTypeDescription
aiAuditEventsStorageEnabledBooleanStatus: Experiment. Introduced in GitLab 19.2.

Indicates whether AI audit events are stored for the group.
builtInProjectTemplatesEnabledBooleanStatus: Experiment. Introduced in GitLab 19.0.

Indicates whether built-in project templates are available for new projects in the group.
clientMutationIdStringA unique identifier for the client performing the mutation.
duoAutoModeEnabledBooleanStatus: Experiment. Introduced in GitLab 19.5.

Indicates whether Duo Agent Platform auto mode is enabled for the group.
duoFeaturesEnabledBooleanStatus: Experiment. Introduced in GitLab 16.10.

Indicates whether GitLab Duo features are enabled for the group.
fullPathID!Full path of the group that will be updated.
lockAiAuditEventsStorageEnabledBooleanStatus: Experiment. Introduced in GitLab 19.2.

Indicates whether AI audit events storage is enforced for all subgroups and projects.
lockBuiltInProjectTemplatesEnabledBooleanStatus: Experiment. Introduced in GitLab 19.0.

Indicates if the built-in project templates enabled setting is enforced for all subgroups.
lockDuoAutoModeEnabledBooleanStatus: Experiment. Introduced in GitLab 19.5.

Indicates if the Duo Agent Platform auto mode setting is enforced for all subgroups.
lockDuoFeaturesEnabledBooleanStatus: Experiment. Introduced in GitLab 16.10.

Indicates if the GitLab Duo features enabled setting is enforced for all subgroups.
lockMathRenderingLimitsEnabledBooleanIndicates if math rendering limits are locked for all descendant groups.
lockToolApprovalForSessionEnabledBooleanStatus: Experiment. Introduced in GitLab 18.11.

Indicates if the tool approval for session setting is enforced for all subgroups.
mathRenderingLimitsEnabledBooleanIndicates if math rendering limits are used for the group.
nameStringName of the group.
pathStringPath of the namespace.
sharedRunnersSettingSharedRunnersSettingShared runners availability for the namespace and its descendants.
stepUpAuthRequiredOauthProviderStringOAuth provider required for step-up authentication.
toolApprovalForSessionEnabledBooleanStatus: Experiment. Introduced in GitLab 18.11.

Indicates whether tool approval for session is enabled for the group.
visibilityVisibilityLevelsEnumVisibility of the namespace.
webBasedCommitSigningEnabledBooleanStatus: Experiment. Introduced in GitLab 18.2.

Indicates whether web-based commit signing is enabled for the group.

HierarchyFilterInput

Arguments

NameTypeDescription
includeDescendantWorkItemsBooleanWhether to include work items of descendant parents when filtering by parent_ids.
parentIds[WorkItemID!]Filter work items by global IDs of their parent items (maximum is 100 items).
parentWildcardIdWorkItemParentWildcardIdStatus: Experiment. Introduced in GitLab 18.3.

Filter by parent ID wildcard. Incompatible with parentIds.

HttpIntegrationCreateInput

Autogenerated input type of HttpIntegrationCreate.

Arguments

NameTypeDescriptionDefault
activeBoolean!Whether the integration is receiving alerts.
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the integration.
payloadAttributeMappings[AlertManagementPayloadAlertFieldInput!]Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExampleJsonStringExample of an alert payload.
projectPathID!Project to create the integration in.
typeAlertManagementIntegrationTypeType of integration to create. Cannot be changed after creation.HTTP

HttpIntegrationDestroyInput

Autogenerated input type of HttpIntegrationDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAlertManagementHttpIntegrationID!ID of the integration to remove.

HttpIntegrationResetTokenInput

Autogenerated input type of HttpIntegrationResetToken.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAlertManagementHttpIntegrationID!ID of the integration to mutate.

HttpIntegrationUpdateInput

Autogenerated input type of HttpIntegrationUpdate.

Arguments

NameTypeDescription
activeBooleanWhether the integration is receiving alerts.
clientMutationIdStringA unique identifier for the client performing the mutation.
idAlertManagementHttpIntegrationID!ID of the integration to mutate.
nameStringName of the integration.
payloadAttributeMappings[AlertManagementPayloadAlertFieldInput!]Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExampleJsonStringExample of an alert payload.

ImportSourceUserCancelReassignmentInput

Autogenerated input type of ImportSourceUserCancelReassignment.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idImportSourceUserID!Global ID of the mapping of a user on source instance to a user on destination instance.

ImportSourceUserKeepAllAsPlaceholderInput

Autogenerated input type of ImportSourceUserKeepAllAsPlaceholder.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespaceIdNamespaceID!Global ID of the namespace.

ImportSourceUserKeepAsPlaceholderInput

Autogenerated input type of ImportSourceUserKeepAsPlaceholder.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idImportSourceUserID!Global ID of the mapping of a user on source instance to a user on destination instance.

ImportSourceUserReassignInput

Autogenerated input type of ImportSourceUserReassign.

Arguments

NameTypeDescription
assigneeUserIdUserID!Global ID of the assignee user.
clientMutationIdStringA unique identifier for the client performing the mutation.
idImportSourceUserID!Global ID of the mapping of a user on source instance to a user on destination instance.

ImportSourceUserResendNotificationInput

Autogenerated input type of ImportSourceUserResendNotification.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idImportSourceUserID!Global ID of the mapping of a user on source instance to a user on destination instance.

ImportSourceUserRetryFailedReassignmentInput

Autogenerated input type of ImportSourceUserRetryFailedReassignment.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idImportSourceUserID!Global ID of the mapping of a user on source instance to a user on destination instance.

ImportSourceUserUndoKeepAsPlaceholderInput

Autogenerated input type of ImportSourceUserUndoKeepAsPlaceholder.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idImportSourceUserID!Global ID of the mapping of a user on source instance to a user on destination instance.

InstanceAuditEventStreamingDestinationsCreateInput

Autogenerated input type of InstanceAuditEventStreamingDestinationsCreate.

Arguments

NameTypeDescription
categoryString!Destination category.
clientMutationIdStringA unique identifier for the client performing the mutation.
configJSON!Destination config.
nameStringDestination name.
secretTokenStringSecret token.

InstanceAuditEventStreamingDestinationsDeleteInput

Autogenerated input type of InstanceAuditEventStreamingDestinationsDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsInstanceExternalStreamingDestinationID!ID of the audit events external streaming destination to delete.

InstanceAuditEventStreamingDestinationsUpdateInput

Autogenerated input type of InstanceAuditEventStreamingDestinationsUpdate.

Arguments

NameTypeDescription
activeBooleanActive status of the destination.
categoryStringDestination category.
clientMutationIdStringA unique identifier for the client performing the mutation.
configJSONDestination config.
idAuditEventsInstanceExternalStreamingDestinationID!ID of external audit event destination to update.
nameStringDestination name.
secretTokenStringSecret token.

InstanceExternalAuditEventDestinationCreateInput

Autogenerated input type of InstanceExternalAuditEventDestinationCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationUrlString!Destination URL.
nameStringDestination name.

InstanceExternalAuditEventDestinationDestroyInput

Autogenerated input type of InstanceExternalAuditEventDestinationDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsInstanceExternalAuditEventDestinationID!ID of the external instance audit event destination to destroy.

InstanceExternalAuditEventDestinationUpdateInput

Autogenerated input type of InstanceExternalAuditEventDestinationUpdate.

Arguments

NameTypeDescription
activeBooleanActive status of the destination.
clientMutationIdStringA unique identifier for the client performing the mutation.
destinationUrlStringDestination URL to change.
idAuditEventsInstanceExternalAuditEventDestinationID!ID of the external instance audit event destination to update.
nameStringDestination name.

InstanceGoogleCloudLoggingConfigurationCreateInput

Autogenerated input type of InstanceGoogleCloudLoggingConfigurationCreate.

Arguments

NameTypeDescriptionDefault
clientEmailString!Email address associated with the service account that will be used to authenticate and interact with the Google Cloud Logging service. This is part of the IAM credentials.
clientMutationIdStringA unique identifier for the client performing the mutation.
googleProjectIdNameString!Unique identifier of the Google Cloud project to which the logging configuration belongs.
logIdNameStringUnique identifier used to distinguish and manage different logs within the same Google Cloud project.(defaults to audit_events)."audit_events"
nameStringDestination name.
privateKeyString!Private Key associated with the service account. This key is used to authenticate the service account and authorize it to interact with the Google Cloud Logging service.

InstanceGoogleCloudLoggingConfigurationDestroyInput

Autogenerated input type of InstanceGoogleCloudLoggingConfigurationDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuditEventsInstanceGoogleCloudLoggingConfigurationID!ID of the Google Cloud logging configuration to destroy.

InstanceGoogleCloudLoggingConfigurationUpdateInput

Autogenerated input type of InstanceGoogleCloudLoggingConfigurationUpdate.

Arguments

NameTypeDescription
activeBooleanActive status of the destination.
clientEmailStringEmail address associated with the service account that will be used to authenticate and interact with the Google Cloud Logging service. This is part of the IAM credentials.
clientMutationIdStringA unique identifier for the client performing the mutation.
googleProjectIdNameStringUnique identifier of the Google Cloud project to which the logging configuration belongs.
idAuditEventsInstanceGoogleCloudLoggingConfigurationID!ID of the instance google Cloud configuration to update.
logIdNameStringUnique identifier used to distinguish and manage different logs within the same Google Cloud project.
nameStringDestination name.
privateKeyStringPrivate Key associated with the service account. This key is used to authenticate the service account and authorize it to interact with the Google Cloud Logging service.

InstanceSecretsManagerEnrollInput

Autogenerated input type of InstanceSecretsManagerEnroll.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.

InstanceSecretsManagerUnenrollInput

Autogenerated input type of InstanceSecretsManagerUnenroll.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.

IntegrationExclusionCreateInput

Autogenerated input type of IntegrationExclusionCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupIds[GroupID!]IDs of groups to exclude up to a maximum of 100.
integrationNameIntegrationType!Type of integration to exclude.
projectIds[ProjectID!]IDs of projects to exclude up to a maximum of 100.

IntegrationExclusionDeleteInput

Autogenerated input type of IntegrationExclusionDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupIds[GroupID!]IDs of excluded groups.
integrationNameIntegrationType!Type of integration.
projectIds[ProjectID!]IDs of excluded projects.

IssuableResourceLinkCreateInput

Autogenerated input type of IssuableResourceLinkCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIssueID!Incident id to associate the resource link with.
linkString!Link of the resource.
linkTextStringLink text of the resource.
linkTypeIssuableResourceLinkTypeLink type of the resource.

IssuableResourceLinkDestroyInput

Autogenerated input type of IssuableResourceLinkDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIncidentManagementIssuableResourceLinkID!Issuable resource link ID to remove.

IssueLinkAlertsInput

Autogenerated input type of IssueLinkAlerts.

Arguments

NameTypeDescription
alertReferences[String!]!Alerts references to be linked to the incident.
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.

IssueMoveInput

Autogenerated input type of IssueMove.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.
targetProjectPathID!Project to move the issue to.
targetWorkItemTypeIdWorkItemsTypeIDWork item type to use in the target project. When omitted, the source work item type is preserved.

IssueMoveListInput

Autogenerated input type of IssueMoveList.

Arguments

NameTypeDescription
boardIdBoardID!Global ID of the board that the issue is in.
clientMutationIdStringA unique identifier for the client performing the mutation.
epicIdEpicIDDeprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
fromListIdIDID of the board list that the issue will be moved from.
iidString!IID of the issue to mutate.
moveAfterIdIDID of issue that should be placed after the current issue.
moveBeforeIdIDID of issue that should be placed before the current issue.
positionInListIntPosition of issue within the board list. Positions start at 0. Use -1 to move to the end of the list.
projectPathID!Project the issue to mutate is in.
toListIdIDID of the board list that the issue will be moved to.

IssueSetAssigneesInput

Autogenerated input type of IssueSetAssignees.

Arguments

NameTypeDescriptionDefault
assigneeUsernames[String!]!Usernames to assign to the resource. Replaces existing assignees by default.
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
operationModeMutationOperationModeOperation to perform. Defaults to REPLACE.REPLACE
projectPathID!Project the issue to mutate is in.

IssueSetConfidentialInput

Autogenerated input type of IssueSetConfidential.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
confidentialBoolean!Whether or not to set the issue as a confidential.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.

IssueSetCrmContactsInput

Autogenerated input type of IssueSetCrmContacts.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
contactIds[CustomerRelationsContactID!]!Customer relations contact IDs to set. Replaces existing contacts by default.
iidString!IID of the issue to mutate.
operationModeMutationOperationModeChanges the operation mode. Defaults to REPLACE.
projectPathID!Project the issue to mutate is in.

IssueSetDueDateInput

Autogenerated input type of IssueSetDueDate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
dueDateTimeDesired due date for the issue. Due date is removed if null.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.

IssueSetEpicInput

Autogenerated input type of IssueSetEpic.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
epicIdEpicIDDeprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.

IssueSetEscalationPolicyInput

Autogenerated input type of IssueSetEscalationPolicy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
escalationPolicyIdIncidentManagementEscalationPolicyIDGlobal ID of the escalation policy to assign to the issue. Policy will be removed if absent or set to null.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.

IssueSetEscalationStatusInput

Autogenerated input type of IssueSetEscalationStatus.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.
statusIssueEscalationStatus!Set the escalation status.

IssueSetIterationInput

Autogenerated input type of IssueSetIteration.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
iterationIdIterationIDIteration to assign to the issue.
projectPathID!Project the issue to mutate is in.

IssueSetLockedInput

Autogenerated input type of IssueSetLocked.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
lockedBoolean!Whether or not to lock discussion on the issue.
projectPathID!Project the issue to mutate is in.

IssueSetSeverityInput

Autogenerated input type of IssueSetSeverity.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.
severityIssuableSeverity!Set the incident severity level.

IssueSetSubscriptionInput

Autogenerated input type of IssueSetSubscription.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.
subscribedStateBoolean!Desired state of the subscription.

IssueSetWeightInput

Autogenerated input type of IssueSetWeight.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.
weightIntThe desired weight for the issue. If set to null, weight is removed.

IssueUnlinkAlertInput

Autogenerated input type of IssueUnlinkAlert.

Arguments

NameTypeDescription
alertIdAlertManagementAlertID!Global ID of the alert to unlink from the incident.
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.

ItemConsumerTargetInput

Arguments

NameTypeDescription
groupIdGroupIDGroup in which to configure the item.
projectIdProjectIDProject in which to configure the item.

IterationCadenceCreateInput

Autogenerated input type of IterationCadenceCreate.

Arguments

NameTypeDescription
activeBoolean!Whether the iteration cadence is active.
automaticBoolean!Whether the iteration cadence should automatically generate upcoming iterations.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the iteration cadence. Maximum length is 5000 characters.
durationInWeeksIntDuration in weeks of the iterations within the cadence.
groupPathID!Group where the iteration cadence is created.
iterationsInAdvanceIntNumber of future iterations to schedule in addition to the current one.
rollOverBooleanWhether the iteration cadence should roll over issues to the next iteration or not.
startDateTimeTimestamp of the automation start date.
titleStringTitle of the iteration cadence.

IterationCadenceDestroyInput

Autogenerated input type of IterationCadenceDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIterationsCadenceID!Global ID of the iteration cadence.

IterationCadenceUpdateInput

Autogenerated input type of IterationCadenceUpdate.

Arguments

NameTypeDescription
activeBooleanWhether the iteration cadence is active.
automaticBooleanWhether the iteration cadence should automatically generate upcoming iterations.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the iteration cadence. Maximum length is 5000 characters.
durationInWeeksIntDuration in weeks of the iterations within the cadence.
idIterationsCadenceID!Global ID of the iteration cadence.
iterationsInAdvanceIntNumber of future iterations to schedule in addition to the current one.
rollOverBooleanWhether the iteration cadence should roll over issues to the next iteration or not.
startDateTimeTimestamp of the automation start date.
titleStringTitle of the iteration cadence.

IterationDeleteInput

Autogenerated input type of IterationDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIterationID!ID of the iteration.

JiraImportStartInput

Autogenerated input type of JiraImportStart.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
jiraProjectKeyString!Project key of the importer Jira project.
jiraProjectNameStringDeprecated in GitLab 17.4. Argument is not used.
projectPathID!Project to import the Jira project into.
usersMapping[JiraUsersMappingInputType!]Mapping of Jira to GitLab users.

JiraImportUsersInput

Autogenerated input type of JiraImportUsers.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Project to import the Jira users into.
startAtIntIndex of the record the import should started at, default 0 (50 records returned).

JiraUsersMappingInputType

Arguments

NameTypeDescription
gitlabIdIntID of the GitLab user.
jiraAccountIdString!Jira account ID of the user.

JobArtifactsDestroyInput

Autogenerated input type of JobArtifactsDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiBuildID!ID of the job to mutate.

JobCancelInput

Autogenerated input type of JobCancel.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiBuildID!ID of the job to mutate.

JobPlayInput

Autogenerated input type of JobPlay.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiProcessableID!ID of the job to mutate.
inputs[CiInputsInput!]Inputs to use when playing the job.[]
variables[CiVariableInput!]Variables to use when playing a manual job.[]

JobRetryInput

Autogenerated input type of JobRetry.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiProcessableID!ID of the job to mutate.
inputs[CiInputsInput!]Inputs to use when retrying the job.[]
variables[CiVariableInput!]Variables to use when retrying a manual job.[]

JobUnscheduleInput

Autogenerated input type of JobUnschedule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiBuildID!ID of the job to mutate.

LabelCreateInput

Autogenerated input type of LabelCreate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
colorStringThe color of the label given in 6-digit hex notation with leading ‘#’ sign (for example, #FFAABB) or one of the CSS color names. See List of color keywords at mozilla.org."#6699cc"
descriptionStringDescription of the label.
groupPathIDFull path of the group with which the resource is associated.
projectPathIDFull path of the project with which the resource is associated.
titleString!Title of the label.

LabelUpdateInput

Autogenerated input type of LabelUpdate.

Arguments

NameTypeDescription
archivedBooleanWhether to archive the label. Introduced in GitLab 18.10.
clientMutationIdStringA unique identifier for the client performing the mutation.
idLabelID!Global ID of the label to update.

LdapAdminRoleLinkCreateInput

Autogenerated input type of LdapAdminRoleLinkCreate.

Arguments

NameTypeDescription
adminMemberRoleIdMemberRoleID!Global ID of the custom admin role to be assigned to a user.
clientMutationIdStringA unique identifier for the client performing the mutation.
cnStringCommon Name (CN) of the LDAP group.
filterStringSearch filter for the LDAP group.
providerString!LDAP provider for the LDAP link.

LdapAdminRoleLinkDestroyInput

Autogenerated input type of LdapAdminRoleLinkDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAuthzLdapAdminRoleLinkID!Global ID of the instance-level LDAP link to delete.

LifecycleAttachWorkItemTypeInput

Autogenerated input type of LifecycleAttachWorkItemType.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
lifecycleIdWorkItemsStatusesLifecycleID!Global ID of the lifecycle to attach the work item type to.
namespacePathID!Namespace path where the lifecycle exists.
statusMappings[StatusMappingInput!]Status mappings from the old lifecycle to the new lifecycle.
workItemTypeIdWorkItemsTypeID!Global ID of the work item type to attach to the lifecycle.

LifecycleCreateInput

Autogenerated input type of LifecycleCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
defaultClosedStatusIndexInt!Index of the default closed status in the statuses array.
defaultDuplicateStatusIndexInt!Index of the default duplicated status in the statuses array.
defaultOpenStatusIndexInt!Index of the default open status in the statuses array.
nameString!Name of the lifecycle.
namespacePathID!Namespace path where the lifecycle will be created.
statuses[WorkItemStatusInput!]!Statuses of the lifecycle. Can be existing (with id) or new (without id).

LifecycleDeleteInput

Autogenerated input type of LifecycleDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemsStatusesLifecycleID!Global ID of the lifecycle to delete.
namespacePathID!Namespace path where the lifecycle exists.

LifecycleUpdateInput

Autogenerated input type of LifecycleUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
defaultClosedStatusIndexIntIndex of the default closed status in the statuses array.
defaultDuplicateStatusIndexIntIndex of the default duplicated status in the statuses array.
defaultOpenStatusIndexIntIndex of the default open status in the statuses array.
idWorkItemsStatusesLifecycleID!Global ID of the lifecycle to be updated.
nameStringName of the lifecycle.
namespacePathID!Namespace path where the lifecycle exists.
statusMappings[StatusMappingInput!]Mappings for statuses being removed from the lifecycle. Maps old status to replacement status.
statuses[WorkItemStatusInput!]Statuses of the lifecycle. Can be existing (with id) or new (without id).

LinkProjectComplianceViolationIssueInput

Autogenerated input type of LinkProjectComplianceViolationIssue.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
issueIidString!IID of the issue to be linked.
projectPathID!Full path of the project the issue belongs to.
violationIdComplianceManagementProjectsComplianceViolationID!Global ID of the project compliance violation.

MarkAsSpamSnippetInput

Autogenerated input type of MarkAsSpamSnippet.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idSnippetID!Global ID of the snippet to update.

MavenCacheEntryDeleteInput

Autogenerated input type of MavenCacheEntryDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idString!ID of the cache entry.

MavenUpstreamCacheDeleteInput

Autogenerated input type of MavenUpstreamCacheDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesPackagesMavenUpstreamID!ID of the Maven virtual registry upstream.

MavenUpstreamCreateInput

Autogenerated input type of MavenUpstreamCreate.

Arguments

NameTypeDescriptionDefault
cacheValidityHoursIntCache validity period. Defaults to 24 hours.24
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the upstream registry.
idVirtualRegistriesPackagesMavenRegistryID!ID of the upstream registry.
metadataCacheValidityHoursIntMetadata cache validity period. Defaults to 24 hours.24
nameString!Name of upstream registry.
passwordStringPassword of the upstream registry.
urlString!URL of the upstream registry.
usernameStringUsername of the upstream registry.

MavenUpstreamDeleteInput

Autogenerated input type of MavenUpstreamDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesPackagesMavenUpstreamID!ID of the upstream to be deleted.

MavenUpstreamUpdateInput

Autogenerated input type of MavenUpstreamUpdate.

Arguments

NameTypeDescription
cacheValidityHoursIntCache validity period.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the upstream registry.
idVirtualRegistriesPackagesMavenUpstreamID!ID of the upstream registry.
metadataCacheValidityHoursIntMetadata cache validity period.
nameStringName of upstream registry.
passwordStringPassword of the upstream registry.
urlStringURL of the upstream registry.
usernameStringUsername of the upstream registry.

MavenVirtualRegistryCacheDeleteInput

Autogenerated input type of MavenVirtualRegistryCacheDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesPackagesMavenRegistryID!ID of the Maven virtual registry.

MavenVirtualRegistryCreateInput

Autogenerated input type of MavenVirtualRegistryCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the virtual registry.
groupPathIDFull path of the group with which the resource is associated.
nameString!Name of virtual registry.

MavenVirtualRegistryDeleteInput

Autogenerated input type of MavenVirtualRegistryDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesPackagesMavenRegistryID!ID of the Maven virtual registry to be deleted.

MavenVirtualRegistryUpdateInput

Autogenerated input type of MavenVirtualRegistryUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the virtual registry.
idVirtualRegistriesPackagesMavenRegistryID!ID of the Maven virtual registry to be updated.
nameStringName of virtual registry.

MavenVirtualRegistryUpstreamDeleteInput

Autogenerated input type of MavenVirtualRegistryUpstreamDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
upstreamIdVirtualRegistriesPackagesMavenRegistryUpstreamID!ID of the Maven virtual registry upstream.

MavenVirtualRegistryUpstreamUpdateInput

Autogenerated input type of MavenVirtualRegistryUpstreamUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVirtualRegistriesPackagesMavenRegistryUpstreamID!ID of the Maven virtual registry upstream.
positionInt!Priority order of an upstream within a virtual registry.

MemberRoleAdminCreateInput

Autogenerated input type of MemberRoleAdminCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the member role.
nameStringName of the member role.
permissions[MemberRoleAdminPermission!]List of all customizable admin permissions.

MemberRoleAdminDeleteInput

Autogenerated input type of MemberRoleAdminDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idMemberRoleID!ID of the admin member role to delete.

MemberRoleAdminUpdateInput

Autogenerated input type of MemberRoleAdminUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the member role.
idMemberRoleID!ID of the member role to mutate.
nameStringName of the member role.
permissions[MemberRoleAdminPermission!]List of all customizable admin permissions.

MemberRoleCreateInput

Autogenerated input type of MemberRoleCreate.

Arguments

NameTypeDescription
baseAccessLevelMemberRolesAccessLevel!Base access level for the custom role.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the member role.
groupPathIDGroup the member role to mutate is in. Required for SaaS.
nameStringName of the member role.
permissions[MemberRolePermission!]List of all customizable permissions.

MemberRoleDeleteInput

Autogenerated input type of MemberRoleDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idMemberRoleID!ID of the member role to delete.

MemberRoleToUserAssignInput

Autogenerated input type of MemberRoleToUserAssign.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
memberRoleIdMemberRoleIDGlobal ID of the custom role to be assigned to a user. Admin roles will be unassigned from the user if omitted or set as NULL.
userIdUserID!Global ID of the user to be assigned to a custom role.

MemberRoleUpdateInput

Autogenerated input type of MemberRoleUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the member role.
idMemberRoleID!ID of the member role to mutate.
nameStringName of the member role.
permissions[MemberRolePermission!]List of all customizable permissions.

MergeAccessLevelInput

Defines which user roles, users, or groups can merge into a protected branch.

Arguments

NameTypeDescription
accessLevelIntAccess level allowed to perform action.
groupIdGroupIDGroup associated with the access level.
memberRoleIdMemberRoleIDStatus: Experiment. Introduced in GitLab 19.2.

Custom member role associated with the access level.
userIdUserIDUser associated with the access level.

MergeRequestAcceptInput

Autogenerated input type of MergeRequestAccept.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
commitMessageStringCustom merge commit message.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.
shaString!HEAD SHA at the time when the merge was requested.
shouldRemoveSourceBranchBooleanShould the source branch be removed.
squashBooleanSquash commits on the source branch before merge.false
squashCommitMessageStringCustom squash commit message (if squash is true).
strategyMergeStrategyEnumHow to merge the merge request.

MergeRequestBypassSecurityPolicyInput

Autogenerated input type of MergeRequestBypassSecurityPolicy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.
reasonString!Reason for bypassing the security policy.
securityPolicyIds[ID!]!ID of the security policy to bypass.

MergeRequestCreateInput

Autogenerated input type of MergeRequestCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the merge request (Markdown rendered as HTML for caching).
labels[String!]Labels of the merge request.
mergeAfterTimeDate after which the merge request can be merged.
projectPathID!Project full path the merge request is associated with.
removeSourceBranchBooleanIndicates if the source branch of the merge request will be deleted after merge.
sourceBranchString!Source branch of the merge request.
targetBranchString!Target branch of the merge request.
titleString!Title of the merge request.

MergeRequestCreateWorkItemRelationsInput

Autogenerated input type of MergeRequestCreateWorkItemRelations.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
linkTypeMergeRequestWorkItemLinkTypeType of relationship to create. Defaults to RELATED. MENTIONED relations are managed automatically and cannot be created.RELATED
projectPathID!Project the merge request to mutate is in.
workItemIds[WorkItemID!]!Global IDs of the work items to link.

MergeRequestDestroyRequestedChangesInput

Autogenerated input type of MergeRequestDestroyRequestedChanges.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.

MergeRequestDestroyWorkItemRelationsInput

Autogenerated input type of MergeRequestDestroyWorkItemRelations.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[MergeRequestsClosingIssuesID!]!Global IDs of the relations to remove.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.

MergeRequestRequestChangesInput

Autogenerated input type of MergeRequestRequestChanges.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.

MergeRequestResyncSecurityPoliciesInput

Autogenerated input type of MergeRequestResyncSecurityPolicies.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to re-evaluate.
projectPathID!Project the merge request belongs to.

MergeRequestReviewerRereviewInput

Autogenerated input type of MergeRequestReviewerRereview.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.
userIdUserID!User ID for the user that has been requested for a new review.

MergeRequestSavedViewCreateInput

Autogenerated input type of MergeRequestSavedViewCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
filtersMergeRequestSavedViewFilterInputMerge request filters stored in the saved view.
nameString!Name of the saved view.

MergeRequestSavedViewDeleteInput

Autogenerated input type of MergeRequestSavedViewDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idMergeRequestsSavedViewID!Global ID of the saved view.

MergeRequestSavedViewFilterInput

Merge request filter values that can be stored in a saved view.

Arguments

NameTypeDescription
approvedBy[String!]Usernames of the approvers.
assigneeUsernames[String!]Usernames of users assigned to the merge request.
authorUsernameStringUsername of the author.
draftBooleanLimit results to draft merge requests.
labelName[String!]Labels applied to the merge request.
mergedAfterTimeMerge requests merged after the timestamp.
mergedBeforeTimeMerge requests merged before the timestamp.
milestoneTitleStringTitle of the milestone.
notMergeRequestSavedViewNegatedFilterInputFilter values to exclude.
reviewerUsernameStringUsername of the reviewer.
sortMergeRequestSortSort order for the merge requests.
sourceBranches[String!]Source branch names.
stateMergeRequestStateMerge request state.
targetBranches[String!]Target branch names.

MergeRequestSavedViewNegatedFilterInput

Merge request filter values to exclude in a saved view.

Arguments

NameTypeDescription
approvedBy[String!]Usernames of approvers to exclude.
assigneeUsernames[String!]Usernames of assignees to exclude.
authorUsernameStringUsername of the author to exclude.
labelName[String!]Labels to exclude.
milestoneTitleStringTitle of the milestone to exclude.
reviewerUsernameStringUsername of the reviewer to exclude.
sourceBranches[String!]Source branch names to exclude.
targetBranches[String!]Target branch names to exclude.

MergeRequestSavedViewUpdateInput

Autogenerated input type of MergeRequestSavedViewUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
filtersMergeRequestSavedViewFilterInputMerge request filters stored in the saved view.
idMergeRequestsSavedViewID!Global ID of the saved view.
nameStringName of the saved view.

MergeRequestSetAssigneesInput

Autogenerated input type of MergeRequestSetAssignees.

Arguments

NameTypeDescriptionDefault
assigneeUsernames[String!]!Usernames to assign to the resource. Replaces existing assignees by default.
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
operationModeMutationOperationModeOperation to perform. Defaults to REPLACE.REPLACE
projectPathID!Project the merge request to mutate is in.

MergeRequestSetBlockingMergeRequestsInput

Autogenerated input type of MergeRequestSetBlockingMergeRequests.

Arguments

NameTypeDescription
blockingMergeRequestReferences[String!]!Array of blocking merge request references (e.g., “!123”, “project!456”).
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.

MergeRequestSetDraftInput

Autogenerated input type of MergeRequestSetDraft.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
draftBoolean!Whether or not to set the merge request as a draft.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.

MergeRequestSetLabelsInput

Autogenerated input type of MergeRequestSetLabels.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
labelIds[LabelID!]!Label IDs to set. Replaces existing labels by default.
operationModeMutationOperationModeChanges the operation mode. Defaults to REPLACE.
projectPathID!Project the merge request to mutate is in.

MergeRequestSetLockedInput

Autogenerated input type of MergeRequestSetLocked.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
lockedBoolean!Whether or not to lock the merge request.
projectPathID!Project the merge request to mutate is in.

MergeRequestSetMilestoneInput

Autogenerated input type of MergeRequestSetMilestone.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
milestoneIdMilestoneIDMilestone to assign to the merge request.
projectPathID!Project the merge request to mutate is in.

MergeRequestSetReviewersInput

Autogenerated input type of MergeRequestSetReviewers.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
operationModeMutationOperationModeOperation to perform. Defaults to REPLACE.REPLACE
projectPathID!Project the merge request to mutate is in.
reviewerUsernames[String!]!Usernames of reviewers to assign. Replaces existing reviewers by default. Usernames that do not match a visible user are reported in errors and not assigned.

MergeRequestSetSubscriptionInput

Autogenerated input type of MergeRequestSetSubscription.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the merge request to mutate.
projectPathID!Project the merge request to mutate is in.
subscribedStateBoolean!Desired state of the subscription.

MergeRequestUpdateApprovalRuleInput

Autogenerated input type of MergeRequestUpdateApprovalRule.

Arguments

NameTypeDescriptionDefault
approvalRuleIdInt!ID of an approval rule.
approvalsRequiredInt!Number of required approvals for a given rule.
clientMutationIdStringA unique identifier for the client performing the mutation.
groupIds[String!]IDs of groups as approvers.[]
iidString!IID of the merge request to mutate.
nameString!Name of the approval rule.
projectPathID!Project the merge request to mutate is in.
removeHiddenGroupsBooleanWhether hidden groups should be removed.false
userIds[String!]IDs of users as approvers.[]

MergeRequestUpdateInput

Autogenerated input type of MergeRequestUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the merge request (Markdown rendered as HTML for caching).
iidString!IID of the merge request to mutate.
mergeAfterTimeDate after which the merge request can be merged.
overrideRequestedChangesBooleanOverride all requested changes. Can only be set by users who have permissionto merge this merge request.
projectPathID!Project the merge request to mutate is in.
removeSourceBranchBooleanIndicates if the source branch of the merge request will be deleted after merge.
stateMergeRequestNewStateAction to perform to change the state.
targetBranchStringTarget branch of the merge request.
timeEstimateStringEstimated time to complete the merge request. Use null or 0 to remove the current estimate.
titleStringTitle of the merge request.

MergeRequestsResolverNegatedParams

Arguments

NameTypeDescription
approvedBy[String!]Filters merge requests to exclude any that are approved by usernames in the given array.
assigneeUsernames[String!]Filters merge requests to exclude any that are assigned to the usernames in the given array.
authorUsernameStringFilters merge requests to exclude any that are authored by the given user.
labelName[String!]Filters merge requests to exclude any that have the labels provided in the given array.
labels[String!]Deprecated in GitLab 17.7. Use labelName.
milestoneTitleStringFilters merge requests to those not in the given milestone.
myReactionEmojiStringFilters merge requests to those without the given reaction from the authenticated user.
onlyReviewerBooleanStatus: Experiment. Introduced in GitLab 17.11.

Filters out merge requests to those that do not have the reviewer as the only assigned reviewer.
releaseTagStringFilters merge requests to those without the given release tag.
reviewStates[MergeRequestReviewState!]Status: Experiment. Introduced in GitLab 17.9.

Filters merge requests to those where a reviewer does not have the provided state.
reviewerUsernameStringFilters merge requests to those not reviewed by the given user.
sourceBranches[String!]Filters merge requests to exclude the source branch names provided in the given array.
targetBranches[String!]Filters merge requests to exclude the target branch names provided in the given array.

MergeTrainsDeleteCarInput

Autogenerated input type of MergeTrainsDeleteCar.

Arguments

NameTypeDescription
carIdMergeTrainsCarID!Global ID of the car.
clientMutationIdStringA unique identifier for the client performing the mutation.

MlModelCreateInput

Autogenerated input type of MlModelCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the model.
nameString!Name of the model.
projectPathID!Project the model to mutate is in.

MlModelDeleteInput

Autogenerated input type of MlModelDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idMlModelID!Global ID of the model to be deleted.
projectPathID!Project the model to mutate is in.

MlModelDestroyInput

Autogenerated input type of MlModelDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idMlModelID!Global ID of the model to be deleted.
projectPathID!Project the model to mutate is in.

MlModelEditInput

Autogenerated input type of MlModelEdit.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the model.
modelIdIntId of the model.
nameString!Name of the model.
projectPathID!Project the model to mutate is in.

MlModelVersionCreateInput

Autogenerated input type of MlModelVersionCreate.

Arguments

NameTypeDescription
candidateIdMlCandidateIDGlobal ID of a candidate to promote optionally.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the model version.
modelIdMlModelID!Global ID of the model the version belongs to.
projectPathID!Project the model to mutate is in.
versionStringModel version.

MlModelVersionDeleteInput

Autogenerated input type of MlModelVersionDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idMlModelVersionID!Global ID of the model version to be deleted.

MlModelVersionEditInput

Autogenerated input type of MlModelVersionEdit.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionString!Description of the model version.
modelIdMlModelID!Global ID of the model the version belongs to.
projectPathID!Project the model to mutate is in.
versionString!Model version.

NamespaceBanDestroyInput

Autogenerated input type of NamespaceBanDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idNamespacesNamespaceBanID!Global ID of the namespace ban to remove.

NamespaceCiCdSettingsUpdateInput

Autogenerated input type of NamespaceCiCdSettingsUpdate.

Arguments

NameTypeDescription
allowStaleRunnerPruningBooleanIndicates if stale runners directly belonging to the namespace should be periodically pruned.
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Full path of the namespace the settings belong to.

NamespaceCreateRemoteDevelopmentClusterAgentMappingInput

Autogenerated input type of NamespaceCreateRemoteDevelopmentClusterAgentMapping.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterAgentIdClustersAgentID!GlobalID of the cluster agent to be associated with the namespace.
namespaceIdGroupID!GlobalID of the group to be associated with the cluster agent.

NamespaceDeleteRemoteDevelopmentClusterAgentMappingInput

Autogenerated input type of NamespaceDeleteRemoteDevelopmentClusterAgentMapping.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterAgentIdClustersAgentID!GlobalID of the cluster agent to be un-associated from the namespace.
namespaceIdGroupID!GlobalID of the group to be un-associated from the cluster agent.

NamespaceSecretsManagerEnrollInput

Autogenerated input type of NamespaceSecretsManagerEnroll.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespacePathID!Full path of the namespace to enroll.

NamespaceSecretsManagerUnenrollInput

Autogenerated input type of NamespaceSecretsManagerUnenroll.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespacePathID!Full path of the namespace to unenroll.

NamespaceSettingsUpdateInput

Autogenerated input type of NamespaceSettingsUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Full path of the namespace the settings belong to.
pipelineVariablesDefaultRolePipelineVariablesDefaultRoleTypeIndicates the default minimum role required to override pipeline variables in the namespace.

NamespacesRegenerateNewWorkItemEmailAddressInput

Autogenerated input type of NamespacesRegenerateNewWorkItemEmailAddress.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Full path of the namespace to regenerate the new work item email address for.

NegatedBoardIssueInput

Arguments

NameTypeDescription
assigneeUsername[String]Filter by assignee username.
authorUsernameStringFilter by author username.
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 18.4.

Filter by negated custom fields.
epicIdEpicIDDeprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
healthStatusFilterHealthStatusHealth status not applied to the issue. Includes issues where health status is not set.
iids[String!]List of IIDs of issues. For example ["1", "2"].
iterationId[IterationID!]Filter by a list of iteration IDs. Incompatible with iterationWildcardId.
iterationTitleStringFilter by iteration title.
iterationWildcardIdNegatedIterationWildcardIdFilter by iteration ID wildcard.
labelName[String]Filter by label name.
milestoneTitleStringFilter by milestone title.
milestoneWildcardIdMilestoneWildcardIdFilter by milestone ID wildcard.
myReactionEmojiStringFilter by reaction emoji applied by the current user. Wildcard values “NONE” and “ANY” are supported.
releaseTagStringFilter by release tag.
types[IssueType!]Filter by the given issue types.
weightStringFilter by weight.
workItemTypeIds[WorkItemsTypeID!]Filter by work item type global IDs.

NegatedComplianceFrameworkFilters

Arguments

NameTypeDescription
idComplianceManagementFrameworkIDID of the compliance framework.
ids[ComplianceManagementFrameworkID!]IDs of the compliance framework.

NegatedEpicBoardIssueInput

Arguments

NameTypeDescription
authorUsernameStringFilter by author username.
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 18.4.

Filter by negated custom fields.
labelName[String]Filter by label name.
myReactionEmojiStringFilter by reaction emoji applied by the current user. Wildcard values “NONE” and “ANY” are supported.

NegatedEpicFilterInput

Arguments

NameTypeDescription
authorUsernameStringFilter by author username.
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 18.4.

Filter by negated custom fields.
labelName[String]Filter by label name.
myReactionEmojiStringFilter by reaction emoji applied by the current user.

NegatedIssueFilterInput

Arguments

NameTypeDescription
assigneeIdStringID of a user not assigned to the issues.
assigneeUsernames[String!]Usernames of users not assigned to the issue.
authorUsername[String!]Username of a user who didn’t author the issue.
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 18.4.

Filter by negated custom fields.
epicIdStringID of an epic not associated with the issues.
healthStatusFilter[HealthStatus!]Health status not applied to the issue. Includes issues where health status is not set.
iids[String!]List of IIDs of issues to exclude. For example, [1, 2].
iterationId[ID!]List of iteration Global IDs not applied to the issue.
iterationWildcardIdIterationWildcardIdFilter by negated iteration ID wildcard.
labelName[String!]Labels not applied to the issue.
milestoneTitle[String!]Milestone not applied to the issue.
milestoneWildcardIdNegatedMilestoneWildcardIdFilter by negated milestone wildcard values.
myReactionEmojiStringFilter by reaction emoji applied by the current user.
releaseTag[String!]Release tag not associated with the issue’s milestone. Ignored when parent is a group.
types[IssueType!]Filters out issues by the given issue types.
weightStringWeight not applied to the issue.

NegatedValueStreamAnalyticsIssuableFilterInput

Arguments

NameTypeDescription
assigneeUsernames[String!]Usernames of users not assigned to the issue or merge request.
authorUsernameStringUsername of a user who didn’t author the issue or merge request.
epicIdIDID of an epic not associated with the issues. Using the filter is not supported for stages based on merge requests.
iterationIdIDList of iteration Global IDs not applied to the issue. Using the filter is not supported for stages based on merge requests.
labelNames[String!]Labels not applied to the issue or merge request.
milestoneTitleStringMilestone not applied to the issue or merge request.
myReactionEmojiStringFilter by reaction emoji applied by the current user.
weightIntWeight not applied to the issue. Using the filter is not supported for stages based on merge requests.

NegatedWorkItemFilterInput

Arguments

NameTypeDescription
assigneeUsernames[String!]Usernames of users not assigned to the work item (maximum is 100 usernames).
authorUsername[String!]Username of a user who didn’t author the work item (maximum is 100 usernames).
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 18.4.

Filter by negated custom fields.
healthStatusFilter[HealthStatus!]Health status not applied to the work items. Includes work items where health status is not set.
iterationId[ID!]List of iteration Global IDs not applied to the work items (maximum is 100 IDs).
iterationWildcardIdIterationWildcardIdFilter by negated iteration ID wildcard.
labelName[String!]Labels not applied to the work item (maximum is 100 labels).
milestoneTitle[String!]Milestone not applied to the work item (maximum is 100 milestones).
milestoneWildcardIdNegatedMilestoneWildcardIdFilter by negated milestone wildcard values.
myReactionEmojiStringFilter by reaction emoji not applied by the current user.
parentIds[WorkItemID!]Status: Experiment. Introduced in GitLab 18.3.

Filter work items by global IDs who don’t belong to parent items (maximum is 100 IDs).
releaseTag[String!]Release tag not associated with the work items’s milestone (maximum is 100 tags). Ignored when parent is a group .
types[IssueType!]Filter out work items by the given types.
weightStringWeight not applied to the work items.
workItemTypeIds[WorkItemsTypeID!]Filter out work items by work item type global IDs.

NoteConvertToThreadInput

Autogenerated input type of NoteConvertToThread.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idNoteID!Global ID of the Note to convert.

OncallRotationActivePeriodInputType

Active period time range for on-call rotation.

Arguments

NameTypeDescription
endTimeString!End of the rotation active period in 24 hour format. For example, “18:30”.
startTimeString!Start of the rotation active period in 24 hour format. For example, “18:30”.

OncallRotationCreateInput

Autogenerated input type of OncallRotationCreate.

Arguments

NameTypeDescription
activePeriodOncallRotationActivePeriodInputTypeActive period of time that the on-call rotation should take place.
clientMutationIdStringA unique identifier for the client performing the mutation.
endsAtOncallRotationDateInputTypeEnd date and time of the on-call rotation, in the timezone of the on-call schedule.
nameString!Name of the on-call rotation.
participants[OncallUserInputType!]!Usernames of users participating in the on-call rotation. A maximum limit of 100 participants applies.
projectPathID!Project to create the on-call schedule in.
rotationLengthOncallRotationLengthInputType!Rotation length of the on-call rotation.
scheduleIidString!IID of the on-call schedule to create the on-call rotation in.
startsAtOncallRotationDateInputType!Start date and time of the on-call rotation, in the timezone of the on-call schedule.

OncallRotationDateInputType

Date input type for on-call rotation.

Arguments

NameTypeDescription
dateString!Date component of the date in YYYY-MM-DD format.
timeString!Time component of the date in 24hr HH:MM format.

OncallRotationDestroyInput

Autogenerated input type of OncallRotationDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIncidentManagementOncallRotationID!ID of the on-call rotation to remove.
projectPathID!Project to remove the on-call schedule from.
scheduleIidString!IID of the on-call schedule to the on-call rotation belongs to.

OncallRotationLengthInputType

The rotation length of the on-call rotation.

Arguments

NameTypeDescription
lengthInt!Rotation length of the on-call rotation.
unitOncallRotationUnitEnum!Unit of the rotation length of the on-call rotation.

OncallRotationUpdateInput

Autogenerated input type of OncallRotationUpdate.

Arguments

NameTypeDescription
activePeriodOncallRotationActivePeriodInputTypeActive period of time that the on-call rotation should take place.
clientMutationIdStringA unique identifier for the client performing the mutation.
endsAtOncallRotationDateInputTypeEnd date and time of the on-call rotation, in the timezone of the on-call schedule.
idIncidentManagementOncallRotationID!ID of the on-call schedule to create the on-call rotation in.
nameStringName of the on-call rotation.
participants[OncallUserInputType!]Usernames of users participating in the on-call rotation. A maximum limit of 100 participants applies.
rotationLengthOncallRotationLengthInputTypeRotation length of the on-call rotation.
startsAtOncallRotationDateInputTypeStart date and time of the on-call rotation, in the timezone of the on-call schedule.

OncallScheduleCreateInput

Autogenerated input type of OncallScheduleCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the on-call schedule.
nameString!Name of the on-call schedule.
projectPathID!Project to create the on-call schedule in.
timezoneString!Timezone of the on-call schedule.

OncallScheduleDestroyInput

Autogenerated input type of OncallScheduleDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!On-call schedule internal ID to remove.
projectPathID!Project to remove the on-call schedule from.

OncallScheduleUpdateInput

Autogenerated input type of OncallScheduleUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the on-call schedule.
iidString!On-call schedule internal ID to update.
nameStringName of the on-call schedule.
projectPathID!Project to update the on-call schedule in.
timezoneStringTimezone of the on-call schedule.

OncallUserInputType

The rotation user and color palette.

Arguments

NameTypeDescription
colorPaletteDataVisualizationColorEnumValue of DataVisualizationColorEnum. The color from the palette to assign to the on-call user.
colorWeightDataVisualizationWeightEnumColor weight to assign to for the on-call user. To view on-call schedules in GitLab, do not provide a value below 500. A value between 500 and 950 ensures sufficient contrast.
usernameString!Username of the user to participate in the on-call rotation. For example, "user_one".

OrbitUpdateInput

Autogenerated input type of OrbitUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enabledBoolean!Whether to enable or disable the Knowledge Graph for the group.
groupPathID!Full path of the group to update.

OrganizationConfirmInput

Autogenerated input type of OrganizationConfirm.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groups[GroupID!]Global IDs of top-level groups to transfer to the organization.
idOrganizationsOrganizationID!Global ID of the organization to confirm.

OrganizationCreateClusterAgentMappingInput

Autogenerated input type of OrganizationCreateClusterAgentMapping.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterAgentIdClustersAgentID!GlobalID of the cluster agent to be associated with the organization.
organizationIdOrganizationsOrganizationID!GlobalID of the organization to be associated with the cluster agent.

OrganizationCreateInput

Autogenerated input type of OrganizationCreate.

Arguments

NameTypeDescription
avatarUploadAvatar for the organization.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the organization.
nameString!Name for the organization.
pathString!Path for the organization.
visibilityOrganizationVisibilityVisibility for the organization.

OrganizationDeleteClusterAgentMappingInput

Autogenerated input type of OrganizationDeleteClusterAgentMapping.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterAgentIdClustersAgentID!GlobalID of the cluster agent to be dissociated with the organization.
organizationIdOrganizationsOrganizationID!GlobalID of the organization to be dissociated with the cluster agent.

OrganizationDeleteInput

Autogenerated input type of OrganizationDelete.

Arguments

NameTypeDescription
avatarUploadAvatar for the organization.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the organization.
idOrganizationsOrganizationID!ID of the organization to soft-delete.

OrganizationRestoreInput

Autogenerated input type of OrganizationRestore.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idOrganizationsOrganizationID!ID of the organization to restore.

OrganizationUpdateInput

Autogenerated input type of OrganizationUpdate.

Arguments

NameTypeDescription
avatarUploadAvatar for the organization.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the organization.
idOrganizationsOrganizationID!ID of the organization to mutate.
nameStringName for the organization.
pathStringPath for the organization.
policyStoreExperimentEnabledBooleanStatus: Experiment. Introduced in GitLab 19.4.

Opt the organization in to or out of the Policy Store experiment. Opting in returns an error when the experiment is not available to the organization; opting out is always accepted.
visibilityOrganizationVisibilityVisibility for the organization.

OrganizationUserCreateInput

Autogenerated input type of OrganizationUserCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
organizationIdOrganizationsOrganizationID!ID of the organization to add the user to.
userTypeOrganizationUserType!Type to add the organization user with.
usernameString!Username of the user to add to the organization.

OrganizationUserDeleteInput

Autogenerated input type of OrganizationUserDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idOrganizationsOrganizationUserID!ID of the organization user to delete.

OrganizationUserUpdateInput

Autogenerated input type of OrganizationUserUpdate.

Arguments

NameTypeDescription
accessLevelOrganizationUserAccessLevel!Access level to update the organization user to.
clientMutationIdStringA unique identifier for the client performing the mutation.
idOrganizationsOrganizationUserID!ID of the organization user to mutate.

PagesMarkOnboardingCompleteInput

Autogenerated input type of PagesMarkOnboardingComplete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project.

PersonalAccessTokenCreateInput

Autogenerated input type of PersonalAccessTokenCreate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the token.
expiresAtISO8601DateExpiration date of the token.
granularScopes[GranularScopeInput!]!List of granular scopes to assign to the token.
nameString!Name of the token.
sudoBooleanWhether the token can impersonate other users with sudo. Requires the token owner to be an administrator.false

PersonalAccessTokenRevokeInput

Autogenerated input type of PersonalAccessTokenRevoke.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idPersonalAccessTokenID!Global ID of the personal access token that will be revoked.

PersonalAccessTokenRotateInput

Autogenerated input type of PersonalAccessTokenRotate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
expiresAtISO8601DateExpiration date of the token.
idPersonalAccessTokenID!Global ID of the personal access token that will be rotated.

PipelineCancelInput

Autogenerated input type of PipelineCancel.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiPipelineID!ID of the pipeline to mutate.

PipelineCreateInput

Autogenerated input type of PipelineCreate.

Arguments

NameTypeDescription
asyncBooleanStatus: Experiment. Introduced in GitLab 17.8.

When true, the request does not wait for the pipeline to be created, and returns a unique identifier that can be used to check the creation status.
clientMutationIdStringA unique identifier for the client performing the mutation.
inputs[CiInputsInput!]Status: Experiment. Introduced in GitLab 17.10.

Inputs for the pipeline.
mergeRequestIidStringIID of the merge request to create pipeline for.
projectPathID!Full path of the project that is triggering the pipeline.
refString!Ref on which to run the pipeline. Ignored when mergeRequestIid is provided; the merge request ref path is used instead.
variables[CiVariableInput!]Variables for the pipeline.

PipelineDestroyInput

Autogenerated input type of PipelineDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiPipelineID!ID of the pipeline to mutate.

PipelineExecutionSchedulePolicyTestRunInput

Autogenerated input type of PipelineExecutionSchedulePolicyTestRun.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
policyIdSecurityPolicyID!Global ID of the pipeline execution schedule policy to test.
projectPathID!Full path of the project to run the test on.

PipelineRetryInput

Autogenerated input type of PipelineRetry.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiPipelineID!ID of the pipeline to mutate.

PipelineScheduleCreateInput

Autogenerated input type of PipelineScheduleCreate.

Arguments

NameTypeDescription
activeBooleanIndicates if the pipeline schedule should be active or not.
clientMutationIdStringA unique identifier for the client performing the mutation.
cronString!Cron expression of the pipeline schedule.
cronTimezoneStringCron time zone supported by ActiveSupport::TimeZone. For example: Pacific Time (US & Canada) (default: UTC).
descriptionString!Description of the pipeline schedule.
inputs[CiInputsInput!]Status: Experiment. Introduced in GitLab 17.10.

Inputs for the pipeline schedule.
projectPathID!Full path of the project the pipeline schedule is associated with.
refString!Ref of the pipeline schedule.
variables[PipelineScheduleVariableInput!]Variables for the pipeline schedule.

PipelineScheduleDeleteInput

Autogenerated input type of PipelineScheduleDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiPipelineScheduleID!ID of the pipeline schedule to mutate.

PipelineSchedulePlayInput

Autogenerated input type of PipelineSchedulePlay.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiPipelineScheduleID!ID of the pipeline schedule to mutate.

PipelineScheduleTakeOwnershipInput

Autogenerated input type of PipelineScheduleTakeOwnership.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiPipelineScheduleID!ID of the pipeline schedule to mutate.

PipelineScheduleUpdateInput

Autogenerated input type of PipelineScheduleUpdate.

Arguments

NameTypeDescription
activeBooleanIndicates if the pipeline schedule should be active or not.
clientMutationIdStringA unique identifier for the client performing the mutation.
cronStringCron expression of the pipeline schedule.
cronTimezoneStringCron time zone supported by ActiveSupport::TimeZone. For example: Pacific Time (US & Canada) (default: UTC).
descriptionStringDescription of the pipeline schedule.
idCiPipelineScheduleID!ID of the pipeline schedule to mutate.
inputs[CiInputsInput!]Status: Experiment. Introduced in GitLab 17.11.

Inputs for the pipeline schedule.
refStringRef of the pipeline schedule.
variables[PipelineScheduleVariableInput!]Variables for the pipeline schedule.

PipelineScheduleVariableInput

Attributes for the pipeline schedule variable.

Arguments

NameTypeDescription
destroyBooleanBoolean option to destroy the variable.
idCiPipelineScheduleVariableIDID of the variable to mutate.
keyString!Name of the variable.
valueString!Value of the variable.
variableTypeCiVariableType!Type of the variable.

PipelineTriggerCreateInput

Autogenerated input type of PipelineTriggerCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionString!Description of the pipeline trigger token.
expiresAtTimeTimestamp of when the pipeline trigger token expires.
projectPathID!Full path of the project that the pipeline trigger token to mutate is in.

PipelineTriggerDeleteInput

Autogenerated input type of PipelineTriggerDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiTriggerID!ID of the pipeline trigger token to delete.

PipelineTriggerUpdateInput

Autogenerated input type of PipelineTriggerUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionString!Description of the pipeline trigger token.
idCiTriggerID!ID of the pipeline trigger token to update.

PrincipalInput

Representation of who is provided access to. For eg: User/Role/MemberRole.

Arguments

NameTypeDescription
idInt!ID of the principal.
typePrincipalType!Type of the principal.

ProcessUserBillablePromotionRequestInput

Autogenerated input type of ProcessUserBillablePromotionRequest.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
statusMemberApprovalStatusType!Status for the member approval request (approved, denied, pending).
userIdUserID!Global ID of user to be promoted.

ProjectCiCdSettingsUpdateInput

Autogenerated input type of ProjectCiCdSettingsUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
crossProjectPushForJobTokenAllowedBooleanIndicates the ability to push to this repository using a job token from an allowlisted project.
displayPipelineVariablesBooleanIndicates whether pipeline variables can be displayed in the UI.
fullPathID!Full Path of the project the settings belong to.
groupRunnersEnabledBooleanIndicates whether group runners are enabled for the project.
inboundJobTokenScopeEnabledBooleanIndicates whether CI/CD job tokens generated in other projects have restricted access to this project.
jobTokenScopeEnabledBooleanDeprecated in GitLab 16.0. Outbound job token scope is being removed. This field can now only be set to false.
keepLatestArtifactBooleanIndicates whether the latest artifact should be kept for the project.
maxPipelinesPerMergeTrainIntMaximum number of parallel pipelines per merge train.
mergePipelinesEnabledBooleanIndicates if merged results pipelines are enabled for the project.
mergeTrainEnforcementMergeTrainEnforcementMerge train enforcement level for the project.
mergeTrainsEnabledBooleanIndicates if merge trains are enabled for the project.
mergeTrainsSkipTrainAllowedBooleanIndicates whether an option is allowed to merge without refreshing the merge train. Ignored unless the merge_trains_skip_train feature flag is also enabled.
pipelineVariablesMinimumOverrideRoleStringMinimum role required to set variables when creating a pipeline or running a job.
pushRepositoryForJobTokenAllowedBooleanIndicates the ability to push to the original project repository using a job token.
resourceGroupDefaultProcessModeResourceGroupsProcessModeDefault process mode for resource groups in the project.
skipBranchPipelinesForMrsBooleanIndicates whether branch pipelines are skipped if a merge request is open.

ProjectComplianceControlStatusInput

Arguments

NameTypeDescription
complianceRequirementIdComplianceManagementComplianceFrameworkComplianceRequirementIDCompliance requirement id of the statuses.

ProjectComplianceViolationFilterInput

Filters for project compliance violations.

Arguments

NameTypeDescription
controlIdComplianceManagementComplianceFrameworkComplianceRequirementsControlIDControl ID for which to filter compliance violations.
createdAfterDateCompliance violations created on or after the date (inclusive).
createdBeforeDateCompliance violations created on or before the date (inclusive).
projectIdProjectIDProject ID for which to filter compliance violations.
status[ComplianceViolationStatus!]Status of the project compliance violation.

ProjectCustomAttributeSetInput

Autogenerated input type of ProjectCustomAttributeSet.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
keyString!Key of the custom attribute.
projectPathID!Full path of the project.
valueString!Value of the custom attribute.

ProjectMemberBulkUpdateInput

Autogenerated input type of ProjectMemberBulkUpdate.

Arguments

NameTypeDescription
accessLevelMemberAccessLevel!Access level to update the members to.
clientMutationIdStringA unique identifier for the client performing the mutation.
expiresAtTimeDate and time the membership expires.
projectIdProjectID!Global ID of the project.
userIds[UserID!]!Global IDs of the members.

ProjectRequirementComplianceStatusInput

Arguments

NameTypeDescription
frameworkIdComplianceManagementFrameworkIDFilter compliance requirement statuses by compliance framework.
requirementIdComplianceManagementComplianceFrameworkComplianceRequirementIDFilter compliance requirement statuses by compliance requirement.

ProjectSavedReplyCreateInput

Autogenerated input type of ProjectSavedReplyCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
contentString!Content of the saved reply.
nameString!Name of the saved reply.
projectIdProjectID!Project for the saved reply.

ProjectSavedReplyDestroyInput

Autogenerated input type of ProjectSavedReplyDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idProjectsSavedReplyID!Global ID of the project-level saved reply.

ProjectSavedReplyUpdateInput

Autogenerated input type of ProjectSavedReplyUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
contentString!Content of the saved reply.
idProjectsSavedReplyID!Global ID of the project-level saved reply.
nameString!Name of the saved reply.

ProjectSecretCreateInput

Autogenerated input type of ProjectSecretCreate.

Arguments

NameTypeDescription
branchString!Branches that can access the secret.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the project secret.
environmentString!Environments that can access the secret.
nameString!Name of the project secret.
projectPathID!Project of the secret.
rotationIntervalDaysIntNumber of days between rotation reminders for the secret.
secretString!Value of the project secret.

ProjectSecretDeleteInput

Autogenerated input type of ProjectSecretDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the project secret.
projectPathID!Project of the secret.

ProjectSecretUpdateInput

Autogenerated input type of ProjectSecretUpdate.

Arguments

NameTypeDescription
branchStringNew branches that can access the secret.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringNew description of the project secret.
environmentStringNew environments that can access the secret.
metadataCasInt!This should match the current metadata version of the project secret being updated.
nameString!Name of the project secret to update.
projectPathID!Project of the secret.
rotationIntervalDaysIntNumber of days between rotation reminders for the secret.
secretStringNew value of the project secret.

ProjectSecretsManagerDeprovisionInput

Autogenerated input type of ProjectSecretsManagerDeprovision.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Project of the secrets manager.

ProjectSecretsManagerInitializeInput

Autogenerated input type of ProjectSecretsManagerInitialize.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Project of the secrets manager.

ProjectSecretsPermissionDeleteInput

Autogenerated input type of ProjectSecretsPermissionDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
principalPrincipalInput!User/MemberRole/Role whose access is being removed.
projectPathID!Project from which the permissions are removed.

ProjectSecretsPermissionUpdateInput

Autogenerated input type of ProjectSecretsPermissionUpdate.

Arguments

NameTypeDescription
actions[SecretsManagementAction!]!Actions that can be performed on secrets.
clientMutationIdStringA unique identifier for the client performing the mutation.
expiredAtISO8601DateExpiration date for Secret Permission (optional).
principalPrincipalInput!User/MemberRole/Role that is provided access.
projectPathID!Project to which the permissions are added.

ProjectSecurityExclusionCreateInput

Autogenerated input type of ProjectSecurityExclusionCreate.

Arguments

NameTypeDescription
activeBoolean!Whether the exclusion is active.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringOptional description for the exclusion.
projectPathID!Full path of the project the exclusion will be associated with.
scannerExclusionScannerEnum!Scanner to ignore values for based on the exclusion.
typeExclusionTypeEnum!Type of the exclusion.
valueString!Value of the exclusion.

ProjectSecurityExclusionDeleteInput

Autogenerated input type of ProjectSecurityExclusionDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idSecurityProjectSecurityExclusionID!Global ID of the exclusion to be deleted.

ProjectSecurityExclusionUpdateInput

Autogenerated input type of ProjectSecurityExclusionUpdate.

Arguments

NameTypeDescription
activeBooleanWhether the exclusion is active.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringOptional description for the exclusion.
idSecurityProjectSecurityExclusionID!Global ID of the exclusion to be updated.
scannerExclusionScannerEnumScanner to ignore values for based on the exclusion.
typeExclusionTypeEnumType of the exclusion.
valueStringValue of the exclusion.

ProjectSetComplianceFrameworkInput

Autogenerated input type of ProjectSetComplianceFramework.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
complianceFrameworkIdComplianceManagementFrameworkIDID of the compliance framework to assign to the project. Set to null to unset.
projectIdProjectID!ID of the project to change the compliance framework of.

ProjectSetContinuousVulnerabilityScanningInput

Autogenerated input type of ProjectSetContinuousVulnerabilityScanning.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enableBoolean!Desired status for continuous vulnerability scanning feature.
projectPathID!Full path of the project.

ProjectSetLockedInput

Autogenerated input type of ProjectSetLocked.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
filePathString!Full path to the file.
lockBoolean!Whether or not to lock the file path.
projectPathID!Full path of the project to mutate.

ProjectSettingsUpdateInput

Autogenerated input type of ProjectSettingsUpdate.

Arguments

NameTypeDescription
aiAuditEventsStorageEnabledBooleanStatus: Experiment. Introduced in GitLab 19.2.

Indicates whether AI audit events are stored for the project.
clientMutationIdStringA unique identifier for the client performing the mutation.
duoContextExclusionSettingsDuoContextExclusionSettingsInputSettings for excluding files from Duo context.
duoFeaturesEnabledBooleanIndicates whether GitLab Duo features are enabled for the project.
duoSastFpDetectionEnabledBooleanIndicates whether SAST False Positive Detection is enabled for the project.
duoSastVrWorkflowEnabledBooleanIndicates whether SAST Vulnerability Resolution workflow is enabled for the project.
duoSecretDetectionFpEnabledBooleanIndicates whether Secret Detection False Positive Detection is enabled for the project.
fullPathID!Full Path of the project the settings belong to.
toolApprovalForSessionEnabledBooleanIndicates whether tool approval for Duo Workflow sessions is enabled for the project.
webBasedCommitSigningEnabledBooleanStatus: Experiment. Introduced in GitLab 18.2.

Indicates whether web-based commit signing is enabled for the project.

ProjectSubscriptionCreateInput

Autogenerated input type of ProjectSubscriptionCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathString!Full path of the downstream project of the Project Subscription.
upstreamPathString!Full path of the upstream project of the Project Subscription.

ProjectSubscriptionDeleteInput

Autogenerated input type of ProjectSubscriptionDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
subscriptionIdCiSubscriptionsProjectID!ID of the subscription to delete.

ProjectSyncForkInput

Autogenerated input type of ProjectSyncFork.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project to initialize.
targetBranchString!Ref of the fork to fetch into.

ProjectTargetBranchRuleCreateInput

Autogenerated input type of ProjectTargetBranchRuleCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name for the target branch rule.
projectIdProjectID!Project ID for the target branch rule.
targetBranchString!Target branch for the target branch rule.

ProjectTargetBranchRuleDestroyInput

Autogenerated input type of ProjectTargetBranchRuleDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idProjectsTargetBranchRuleID!ID for the target branch rule.

ProjectTrackedContextInput

Input for specifying a project tracked context.

Arguments

NameTypeDescription
nameString!Name of the tracked context.
typeProjectTrackedContext!Type of the tracked context.

ProjectTransferInput

Autogenerated input type of ProjectTransfer.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idProjectID!Global ID of the project to transfer.
namespaceIdNamespaceID!Global ID of the target namespace.

ProjectUpdateComplianceFrameworksInput

Autogenerated input type of ProjectUpdateComplianceFrameworks.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
complianceFrameworkIds[ComplianceManagementFrameworkID!]!IDs of the compliance framework to update for the project.
projectIdProjectID!ID of the project to change the compliance framework of.

PrometheusIntegrationCreateInput

Autogenerated input type of PrometheusIntegrationCreate.

Arguments

NameTypeDescriptionDefault
activeBoolean!Whether the integration is receiving alerts.
apiUrlStringDeprecated in GitLab 18.2. Feature removed in 16.0.
clientMutationIdStringA unique identifier for the client performing the mutation.
nameStringName of the integration."Prometheus"
payloadAttributeMappings[AlertManagementPayloadAlertFieldInput!]Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExampleJsonStringExample of an alert payload.
projectPathID!Project to create the integration in.
typeAlertManagementIntegrationTypeType of integration to create. Cannot be changed after creation.HTTP

PrometheusIntegrationResetTokenInput

Autogenerated input type of PrometheusIntegrationResetToken.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIntegrationsPrometheusID!ID of the integration to mutate.

PrometheusIntegrationUpdateInput

Autogenerated input type of PrometheusIntegrationUpdate.

Arguments

NameTypeDescription
activeBooleanWhether the integration is receiving alerts.
apiUrlStringDeprecated in GitLab 18.2. Feature removed in 16.0.
clientMutationIdStringA unique identifier for the client performing the mutation.
idIntegrationsPrometheusID!ID of the integration to mutate.
nameStringName of the integration.
payloadAttributeMappings[AlertManagementPayloadAlertFieldInput!]Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExampleJsonStringExample of an alert payload.

PromoteToEpicInput

Autogenerated input type of PromoteToEpic.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathIDGroup the promoted epic will belong to.
iidString!IID of the issue to mutate.
projectPathID!Project the issue to mutate is in.

PushAccessLevelInput

Defines which user roles, users, deploy keys, or groups can push to a protected branch.

Arguments

NameTypeDescription
accessLevelIntAccess level allowed to perform action.
deployKeyIdDeployKeyIDDeploy key assigned to the access level.
groupIdGroupIDGroup associated with the access level.
memberRoleIdMemberRoleIDStatus: Experiment. Introduced in GitLab 19.2.

Custom member role associated with the access level.
userIdUserIDUser associated with the access level.

RefreshFindingTokenStatusInput

Autogenerated input type of RefreshFindingTokenStatus.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
vulnerabilityIdVulnerabilityID!Global ID of the Vulnerability whose token status should be refreshed.

RefreshSecurityFindingTokenStatusInput

Autogenerated input type of RefreshSecurityFindingTokenStatus.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
securityFindingUuidString!UUID of the Security::Finding whose token status should be refreshed (MR context).

RefreshStandardsAdherenceChecksInput

Autogenerated input type of RefreshStandardsAdherenceChecks.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Group path.

RefreshVulnerabilityFindingTokenStatusInput

Autogenerated input type of RefreshVulnerabilityFindingTokenStatus.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
vulnerabilityIdVulnerabilityID!Global ID of the Vulnerability whose token status should be refreshed.

ReleaseAssetLinkCreateInput

Autogenerated input type of ReleaseAssetLinkCreate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
directAssetPathStringRelative path for a direct asset link.
linkTypeReleaseAssetLinkTypeType of the asset link.OTHER
nameString!Name of the asset link.
projectPathID!Full path of the project the asset link is associated with.
tagNameString!Name of the associated release’s tag.
urlString!URL of the asset link.

ReleaseAssetLinkDeleteInput

Autogenerated input type of ReleaseAssetLinkDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idReleasesLinkID!ID of the release asset link to delete.

ReleaseAssetLinkInput

Fields that are available when modifying a release asset link.

Arguments

NameTypeDescriptionDefault
directAssetPathStringRelative path for a direct asset link.
linkTypeReleaseAssetLinkTypeType of the asset link.OTHER
nameString!Name of the asset link.
urlString!URL of the asset link.

ReleaseAssetLinkUpdateInput

Autogenerated input type of ReleaseAssetLinkUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
directAssetPathStringRelative path for a direct asset link.
idReleasesLinkID!ID of the release asset link to update.
linkTypeReleaseAssetLinkTypeType of the asset link.
nameStringName of the asset link.
urlStringURL of the asset link.

ReleaseAssetsInput

Fields that are available when modifying release assets.

Arguments

NameTypeDescription
links[ReleaseAssetLinkInput!]List of asset links to associate to the release.

ReleaseCreateInput

Autogenerated input type of ReleaseCreate.

Arguments

NameTypeDescription
assetsReleaseAssetsInputAssets associated to the release.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription (also known as “release notes”) of the release.
milestones[String!]Title of each milestone the release is associated with. GitLab Premium customers can specify group milestones.
nameStringName of the release.
projectPathID!Full path of the project the release is associated with.
refStringCommit SHA or branch name to use if creating a new tag.
releasedAtTimeDate and time for the release. Defaults to the current time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). Only provide this field if creating an upcoming or historical release.
tagMessageStringMessage to use if creating a new annotated tag.
tagNameString!Name of the tag to associate with the release.

ReleaseDeleteInput

Autogenerated input type of ReleaseDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project the release is associated with.
tagNameString!Name of the tag associated with the release to delete.

ReleaseUpdateInput

Autogenerated input type of ReleaseUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription (release notes) of the release.
milestones[String!]Title of each milestone the release is associated with. GitLab Premium customers can specify group milestones.
nameStringName of the release.
projectPathID!Full path of the project the release is associated with.
releasedAtTimeRelease date.
tagNameString!Name of the tag associated with the release.

RemoveProjectFromSecurityDashboardInput

Autogenerated input type of RemoveProjectFromSecurityDashboard.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idProjectID!ID of the project to remove from the Instance Security Dashboard.

RepositionImageDiffNoteInput

Autogenerated input type of RepositionImageDiffNote.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idDiffNoteID!Global ID of the DiffNote to update.
positionUpdateDiffImagePositionInput!Position of the note on a diff.

RequirementLegacyFilterInput

Arguments

NameTypeDescription
legacyIids[String!]!List of legacy requirement IIDs of work items. or example ["1", "2"].

RestorePagesDeploymentInput

Autogenerated input type of RestorePagesDeployment.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idPagesDeploymentID!ID of the Pages Deployment.

ResyncSecurityPoliciesInput

Autogenerated input type of ResyncSecurityPolicies.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathString!Full path of the project or group.
relationshipRelationshipTypeRelationship of the policies to resync.DIRECT

RunnerAssignToProjectInput

Autogenerated input type of RunnerAssignToProject.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project to which the runner will be assigned.
runnerIdCiRunnerID!ID of the runner to assign to the project .

RunnerBulkPauseInput

Autogenerated input type of RunnerBulkPause.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[CiRunnerID!]!IDs of the runners to pause or unpause.
pausedBoolean!Indicates the runner is not allowed to receive jobs.

RunnerCacheClearInput

Autogenerated input type of RunnerCacheClear.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectIdProjectID!Global ID of the project that will have its runner cache cleared.

RunnerCreateInput

Autogenerated input type of RunnerCreate.

Arguments

NameTypeDescription
accessLevelCiRunnerAccessLevelAccess level of the runner.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the runner.
groupIdGroupIDGlobal ID of the group that the runner is created in (valid only for group runner).
lockedBooleanIndicates the runner is locked.
maintenanceNoteStringRunner’s maintenance notes.
maximumTimeoutIntMaximum timeout (in seconds) for jobs processed by the runner.
pausedBooleanIndicates the runner is not allowed to receive jobs.
privateProjectsMinutesCostFactorFloatStatus: Experiment. Introduced in GitLab 17.7.

Private projects’ “compute cost factor” associated with the runner (GitLab.com only).
projectIdProjectIDGlobal ID of the project that the runner is created in (valid only for project runner).
publicProjectsMinutesCostFactorFloatStatus: Experiment. Introduced in GitLab 17.7.

Public projects’ “compute cost factor” associated with the runner (GitLab.com only).
runUntaggedBooleanIndicates the runner is able to run untagged jobs.
runnerTypeCiRunnerType!Type of the runner to create.
tagList[String!]Tags associated with the runner.
tokenExpiresAtTimeToken expiration time (ISO 8601 format). Must be between 5 minutes and 15 days in the future, and cannot exceed instance/group/project limits.
tokenRotationDeadlineTimeStatus: Experiment. Introduced in GitLab 18.10.

Deadline for token rotation (ISO 8601 format). Requires tokenExpiresAt. Must be <= tokenExpiresAt. Setting both to the same value disables token rotation.

RunnerDeleteInput

Autogenerated input type of RunnerDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idCiRunnerID!ID of the runner to delete.

RunnerUnassignFromProjectInput

Autogenerated input type of RunnerUnassignFromProject.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project from which the runner will be unassigned.
runnerIdCiRunnerID!ID of the runner to unassign from the project.

RunnerUpdateInput

Autogenerated input type of RunnerUpdate.

Arguments

NameTypeDescription
accessLevelCiRunnerAccessLevelAccess level of the runner.
activeBooleanDeprecated in GitLab 14.8. Renamed. Use paused instead.
associatedProjects[ProjectID!]Projects associated with the runner. Available only for project runners.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the runner.
idCiRunnerID!ID of the runner to update.
lockedBooleanIndicates the runner is locked.
maintenanceNoteStringRunner’s maintenance notes.
maximumTimeoutIntMaximum timeout (in seconds) for jobs processed by the runner.
pausedBooleanIndicates the runner is not allowed to receive jobs.
privateProjectsMinutesCostFactorFloatStatus: Experiment. Introduced in GitLab 17.7.

Private projects’ “compute cost factor” associated with the runner (GitLab.com only).
publicProjectsMinutesCostFactorFloatStatus: Experiment. Introduced in GitLab 17.7.

Public projects’ “compute cost factor” associated with the runner (GitLab.com only).
runUntaggedBooleanIndicates the runner is able to run untagged jobs.
tagList[String!]Tags associated with the runner.

RunnersExportUsageInput

Autogenerated input type of RunnersExportUsage.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
fromDateISO8601DateUTC start date of the period to report on. Defaults to the start of last full month.
fullPathIDFilter jobs by the full path of the group or project they belong to. For example, gitlab-org or gitlab-org/gitlab. Available only to administrators and users with the Maintainer role for the group (when a group is specified), or project (when a project is specified). Limited to runners from 5000 child projects.
maxProjectCountIntMaximum number of projects to return. All other runner usage will be attributed to an <Other projects> entry. Defaults to 1000 projects.1000
runnerTypeCiRunnerTypeScope of the runners to include in the report.
toDateISO8601DateUTC end date of the period to report on. " \ “Defaults to the end of the month specified by fromDate.

RunnersRegistrationTokenResetInput

Autogenerated input type of RunnersRegistrationTokenReset.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIDID of the project or group to reset the token for. Omit if resetting instance runner token.
typeCiRunnerType!Scope of the object to reset the token for.

SafeDisablePipelineVariablesInput

Autogenerated input type of SafeDisablePipelineVariables.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Full path of the group to disable pipeline variables for.

SastCiConfigurationAnalyzersEntityInput

Represents the analyzers entity in SAST CI configuration.

Arguments

NameTypeDescription
enabledBoolean!State of the analyzer.
nameString!Name of analyzer.
variables[SastCiConfigurationEntityInput!]List of variables for the analyzer.

SastCiConfigurationEntityInput

Represents an entity in SAST CI configuration.

Arguments

NameTypeDescription
defaultValueString!Default value that is used if value is empty.
fieldString!CI keyword of entity.
valueString!Current value of the entity.

SastCiConfigurationInput

Represents a CI configuration of SAST.

Arguments

NameTypeDescription
analyzers[SastCiConfigurationAnalyzersEntityInput!]List of analyzers and related variables for the SAST configuration.
global[SastCiConfigurationEntityInput!]List of global entities related to SAST configuration.
pipeline[SastCiConfigurationEntityInput!]List of pipeline entities related to SAST configuration.

SavedReplyCreateInput

Autogenerated input type of SavedReplyCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
contentString!Content of the saved reply.
nameString!Name of the saved reply.

SavedReplyDestroyInput

Autogenerated input type of SavedReplyDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idUsersSavedReplyID!Global ID of the user saved reply.

SavedReplyUpdateInput

Autogenerated input type of SavedReplyUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
contentString!Content of the saved reply.
idUsersSavedReplyID!Global ID of the user saved reply.
nameString!Name of the saved reply.

ScanExecutionPolicyCommitInput

Autogenerated input type of ScanExecutionPolicyCommit.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathStringFull path of the project.
nameString!Name of the policy. If the name is null, the name field from policy_yaml is used.
operationModeMutationOperationMode!Changes the operation mode.
policyYamlString!YAML snippet of the policy.
projectPathIDDeprecated in GitLab 14.10. Use fullPath.

SecretPermissionDeleteInput

Autogenerated input type of SecretPermissionDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
principalPrincipalInput!Whose permission to be deleted.
projectPathID!Project permissions for the secret.

SecretPermissionUpdateInput

Autogenerated input type of SecretPermissionUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
expiredAtISO8601DateExpiration date for Secret Permission (optional).
permissions[String!]!Permissions to be provided. [‘create’, ‘update’, ‘read’, ‘delete’].
principalPrincipalInput!User/MemberRole/Role that is provided access.
projectPathID!Project to which the permissions are added.

SecretsManagerEnableAddOnInput

Autogenerated input type of SecretsManagerEnableAddOn.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Full path of the top-level group to enable the Secrets Manager add-on for.

SecretsManagerInstanceEnableAddOnInput

Autogenerated input type of SecretsManagerInstanceEnableAddOn.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.

SecretsManagerInstanceStartTrialInput

Autogenerated input type of SecretsManagerInstanceStartTrial.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.

SecretsManagerStartTrialInput

Autogenerated input type of SecretsManagerStartTrial.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Full path of the top-level group to start a Secrets Manager trial for.

SecurityAttributeCreateInput

Autogenerated input type of SecurityAttributeCreate.

Arguments

NameTypeDescription
attributes[SecurityAttributeInput!]!Attributes to create.
categoryIdSecurityCategoryID!Global ID of the security category.
clientMutationIdStringA unique identifier for the client performing the mutation.
namespaceIdNamespaceID!Global ID of the namespace.

SecurityAttributeDestroyInput

Autogenerated input type of SecurityAttributeDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idSecurityAttributeID!Global ID of the security attribute to destroy.

SecurityAttributeInput

Input type for security attribute.

Arguments

NameTypeDescription
colorColor!Color of the security attribute.
descriptionString!Description of the security attribute.
nameString!Name of the security attribute.

SecurityAttributeProjectUpdateInput

Autogenerated input type of SecurityAttributeProjectUpdate.

Arguments

NameTypeDescription
addAttributeIds[SecurityAttributeID!]Global IDs of the security attributes to add to the project.
clientMutationIdStringA unique identifier for the client performing the mutation.
projectIdProjectID!Global ID of the project.
removeAttributeIds[SecurityAttributeID!]Global IDs of the security attributes to remove from the project.

SecurityAttributeUpdateInput

Autogenerated input type of SecurityAttributeUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
colorColorColor of the security attribute.
descriptionStringDescription of the security attribute.
idSecurityAttributeID!Global ID of the security attribute.
nameStringName of the security attribute.

SecurityCategoryCreateInput

Autogenerated input type of SecurityCategoryCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the security category.
multipleSelectionBooleanWhether multiple attributes can be selected.
nameString!Name of the security category.
namespaceIdNamespaceID!Global ID of the category namespace.

SecurityCategoryDestroyInput

Autogenerated input type of SecurityCategoryDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idSecurityCategoryID!Global ID of the security category to destroy.

SecurityCategoryUpdateInput

Autogenerated input type of SecurityCategoryUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the security category.
idSecurityCategoryID!Global ID of the security category.
nameStringName of the security category.
namespaceIdNamespaceID!Global ID of the category namespace.

SecurityFindingCreateIssueInput

Autogenerated input type of SecurityFindingCreateIssue.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectProjectID!ID of the project to attach the issue to.
uuidString!UUID of the security finding to be used to create an issue.

SecurityFindingCreateMergeRequestInput

Autogenerated input type of SecurityFindingCreateMergeRequest.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
uuidString!UUID of the security finding to be used to create a merge request.

SecurityFindingCreateVulnerabilityInput

Autogenerated input type of SecurityFindingCreateVulnerability.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
uuidString!UUID of the security finding to be used to create a vulnerability.

SecurityFindingDismissInput

Autogenerated input type of SecurityFindingDismiss.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentStringComment why finding should be dismissed.
dismissalReasonVulnerabilityDismissalReasonReason why finding should be dismissed.
uuidString!UUID of the finding to be dismissed.

SecurityFindingExternalIssueLinkCreateInput

Autogenerated input type of SecurityFindingExternalIssueLinkCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
externalTrackerVulnerabilityExternalIssueLinkExternalTracker!External tracker type of the external issue link.
linkTypeVulnerabilityExternalIssueLinkType!Type of the external issue link.
projectProjectID!ID of the project to attach the issue to.
uuidString!UUID of the security finding to be used to create an issue.

SecurityFindingJiraIssueFormUrlCreateInput

Autogenerated input type of SecurityFindingJiraIssueFormUrlCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectProjectID!ID of the project to attach the issue to.
uuidString!UUID of the security finding to be used to create an issue.

SecurityFindingRevertToDetectedInput

Autogenerated input type of SecurityFindingRevertToDetected.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentStringComment that explains why finding was reverted to detected status.
uuidString!UUID of the finding to be dismissed.

SecurityFindingSeverityOverrideInput

Autogenerated input type of SecurityFindingSeverityOverride.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
severityVulnerabilitySeverity!New severity value for the finding.
uuidString!UUID of the finding to modify.

SecurityPolicyProjectAssignInput

Autogenerated input type of SecurityPolicyProjectAssign.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathStringFull path of the project or group.
projectPathIDDeprecated in GitLab 14.10. Use fullPath.
securityPolicyProjectIdProjectID!ID of the security policy project.

SecurityPolicyProjectCreateAsyncInput

Autogenerated input type of SecurityPolicyProjectCreateAsync.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathString!Full path of the project or group.

SecurityPolicyProjectCreateInput

Autogenerated input type of SecurityPolicyProjectCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathStringFull path of the project or group.
projectPathIDDeprecated in GitLab 14.10. Use fullPath.

SecurityPolicyProjectUnassignInput

Autogenerated input type of SecurityPolicyProjectUnassign.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathStringFull path of the project or group.
projectPathIDDeprecated in GitLab 14.10. Use fullPath.

SecurityRefInput

Arguments

NameTypeDescription
nameString!Name of the ref.
refTypeSecurityTrackedRefType!Type of ref (branch or tag).

SecurityRefsTrackInput

Autogenerated input type of SecurityRefsTrack.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project.
refs[SecurityRefInput!]!Array of refs to be tracked.

SecurityRefsUntrackInput

Autogenerated input type of SecurityRefsUntrack.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
refIds[SecurityProjectTrackedContextID!]!Global IDs of the tracked refs to stop tracking.

SecurityScanProfileAttachInput

Autogenerated input type of SecurityScanProfileAttach.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
groupIds[GroupID!]Group IDs to attach the profile to.[]
projectIds[ProjectID!]Project IDs to attach the profile to.[]
securityScanProfileIdSecurityScanProfileID!Security scan profile ID to attach.

SecurityScanProfileAutoRemediationInput

Auto-remediation configuration for a dependency scanning post-processing scan profile.

Arguments

NameTypeDescription
cooldownIntStatus: Experiment. Introduced in GitLab 19.3.

Minimum number of days after a package is released before it can be used.
enabledBooleanStatus: Experiment. Introduced in GitLab 19.3.

Whether auto-remediation is enabled.
openMergeRequestsLimitIntStatus: Experiment. Introduced in GitLab 19.3.

Maximum number of open auto-remediation merge requests at once.
severityLevelVulnerabilitySeverityStatus: Experiment. Introduced in GitLab 19.3.

Minimum vulnerability severity that triggers an automated upgrade. Findings below this threshold are skipped.
upgradePolicySecurityScanProfileUpgradePolicyStatus: Experiment. Introduced in GitLab 19.3.

Highest version bump allowed when remediating.

SecurityScanProfileConfigurationInput

Typed configuration for a scan profile trigger. Exactly one member may be set, and it must match the scan profile type.

Arguments

NameTypeDescription
dependencyScanningPostProcessingSecurityScanProfileDependencyScanningPostProcessingConfigurationInputStatus: Experiment. Introduced in GitLab 19.3.

Configuration for a dependency scanning post-processing scan profile.
sastSecurityScanProfileSastConfigurationInputStatus: Experiment. Introduced in GitLab 19.4.

Configuration for a SAST scan profile.
secretDetectionSecurityScanProfileSecretDetectionConfigurationInputStatus: Experiment. Introduced in GitLab 19.3.

Configuration for a secret detection scan profile.
triageAndRemediationSecurityScanProfileTriageAndRemediationConfigurationInputStatus: Experiment. Introduced in GitLab 19.4.

Configuration for a triage and remediation scan profile.

SecurityScanProfileCreateInput

Autogenerated input type of SecurityScanProfileCreate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionString!Description of the scan profile.
nameString!Name of the scan profile.
namespaceIdNamespaceID!Global ID of the top level namespace to create the scan profile for.
scanTypeSecurityScanProfileType!Type of the scan profile.
stripDefaultsBooleanWhen true, trigger configuration values equal to the defaults are removed before storage so only overrides are persisted. When false, the configuration is stored as provided, ignoring defaults.true
triggers[SecurityScanProfileTriggerInput!]!Triggers with optional configuration for the scan profile. At least one is required.

SecurityScanProfileDeleteInput

Autogenerated input type of SecurityScanProfileDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idSecurityScanProfileID!Global ID of the scan profile to delete.

SecurityScanProfileDependencyScanningPostProcessingConfigurationInput

Configuration for a dependency scanning post-processing scan profile.

Arguments

NameTypeDescription
autoRemediationSecurityScanProfileAutoRemediationInputStatus: Experiment. Introduced in GitLab 19.3.

Auto-remediation configuration.

SecurityScanProfileDetachInput

Autogenerated input type of SecurityScanProfileDetach.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
groupIds[GroupID!]Group IDs to detach the profile from.[]
projectIds[ProjectID!]Project IDs to detach the profile from.[]
securityScanProfileIdSecurityScanProfileID!Security scan profile ID to detach.

SecurityScanProfileSastConfigurationInput

Configuration for a SAST scan profile.

Arguments

NameTypeDescription
advancedSastPartialScanSecurityScanProfileAdvancedSastPartialScanStatus: Experiment. Introduced in GitLab 19.4.

Controls GitLab Advanced SAST diff-based scanning. Use ‘differential’ to enable, ‘false’ to disable.
analyzerImageTagStringStatus: Experiment. Introduced in GitLab 19.4.

Tag of the analyzer image to use. Warning: Setting this value overrides the pinned image tag for all SAST analyzers, which can cause analyzer failures if they require specific versions.
excludedAnalyzers[String!]Status: Experiment. Introduced in GitLab 19.4.

Analyzers excluded from the scan.
excludedPaths[String!]Status: Experiment. Introduced in GitLab 19.4.

Glob paths excluded from the scan.
gitlabAdvSastIncrScanBooleanStatus: Experiment. Introduced in GitLab 19.4.

Whether GitLab Advanced SAST incremental scanning is enabled.
imageSuffixSecurityScanProfileImageSuffixStatus: Experiment. Introduced in GitLab 19.4.

Suffix appended to the analyzer image name.
secureAnalyzersPrefixStringStatus: Experiment. Introduced in GitLab 19.4.

Prefix for the container registry from which the analyzer image is pulled.

SecurityScanProfileSastFalsePositiveInput

Configuration for the SAST false positive detection trigger of a triage and remediation scan profile.

Arguments

NameTypeDescription
cweClasses[CweIdentifier!]Status: Experiment. Introduced in GitLab 19.4.

CWE identifiers to restrict false positive detection to.
runModeSecurityScanProfileRunModeStatus: Experiment. Introduced in GitLab 19.4.

Whether false positive detection runs automatically or only when triggered by a user.
severityLevelVulnerabilitySeverityStatus: Experiment. Introduced in GitLab 19.4.

Minimum vulnerability severity that triggers false positive detection. Findings below this threshold are skipped.

SecurityScanProfileSastVulnerabilityResolutionInput

Configuration for the SAST vulnerability resolution trigger of a triage and remediation scan profile.

Arguments

NameTypeDescription
cweClasses[CweIdentifier!]Status: Experiment. Introduced in GitLab 19.4.

CWE identifiers to restrict resolution to.
falsePositiveConfidenceSecurityScanProfileFalsePositiveConfidenceStatus: Experiment. Introduced in GitLab 19.4.

Restricts resolution to findings carrying the given false positive assessment.
openMergeRequestsLimitIntStatus: Experiment. Introduced in GitLab 19.4.

Maximum number of open merge requests resolution may have at once, from 0 to 100. Null means no limit.
runModeSecurityScanProfileRunModeStatus: Experiment. Introduced in GitLab 19.4.

Whether resolution runs automatically or only when triggered by a user.
severityLevelVulnerabilitySeverityStatus: Experiment. Introduced in GitLab 19.4.

Minimum vulnerability severity that triggers a resolution attempt. Findings below this threshold are skipped.

SecurityScanProfileSecretDetectionConfigurationInput

Configuration for a secret detection scan profile.

Arguments

NameTypeDescription
excludedPaths[String!]Status: Experiment. Introduced in GitLab 19.3.

Glob paths excluded from the scan.
historicScanBooleanStatus: Experiment. Introduced in GitLab 19.3.

Whether to scan the full git history instead of only the current state.
imageSuffixSecurityScanProfileImageSuffixStatus: Experiment. Introduced in GitLab 19.3.

Suffix appended to the analyzer image name.
logOptionsStringStatus: Experiment. Introduced in GitLab 19.3.

Options passed to git log to control the commit range scanned.
rulesetGitReferenceStringStatus: Experiment. Introduced in GitLab 19.3.

Git reference of the remote ruleset configuration to use.
secureAnalyzersPrefixStringStatus: Experiment. Introduced in GitLab 19.3.

Prefix for the container registry from which the analyzer image is pulled.

SecurityScanProfileSecretDetectionFalsePositiveInput

Configuration for the secret detection false positive detection trigger of a triage and remediation scan profile.

Arguments

NameTypeDescription
runModeSecurityScanProfileRunModeStatus: Experiment. Introduced in GitLab 19.4.

Whether false positive detection runs automatically or only when triggered by a user.
severityLevelVulnerabilitySeverityStatus: Experiment. Introduced in GitLab 19.4.

Minimum vulnerability severity that triggers false positive detection. Findings below this threshold are skipped.

SecurityScanProfileTriageAndRemediationConfigurationInput

Configuration for a triage and remediation scan profile trigger. Exactly one member may be set, and it must match the trigger type it is attached to.

Arguments

NameTypeDescription
sastFalsePositiveSecurityScanProfileSastFalsePositiveInputStatus: Experiment. Introduced in GitLab 19.4.

Configuration for the SAST false positive detection trigger.
sastVulnerabilityResolutionSecurityScanProfileSastVulnerabilityResolutionInputStatus: Experiment. Introduced in GitLab 19.4.

Configuration for the SAST vulnerability resolution trigger.
sbomIngestedSecurityScanProfileDependencyScanningPostProcessingConfigurationInputStatus: Experiment. Introduced in GitLab 19.4.

Configuration for the SBOM ingested trigger.
secretDetectionFalsePositiveSecurityScanProfileSecretDetectionFalsePositiveInputStatus: Experiment. Introduced in GitLab 19.4.

Configuration for the secret detection false positive detection trigger.
vulnerabilityEnrichmentSecurityScanProfileVulnerabilityEnrichmentInputStatus: Experiment. Introduced in GitLab 19.4.

Configuration for the vulnerability enrichment trigger.

SecurityScanProfileTriggerInput

A trigger, with optional configuration, for a scan profile.

Arguments

NameTypeDescription
configurationSecurityScanProfileConfigurationInputStatus: Experiment. Introduced in GitLab 19.3.

Configuration attached to the trigger. When set, exactly one member must be present and it must match the scan profile type.
triggerTypeScanProfileTriggerType!Type of the trigger.

SecurityScanProfileUpdateInput

Autogenerated input type of SecurityScanProfileUpdate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the scan profile.
idSecurityScanProfileID!Global ID of the scan profile to update.
nameStringName of the scan profile.
stripDefaultsBooleanWhen true, trigger configuration values equal to the defaults are removed before storage so only overrides are persisted. When false, the configuration is stored as provided, ignoring defaults.true
triggers[SecurityScanProfileTriggerInput!]Complete set of triggers with optional configuration for the scan profile. When provided, triggers omitted from the list are removed, and a trigger sent without a configuration has its existing configuration removed.

SecurityScanProfileVulnerabilityEnrichmentInput

Configuration for the vulnerability enrichment trigger of a triage and remediation scan profile.

Arguments

NameTypeDescription
runModeSecurityScanProfileRunModeStatus: Experiment. Introduced in GitLab 19.4.

Whether enrichment runs automatically or only when triggered by a user.
severityLevelVulnerabilitySeverityStatus: Experiment. Introduced in GitLab 19.4.

Minimum vulnerability severity that triggers enrichment. Findings below this threshold are skipped.

SecurityTrainingUpdateInput

Autogenerated input type of SecurityTrainingUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
isEnabledBoolean!Sets the training provider as enabled for the project.
isPrimaryBooleanSets the training provider as primary for the project.
projectPathID!Full path of the project.
providerIdSecurityTrainingProviderID!ID of the provider.

SetContainerScanningForRegistryInput

Autogenerated input type of SetContainerScanningForRegistry.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enableBoolean!Desired status for container scanning for registry feature.
namespacePathID!Full path of the namespace (project).

SetCvsForContainerScanningInput

Autogenerated input type of SetCvsForContainerScanning.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enableBoolean!Desired status for CVS for container scanning.
projectPathID!Full path of the project.

SetCvsForDependencyScanningInput

Autogenerated input type of SetCvsForDependencyScanning.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enableBoolean!Desired status for CVS for dependency scanning.
projectPathID!Full path of the project.

SetGroupCustomAttributeInput

Autogenerated input type of SetGroupCustomAttribute.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
groupPathID!Full path of the group.
keyString!Key of the custom attribute.
valueString!Value of the custom attribute.

SetGroupSecretPushProtectionInput

Autogenerated input type of SetGroupSecretPushProtection.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespacePathID!Full path of the group.
projectsToExclude[Int!]IDs of projects to exclude from the feature.
secretPushProtectionEnabledBoolean!Whether to enable the feature.

SetGroupValidityChecksInput

Autogenerated input type of SetGroupValidityChecks.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespacePathID!Full path of the group.
projectsToExclude[Int!]IDs of projects to exclude from validity checks configuration.
validityChecksEnabledBoolean!Whether to enable validity checks for all projects in the group.

SetLicenseConfigurationSourceInput

Autogenerated input type of SetLicenseConfigurationSource.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project.
sourceSecurityPreferredLicenseSourceConfiguration!Preferred source of license information for dependencies.

SetLicenseScanningForCyclonedxInput

Autogenerated input type of SetLicenseScanningForCyclonedx.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enableBoolean!Desired status for license scanning for CycloneDX files.
projectPathID!Full path of the project.

SetPagesForceHttpsInput

Autogenerated input type of SetPagesForceHttps.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Path of the project to set the pages force HTTPS.
valueBoolean!Indicates user wants to enforce HTTPS on their pages.

SetPagesUseUniqueDomainInput

Autogenerated input type of SetPagesUseUniqueDomain.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Path of the project to set the pages to use unique domains.
valueBoolean!Indicates user wants to use unique subdomains for their pages.

SetPreReceiveSecretDetectionInput

Autogenerated input type of SetPreReceiveSecretDetection.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enableBoolean!Desired status for secret push protection feature.
namespacePathID!Full path of the namespace (project).

SetSecretPushProtectionInput

Autogenerated input type of SetSecretPushProtection.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enableBoolean!Desired status for secret push protection feature.
namespacePathID!Full path of the namespace (project).

SetValidityChecksInput

Autogenerated input type of SetValidityChecks.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enableBoolean!Desired status for validity checks feature.
namespacePathID!Full path of the namespace (project).

SnippetBlobActionInputType

Represents an action to perform over a snippet file.

Arguments

NameTypeDescription
actionSnippetBlobActionEnum!Type of input action.
contentStringSnippet file content.
filePathString!Path of the snippet file.
previousPathStringPrevious path of the snippet file.

StarProjectInput

Autogenerated input type of StarProject.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectIdProjectID!Full path of the project to star or unstar.
starredBoolean!Indicates whether to star or unstar the project.

StartVulnerabilityWorkflowInput

Autogenerated input type of StartVulnerabilityWorkflow.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
findingUuids[String!]Finding UUIDs to process, up to 1000. If omitted, all project findings are processed.
projectIdProjectID!Global ID of the project.
severities[VulnerabilitySeverity!]Severities to process. If omitted, all severities are processed.
workflowVulnerabilityDuoWorkflow!Workflow to execute.

StatusMappingInput

Input for mapping a removed status to a replacement status.

Arguments

NameTypeDescription
newStatusIdWorkItemsStatusesStatusID!Global ID of the replacement status.
oldStatusIdWorkItemsStatusesStatusID!Global ID of the status being removed/replaced.

TagCreateInput

Autogenerated input type of TagCreate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
messageStringTagging message.""
nameString!Name of the tag.
projectPathID!Project full path the branch is associated with.
refString!Tag name or commit SHA to create tag from.

TagDeleteInput

Autogenerated input type of TagDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the tag.
projectPathID!Project full path the branch is associated with.

TaskListToggleInput

Toggles a single task list item checkbox instead of replacing the full Markdown source.

Arguments

NameTypeDescription
checkedBoolean!Indicates the state the task list item should be toggled to.
lineSourceString!Full Markdown source of the line containing the task list item; used to detect concurrent edits.
lineSourceposString!Source position of the task list item in the Markdown source; for example, 5:1-5:14.

TerraformStateDeleteInput

Autogenerated input type of TerraformStateDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idTerraformStateID!Global ID of the Terraform state.

TerraformStateLockInput

Autogenerated input type of TerraformStateLock.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idTerraformStateID!Global ID of the Terraform state.

TerraformStateUnlockInput

Autogenerated input type of TerraformStateUnlock.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idTerraformStateID!Global ID of the Terraform state.

Timeframe

A time-frame defined as a closed inclusive range of two dates.

Arguments

NameTypeDescription
endDate!End of the range.
startDate!Start of the range.

TimelineEventCreateInput

Autogenerated input type of TimelineEventCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
incidentIdIssueID!Incident ID of the timeline event.
noteString!Text note of the timeline event.
occurredAtTime!Timestamp of when the event occurred.
timelineEventTagNames[String!]Tags for the incident timeline event.

TimelineEventDestroyInput

Autogenerated input type of TimelineEventDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIncidentManagementTimelineEventID!Timeline event ID to remove.

TimelineEventPromoteFromNoteInput

Autogenerated input type of TimelineEventPromoteFromNote.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
noteIdNoteID!Note ID from which the timeline event promoted.

TimelineEventTagCreateInput

Autogenerated input type of TimelineEventTagCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Name of the tag.
projectPathID!Project to create the timeline event tag in.

TimelineEventUpdateInput

Autogenerated input type of TimelineEventUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idIncidentManagementTimelineEventID!ID of the timeline event to update.
noteStringText note of the timeline event.
occurredAtTimeTimestamp when the event occurred.
timelineEventTagNames[String!]Tags for the incident timeline event.

TimelogCreateInput

Autogenerated input type of TimelogCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
issuableIdIssuableID!Global ID of the issuable (Issue, WorkItem or MergeRequest).
spentAtTimeTimestamp of when the time was spent. If empty, defaults to current time.
summaryString!Summary of time spent.
timeSpentString!Amount of time spent.

TimelogDeleteInput

Autogenerated input type of TimelogDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idTimelogID!Global ID of the timelog.

TimestampRange

A closed, inclusive range of two timestamps.

Arguments

NameTypeDescription
endTime!End of the range.
startTime!Start of the range.

TodoCreateInput

Autogenerated input type of TodoCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
targetIdTodoableID!Global ID of the to-do item’s parent. Issues, merge requests, designs, and epics are supported.

TodoDeleteAllDoneInput

Autogenerated input type of TodoDeleteAllDone.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
updatedBeforeTimeTo-do items marked as done before the timestamp will be deleted.

TodoDeleteManyInput

Autogenerated input type of TodoDeleteMany.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[TodoID!]!Global IDs of the to-do items to process (a maximum of 100 is supported at once).

TodoMarkDoneInput

Autogenerated input type of TodoMarkDone.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idTodoID!Global ID of the to-do item to mark as done.

TodoResolveManyInput

Autogenerated input type of TodoResolveMany.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[TodoID!]!Global IDs of the to-do items to process (a maximum of 100 is supported at once).

TodoRestoreInput

Autogenerated input type of TodoRestore.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idTodoID!Global ID of the to-do item to restore.

TodoRestoreManyInput

Autogenerated input type of TodoRestoreMany.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[TodoID!]!Global IDs of the to-do items to process (a maximum of 100 is supported at once).

TodoSnoozeInput

Autogenerated input type of TodoSnooze.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idTodoID!Global ID of the to-do item to be snoozed.
snoozeUntilTime!Time until which the todo should be snoozed.

TodoSnoozeManyInput

Autogenerated input type of TodoSnoozeMany.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[TodoID!]!Global IDs of the to-do items to process (a maximum of 100 is supported at once).
snoozeUntilTime!Time until which the todos should be snoozed.

TodoUnSnoozeInput

Autogenerated input type of TodoUnSnooze.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idTodoID!Global ID of the to-do item to be snoozed.

TodoUnsnoozeManyInput

Autogenerated input type of TodoUnsnoozeMany.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[TodoID!]!Global IDs of the to-do items to process (a maximum of 100 is supported at once).

TodosMarkAllDoneInput

Autogenerated input type of TodosMarkAllDone.

Arguments

NameTypeDescription
action[TodoActionEnum!]Action to be filtered.
authorId[ID!]ID of an author.
clientMutationIdStringA unique identifier for the client performing the mutation.
groupId[ID!]ID of a group.
projectId[ID!]ID of a project.
targetIdTodoableIDGlobal ID of the to-do item’s parent. Issues, merge requests, designs, and epics are supported. If argument is omitted, all pending to-do items of the current user are marked as done.
type[TodoTargetEnum!]Type of the todo.

TrackingEventInput

Attributes for defining a tracking event.

Arguments

NameTypeDescription
actionString!Event action.
categoryString!Event category.
extraJSONExtra metadata for the event.
labelStringEvent label.
propertyStringEvent property.
valueStringEvent value.

UnionedEpicFilterInput

Arguments

NameTypeDescription
authorUsername[String!]Deprecated in GitLab 16.6. Use authorUsernames instead.
authorUsernames[String!]Filters epics that are authored by one of the given users.
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 18.4.

Filter custom fields by one of the given values.
labelName[String!]Deprecated in GitLab 16.6. Use labelNames instead.
labelNames[String!]Filters epics that have at least one of the given labels.

UnionedIssueFilterInput

Arguments

NameTypeDescription
assigneeUsernames[String!]Filters issues that are assigned to at least one of the given users.
authorUsernames[String!]Filters issues that are authored by one of the given users.
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 18.4.

Filter custom fields by one of the given values.
labelNames[String!]Filters issues that have at least one of the given labels.

UnionedMergeRequestFilterInput

Arguments

NameTypeDescription
assigneeUsernames[String!]Filters MRs that are assigned to at least one of the given users.
onlyReviewerUsernameStringStatus: Experiment. Introduced in GitLab 17.11.

Filters merge requests that have no reviewer OR only reviewer. Only compatible with reviewerWildcard.
reviewStates[MergeRequestReviewState!]Status: Experiment. Introduced in GitLab 18.0.

Filters merge requests that have been reviewed. Only compatible with reviewerWildcard.
reviewerWildcardReviewerWildcardIdStatus: Experiment. Introduced in GitLab 17.11.

Filter by reviewer presence.

UnionedWorkItemFilterInput

Arguments

NameTypeDescription
assigneeUsernames[String!]Filters work items that are assigned to at least one of the given users (maximum is 100 usernames).
authorUsernames[String!]Filters work items that are authored by one of the given users (maximum is 100 usernames).
customField[WorkItemWidgetCustomFieldFilterInputType!]Status: Experiment. Introduced in GitLab 18.4.

Filter custom fields by one of the given values.
labelNames[String!]Filters work items that have at least one of the given labels (maximum is 100 labels).

UnlinkProjectComplianceViolationIssueInput

Autogenerated input type of UnlinkProjectComplianceViolationIssue.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
issueIidString!IID of the issue to be unlinked.
projectPathID!Full path of the project the issue belongs to.
violationIdComplianceManagementProjectsComplianceViolationID!Global ID of the project compliance violation.

UpdateAiToolRuleInput

Autogenerated input type of UpdateAiToolRule.

Arguments

NameTypeDescription
backgroundAccessAiBackgroundToolPermissionStatus: Experiment. Introduced in GitLab 19.3.

Permission mode for the background-flow surface.
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Full path of the root namespace to update the tool rule for.
localAccessAiToolPermissionPermission mode for local or IDE surface.
projectPathIDFull path of the project to update the tool rule for. When provided, creates a project-level rule that can only be stricter than the namespace rule.
toolIdString!Tool name string identifying the tool to update. For example, “create_issue”.
webAccessAiToolPermissionPermission mode for web surface.

UpdateAlertStatusInput

Autogenerated input type of UpdateAlertStatus.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
iidString!IID of the alert to mutate.
projectPathID!Project the alert to mutate is in.
statusAlertManagementStatus!Status to set the alert.

UpdateBoardEpicUserPreferencesInput

Autogenerated input type of UpdateBoardEpicUserPreferences.

Arguments

NameTypeDescription
boardIdBoardID!Board global ID.
clientMutationIdStringA unique identifier for the client performing the mutation.
collapsedBoolean!Whether the epic should be collapsed in the board.
epicIdEpicID!ID of an epic to set preferences for.

UpdateBoardInput

Autogenerated input type of UpdateBoard.

Arguments

NameTypeDescription
assigneeIdUserIDID of user to be assigned to the board.
clientMutationIdStringA unique identifier for the client performing the mutation.
hideBacklogListBooleanWhether or not backlog list is hidden.
hideClosedListBooleanWhether or not closed list is hidden.
idBoardID!Board global ID.
iterationCadenceIdIterationsCadenceIDID of iteration cadence to be assigned to the board.
iterationIdIterationIDID 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.
milestoneIdMilestoneIDID of milestone to be assigned to the board.
nameStringBoard name.
weightIntWeight value to be assigned to the board.

UpdateBoardListInput

Autogenerated input type of UpdateBoardList.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
collapsedBooleanIndicates if the list is collapsed for the user.
listIdListID!Global ID of the list.
positionIntPosition of list within the board.

UpdateComplianceFrameworkInput

Autogenerated input type of UpdateComplianceFramework.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idComplianceManagementFrameworkID!Global ID of the compliance framework to update.
paramsComplianceFrameworkInput!Parameters to update the compliance framework with.

UpdateComplianceRequirementInput

Autogenerated input type of UpdateComplianceRequirement.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
controls[ComplianceRequirementsControlInput!]Controls to add or update to the compliance requirement.
idComplianceManagementComplianceFrameworkComplianceRequirementID!Global ID of the compliance requirement to update.
paramsComplianceRequirementInput!Parameters to update the compliance requirement with.

UpdateComplianceRequirementsControlInput

Autogenerated input type of UpdateComplianceRequirementsControl.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idComplianceManagementComplianceFrameworkComplianceRequirementsControlID!Global ID of the compliance requirement control to update.
paramsComplianceRequirementsControlInput!Parameters to update the compliance requirement control with.

UpdateContainerExpirationPolicyInput

Autogenerated input type of UpdateContainerExpirationPolicy.

Arguments

NameTypeDescription
cadenceContainerExpirationPolicyCadenceEnumSchedule of the container expiration policy.
clientMutationIdStringA unique identifier for the client performing the mutation.
enabledBooleanIndicates whether the container expiration policy is enabled.
keepNContainerExpirationPolicyKeepEnumNumber of tags to retain.
nameRegexUntrustedRegexpTags with names matching the regex pattern will expire.
nameRegexKeepUntrustedRegexpTags with names matching the regex pattern will be preserved.
olderThanContainerExpirationPolicyOlderThanEnumTags older than the given age will expire.
projectPathID!Project path where the container expiration policy is located.

UpdateContainerProtectionRepositoryRuleInput

Autogenerated input type of UpdateContainerProtectionRepositoryRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idContainerRegistryProtectionRuleID!Global ID of the container repository protection rule to be updated.
minimumAccessLevelForDeleteContainerProtectionRepositoryRuleAccessLevelStatus: Experiment. Introduced in GitLab 17.11.

Minimum GitLab access level required to delete container images from the container repository. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, the default minimum access level is DEVELOPER. Valid only when feature flag container_registry_protected_containers_delete is enabled.
minimumAccessLevelForPushContainerProtectionRepositoryRuleAccessLevelMinimum GitLab access level required to push container images to the container repository. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, the default minimum access level is DEVELOPER.
repositoryPathPatternStringContainer repository path pattern protected by the protection rule. Must start with the project’s full path. For example: my-project/*-prod-*. Wildcard character * is allowed anywhere after the project’s full path.

UpdateContainerProtectionTagRuleInput

Autogenerated input type of UpdateContainerProtectionTagRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idContainerRegistryProtectionTagRuleID!Global ID of the tag protection rule to update.
minimumAccessLevelForDeleteContainerProtectionTagRuleAccessLevelMinimum GitLab access level required to delete container image tags from the container repository. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, no access level can delete tags.
minimumAccessLevelForPushContainerProtectionTagRuleAccessLevelMinimum GitLab access level required to push container image tags to the container repository. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, no access level can push tags.
tagNamePatternStringThe pattern that matches container image tags to protect. For example, v1.*. Wildcard character * allowed.

UpdateCustomDashboardInput

Autogenerated input type of UpdateCustomDashboard.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
configCustomDashboardConfigInputDashboard layout/config.
descriptionStringDashboard description.
idAnalyticsCustomDashboardsDashboardID!Global ID of the dashboard to update.
nameStringDashboard name.

UpdateDependencyProxyImageTtlGroupPolicyInput

Autogenerated input type of UpdateDependencyProxyImageTtlGroupPolicy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enabledBooleanIndicates whether the policy is enabled or disabled.
groupPathID!Group path for the group dependency proxy image TTL policy.
ttlIntNumber of days to retain a cached image file.

UpdateDependencyProxyPackagesSettingsInput

Autogenerated input type of UpdateDependencyProxyPackagesSettings.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enabledBooleanIndicates whether the dependency proxy for packages is enabled for the project.
mavenExternalRegistryPasswordStringPassword for the external Maven packages registry. Introduced in 16.5: This feature is an Experiment. It can be changed or removed at any time.
mavenExternalRegistryUrlStringURL for the external Maven packages registry.
mavenExternalRegistryUsernameStringUsername for the external Maven packages registry.
projectPathID!Project path for the dependency proxy for packages settings.

UpdateDependencyProxySettingsInput

Autogenerated input type of UpdateDependencyProxySettings.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enabledBooleanIndicates whether the policy is enabled or disabled.
groupPathID!Group path for the group dependency proxy.
identityStringIdentity credential used to authenticate with Docker Hub when pulling images. Can be a username (for password or personal access token (PAT)) or organization name (for organization access token (OAT)).
secretStringSecret credential used to authenticate with Docker Hub when pulling images. Can be a password, personal access token (PAT), or organization access token (OAT).

UpdateDiffImagePositionInput

Arguments

NameTypeDescription
heightIntTotal height of the image.
widthIntTotal width of the image.
xIntX position of the note.
yIntY position of the note.

UpdateDuoWorkflowAgentPrivilegesInput

Autogenerated input type of UpdateDuoWorkflowAgentPrivileges.

Arguments

NameTypeDescription
agentPrivileges[Int!]Replaces the set of actions the agent is allowed to perform.
clientMutationIdStringA unique identifier for the client performing the mutation.
preApprovedAgentPrivileges[Int!]Replaces the set of actions the agent can perform without asking for approval.
workflowIdAiDuoWorkflowsWorkflowID!Global ID of the workflow to update.

UpdateDuoWorkflowToolCallApprovalsInput

Autogenerated input type of UpdateDuoWorkflowToolCallApprovals.

Arguments

NameTypeDescription
approvalSourceDuoWorkflowToolCallApprovalSourceStatus: Experiment. Introduced in GitLab 19.3.

Source of the approval decision, for audit purposes.
clientMutationIdStringA unique identifier for the client performing the mutation.
patternStringGlob pattern to approve for matching tool call arguments.
toolCallArgsJSONArguments for the tool call.
toolNameString!Name of the tool to approve.
workflowIdAiDuoWorkflowsWorkflowID!Global ID of the workflow to update.

UpdateDuoWorkflowWebSearchInput

Autogenerated input type of UpdateDuoWorkflowWebSearch.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
webSearchEnabledBoolean!Whether web search should be enabled for the session.
workflowIdAiDuoWorkflowsWorkflowID!Global ID of the workflow to update.

UpdateEpicBoardListInput

Autogenerated input type of UpdateEpicBoardList.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
collapsedBooleanIndicates if the list is collapsed for the user.
listIdBoardsEpicListID!Global ID of the epic list.
positionIntPosition of list within the board.

UpdateEpicInput

Autogenerated input type of UpdateEpic.

Arguments

NameTypeDescription
addLabelIds[ID!]IDs of labels to be added to the epic.
addLabels[String!]Array of labels to be added to the epic.
clientMutationIdStringA unique identifier for the client performing the mutation.
colorColorColor of the epic.
confidentialBooleanIndicates if the epic is confidential.
descriptionStringDescription of the epic.
dueDateFixedStringEnd date of the epic.
dueDateIsFixedBooleanIndicates end date should be sourced from due_date_fixed field not the issue milestones.
groupPathID!Group the epic to mutate is in.
iidID!IID of the epic to mutate.
removeLabelIds[ID!]IDs of labels to be removed from the epic.
removeLabels[String!]Array of labels to be removed from the epic.
startDateFixedStringStart date of the epic.
startDateIsFixedBooleanIndicates start date should be sourced from start_date_fixed field not the issue milestones.
stateEventEpicStateEventState event for the epic.
titleStringTitle of the epic.

UpdateImageDiffNoteInput

Autogenerated input type of UpdateImageDiffNote.

Arguments

NameTypeDescription
bodyStringContent of the note.
clientMutationIdStringA unique identifier for the client performing the mutation.
idNoteID!Global ID of the note to update.
positionUpdateDiffImagePositionInputPosition of the note on a diff.

UpdateIssueInput

Autogenerated input type of UpdateIssue.

Arguments

NameTypeDescription
addLabelIds[ID!]IDs of labels to be added to the issue.
clientMutationIdStringA unique identifier for the client performing the mutation.
confidentialBooleanIndicates the issue is confidential.
descriptionStringDescription of the issue.
dueDateISO8601DateDue date of the issue.
epicIdEpicIDDeprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
healthStatusHealthStatusDesired health status.
iidString!IID of the issue to mutate.
labelIds[ID!]IDs of labels to be set. Replaces existing issue labels.
lockedBooleanIndicates discussion is locked on the issue.
milestoneIdIDID of the milestone to assign to the issue. Accepts either a global ID, for example "gid://gitlab/Milestone/42", or a numeric ID, for example "42". On update milestone will be removed if set to null.
projectPathID!Project the issue to mutate is in.
removeLabelIds[ID!]IDs of labels to be removed from the issue.
stateEventIssueStateEventClose or reopen an issue.
timeEstimateStringEstimated time to complete the issue. Use null or 0 to remove the current estimate.
titleStringTitle of the issue.
typeIssueTypeType of the issue.
weightIntWeight of the issue.

UpdateIterationInput

Autogenerated input type of UpdateIteration.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the iteration.
dueDateStringEnd date of the iteration.
groupPathID!Group of the iteration.
idID!Global ID of the iteration.
startDateStringStart date of the iteration.
titleStringTitle of the iteration.

UpdateNamespacePackageSettingsInput

Autogenerated input type of UpdateNamespacePackageSettings.

Arguments

NameTypeDescription
auditEventsEnabledBooleanIndicates whether audit events are created when publishing or deleting a package in the namespace (Premium and Ultimate only).
clientMutationIdStringA unique identifier for the client performing the mutation.
genericDuplicateExceptionRegexUntrustedRegexpWhen generic_duplicates_allowed is false, you can publish duplicate packages with names or versions that match this regex. When generic_duplicates_allowed is true, duplicate packages with names or versions that match this regex are rejected.
genericDuplicatesAllowedBooleanIndicates whether duplicate generic packages are allowed for the namespace.
lockMavenPackageRequestsForwardingBooleanIndicates whether Maven package forwarding is locked for all descendent namespaces.
lockNpmPackageRequestsForwardingBooleanIndicates whether npm package forwarding is locked for all descendent namespaces.
lockPypiPackageRequestsForwardingBooleanIndicates whether PyPI package forwarding is locked for all descendent namespaces.
lockRubygemsPackageRequestsForwardingBooleanIndicates whether RubyGems package forwarding is locked for all descendent namespaces.
mavenDuplicateExceptionRegexUntrustedRegexpWhen maven_duplicates_allowed is false, you can publish duplicate packages with names or versions that match this regex. When maven_duplicates_allowed is true, duplicate packages with names or versions that match this regex are rejected.
mavenDuplicatesAllowedBooleanIndicates whether duplicate Maven packages are allowed for the namespace.
mavenPackageRequestsForwardingBooleanIndicates whether Maven package forwarding is allowed for the namespace.
namespacePathID!Namespace path where the namespace package setting is located.
npmPackageRequestsForwardingBooleanIndicates whether npm package forwarding is allowed for the namespace.
nugetDuplicateExceptionRegexUntrustedRegexpWhen nuget_duplicates_allowed is false, you can publish duplicate packages with names or versions that match this regex. When nuget_duplicates_allowed is true, duplicate packages with names or versions that match this regex are rejected.
nugetDuplicatesAllowedBooleanIndicates whether duplicate NuGet packages are allowed for the namespace.
nugetSymbolServerEnabledBooleanIndicates whether the NuGet symbol server is enabled for the namespace.
pypiPackageRequestsForwardingBooleanIndicates whether PyPI package forwarding is allowed for the namespace.
rubygemsPackageRequestsForwardingBooleanIndicates whether RubyGems package forwarding is allowed for the namespace.
terraformModuleDuplicateExceptionRegexUntrustedRegexpWhen terraform_module_duplicates_allowed is false, you can publish duplicate packages with names that match this regex. When terraform_module_duplicates_allowed is true, duplicate packages with names that match this regex are rejected.
terraformModuleDuplicatesAllowedBooleanIndicates whether duplicate Terraform packages are allowed for the namespace.

UpdateNoteInput

Autogenerated input type of UpdateNote.

Arguments

NameTypeDescription
bodyStringContent of the note.
clientMutationIdStringA unique identifier for the client performing the mutation.
idNoteID!Global ID of the note to update.

UpdatePackagesCleanupPolicyInput

Autogenerated input type of UpdatePackagesCleanupPolicy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
keepNDuplicatedPackageFilesPackagesCleanupKeepDuplicatedPackageFilesEnumNumber of duplicated package files to retain.
projectPathID!Project path where the packages cleanup policy is located.

UpdatePackagesProtectionRuleInput

Autogenerated input type of UpdatePackagesProtectionRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idPackagesProtectionRuleID!Global ID of the package protection rule to be updated.
minimumAccessLevelForDeletePackagesProtectionRuleAccessLevelForDeleteStatus: Experiment. Introduced in GitLab 17.10.

Minimum GitLab access required to delete packages from the package registry. Valid values include OWNER or ADMIN. If the value is nil, the default minimum access level is MAINTAINER. Available only when feature flag packages_protected_packages_delete is enabled.
minimumAccessLevelForPushPackagesProtectionRuleAccessLevelMinimum GitLab access required to push packages to the package registry. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, the default minimum access level is DEVELOPER.
packageNamePatternStringPackage name protected by the protection rule. For example, @my-scope/my-package-*. Wildcard character * allowed.
packageTypePackagesProtectionRulePackageTypePackage type protected by the protection rule. For example, NPM, PYPI.

UpdateProjectComplianceViolationInput

Autogenerated input type of UpdateProjectComplianceViolation.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idComplianceManagementProjectsComplianceViolationID!Global ID of the project compliance violation to update.
statusComplianceViolationStatus!New status for the project compliance violation.

UpdateRequirementInput

Autogenerated input type of UpdateRequirement.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the requirement.
iidStringDeprecated in GitLab 15.8. Use work_item_iid instead.
lastTestReportStateTestReportStateCreates a test report for the requirement with the given state.
projectPathID!Full project path the requirement is associated with.
stateRequirementStateState of the requirement.
titleStringTitle of the requirement.
workItemIidStringIID of the requirement work item to update.

UpdateSnippetInput

Autogenerated input type of UpdateSnippet.

Arguments

NameTypeDescription
blobActions[SnippetBlobActionInputType!]Actions to perform over the snippet repository and blobs.
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the snippet.
idSnippetID!Global ID of the snippet to update.
titleStringTitle of the snippet.
visibilityLevelVisibilityLevelsEnumVisibility level of the snippet.

UpdateTerraformStateProtectionRuleInput

Autogenerated input type of UpdateTerraformStateProtectionRule.

Arguments

NameTypeDescription
allowedFromTerraformStateProtectionRuleAllowedFromStatus: Experiment. Introduced in GitLab 18.11.

Restriction on the source of write requests. ANYWHERE allows all sources, CI_ONLY requires a CI job token, CI_ON_PROTECTED_BRANCH_ONLY requires a CI job on a protected branch.
clientMutationIdStringA unique identifier for the client performing the mutation.
idTerraformStateProtectionRuleID!Global ID of the Terraform state protection rule to update.
minimumAccessLevelForWriteTerraformStateProtectionRuleAccessLevelStatus: Experiment. Introduced in GitLab 18.11.

Minimum GitLab access level required to perform write operations on the Terraform state. Valid values include DEVELOPER, MAINTAINER, OWNER, or ADMIN.
stateNameStringStatus: Experiment. Introduced in GitLab 18.11.

Terraform state name protected by the rule.

UpdateValueStreamStageInput

Attributes to update value stream stage.

Arguments

NameTypeDescriptionDefault
customBooleanWhether the stage is customized. If false, it assigns a built-in default stage by name.true
endEventIdentifierValueStreamStageEventEnd event identifier.
endEventLabelIdLabelIDLabel ID associated with the end event identifier.
hiddenBooleanWhether the stage is hidden.
idAnalyticsCycleAnalyticsStageIDID of the stage to be updated.
nameStringName of the stage.
startEventIdentifierValueStreamStageEventStart event identifier.
startEventLabelIdLabelIDLabel ID associated with the start event identifier.

UpdateVirtualRegistriesSettingInput

Autogenerated input type of UpdateVirtualRegistriesSetting.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enabledBooleanEnable or disable the virtual registries.
fullPathID!Group path for the group virtual registries.

UploadCreateInput

Autogenerated input type of UploadCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fileUpload!File to upload.
groupPathIDFull path of the group with which the resource is associated.
projectPathIDFull path of the project with which the resource is associated.

UploadDeleteInput

Autogenerated input type of UploadDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
filenameString!Upload filename.
groupPathIDFull path of the group with which the resource is associated.
projectPathIDFull path of the project with which the resource is associated.
secretString!Secret part of upload path.

UpsertFlatUserCapInput

Autogenerated input type of UpsertFlatUserCap.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
flatUserCapFloat!Default per-user budget cap applied to all users.
flatUserCapEnabledBoolean!Whether the flat per-user budget cap is enabled.
namespacePathStringPath of the top-level group namespace. Omit for self-managed instance scope.

UpsertUserBudgetCapOverridesInput

Autogenerated input type of UpsertUserBudgetCapOverrides.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespacePathStringPath of the top-level group namespace. Omit for self-managed instance scope.
overrides[BudgetCapUserOverrideInput!]!List of per-user budget cap overrides to upsert.

UserAchievementPrioritiesUpdateInput

Autogenerated input type of UserAchievementPrioritiesUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
userAchievementIds[AchievementsUserAchievementID!]!Global IDs of the user achievements being prioritized, ordered from highest to lowest priority.

UserAchievementsDeleteInput

Autogenerated input type of UserAchievementsDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
userAchievementIdAchievementsUserAchievementID!Global ID of the user achievement being deleted.

UserAchievementsUpdateInput

Autogenerated input type of UserAchievementsUpdate.

Arguments

NameTypeDescription
awardMessageStringMessage to associate with the awarded achievement.
clientMutationIdStringA unique identifier for the client performing the mutation.
showOnProfileBooleanIndicates whether or not the user achievement is visible on the profile.
userAchievementIdAchievementsUserAchievementID!Global ID of the user achievement being updated.

UserAddOnAssignmentBulkCreateInput

Autogenerated input type of UserAddOnAssignmentBulkCreate.

Arguments

NameTypeDescription
addOnPurchaseIdGitlabSubscriptionsAddOnPurchaseID!Global ID of AddOnPurchase to be assigned to.
clientMutationIdStringA unique identifier for the client performing the mutation.
userIds[UserID!]!Global IDs of user to be assigned.

UserAddOnAssignmentBulkRemoveInput

Autogenerated input type of UserAddOnAssignmentBulkRemove.

Arguments

NameTypeDescription
addOnPurchaseIdGitlabSubscriptionsAddOnPurchaseID!Global ID of AddOnPurchase to be unassigned from.
clientMutationIdStringA unique identifier for the client performing the mutation.
userIds[UserID!]!Global IDs of user to be unassigned.

UserAddOnAssignmentCreateInput

Autogenerated input type of UserAddOnAssignmentCreate.

Arguments

NameTypeDescription
addOnPurchaseIdGitlabSubscriptionsAddOnPurchaseID!Global ID of AddOnPurchase to be assigned to.
clientMutationIdStringA unique identifier for the client performing the mutation.
userIdUserID!Global ID of user to be assigned.

UserAddOnAssignmentRemoveInput

Autogenerated input type of UserAddOnAssignmentRemove.

Arguments

NameTypeDescription
addOnPurchaseIdGitlabSubscriptionsAddOnPurchaseID!Global ID of AddOnPurchase assignment belongs to.
clientMutationIdStringA unique identifier for the client performing the mutation.
userIdUserID!Global ID of user whose assignment will be removed.

UserCalloutCreateInput

Autogenerated input type of UserCalloutCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
featureNameString!Feature name you want to dismiss the callout for.

UserCustomAttributeSetInput

Autogenerated input type of UserCustomAttributeSet.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
keyString!Key of the custom attribute.
userIdUserID!Global ID of the user.
valueString!Value of the custom attribute.

UserGroupCalloutCreateInput

Autogenerated input type of UserGroupCalloutCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
featureNameString!Feature name you want to dismiss the callout for.
groupIdGroupID!Group for the callout.

UserPreferencesUpdateInput

Autogenerated input type of UserPreferencesUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
duoDefaultNamespaceIdIntDefault namespace context for Duo features when namespace can not be inferred.
extensionsMarketplaceOptInStatusExtensionsMarketplaceOptInStatusStatus of the Web IDE Extension Marketplace opt-in for the user.
issuesSortIssueSortSort order for issue lists.
knowledgeGraphGoverningNamespaceIdIntGoverning and billing namespace for Orbit.
mergeRequestDashboardListTypeMergeRequestsDashboardListTypeMerge request dashboard list rendering type.
mergeRequestDashboardShowDraftsBooleanShow draft merge requests on the merge request dashboard.
mergeRequestsSortMergeRequestSortSort order for issue lists.
orbitSettingsJSONStatus: Experiment. Introduced in GitLab 19.0.

Orbit agent settings, e.g.: “{ enabled: false }”.
organizationGroupsProjectsDisplayOrganizationGroupProjectDisplayStatus: Experiment. Introduced in GitLab 17.2.

Default list view for organization groups and projects.
organizationGroupsProjectsSortOrganizationGroupProjectSortStatus: Experiment. Introduced in GitLab 17.2.

Sort order for organization groups and projects.
projectsSortProjectSortSort order for projects.
useWorkItemsViewBooleanUse work item view instead of legacy issue view.
visibilityPipelineIdTypeVisibilityPipelineIdTypeDetermines whether the pipeline list shows ID or IID.
wikiUseAutoCommitMessageBooleanStatus: Experiment. Introduced in GitLab 18.10.

Whether to skip the commit message modal and use the auto-generated commit message when saving changes to a wiki document.
workItemsDisplaySettingsJSONStatus: Experiment. Introduced in GitLab 18.1.

Display settings for the work item lists, e.g.: “{ shouldOpenItemsInSidePanel: false }”.

UserSetNamespaceCommitEmailInput

Autogenerated input type of UserSetNamespaceCommitEmail.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
emailIdEmailIDID of the email to set.
namespaceIdNamespaceID!ID of the namespace to set the namespace commit email for.

ValueStreamCreateInput

Autogenerated input type of ValueStreamCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
nameString!Value stream name.
namespacePathID!Full path of the namespace(project or group) the value stream is created in.
settingValueStreamSettingInputValue stream configuration.
stages[CreateValueStreamStageInput!]Value stream stages.

ValueStreamDestroyInput

Autogenerated input type of ValueStreamDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAnalyticsCycleAnalyticsValueStreamID!Global ID of the value stream to destroy.

ValueStreamSettingInput

Attributes for value stream setting.

Arguments

NameTypeDescription
projectIdsFilter[ProjectID!]Projects’ global IDs used to filter value stream data.

ValueStreamUpdateInput

Autogenerated input type of ValueStreamUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idAnalyticsCycleAnalyticsValueStreamID!Global ID of the value stream to update.
nameStringValue stream name.
settingValueStreamSettingInputValue stream configuration.
stages[UpdateValueStreamStageInput!]Value stream stages.

VerificationStatusFilterInput

Arguments

NameTypeDescription
verificationStatusRequirementStatusFilter!Verification status of the work item.

VerificationStatusInput

Arguments

NameTypeDescription
verificationStatusTestReportState!Verification status of the work item.

VerifiedNamespaceCreateInput

Autogenerated input type of VerifiedNamespaceCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
namespacePathID!Root namespace path.
verificationLevelCiCatalogResourceVerificationLevel!Verification level for a root namespace.

VirtualRegistriesCleanupPolicyUpsertInput

Autogenerated input type of VirtualRegistriesCleanupPolicyUpsert.

Arguments

NameTypeDescription
cadenceIntJob cadence for the cleanup process. Allowed values are 1, 7, 14, 30, 90. Default is 7.
clientMutationIdStringA unique identifier for the client performing the mutation.
enabledBooleanEnable or disable the virtual registries cleanup policy. Default is false.
fullPathID!Group path for the group virtual registries.
keepNDaysAfterDownloadIntKeep packages for the period after download. Range is 1-365. Default is 30.
notifyOnFailureBooleanWhether to notify group owners when cleanup runs fail. Default is false.
notifyOnSuccessBooleanWhether to notify group owners when cleanup runs succeed. Default is false.

VulnerabilitiesArchiveInput

Autogenerated input type of VulnerabilitiesArchive.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
dateDate!Last update date of vulnerabilities being archived.
projectIdProjectID!ID of the project to attach the vulnerability to.

VulnerabilitiesCreateIssueInput

Autogenerated input type of VulnerabilitiesCreateIssue.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectProjectID!ID of the project to attach the issue to.
vulnerabilityIds[VulnerabilityID!]!IDs of vulnerabilities to link to the given issue. Up to 100 can be provided.

VulnerabilitiesDismissInput

Autogenerated input type of VulnerabilitiesDismiss.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentStringComment why vulnerability was dismissed (maximum 50,000 characters).
dismissalReasonVulnerabilityDismissalReasonReason why vulnerability should be dismissed.
vulnerabilityIds[VulnerabilityID!]!IDs of the vulnerabilities to be dismissed (maximum 100 entries).

VulnerabilitiesRemoveAllFromProjectInput

Autogenerated input type of VulnerabilitiesRemoveAllFromProject.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectIds[ProjectID!]!IDs of project for which all Vulnerabilities should be removed. The deletion will happen in the background so the changes will not be visible immediately.
resolvedOnDefaultBranchBooleanWhen set as true, deletes only the vulnerabilities no longer detected. When set as false, deletes only the vulnerabilities still detected.

VulnerabilityAutoRemediationInput

Autogenerated input type of VulnerabilityAutoRemediation.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
vulnerabilityIdVulnerabilityID!ID of the vulnerability to remediate.

VulnerabilityConfirmInput

Autogenerated input type of VulnerabilityConfirm.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentStringComment why vulnerability was confirmed (maximum 50,000 characters).
idVulnerabilityID!ID of the vulnerability to be confirmed.

VulnerabilityCountFilterInput

Input type for filtering projects by vulnerability count and severity.

Arguments

NameTypeDescription
countInt!Number of vulnerabilities to filter by.
operatorComparisonOperator!Comparison operator for the vulnerability count.
severityVulnerabilitySeverity!Severity level of vulnerabilities to filter by.

VulnerabilityCreateInput

Autogenerated input type of VulnerabilityCreate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
confirmedAtTimeTimestamp of when the vulnerability state changed to confirmed (defaults to creation time if status is confirmed).
descriptionString!Long text section that describes the vulnerability in more detail.
detectedAtTimeTimestamp of when the vulnerability was first detected (defaults to creation time).
dismissedAtTimeTimestamp of when the vulnerability state changed to dismissed (defaults to creation time if status is dismissed).
identifiers[VulnerabilityIdentifierInput!]!Array of CVE or CWE identifiers for the vulnerability.
nameString!Name of the vulnerability.
projectProjectID!ID of the project to attach the vulnerability to.
projectTrackedContextProjectTrackedContextInputTracked context to associate with the vulnerability.
resolvedAtTimeTimestamp of when the vulnerability state changed to resolved (defaults to creation time if status is resolved).
scannerVulnerabilityScannerInput!Information about the scanner used to discover the vulnerability.
severityVulnerabilitySeveritySeverity of the vulnerability (defaults to unknown).UNKNOWN
solutionStringInstructions for how to fix the vulnerability.
stateVulnerabilityStateState of the vulnerability (defaults to detected).DETECTED

VulnerabilityDismissFalsePositiveFlagInput

Autogenerated input type of VulnerabilityDismissFalsePositiveFlag.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVulnerabilityID!ID of the vulnerability to dismiss false positive flag for.

VulnerabilityDismissInput

Autogenerated input type of VulnerabilityDismiss.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentStringComment why vulnerability was dismissed (maximum 50,000 characters).
dismissalReasonVulnerabilityDismissalReasonReason why vulnerability should be dismissed.
idVulnerabilityID!ID of the vulnerability to be dismissed.

VulnerabilityExternalIssueLinkCreateInput

Autogenerated input type of VulnerabilityExternalIssueLinkCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
externalTrackerVulnerabilityExternalIssueLinkExternalTracker!External tracker type of the external issue link.
idVulnerabilityID!ID of the vulnerability.
linkTypeVulnerabilityExternalIssueLinkType!Type of the external issue link.

VulnerabilityExternalIssueLinkDestroyInput

Autogenerated input type of VulnerabilityExternalIssueLinkDestroy.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idVulnerabilitiesExternalIssueLinkID!Global ID of the vulnerability external issue link.

VulnerabilityIdentifierInput

Arguments

NameTypeDescription
externalIdStringExternal ID of the vulnerability identifier.
externalTypeStringExternal type of the vulnerability identifier.
nameString!Name of the vulnerability identifier.
urlString!URL of the vulnerability identifier.

VulnerabilityIssueLinkCreateInput

Autogenerated input type of VulnerabilityIssueLinkCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
issueIdIssueID!ID of the issue to link to.
vulnerabilityIds[VulnerabilityID!]!IDs of vulnerabilities to link to the given issue. Up to 100 can be provided.

VulnerabilityLinkMergeRequestInput

Autogenerated input type of VulnerabilityLinkMergeRequest.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
mergeRequestIdMergeRequestID!ID of the merge request.
readinessScoreFloatConfidence rating representing the estimated accuracy of the fix in the AI generated merge request. Decimal value between 0 and 1, with 1 being the highest.
vulnerabilityIdVulnerabilityID!ID of the vulnerability.

VulnerabilityResolveInput

Autogenerated input type of VulnerabilityResolve.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentStringComment why vulnerability was resolved (maximum 50,000 characters).
idVulnerabilityID!ID of the vulnerability to be resolved.

VulnerabilityRevertToDetectedInput

Autogenerated input type of VulnerabilityRevertToDetected.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentStringComment why vulnerability was reverted to detected (maximum 50,000 characters).
idVulnerabilityID!ID of the vulnerability to be reverted to detected.

VulnerabilityScannerInput

Arguments

NameTypeDescription
idString!Unique ID that identifies the scanner.
nameString!Human readable value that identifies the analyzer, not required to be unique.
urlString!Link to more information about the analyzer.
vendorVulnerabilityScannerVendorInputInformation about vendor/maintainer of the scanner.
versionString!Version of the scanner.

VulnerabilityScannerVendorInput

Arguments

NameTypeDescription
nameString!Name of the vendor/maintainer.

VulnerabilityUnlinkMergeRequestInput

Autogenerated input type of VulnerabilityUnlinkMergeRequest.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
mergeRequestIdMergeRequestID!ID of the merge request.
vulnerabilityIdVulnerabilityID!ID of the vulnerability.

WikiPageSubscribeInput

Autogenerated input type of WikiPageSubscribe.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWikiPageMetaID!Global ID of the wiki page meta record.
subscribedBoolean!Desired state of the subscription.

WorkItemAddClosingMergeRequestInput

Autogenerated input type of WorkItemAddClosingMergeRequest.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
contextNamespacePathIDFull path of the context namespace (project or group). Only project full paths are used to find a merge request using a short reference syntax like !1. Ignored for full references and URLs. Defaults to the namespace of the work item if not provided.
idWorkItemID!Global ID of the work item.
mergeRequestReferenceString!Merge request reference (short, full or URL). Example: !1, project_full_path!1 or https://gitlab.com/gitlab-org/gitlab/-/merge_requests/1.

WorkItemAddLinkedItemsInput

Autogenerated input type of WorkItemAddLinkedItems.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item.
linkTypeWorkItemRelatedLinkTypeType of link. Defaults to RELATED.
workItemsIds[WorkItemID!]!Global IDs of the items to link. Maximum number of IDs you can provide: 10.

WorkItemAvailabilityToggleInput

Autogenerated input type of WorkItemAvailabilityToggle.

Arguments

NameTypeDescription
actionWorkItemAvailabilityAction!Whether to enable or disable the work item type.
clientMutationIdStringA unique identifier for the client performing the mutation.
fullPathID!Full path of the group or project.
scopeWorkItemAvailabilityScope!Whether to apply to the namespace or propagate to all existing children.
workItemTypeIdWorkItemsTypeID!Global ID of the work item type.

WorkItemBulkMoveInput

Autogenerated input type of WorkItemBulkMove.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
ids[WorkItemID!]!Global ID array of the work items that will be moved. IDs that the user can’t move will be ignored. A max of 100 can be provided.
sourceFullPathString!Full path of the source namespace. For example, gitlab-org/gitlab-foss.
targetFullPathString!Full path of the target namespace. For example, gitlab-org/gitlab-foss. User paths are not supported.

WorkItemBulkUpdateInput

Autogenerated input type of WorkItemBulkUpdate.

Arguments

NameTypeDescription
assigneesWidgetWorkItemWidgetAssigneesInputStatus: Experiment. Introduced in GitLab 18.2.

Input for assignees widget.
clientMutationIdStringA unique identifier for the client performing the mutation.
confidentialBooleanStatus: Experiment. Introduced in GitLab 18.2.

Sets the work item confidentiality.
fullPathID!Full path of the project or group (Premium and Ultimate only) containing the work items that will be updated. User paths are not supported.
healthStatusWidgetWorkItemWidgetHealthStatusInputStatus: Experiment. Introduced in GitLab 18.2.

Input for health status widget.
hierarchyWidgetWorkItemWidgetHierarchyCreateInputStatus: Experiment. Introduced in GitLab 18.2.

Input for hierarchy widget.
ids[WorkItemID!]!Global ID array of the work items that will be updated. IDs that the user can’t update will be ignored. A max of 100 can be provided.
iterationWidgetWorkItemWidgetIterationInputStatus: Experiment. Introduced in GitLab 18.2.

Input for iteration widget.
labelsWidgetWorkItemWidgetLabelsUpdateInputInput for labels widget.
milestoneWidgetWorkItemWidgetMilestoneInputStatus: Experiment. Introduced in GitLab 18.2.

Input for milestone widget.
stateEventWorkItemStateEventStatus: Experiment. Introduced in GitLab 18.2.

Close or reopen multiple work items at once.
statusWidgetWorkItemWidgetStatusInputStatus: Experiment. Introduced in GitLab 18.3.

Input for status widget.
subscriptionEventWorkItemSubscriptionEventStatus: Experiment. Introduced in GitLab 18.2.

Subscribe or unsubscribe from the work items.

WorkItemConvertInput

Autogenerated input type of WorkItemConvert.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item.
workItemTypeIdWorkItemsTypeID!Global ID of the new work item type.

WorkItemConvertTaskInput

Arguments

NameTypeDescription
lineNumberEndInt!Last line in the Markdown source that defines the list item task.
lineNumberStartInt!First line in the Markdown source that defines the list item task.
lockVersionInt!Current lock version of the work item containing the task in the description.
titleString!Full string of the task to be replaced. New title for the created work item.
workItemTypeIdWorkItemsTypeID!Global ID of the work item type used to create the new work item.

WorkItemCreateFromTaskInput

Autogenerated input type of WorkItemCreateFromTask.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item.
workItemDataWorkItemConvertTaskInput!Arguments necessary to convert a task into a work item.

WorkItemCreateInput

Autogenerated input type of WorkItemCreate.

Arguments

NameTypeDescription
agentPlanWidgetWorkItemWidgetAgentPlanInputStatus: Experiment. Introduced in GitLab 19.0.

Input for agent plan widget.
assigneesWidgetWorkItemWidgetAssigneesInputInput for assignees widget.
clientMutationIdStringA unique identifier for the client performing the mutation.
colorWidgetWorkItemWidgetColorInputInput for color widget.
confidentialBooleanSets the work item confidentiality.
createSourceStringSource which triggered the creation of the work item. Used only for tracking purposes.
createdAtTimeTimestamp when the work item was created. Available only for admins and project owners.
crmContactsWidgetWorkItemWidgetCrmContactsCreateInputInput for CRM contacts widget.
customFieldsWidget[WorkItemWidgetCustomFieldValueInputType!]Status: Experiment. Introduced in GitLab 17.10.

Input for custom fields widget.
descriptionStringDeprecated in GitLab 16.9. use description widget instead.
descriptionWidgetWorkItemWidgetDescriptionInputInput for description widget.
developmentWidgetWorkItemWidgetDevelopmentCreateInputInput for development widget.
discussionsToResolveWorkItemResolveDiscussionsInputInformation required to resolve discussions in a noteable, when the work item is created.
healthStatusWidgetWorkItemWidgetHealthStatusInputInput for health status widget.
hierarchyWidgetWorkItemWidgetHierarchyCreateInputInput for hierarchy widget.
iterationWidgetWorkItemWidgetIterationInputIteration widget of the work item.
labelsWidgetWorkItemWidgetLabelsCreateInputInput for labels widget.
linkedItemsWidgetWorkItemWidgetLinkedItemsCreateInputInput for linked items widget.
milestoneWidgetWorkItemWidgetMilestoneInputInput for milestone widget.
namespacePathIDFull path of the namespace(project or group) the work item is created in.
projectPathIDDeprecated in GitLab 15.10. Please use namespacePath instead. That will cover for both projects and groups.
startAndDueDateWidgetWorkItemWidgetStartAndDueDateUpdateInputInput for start and due date widget.
statusWidgetWorkItemWidgetStatusInputStatus: Experiment. Introduced in GitLab 17.11.

Input for status widget.
titleString!Title of the work item.
vulnerabilityIdVulnerabilityIDStatus: Experiment. Introduced in GitLab 17.9.

Input for linking an existing vulnerability to created work item.
weightWidgetWorkItemWidgetWeightInputInput for weight widget.
workItemTypeIdWorkItemsTypeID!Global ID of a work item type.

WorkItemDecisionCreateInput

Autogenerated input type of WorkItemDecisionCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringContext of the decision.
discussionIdDiscussionIDGlobal ID of the originating discussion thread.
options[WorkItemDecisionOptionInput!]Candidate options of the decision. Maximum of 5 options. Incompatible with resolution.
resolutionWorkItemDecisionResolutionInputWhen present, records the decision as resolved at creation. Incompatible with options.
sourceLinkStringURL of the comment, discussion, or external resource that prompted the decision.
titleStringQuestion being decided. Required unless resolution is provided.
workItemIdWorkItemID!Global ID of the work item.

WorkItemDecisionOptionInput

Attributes for a candidate option of a work item decision.

Arguments

NameTypeDescription
contentString!Content of the decision option.
descriptionStringReasoning behind the decision option.
recommendedBooleanIndicates the option is recommended by GitLab Duo.

WorkItemDecisionResolutionInput

Attributes for recording a work item decision as resolved at creation.

Arguments

NameTypeDescription
decisionString!Decision that was made, recorded as the selected option of the work item decision.
rationaleStringReasoning behind the decision.
resolvedByIdUserIDGlobal ID of the user who resolved the decision. Defaults to the current user.

WorkItemDecisionResolveInput

Autogenerated input type of WorkItemDecisionResolve.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemsDecisionID!Global ID of the decision.
resolutionRationaleStringReasoning for the resolution.
resolvingNoteIdNoteIDGlobal ID of the comment that resolved the decision.
selectedOptionIds[WorkItemsDecisionOptionID!]Global IDs of the selected options. Maximum of 5 options.

WorkItemDeleteInput

Autogenerated input type of WorkItemDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item.

WorkItemDescriptionTemplateContentInput

Arguments

NameTypeDescription
fromNamespaceStringFull path of the group or project using the template.
nameString!Name of the description template.
projectIdInt!ID of the project the template belongs to.

WorkItemEnableAiPlanningInput

Autogenerated input type of WorkItemEnableAiPlanning.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item.

WorkItemExportInput

Autogenerated input type of WorkItemExport.

Arguments

NameTypeDescription
assigneeUsernames[String!]Usernames of users assigned to the work item (maximum is 100 usernames).
assigneeWildcardIdAssigneeWildcardIdFilter by assignee wildcard. Incompatible with assigneeUsernames.
authorUsernameStringFilter work items by author username.
clientMutationIdStringA unique identifier for the client performing the mutation.
closedAfterTimeWork items closed after the date.
closedBeforeTimeWork items closed before the date.
confidentialBooleanFilter for confidential work items. If false, excludes confidential work items. If true, returns only confidential work items.
createdAfterTimeWork items created after the timestamp.
createdBeforeTimeWork items created before the timestamp.
crmContactIdStringFilter by ID of CRM contact.
crmOrganizationIdStringFilter by ID of CRM contact organization.
dueAfterTimeWork items due after the timestamp.
dueBeforeTimeWork items due before the timestamp.
healthStatusFilterHealthStatusFilterStatus: Experiment. Introduced in GitLab 18.2.

Health status of the work items, “none” and “any” values are supported.
hierarchyFiltersHierarchyFilterInputStatus: Experiment. Introduced in GitLab 18.3.

Filtering options related to the work item hierarchy.
ids[WorkItemID!]Filter by global IDs of work items (maximum is 100 IDs).
iids[String!]List of IIDs of work items. For example, ["1", "2"] (maximum is 100 IIDs).
in[IssuableSearchableField!]Specify the fields to perform the search in. Defaults to [TITLE, DESCRIPTION]. Requires the search argument.’.
includeDescendantWorkItemsBooleanStatus: Experiment. Introduced in GitLab 18.3.

Whether to include work items of descendant parents when filtering by parent_ids.
iterationCadenceId[IterationsCadenceID!]Status: Experiment. Introduced in GitLab 18.2.

Filter by a list of iteration cadence IDs.
iterationId[ID]Status: Experiment. Introduced in GitLab 18.2.

List of iteration Global IDs applied to the work items.
iterationWildcardIdIterationWildcardIdStatus: Experiment. Introduced in GitLab 18.2.

Filter by iteration ID wildcard.
labelName[String!]Labels applied to the work item (maximum is 100 labels).
milestoneTitle[String!]Milestone applied to the work item (maximum is 100 milestones).
milestoneWildcardIdMilestoneWildcardIdFilter by milestone ID wildcard. Incompatible with milestoneTitle.
myReactionEmojiStringFilter by reaction emoji applied by the current user. Wildcard values NONE and ANY are supported.
notNegatedWorkItemFilterInputNegated work item arguments.
orUnionedWorkItemFilterInputList of arguments with inclusive OR.
parentIds[WorkItemID!]Filter work items by global IDs of their parent items (maximum is 100 IDs).
parentWildcardIdWorkItemParentWildcardIdStatus: Experiment. Introduced in GitLab 18.5.

Filter by parent ID wildcard. Incompatible with parentIds.
projectPathID!Full project path.
releaseTag[String!]Release tag associated with the work item’s milestone (maximum is 100 tags). Ignored when parent is a group.
releaseTagWildcardIdReleaseTagWildcardIdFilter by release tag wildcard.
searchStringSearch query for title or description.
selectedFields[AvailableExportFields!]List of selected fields to be exported. Omit to export all available fields.
stateIssuableStateCurrent state of the work item.
statusWorkItemWidgetStatusFilterInputStatus: Experiment. Introduced in GitLab 18.7.

Filter by status.
subscribedSubscriptionStatusWork items the current user is subscribed to.
types[IssueType!]Filter work items by the given work item types.
updatedAfterTimeWork items updated after the timestamp.
updatedBeforeTimeWork items updated before the timestamp.
weightStringStatus: Experiment. Introduced in GitLab 18.2.

Weight applied to the work item, “none” and “any” values are supported.
weightWildcardIdWeightWildcardIdStatus: Experiment. Introduced in GitLab 18.2.

Filter by weight ID wildcard. Incompatible with weight.
workItemTypeIds[WorkItemsTypeID!]Filter work items by work item type global IDs.

WorkItemGenerateReadinessScoreInput

Autogenerated input type of WorkItemGenerateReadinessScore.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item to score readiness for.

WorkItemGenerateWorkplanInput

Autogenerated input type of WorkItemGenerateWorkplan.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item to generate a workplan for.

WorkItemHierarchyAddChildrenItemsInput

Autogenerated input type of WorkItemHierarchyAddChildrenItems.

Arguments

NameTypeDescription
childrenIds[WorkItemID!]!Global IDs of children work items.
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item.

WorkItemRemoveLinkedItemsInput

Autogenerated input type of WorkItemRemoveLinkedItems.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item.
workItemsIds[WorkItemID!]!Global IDs of the items to unlink. Maximum number of IDs you can provide: 10.

WorkItemResolveDiscussionsInput

Arguments

NameTypeDescription
discussionIdStringID of a discussion to resolve.
noteableIdNoteableID!Global ID of the noteable where discussions will be resolved when the work item is created. Only MergeRequestID is supported at the moment.

WorkItemResumeWorkplanInput

Autogenerated input type of WorkItemResumeWorkplan.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item whose workplan generation to resume.

WorkItemSavedViewCreateInput

Autogenerated input type of WorkItemSavedViewCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the saved view.
displaySettingsJSON!Display settings associated with the saved view.
filtersWorkItemSavedViewFilterInput!Filters associated with the saved view.
isPrivateBooleanWhether the saved view is private. Default is true.
nameString!Name of the saved view.
namespacePathID!Full path of the namespace to create the saved view in.
privateBooleanDeprecated in GitLab 18.10. Replaced by isPrivate argument.
sortWorkItemSort!Sort option associated with the saved view.

WorkItemSavedViewDeleteInput

Autogenerated input type of WorkItemSavedViewDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemsSavedViewsSavedViewID!Global ID of the saved view.

WorkItemSavedViewFilterInput

Arguments

NameTypeDescription
assigneeUsernames[String!]Filter values for assignee usernames filter(maximum is 100 usernames).
assigneeWildcardIdAssigneeWildcardIdFilter values for assignee wildcard id filter. Incompatible with assigneeUsernames.
authorUsernameStringFilter value for author username filter.
closedAfterTimeFilter value for closed after filter.
closedBeforeTimeFilter value for closed before filter.
confidentialBooleanFilter value for confidential filter.
createdAfterTimeFilter value for created after filter.
createdBeforeTimeFilter value for created before filter.
crmContactIdStringFilter value for crm contact id filter.
crmOrganizationIdStringFilter value for crm organization id filter.
customField[WorkItemWidgetCustomFieldFilterInputType!]Filter value for custom field filter. (maximum is 100 fields).
dueAfterTimeFilter value for due after filter.
dueBeforeTimeFilter value for due before filter.
excludeGroupWorkItemsBooleanFilter value for exclude group work items filter.
excludeProjectsBooleanFilter value for exclude projects filter.
fullPathIDFilter value for full path filter.
healthStatusFilterHealthStatusFilterFilter value for health status filter.
hierarchyFiltersHierarchyFilterInputFilter value for hierarchy filter.
iidStringFilter value for IID filter.
in[IssuableSearchableField!]“Filter value for in filter.
includeDescendantWorkItemsBooleanFilter value for include descendant work items filter.
includeDescendantsBooleanFilter value for include descendants filter.
iterationCadenceId[IterationsCadenceID!]Filter value for iteration cadence id filter. (maximum is 100 IDs).
iterationId[ID!]Filter value for iteration id filter.
iterationWildcardIdIterationWildcardIdFilter value for iteration wildcard id filter.
labelName[String!]Filter value for label name filter. (maximum is 100 labels).
milestoneTitle[String!]Filter value for milestone title filter. (maximum is 100 milestones).
milestoneWildcardIdMilestoneWildcardIdFilter value for milestone wildcard id filter. Incompatible with milestoneTitle.
myReactionEmojiStringFilter value for my reaction emoji filter.
notWorkItemSavedViewNegatedFilterInputFilter value for not filter.
orWorkItemSavedViewUnionedFilterInputFilter values for or filter.
releaseTag[String!]Filter value for release tag filter (maximum is 100 tags).
releaseTagWildcardIdReleaseTagWildcardIdFilter value for release tag wildcard id filter.
searchStringFilter value for search filter.
stateIssuableStateFilter value for state filter.
statusWorkItemWidgetStatusFilterInputFilter value for status filter.
subscribedSubscriptionStatusFilter value for subscribed filter.
types[IssueType!]Filter value for types filter.
updatedAfterTimeFilter value for updated after filter.
updatedBeforeTimeFilter value for updated before filter.
weightStringFilter value for weight filter.
weightWildcardIdWeightWildcardIdFilter value for weight wildcard id filter.
workItemTypeIds[WorkItemsTypeID!]Filter value for work item type global IDs.

WorkItemSavedViewNegatedFilterInput

Arguments

NameTypeDescription
assigneeUsernames[String!]Filter value for not assignee username filter. (maximum is 100 usernames).
authorUsername[String!]Filter value for not author username filter. (maximum is 100 usernames).
customField[WorkItemWidgetCustomFieldFilterInputType!]Filter value for not custom field filter.
healthStatusFilter[HealthStatus!]Filter values for not health status filter.
iterationId[ID!]Filter values for not iteration id filter. (maximum is 100 IDs).
iterationWildcardIdIterationWildcardIdFilter value for not iteration wildcard id filter.
labelName[String!]Filter value for not label name filter. (maximum is 100 labels).
milestoneTitle[String!]Filter value for not milestone title filter.(maximum is 100 milestones).
milestoneWildcardIdNegatedMilestoneWildcardIdFilter value for not milestone wildcard id filter.
myReactionEmojiStringFilter value for not my reaction emoji filter.
parentIds[WorkItemID!]Filter work items by global IDs who don’t belong to parent items (maximum is 100 IDs).
releaseTag[String!]File value for not release tag filter. (maximum is 100 tags).
types[IssueType!]Filter value for not types filter.
weightStringFilter values for not weight filter.
workItemTypeIds[WorkItemsTypeID!]Filter value for not work item type global IDs filter.

WorkItemSavedViewReorderInput

Autogenerated input type of WorkItemSavedViewReorder.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemsSavedViewsSavedViewID!Global ID of the saved view to be reordered.
moveAfterIdWorkItemsSavedViewsSavedViewIDGlobal ID of a saved view that the reordered view should be placed after.
moveBeforeIdWorkItemsSavedViewsSavedViewIDGlobal ID of a saved view that the reordered view should be placed before.

WorkItemSavedViewSubscribeInput

Autogenerated input type of WorkItemSavedViewSubscribe.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemsSavedViewsSavedViewID!Global ID of the saved view to subscribe to.

WorkItemSavedViewUnionedFilterInput

Arguments

NameTypeDescription
assigneeUsernames[String!]Filter value for unioned assignee usernames filter. (maximum is 100 usernames).
authorUsernames[String!]Filter value for unioned author usernames filter. (maximum is 100 usernames).
customField[WorkItemWidgetCustomFieldFilterInputType!]Filter value for unioned custom field filter.
labelNames[String!]Filter value for unioned label names filter.(maximum is 100 labels).

WorkItemSavedViewUnsubscribeInput

Autogenerated input type of WorkItemSavedViewUnsubscribe.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemsSavedViewsSavedViewID!Global ID of the saved view to unsubscribe from.

WorkItemSavedViewUpdateInput

Autogenerated input type of WorkItemSavedViewUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the saved view.
displaySettingsJSONDisplay settings associated with the saved view.
filtersWorkItemSavedViewFilterInputFilters associated with the saved view.
idWorkItemsSavedViewsSavedViewID!Global ID of the saved view.
isPrivateBooleanWhether the saved view is private.
nameStringName of the saved view.
privateBooleanDeprecated in GitLab 18.10. Replaced by isPrivate argument.
sortWorkItemSortSorting option associated with the saved view.

WorkItemSettingsUpdateInput

Autogenerated input type of WorkItemSettingsUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
customizableTypeVisibilityBooleanWhether namespace admins can configure per-type work item visibility.
fullPathIDFull path of the root group. Omit to use the current organization.

WorkItemStatusInput

Arguments

NameTypeDescription
categoryWorkItemStatusCategoryEnumCategory of the status.
colorStringColor of the status.
descriptionStringDescription of the status.
idGlobalIDID of the status. If not provided, a new status will be created.
nameStringName of the status.

WorkItemSubscribeInput

Autogenerated input type of WorkItemSubscribe.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item.
subscribedBoolean!Desired state of the subscription.

WorkItemTypeCreateInput

Autogenerated input type of WorkItemTypeCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
enabledByDefaultForNewNamespacesBooleanIndicates the type is enabled by default for new child namespaces.
fullPathStringFull path of the root group.
iconNameString!Icon name for the work item type. Use the workItemTypeIconDefinitions query to retrieve the list of available icon names.
nameString!Name for the work item type.

WorkItemTypeUpdateInput

Autogenerated input type of WorkItemTypeUpdate.

Arguments

NameTypeDescription
archiveBooleanWhether to archive the work item type.
clientMutationIdStringA unique identifier for the client performing the mutation.
enabledByDefaultForNewNamespacesBooleanIndicates the type is enabled by default for new child namespaces.
fullPathStringFull path of the root group.
iconNameStringIcon name for the work item type. Use the workItemTypeIconDefinitions query to retrieve the list of available icon names.
idWorkItemsTypeID!Global ID of the work item type to update.
nameStringNew name for the work item type.

WorkItemUpdateInput

Autogenerated input type of WorkItemUpdate.

Arguments

NameTypeDescription
agentPlanWidgetWorkItemWidgetAgentPlanInputStatus: Experiment. Introduced in GitLab 19.0.

Input for agent plan widget.
assigneesWidgetWorkItemWidgetAssigneesInputInput for assignees widget.
awardEmojiWidgetWorkItemWidgetAwardEmojiUpdateInputInput for emoji reactions widget.
clientMutationIdStringA unique identifier for the client performing the mutation.
colorWidgetWorkItemWidgetColorInputInput for color widget.
confidentialBooleanSets the work item confidentiality.
crmContactsWidgetWorkItemWidgetCrmContactsUpdateInputInput for CRM contacts widget.
currentUserTodosWidgetWorkItemWidgetCurrentUserTodosInputInput for to-dos widget.
customFieldsWidget[WorkItemWidgetCustomFieldValueInputType!]Status: Experiment. Introduced in GitLab 17.10.

Input for custom fields widget.
descriptionWidgetWorkItemWidgetDescriptionInputInput for description widget.
healthStatusWidgetWorkItemWidgetHealthStatusInputInput for health status widget.
hierarchyWidgetWorkItemWidgetHierarchyUpdateInputInput for hierarchy widget.
idWorkItemID!Global ID of the work item.
iterationWidgetWorkItemWidgetIterationInputInput for iteration widget.
labelsWidgetWorkItemWidgetLabelsUpdateInputInput for labels widget.
milestoneWidgetWorkItemWidgetMilestoneInputInput for milestone widget.
moveAfterIdWorkItemIDStatus: Experiment. Introduced in GitLab 19.2.

Global ID of a work item that should be placed after the work item.
moveBeforeIdWorkItemIDStatus: Experiment. Introduced in GitLab 19.2.

Global ID of a work item that should be placed before the work item.
notesWidgetWorkItemWidgetNotesInputInput for notes widget.
notificationsWidgetWorkItemWidgetNotificationsUpdateInputInput for notifications widget.
progressWidgetWorkItemWidgetProgressInputInput for progress widget.
startAndDueDateWidgetWorkItemWidgetStartAndDueDateUpdateInputInput for start and due date widget.
stateEventWorkItemStateEventClose or reopen a work item.
statusWidgetWorkItemWidgetStatusInputStatus: Experiment. Introduced in GitLab 17.11.

Input for status widget.
timeTrackingWidgetWorkItemWidgetTimeTrackingInputInput for time tracking widget.
titleStringTitle of the work item.
verificationStatusWidgetVerificationStatusInputInput for verification status widget.
weightWidgetWorkItemWidgetWeightInputInput for weight widget.

WorkItemUserPreferenceUpdateInput

Autogenerated input type of WorkItemUserPreferenceUpdate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
displaySettingsJSONDisplay settings for the work item lists.
namespacePathID!Full path of the namespace on which the preference is set.
sortWorkItemSortSort order for work item lists.CREATED_ASC
workItemTypeIdWorkItemsTypeIDGlobal ID of a work item type.

WorkItemWidgetAgentPlanInput

Arguments

NameTypeDescription
contentStringContent of the agent plan.
readinessScoreIntStatus: Experiment. Introduced in GitLab 19.3.

Readiness score of the agent plan (0-100). Null when the score is not yet available. Only available when the workplan_score feature flag is enabled.
readinessScoreFeedbackStringStatus: Experiment. Introduced in GitLab 19.4.

Markdown feedback explaining the readiness score. Only available when the workplan_score feature flag is enabled.

WorkItemWidgetAssigneesInput

Arguments

NameTypeDescription
assigneeIds[UserID!]!Global IDs of assignees.

WorkItemWidgetAwardEmojiUpdateInput

Arguments

NameTypeDescription
actionWorkItemAwardEmojiUpdateAction!Action for the update.
nameString!Emoji name.

WorkItemWidgetColorInput

Arguments

NameTypeDescription
colorColor!Color of the work item.

WorkItemWidgetCrmContactsCreateInput

Arguments

NameTypeDescription
contactIds[CustomerRelationsContactID!]!CRM contact IDs to set.

WorkItemWidgetCrmContactsUpdateInput

Arguments

NameTypeDescriptionDefault
contactIds[CustomerRelationsContactID!]!CRM contact IDs to set. Replaces existing contacts by default.
operationModeMutationOperationModeSet the operation mode.REPLACE

WorkItemWidgetCurrentUserTodosInput

Arguments

NameTypeDescription
actionWorkItemTodoUpdateAction!Action for the update.
todoIdTodoIDGlobal ID of the to-do. If not present, all to-dos of the work item will be updated.

WorkItemWidgetCustomFieldFilterInputType

Arguments

NameTypeDescription
customFieldIdIssuablesCustomFieldIDGlobal ID of the custom field.
customFieldNameStringName of the custom field.
selectedOptionIds[IssuablesCustomFieldSelectOptionID!]Global IDs of the selected options for custom fields with select type (maximum is 100 IDs).
selectedOptionValues[String!]Values of the selected options for custom fields with select type (maximum is 100 values).

WorkItemWidgetCustomFieldValueInputType

Arguments

NameTypeDescription
customFieldIdIssuablesCustomFieldID!Global ID of the custom field.
dateValueDateValue for custom fields with date type.
numberValueFloatValue for custom fields with number type.
selectedOptionIds[IssuablesCustomFieldSelectOptionID!]Global IDs of the selected options for custom fields with select type.
textValueStringValue for custom fields with text type.

WorkItemWidgetDescriptionInput

Arguments

NameTypeDescription
descriptionStringDescription of the work item.
taskListToggleTaskListToggleInputToggle a single task list item instead of replacing the full description. Only supported when updating a work item.

WorkItemWidgetDevelopmentCreateInput

Arguments

NameTypeDescription
linkTypeMergeRequestWorkItemLinkTypeType of link. Defaults to RELATED.
mergeRequestIds[MergeRequestID!]!Global IDs of the merge requests to link. Maximum number of IDs you can provide: 100.

WorkItemWidgetHealthStatusInput

Arguments

NameTypeDescription
healthStatusHealthStatusHealth status to be assigned to the work item.

WorkItemWidgetHierarchyCreateInput

Arguments

NameTypeDescription
parentIdWorkItemIDGlobal ID of the parent work item.

WorkItemWidgetHierarchyUpdateInput

Arguments

NameTypeDescription
adjacentWorkItemIdWorkItemIDID of the work item to be switched with.
childrenIds[WorkItemID!]Global IDs of children work items.
parentIdWorkItemIDGlobal ID of the parent work item. Use null to remove the association.
relativePositionRelativePositionTypeType of switch. Valid values are BEFORE or AFTER.

WorkItemWidgetIterationInput

Arguments

NameTypeDescription
iterationIdIterationIDIteration to assign to the work item.

WorkItemWidgetLabelsCreateInput

Arguments

NameTypeDescription
labelIds[LabelID!]!IDs of labels to be added to the work item.

WorkItemWidgetLabelsUpdateInput

Arguments

NameTypeDescription
addLabelIds[LabelID!]Global IDs of labels to be added to the work item.
removeLabelIds[LabelID!]Global IDs of labels to be removed from the work item.

WorkItemWidgetLinkedItemsCreateInput

Arguments

NameTypeDescription
linkTypeWorkItemRelatedLinkTypeType of link. Defaults to RELATED.
workItemsIds[WorkItemID!]!Global IDs of the items to link. Maximum number of IDs you can provide: 10.

WorkItemWidgetMilestoneInput

Arguments

NameTypeDescription
milestoneIdMilestoneIDMilestone to assign to the work item.

WorkItemWidgetNotesInput

Arguments

NameTypeDescription
discussionLockedBoolean!Discussion lock attribute for notes widget of the work item.

WorkItemWidgetNotificationsUpdateInput

Arguments

NameTypeDescription
subscribedBoolean!Desired state of the subscription.

WorkItemWidgetProgressInput

Arguments

NameTypeDescription
currentValueInt!Current progress value of the work item.
endValueIntEnd value of the work item.
startValueIntStart value of the work item.

WorkItemWidgetStartAndDueDateUpdateInput

Arguments

NameTypeDescription
dueDateDateDue date for the work item.
isFixedBooleanIndicates if the work item is using fixed dates.
startDateDateStart date for the work item.

WorkItemWidgetStatusFilterInput

Arguments

NameTypeDescription
idWorkItemsStatusesStatusIDGlobal ID of the status.
nameStringName of the status.

WorkItemWidgetStatusInput

Arguments

NameTypeDescription
nameStringName of the status. Resolved case-insensitively against the work item’s status lifecycle. Mutually exclusive with status.
statusWorkItemsStatusesStatusIDGlobal ID of the status. Mutually exclusive with name.

WorkItemWidgetTimeTrackingInput

Arguments

NameTypeDescription
timeEstimateStringTime estimate for the work item in human readable format. For example: 1h 30m.
timelogWorkItemWidgetTimeTrackingTimelogInputTimelog data for time spent on the work item.

WorkItemWidgetTimeTrackingTimelogInput

Arguments

NameTypeDescription
spentAtTimeTimestamp of when the time tracked was spent at, if not provided would be set to current timestamp.
summaryStringSummary of how the time was spent.
timeSpentString!Amount of time spent in human readable format. For example: 1h 30m.

WorkItemWidgetWeightInput

Arguments

NameTypeDescription
weightIntWeight of the work item.

WorkItemsCsvExportInput

Autogenerated input type of WorkItemsCsvExport.

Arguments

NameTypeDescription
assigneeUsernames[String!]Usernames of users assigned to the work item (maximum is 100 usernames).
assigneeWildcardIdAssigneeWildcardIdFilter by assignee wildcard. Incompatible with assigneeUsernames.
authorUsernameStringFilter work items by author username.
clientMutationIdStringA unique identifier for the client performing the mutation.
closedAfterTimeWork items closed after the date.
closedBeforeTimeWork items closed before the date.
confidentialBooleanFilter for confidential work items. If false, excludes confidential work items. If true, returns only confidential work items.
createdAfterTimeWork items created after the timestamp.
createdBeforeTimeWork items created before the timestamp.
crmContactIdStringFilter by ID of CRM contact.
crmOrganizationIdStringFilter by ID of CRM contact organization.
dueAfterTimeWork items due after the timestamp.
dueBeforeTimeWork items due before the timestamp.
healthStatusFilterHealthStatusFilterStatus: Experiment. Introduced in GitLab 18.2.

Health status of the work items, “none” and “any” values are supported.
hierarchyFiltersHierarchyFilterInputStatus: Experiment. Introduced in GitLab 18.3.

Filtering options related to the work item hierarchy.
ids[WorkItemID!]Filter by global IDs of work items (maximum is 100 IDs).
iids[String!]List of IIDs of work items. For example, ["1", "2"] (maximum is 100 IIDs).
in[IssuableSearchableField!]Specify the fields to perform the search in. Defaults to [TITLE, DESCRIPTION]. Requires the search argument.’.
includeDescendantWorkItemsBooleanStatus: Experiment. Introduced in GitLab 18.3.

Whether to include work items of descendant parents when filtering by parent_ids.
iterationCadenceId[IterationsCadenceID!]Status: Experiment. Introduced in GitLab 18.2.

Filter by a list of iteration cadence IDs.
iterationId[ID]Status: Experiment. Introduced in GitLab 18.2.

List of iteration Global IDs applied to the work items.
iterationWildcardIdIterationWildcardIdStatus: Experiment. Introduced in GitLab 18.2.

Filter by iteration ID wildcard.
labelName[String!]Labels applied to the work item (maximum is 100 labels).
milestoneTitle[String!]Milestone applied to the work item (maximum is 100 milestones).
milestoneWildcardIdMilestoneWildcardIdFilter by milestone ID wildcard. Incompatible with milestoneTitle.
myReactionEmojiStringFilter by reaction emoji applied by the current user. Wildcard values NONE and ANY are supported.
notNegatedWorkItemFilterInputNegated work item arguments.
orUnionedWorkItemFilterInputList of arguments with inclusive OR.
parentIds[WorkItemID!]Filter work items by global IDs of their parent items (maximum is 100 IDs).
parentWildcardIdWorkItemParentWildcardIdStatus: Experiment. Introduced in GitLab 18.5.

Filter by parent ID wildcard. Incompatible with parentIds.
projectPathID!Full project path.
releaseTag[String!]Release tag associated with the work item’s milestone (maximum is 100 tags). Ignored when parent is a group.
releaseTagWildcardIdReleaseTagWildcardIdFilter by release tag wildcard.
searchStringSearch query for title or description.
selectedFields[AvailableExportFields!]List of selected fields to be exported. Omit to export all available fields.
stateIssuableStateCurrent state of the work item.
statusWorkItemWidgetStatusFilterInputStatus: Experiment. Introduced in GitLab 18.7.

Filter by status.
subscribedSubscriptionStatusWork items the current user is subscribed to.
types[IssueType!]Filter work items by the given work item types.
updatedAfterTimeWork items updated after the timestamp.
updatedBeforeTimeWork items updated before the timestamp.
weightStringStatus: Experiment. Introduced in GitLab 18.2.

Weight applied to the work item, “none” and “any” values are supported.
weightWildcardIdWeightWildcardIdStatus: Experiment. Introduced in GitLab 18.2.

Filter by weight ID wildcard. Incompatible with weight.
workItemTypeIds[WorkItemsTypeID!]Filter work items by work item type global IDs.

WorkItemsCsvImportInput

Autogenerated input type of WorkItemsCsvImport.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
fileUpload!CSV file to import work items from.
projectPathID!Full project path.

WorkspaceCreateInput

Autogenerated input type of WorkspaceCreate.

Arguments

NameTypeDescriptionDefault
clientMutationIdStringA unique identifier for the client performing the mutation.
clusterAgentIdClustersAgentID!GlobalID of the cluster agent the created workspace will be associated with.
desiredStateString!Desired state of the created workspace.
devfilePathStringProject path containing the devfile used to configure the workspace. If not provided, the GitLab default devfile is used.null
devfileRefStringDeprecated in GitLab 17.8. Argument is renamed to project_ref.
editorStringDeprecated in GitLab 17.5. Argument is not used.
maxHoursBeforeTerminationIntDeprecated in GitLab 17.9. Field is not used.
projectIdProjectID!ID of the project that will provide the Devfile for the created workspace.
projectRefStringProject repo git ref.
variables[WorkspaceVariableInput!]Deprecated in GitLab 18.0. Argument is renamed to workspace_variables.[]
workspaceVariables[WorkspaceVariableInput!]Status: Experiment. Introduced in GitLab 18.0.

Variables to inject into the workspace.
[]

WorkspaceUpdateInput

Autogenerated input type of WorkspaceUpdate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
desiredStateString!Desired state of the created workspace.
idRemoteDevelopmentWorkspaceID!Global ID of the workspace.

WorkspaceVariableInput

Attributes for defining a variable to be injected in a workspace.

Arguments

NameTypeDescriptionDefault
keyString!Name of the workspace variable.
typeWorkspaceVariableInputTypeDeprecated in GitLab 17.9. Use variableType instead.ENVIRONMENT
valueString!Value of the variable.
variableTypeWorkspaceVariableTypeType of the variable to be injected in a workspace.ENVIRONMENT

approvalProjectRuleDeleteInput

Autogenerated input type of approvalProjectRuleDelete.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idApprovalProjectRuleID!Global ID of the approval project rule to delete.

approvalProjectRuleUpdateInput

Autogenerated input type of approvalProjectRuleUpdate.

Arguments

NameTypeDescription
approvalsRequiredInt!How many approvals are required to satisfy rule.
clientMutationIdStringA unique identifier for the client performing the mutation.
coverageMinimumThresholdFloatMinimum code coverage threshold (0-100). Approval is required if coverage falls below the specified threshold.
groupIds[ID!]List of IDs of Groups that can approval rule.
idApprovalProjectRuleID!Global ID of the approval rule to destroy.
nameString!Name of the approval rule.
userIds[ID!]List of IDs of Users that can approval rule.

branchRuleApprovalProjectRuleCreateInput

Autogenerated input type of branchRuleApprovalProjectRuleCreate.

Arguments

NameTypeDescription
approvalsRequiredInt!How many approvals are required to satisfy rule.
branchRuleIdProjectsBranchRuleID!Global ID of the branch rule to destroy.
clientMutationIdStringA unique identifier for the client performing the mutation.
coverageMinimumThresholdFloatMinimum code coverage threshold (0-100). Approval is required if coverage falls below the specified threshold.
groupIds[ID!]List of IDs of Groups that can approval rule.
nameString!Name of the approval rule.
userIds[ID!]List of IDs of Users that can approval rule.

createContainerProtectionTagRuleInput

Autogenerated input type of createContainerProtectionTagRule.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
minimumAccessLevelForDeleteContainerProtectionTagRuleAccessLevelMinimum GitLab access level required to delete container image tags from the container repository. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, no access level can delete tags.
minimumAccessLevelForPushContainerProtectionTagRuleAccessLevelMinimum GitLab access level required to push container image tags to the container repository. Valid values include MAINTAINER, OWNER, or ADMIN. If the value is nil, no access level can push tags.
projectPathID!Full path of the project containing the container image tags.
tagNamePatternString!The pattern that matches container image tags to protect. For example, v1.*. Wildcard character * allowed.

iterationCreateInput

Autogenerated input type of iterationCreate.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
descriptionStringDescription of the iteration.
dueDateStringEnd date of the iteration.
groupPathIDFull path of the group with which the resource is associated.
iterationsCadenceIdIterationsCadenceIDGlobal ID of the iteration cadence to be assigned to the new iteration.
projectPathIDFull path of the project with which the resource is associated.
startDateStringStart date of the iteration.
titleStringTitle of the iteration.

projectBlobsRemoveInput

Autogenerated input type of projectBlobsRemove.

Arguments

NameTypeDescription
blobOids[String!]!List of blob oids.
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project to replace.

projectTextReplaceInput

Autogenerated input type of projectTextReplace.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
projectPathID!Full path of the project to replace.
replacements[String!]!List of text patterns to replace project-wide.

vulnerabilitiesSeverityOverrideInput

Autogenerated input type of vulnerabilitiesSeverityOverride.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
commentString!Comment why vulnerability severity was changed (maximum 50,000 characters).
severityVulnerabilitySeverity!New severity value for the severities.
vulnerabilityIds[VulnerabilityID!]!IDs of the vulnerabilities for which severity needs to be changed (maximum 100 entries).

workItemsHierarchyReorderInput

Autogenerated input type of workItemsHierarchyReorder.

Arguments

NameTypeDescription
adjacentWorkItemIdWorkItemIDID of the work item to move next to. For example, the item above or below.
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item to be reordered.
parentIdWorkItemIDGlobal ID of the new parent work item.
relativePositionRelativePositionTypePosition relative to the adjacent work item. Valid values are BEFORE or AFTER.

workItemsReorderInput

Autogenerated input type of workItemsReorder.

Arguments

NameTypeDescription
clientMutationIdStringA unique identifier for the client performing the mutation.
idWorkItemID!Global ID of the work item to be reordered.
moveAfterIdWorkItemIDGlobal ID of a work item that should be placed after the work item.
moveBeforeIdWorkItemIDGlobal ID of a work item that should be placed before the work item.