InfoGrab DocsInfoGrab Docs

GraphQL API 뮤테이션

요약

Mutations are the top-level entry points for creating, updating, and deleting data in the GitLab GraphQL API. Deprecated items are planned to be removed in a future release.

Mutations are the top-level entry points for creating, updating, and deleting data in the GitLab GraphQL API. For an introduction, see Mutations.

Warning

Deprecated items are planned to be removed in a future release. For more information, see the GitLab deprecation process.

Calling a mutation#

You call a mutation with one argument, input. You put the mutation's arguments inside input, and then request the fields you want returned:

mutation($id: NoteableID!, $body: String!) {
  # Arguments go inside `input`.
  createNote(input: { noteableId: $id, body: $body }) {
    # Request the fields you want returned.
    note {
      id
      body
    }
    errors
  }
}

Each mutation lists:

  • Input type: The type of input. You need it when you pass all of the arguments as one variable, for example mutation($input: CreateNoteInput!) { createNote(input: $input) { errors } }.
  • Arguments: What you can put inside input. An argument whose type ends in ! is required, unless it has a default value.
  • Fields: What you can request in the result. Every mutation returns errors, a list of error messages. Always request errors so you can see why a mutation failed.

clientMutationId#

Every mutation also accepts an optional clientMutationId argument of type String, and returns the same value in its result. Use it to match each response to its request. It works the same way for every mutation, so it is not listed with each mutation's arguments and fields.

achievementsAward#

Input type: AchievementsAwardInput

Arguments#

Name Type Description
achievementId AchievementsAchievementID! Global ID of the achievement being awarded.
awardMessage String Message to associate with the awarded achievement.
userId UserID! Global ID of the user being awarded the achievement.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievement UserAchievement Achievement award.

achievementsCreate#

Input type: AchievementsCreateInput

Arguments#

Name Type Description
avatar Upload Avatar for the achievement.
description String Description of or notes for the achievement.
name String! Name for the achievement.
namespaceId NamespaceID! Namespace for the achievement.

Fields#

Name Type Description
achievement Achievement Achievement created.
errors [String!]! Errors encountered during the mutation.

achievementsDelete#

Input type: AchievementsDeleteInput

Arguments#

Name Type Description
achievementId AchievementsAchievementID! Global ID of the achievement being deleted.

Fields#

Name Type Description
achievement Achievement Achievement.
errors [String!]! Errors encountered during the mutation.

achievementsRevoke#

Input type: AchievementsRevokeInput

Arguments#

Name Type Description
userAchievementId AchievementsUserAchievementID! Global ID of the user achievement being revoked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievement UserAchievement Achievement award.

achievementsUpdate#

Input type: AchievementsUpdateInput

Arguments#

Name Type Description
achievementId AchievementsAchievementID! Global ID of the achievement being updated.
avatar Upload Avatar for the achievement.
description String Description of or notes for the achievement.
name String Name for the achievement.

Fields#

Name Type Description
achievement Achievement Achievement.
errors [String!]! Errors encountered during the mutation.

addProjectToSecurityDashboard#

Input type: AddProjectToSecurityDashboardInput

Arguments#

Name Type Description
id ProjectID! ID of the project to be added to Instance Security Dashboard.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project that was added to the Instance Security Dashboard.

adminClearDuoAvailability#

히스토리

Clears an admin-locked GitLab Duo availability override from a group.

Input type: AdminClearDuoAvailabilityInput

Arguments#

Name Type Description
groupId GroupID! Group to clear the GitLab Duo availability override from.

Fields#

Name Type Description
adminLocked Boolean Whether the group has an admin-locked GitLab Duo availability override.
availability DuoAvailability Resolved GitLab Duo availability for the group after the override is cleared.
errors [String!]! Errors encountered during the mutation.

adminRolesLdapSync#

히스토리

Input type: AdminRolesLdapSyncInput

Fields#

Name Type Description
errors [String!] Errors encountered during operation.
success Boolean Whether the sync was successfully enqueued.

adminSetDuoAvailability#

히스토리

Sets an admin-locked GitLab Duo availability override on a group.

Input type: AdminSetDuoAvailabilityInput

Arguments#

Name Type Description Default
availability DuoAvailability! GitLab Duo availability state to lock on the group.
clearDescendants Boolean Clear conflicting admin-locked overrides on descendant groups instead of rejecting. false
groupId GroupID! Group to set the GitLab Duo availability override on.

Fields#

Name Type Description
adminLocked Boolean Whether the group has an admin-locked GitLab Duo availability override.
affectedAdminLockedDescendants AdminDuoAvailabilityLockedAncestorConnection Descendant groups with admin-locked overrides that must be cleared before this override can be applied. Present only when clearDescendants was false; the override was not applied. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.
availability DuoAvailability Resolved GitLab Duo availability for the group after the mutation.
conflictingAncestor AdminDuoAvailabilityLockedAncestor Ancestor group whose admin lock blocked the mutation, if any. When present, the override was not applied.
errors [String!]! Errors encountered during the mutation.

adminSidekiqQueuesDeleteJobs#

Input type: AdminSidekiqQueuesDeleteJobsInput

Arguments#

Name Type Description
aiResource String Delete jobs matching ai_resource in the context metadata.
artifactSize String Delete jobs matching artifact_size in the context metadata.
artifactUsedCdn String Delete jobs matching artifact_used_cdn in the context metadata.
artifactsDependenciesCount String Delete jobs matching artifacts_dependencies_count in the context metadata.
artifactsDependenciesSize String Delete jobs matching artifacts_dependencies_size in the context metadata.
bulkImportEntityId String Delete jobs matching bulk_import_entity_id in the context metadata.
callerId String Delete jobs matching caller_id in the context metadata.
clientId String Delete jobs matching client_id in the context metadata.
clientName String Delete jobs matching client_name in the context metadata.
clientType String Delete jobs matching client_type in the context metadata.
clientVersion String Delete jobs matching client_version in the context metadata.
featureCategory String Delete jobs matching feature_category in the context metadata.
glRootNamespaceId String Delete jobs matching gl_root_namespace_id in the context metadata.
glUserId String Delete jobs matching gl_user_id in the context metadata.
jobId String Delete jobs matching job_id in the context metadata.
kubernetesAgentId String Delete jobs matching kubernetes_agent_id in the context metadata.
mergeActionStatus String Delete jobs matching merge_action_status in the context metadata.
mvccManifest String Delete jobs matching mvcc_manifest in the context metadata.
organizationId String Delete jobs matching organization_id in the context metadata.
pipelineId String Delete jobs matching pipeline_id in the context metadata.
project String Delete jobs matching project in the context metadata.
queueName String! Name of the queue to delete jobs from.
relatedClass String Delete jobs matching related_class in the context metadata.
remoteIp String Delete jobs matching remote_ip in the context metadata.
rootCallerId String Delete jobs matching root_caller_id in the context metadata.
rootNamespace String Delete jobs matching root_namespace in the context metadata.
scopedUser String Delete jobs matching scoped_user in the context metadata.
scopedUserId String Delete jobs matching scoped_user_id in the context metadata.
sidekiqDestinationShardRedis String Delete jobs matching sidekiq_destination_shard_redis in the context metadata.
subscriptionPlan String Delete jobs matching subscription_plan in the context metadata.
user String Delete jobs matching user in the context metadata.
userId String Delete jobs matching user_id in the context metadata.
workerClass String Delete jobs with the given worker class.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
result DeleteJobsResponse Information about the status of the deletion request.

aiAction#

히스토리

Input type: AiActionInput

Arguments#

Name Type Description
agenticChat AiAgenticChatInput Input for agentic_chat AI action.
chat AiChatInput Input for chat AI action.
clientSubscriptionId String Client generated ID that can be subscribed to, to receive a response for the mutation.
conversationType AiConversationsThreadsConversationType Conversation type of the thread.
explainVulnerability AiExplainVulnerabilityInput Input for explain_vulnerability AI action.
generateCommitMessage AiGenerateCommitMessageInput Input for generate_commit_message AI action.
generateDescription AiGenerateDescriptionInput Input for generate_description AI action.
measureCommentTemperature AiMeasureCommentTemperatureInput Input for measure_comment_temperature AI action.
platformOrigin String Specifies the origin platform of the request.
projectId ProjectID Global ID of the project the user is acting on.
resolveVulnerability AiResolveVulnerabilityInput Input for resolve_vulnerability AI action.
rootNamespaceId NamespaceID Global ID of the top-level namespace the user is acting on.
summarizeNewMergeRequest AiSummarizeNewMergeRequestInput Input for summarize_new_merge_request AI action.
summarizeReview AiSummarizeReviewInput Input for summarize_review AI action.
threadId AiConversationThreadID Global 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requestId String ID of the request.
threadId AiConversationThreadID Global Id of the thread.

aiCatalogAgentCreate#

히스토리

Input type: AiCatalogAgentCreateInput

Arguments#

Name Type Description
description String! Description for the agent.
mcpServers [AiCatalogMcpServerID!] Introduced as an experiment in GitLab 18.10.

MCP servers to associate with the agent.
mcpTools [String!] Introduced as an experiment in GitLab 18.11.

List of MCP tools enabled for the agent.
name String! Name for the agent.
projectId ProjectID! Project for the agent.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the agent.
systemPrompt String! System prompt for the agent.
tools [AiCatalogBuiltInToolID!] List of GitLab built-in tools enabled for the agent.
userPrompt String User prompt for the agent.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the agent in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogAgent Item created.

aiCatalogAgentDelete#

히스토리

Input type: AiCatalogAgentDeleteInput

Arguments#

Name Type Description
forceHardDelete Boolean When true, the flow will always be hard deleted and never soft deleted. Can only be used by instance admins.
id AiCatalogItemID! Global ID of the catalog Agent to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Returns true if catalog Agent was successfully deleted.

aiCatalogAgentUpdate#

히스토리

Input type: AiCatalogAgentUpdateInput

Arguments#

Name Type Description
description String Description for the agent.
id AiCatalogItemID! Global ID of the catalog Agent to update.
mcpServers [AiCatalogMcpServerID!] Introduced as an experiment in GitLab 18.10.

MCP servers to associate with the agent.
mcpTools [String!] Introduced as an experiment in GitLab 18.11.

List of MCP tools enabled for the agent.
name String Name for the agent.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the agent.
systemPrompt String System prompt for the agent.
tools [AiCatalogBuiltInToolID!] List of GitLab built-in tools enabled for the agent.
userPrompt String User prompt for the agent.
versionBump AiCatalogVersionBump Bump version, calculated from the last released version name.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the agent in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogAgent Agent that was updated.

aiCatalogFlowCreate#

히스토리

Input type: AiCatalogFlowCreateInput

Arguments#

Name Type Description
definition String YAML definition for the flow.
description String! Description for the flow.
name String! Name for the flow.
projectId ProjectID! Project for the flow.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the flow.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the flow in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogFlow Item created.

aiCatalogFlowDelete#

히스토리

Input type: AiCatalogFlowDeleteInput

Arguments#

Name Type Description
forceHardDelete Boolean When true, the flow will always be hard deleted and never soft deleted. Can only be used by instance admins.
id AiCatalogItemID! Global ID of the catalog flow to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Returns true if catalog flow was successfully deleted.

aiCatalogFlowUpdate#

히스토리

Input type: AiCatalogFlowUpdateInput

Arguments#

Name Type Description
definition String YAML definition for the Flow.
description String Description for the flow.
id AiCatalogItemID! Global ID of the catalog flow to update.
name String Name for the flow.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the flow.
versionBump AiCatalogVersionBump Bump version, calculated from the last released version name.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the flow in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogFlow Flow that was updated.

aiCatalogItemConsumerBulkCreate#

히스토리

Input type: AiCatalogItemConsumerBulkCreateInput

Arguments#

Name Type Description
itemId AiCatalogItemID! Global ID of the catalog item to enable.
pinnedVersion AiCatalogPinnedVersion Version 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).
triggerConditions AiCatalogTriggerConditionsInput Introduced as an experiment in GitLab 19.3.

Filter conditions for the auto-created AI Catalog triggers, keyed by event type.
triggerFilter JSON Deprecated in GitLab 19.3. Use triggerConditions.
triggerGoals JSON Introduced as an experiment in GitLab 19.5.

Goals for the auto-created AI Catalog triggers, keyed by event type.
triggerTypes [String!] List of event types to create AI Catalog triggers for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

aiCatalogItemConsumerCreate#

히스토리

Input type: AiCatalogItemConsumerCreateInput

Arguments#

Name Type Description Default
consumerKind AiCatalogItemConsumerKind Type of item configuration. INHERITANCE is only valid for a top-level group target. DIRECT
itemId AiCatalogItemID! Item to configure.
parentItemConsumerId AiCatalogItemConsumerID Parent item consumer belonging to the top-level group.
pinnedVersion AiCatalogPinnedVersion Version 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.
replaceExistingDirectConfigurations Boolean Confirm replacement of a group configuration, and any project configurations, for this item when inheritance is turned on. Required when the item is already configured for the group.
target ItemConsumerTargetInput! Target project or top-level group in which the catalog item is configured.
triggerConditions AiCatalogTriggerConditionsInput Introduced as an experiment in GitLab 19.3.

Filter conditions for the auto-created AI Catalog triggers, keyed by event type.
triggerFilter JSON Deprecated in GitLab 19.3. Use triggerConditions.
triggerGoals JSON Introduced as an experiment in GitLab 19.5.

Goals for the auto-created AI Catalog triggers, keyed by event type.
triggerTypes [String!] List of event types to create AI Catalog triggers for (values can be mention, assign or assign_reviewer).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
itemConsumer AiCatalogItemConsumer Item configuration created.
warnings [String!]! Non-fatal problems encountered while configuring the item. The configuration was still created.

aiCatalogItemConsumerDelete#

히스토리

Input type: AiCatalogItemConsumerDeleteInput

Arguments#

Name Type Description
id AiCatalogItemConsumerID! Global ID of the catalog item consumer to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Returns true if catalog item consumer was successfully deleted.

aiCatalogItemConsumerUpdate#

히스토리

Input type: AiCatalogItemConsumerUpdateInput

Arguments#

Name Type Description
id AiCatalogItemConsumerID! Global ID of the catalog item consumer to update.
pinnedVersion AiCatalogPinnedVersion Version the item is pinned to, in the format n.n.n.
pinnedVersionPrefix AiCatalogPinnedVersion Deprecated in GitLab 19.0. Use pinnedVersion instead.
serviceAccountId UserID Service 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).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
itemConsumer AiCatalogItemConsumer Item consumer that was updated.

aiCatalogItemReport#

히스토리

Input type: AiCatalogItemReportInput

Arguments#

Name Type Description
body String Additional details about the report. Limited to 1000 characters.
id AiCatalogItemID! Global ID of the catalog item to report.
reason AiCatalogItemReportReason! Reason for reporting the catalog item.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

aiCatalogItemStar#

히스토리

Input type: AiCatalogItemStarInput

Arguments#

Name Type Description
id AiCatalogItemID! Global ID of the catalog item to star or unstar.
starred Boolean! Indicates whether to star or unstar the catalog item.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
starCount Int! Number of stars for the catalog item.

aiCatalogItemVersionRestore#

히스토리

Input type: AiCatalogItemVersionRestoreInput

Arguments#

Name Type Description Default
deprecateCurrent Boolean Whether to mark the current latest version as deprecated. false
id AiCatalogItemVersionID! Global ID of the item version to restore from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
itemVersion AiCatalogItemVersion Newly created item version restored from the source version.

aiCatalogMcpServerCreate#

히스토리

Input type: AiCatalogMcpServerCreateInput

Arguments#

Name Type Description
authType AiCatalogMcpServerAuthType! Authentication type for the MCP server.
description String Description for the MCP server.
homepageUrl String Homepage URL for the MCP server.
name String! Name for the MCP server.
oauthClientId String OAuth client ID for the MCP server.
oauthClientSecret String OAuth client secret for the MCP server.
transport AiCatalogMcpServerTransport! Transport type for the MCP server.
url String! URL for the MCP server.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mcpServer AiCatalogMcpServer MCP server created.

aiCatalogMcpServerSetBlock#

히스토리

Blocks or allows an external MCP server for a group or project (kill-switch).

Input type: AiCatalogMcpServerSetBlockInput

Arguments#

Name Type Description
blocked Boolean! Set to true to block the MCP server, false to allow it.
groupFullPath ID Full path of the group to block or allow the MCP server for. Provide exactly one of groupFullPath or projectFullPath.
id AiCatalogMcpServerID! Global ID of the MCP server.
projectFullPath ID Full path of the project to block or allow the MCP server for. Provide exactly one of groupFullPath or projectFullPath.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mcpServer AiCatalogMcpServer MCP server with its updated block status.

aiCatalogMcpServerUpdate#

히스토리

Input type: AiCatalogMcpServerUpdateInput

Arguments#

Name Type Description
authType AiCatalogMcpServerAuthType Authentication type for the MCP server.
description String Description for the MCP server.
homepageUrl String Homepage URL for the MCP server.
id AiCatalogMcpServerID! Global ID of the MCP server to update.
name String Name for the MCP server.
oauthClientId String OAuth client ID for the MCP server.
oauthClientSecret String OAuth client secret for the MCP server.
transport AiCatalogMcpServerTransport Transport type for the MCP server.
url String URL for the MCP server.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mcpServer AiCatalogMcpServer MCP server that was updated.

aiCatalogThirdPartyFlowCreate#

히스토리

Input type: AiCatalogThirdPartyFlowCreateInput

Arguments#

Name Type Description
definition String! YAML definition for the Flow.
description String! Description for the Flow.
name String! Name for the Flow.
projectId ProjectID! Project for the Flow.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the Flow.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the Flow in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogThirdPartyFlow Item created.

aiCatalogThirdPartyFlowDelete#

히스토리

Input type: AiCatalogThirdPartyFlowDeleteInput

Arguments#

Name Type Description
forceHardDelete Boolean When true, the Third Party Flow will always be hard deleted and never soft deleted. Can only be used by instance admins.
id AiCatalogItemID! Global ID of the catalog Third Party Flow to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Returns true if catalog Third Party Flow was successfully deleted.

aiCatalogThirdPartyFlowUpdate#

히스토리

Input type: AiCatalogThirdPartyFlowUpdateInput

Arguments#

Name Type Description
definition String YAML definition for the Flow.
description String Description for the Flow.
id AiCatalogItemID! Global ID of the catalog Flow to update.
name String Name for the Flow.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the Flow.
versionBump AiCatalogVersionBump Bump version, calculated from the last released version name.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the Flow in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogThirdPartyFlow Flow that was updated.

aiDomainSettingsInstanceUpdate#

히스토리

Adds or removes domains from the allowed or denied list for flows running in a sandboxed environment.

Input type: AiDomainSettingsInstanceUpdateInput

Arguments#

Name Type Description
action AiDomainSettingAction! Action to perform on the domain list.
domainSettingType AiDomainSettingType! Type of domain setting to update.
domains [String!]! List of domains to add or remove.

Fields#

Name Type Description
addedDomains [String!] Domains that were added in the operation.
errors [String!]! Errors encountered during the mutation.
removedDomains [String!] Domains that were removed in the operation.

aiDomainSettingsNamespaceUpdate#

히스토리

Adds or removes domains from the allowed or denied list for flows running in a sandboxed environment.

Input type: AiDomainSettingsNamespaceUpdateInput

Arguments#

Name Type Description
action AiDomainSettingAction! Action to perform on the domain list.
domainSettingType AiDomainSettingType! Type of domain setting to update.
domains [String!]! List of domains to add or remove.
namespaceId NamespaceID! Global ID of the root namespace to update.

Fields#

Name Type Description
addedDomains [String!] Domains that were added in the operation.
errors [String!]! Errors encountered during the mutation.
removedDomains [String!] Domains that were removed in the operation.

aiDuoWorkflowCreate#

히스토리

Input type: AiDuoWorkflowCreateInput

Arguments#

Name Type Description
agentPrivileges [Int!] Actions the agent is allowed to perform.
aiCatalogItemVersionId AiCatalogItemVersionID ID of the catalog item the workflow is triggered from.
allowAgentToRequestUser Boolean When enabled, Duo Agent Platform may stop to ask the user questions before proceeding.
environment WorkflowEnvironment Environment for the workflow.
goal String Goal of the workflow.
issueId BigInt IID of the noteable (Issue) that the workflow is associated with.
mergeRequestId BigInt IID of the noteable (MergeRequest) that the workflow is associated with.
namespaceId NamespaceID Global ID of the namespace the user is acting on.
preApprovedAgentPrivileges [Int!] Actions the agent can perform without asking for approval.
projectId ProjectID Global ID of the project the user is acting on.
webSearchEnabled Boolean Enable web search for the session.
workflowDefinition String Workflow type based on its capability.

Fields#

Name Type Description
errors [String!]! Errors encountered during the creation process.
workflow DuoWorkflow Created workflow.

aiFeatureSettingModelAllowlistUpdate#

히스토리

Updates the instance-level model selection allowlist for an AI feature.

Input type: AiFeatureSettingModelAllowlistUpdateInput

Arguments#

Name Type Description
allowlistEnabled Boolean! 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.
feature AiFeatures! AI feature whose model allowlist is being configured.

Fields#

Name Type Description
allowList AiModelSelectionAllowList Model selection allowlist for the feature after the update.
errors [String!]! Errors encountered during the mutation.

aiFeatureSettingUpdate#

히스토리

Updates or creates settings for AI features.

Input type: AiFeatureSettingUpdateInput

Arguments#

Name Type Description
aiSelfHostedModelId AiSelfHostedModelID Global ID of the self-hosted model providing the AI setting.
features [AiFeatures!]! Array of AI features being configured (for single or batch update).
offeredModelRef String Identifier of the selected model for the feature.
provider AiFeatureProviders! Provider for AI setting.

Fields#

Name Type Description
aiFeatureSettings [AiFeatureSetting!]! List of AI feature settings after mutation.
errors [String!]! Errors encountered during the mutation.

aiFlowScheduleCreate#

히스토리

Input type: AiFlowScheduleCreateInput

Arguments#

Name Type Description Default
active Boolean Indicates whether the schedule should be active. true
cron String! Cron expression defining the schedule frequency.
cronTimezone String! IANA timezone for the cron expression.
description String! Description of the schedule.
flowTriggerId AiFlowTriggerID! Global ID of the flow trigger to schedule.

Fields#

Name Type Description
aiFlowSchedule AiFlowScheduleType Created flow schedule.
errors [String!]! Errors encountered during the mutation.

aiFlowScheduleDelete#

히스토리

Input type: AiFlowScheduleDeleteInput

Arguments#

Name Type Description
id AiFlowScheduleID! Global ID of the flow schedule to delete.

Fields#

Name Type Description
aiFlowSchedule AiFlowScheduleType Deleted flow schedule.
errors [String!]! Errors encountered during the mutation.

aiFlowScheduleUpdate#

히스토리

Input type: AiFlowScheduleUpdateInput

Arguments#

Name Type Description
active Boolean Indicates whether the schedule should be active.
cron String Cron expression defining the schedule frequency.
cronTimezone String IANA timezone for the cron expression.
description String Description of the schedule.
id AiFlowScheduleID! Global ID of the flow schedule to update.

Fields#

Name Type Description
aiFlowSchedule AiFlowScheduleType Updated flow schedule.
errors [String!]! Errors encountered during the mutation.

aiFlowTriggerCreate#

히스토리

Input type: AiFlowTriggerCreateInput

Arguments#

Name Type Description
active Boolean Introduced as an experiment in GitLab 19.4.

Indicates whether the AI flow trigger is active. Defaults to true.
aiCatalogItemConsumerId AiCatalogItemConsumerID AI catalog item consumer to use instead of config_path.
configPath String Path to the configuration file for the AI flow trigger.
description String! Description of the AI flow trigger.
eventTypes [Int!] Event types that triggers the AI flow.
filter JSON Introduced as an experiment in GitLab 19.0.

Filter conditions for the AI flow trigger.
goals JSON Introduced as an experiment in GitLab 19.5.

Goals for the AI flow trigger, keyed by event type.
projectPath ID! Full path of the project the AI flow trigger is associated with.
userId UserID Service account for the AI flow trigger.

Fields#

Name Type Description
aiFlowTrigger AiFlowTriggerType Created AI flow trigger.
errors [String!]! Errors encountered during the mutation.

aiFlowTriggerDelete#

히스토리

Input type: AiFlowTriggerDeleteInput

Arguments#

Name Type Description
id AiFlowTriggerID! ID of the flow trigger to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

aiFlowTriggerUpdate#

히스토리

Input type: AiFlowTriggerUpdateInput

Arguments#

Name Type Description
active Boolean Introduced as an experiment in GitLab 19.4.

Indicates whether the AI flow trigger is active. Inactive triggers do not run automatically.
aiCatalogItemConsumerId AiCatalogItemConsumerID AI catalog item consumer to use instead of config_path.
configPath String Path to the configuration file for the AI flow trigger.
description String Description of the AI flow trigger.
eventTypes [Int!] Event types that triggers the AI flow.
filter JSON Introduced as an experiment in GitLab 18.11.

Filter conditions for the AI flow trigger.
goals JSON Introduced as an experiment in GitLab 19.5.

Goals for the AI flow trigger, keyed by event type.
id AiFlowTriggerID! ID of the flow trigger to update.
userId UserID Service account for the AI flow trigger.

Fields#

Name Type Description
aiFlowTrigger AiFlowTriggerType Updated AI flow trigger.
errors [String!]! Errors encountered during the mutation.

aiModelSelectionNamespaceModelAllowlistUpdate#

히스토리

Updates the namespace-level model selection allowlist for an AI feature.

Input type: AiModelSelectionNamespaceModelAllowlistUpdateInput

Arguments#

Name Type Description
allowlistEnabled Boolean! 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.
feature AiFeatures! AI feature whose model allowlist is being configured.
groupId GroupID! Group whose model allowlist is being configured.

Fields#

Name Type Description
allowList AiModelSelectionAllowList Model selection allowlist for the feature after the update.
errors [String!]! Errors encountered during the mutation.

aiModelSelectionNamespaceUpdate#

히스토리

Updates or creates settings for AI features for a namespace.

Input type: AiModelSelectionNamespaceUpdateInput

Arguments#

Name Type Description
features [AiModelSelectionFeatures!]! Array of AI features being configured (for single or batch update).
groupId GroupID! Group for the model selection.
offeredModelRef String! Identifier of the selected model for the feature.

Fields#

Name Type Description
aiFeatureSettings [AiModelSelectionNamespaceFeatureSetting!]! Introduced as an experiment in GitLab 18.1.

List of AI feature settings after mutation.
errors [String!]! Errors encountered during the mutation.

aiSelfHostedModelConnectionCheck#

히스토리

Checks if the AI Gateway can establish a connection with the given model configuration.

Input type: AiSelfHostedModelConnectionCheckInput

Arguments#

Name Type Description
apiToken String API token to access the self-hosted model, if any.
endpoint String Endpoint of the self-hosted model.
iamRole String IAM role ARN that the AI Gateway assumes through STS AssumeRole when calling Amazon Bedrock. Only used by the Amazon Bedrock provider.
identifier String Identifier for 3rd party model provider.
model AiAcceptedSelfHostedModels! AI model deployed.
name String! Deployment name of the self-hosted model.
provider AiSelfHostedModelProvider! Provider for the self-hosted model.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
result CloudConnectorProbeResult Self-hosted hosted connection check result.

aiSelfHostedModelCreate#

히스토리

Input type: AiSelfHostedModelCreateInput

Arguments#

Name Type Description
apiToken String API token to access the self-hosted model, if any.
endpoint String Endpoint of the self-hosted model.
iamRole String IAM role ARN that the AI Gateway assumes through STS AssumeRole when calling Amazon Bedrock. Only used by the Amazon Bedrock provider.
identifier String Identifier for 3rd party model provider.
model AiAcceptedSelfHostedModels! AI model deployed.
name String! Deployment name of the self-hosted model.
provider AiSelfHostedModelProvider! Provider for the self-hosted model.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
selfHostedModel AiSelfHostedModel Self-hosted model after mutation.

aiSelfHostedModelDelete#

히스토리

Deletes a self-hosted model.

Input type: AiSelfHostedModelDeleteInput

Arguments#

Name Type Description
id AiSelfHostedModelID! Global ID of the self-hosted model to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

aiSelfHostedModelUpdate#

히스토리

Updates a self-hosted model.

Input type: AiSelfHostedModelUpdateInput

Arguments#

Name Type Description
apiToken String API token to access the self-hosted model, if any.
endpoint String Endpoint of the self-hosted model.
iamRole String IAM role ARN that the AI Gateway assumes through STS AssumeRole when calling Amazon Bedrock. Only used by the Amazon Bedrock provider.
id AiSelfHostedModelID! Global ID of the self-hosted model to update.
identifier String Identifier for 3rd party model provider.
model AiAcceptedSelfHostedModels! AI model deployed.
name String! Deployment name of the self-hosted model.
provider AiSelfHostedModelProvider! Provider for the self-hosted model.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
selfHostedModel AiSelfHostedModel Self-hosted model after mutation.

alertSetAssignees#

Input type: AlertSetAssigneesInput

Arguments#

Name Type Description
assigneeUsernames [String!]! Usernames to assign to the alert. Replaces existing assignees by default.
iid String! IID of the alert to mutate.
operationMode MutationOperationMode Operation to perform. Defaults to REPLACE.
projectPath ID! Project the alert to mutate is in.

Fields#

Name Type Description
alert AlertManagementAlert Alert after mutation.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.
todo Todo To-do item after mutation.

alertTodoCreate#

Input type: AlertTodoCreateInput

Arguments#

Name Type Description
iid String! IID of the alert to mutate.
projectPath ID! Project the alert to mutate is in.

Fields#

Name Type Description
alert AlertManagementAlert Alert after mutation.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.
todo Todo To-do item after mutation.

approvalProjectRuleDelete#

히스토리

Input type: approvalProjectRuleDeleteInput

Arguments#

Name Type Description
id ApprovalProjectRuleID! Global ID of the approval project rule to delete.

Fields#

Name Type Description
approvalRule ApprovalProjectRule Deleted approval rule.
errors [String!]! Errors encountered during the mutation.

approvalProjectRuleUpdate#

히스토리

Input type: approvalProjectRuleUpdateInput

Arguments#

Name Type Description
approvalsRequired Int! How many approvals are required to satisfy rule.
coverageMinimumThreshold Float Minimum 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.
id ApprovalProjectRuleID! Global ID of the approval rule to destroy.
name String! Name of the approval rule.
userIds [ID!] List of IDs of Users that can approval rule.

Fields#

Name Type Description
approvalRule ApprovalProjectRule Approval rule after mutation.
errors [String!]! Errors encountered during the mutation.

approveDeployment#

Input type: ApproveDeploymentInput

Arguments#

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

Fields#

Name Type Description
deploymentApproval DeploymentApproval DeploymentApproval after mutation.
errors [String!]! Errors encountered during the mutation.

artifactDestroy#

Input type: ArtifactDestroyInput

Arguments#

Name Type Description
id CiJobArtifactID! ID of the artifact to delete.

Fields#

Name Type Description
artifact CiJobArtifact Deleted artifact.
errors [String!]! Errors encountered during the mutation.

artifactRegistryActivate#

히스토리

Activates an Artifact Registry for an organization by claiming a slug.

Input type: ArtifactRegistryActivateInput

Arguments#

Name Type Description
slug String! Slug to claim, Artifact Registry's immutable identifier for the namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ArtifactRegistry Introduced as an experiment in GitLab 19.4.

The organization's registry: the one just provisioned, or the existing one when the organization is already activated. Null on every other refusal.

artifactRegistryArtifactDelete#

히스토리

Deletes one artifact of an Artifact Registry repository. Permanently deletes a published artifact on a hosted repository and evicts a cached artifact on a remote repository, following the kind of the repository addressed. Artifact Registry accepts the request rather than completing it, so the mutation reports acceptance rather than completion. Re-read the artifact list to see the result.

Input type: ArtifactRegistryArtifactDeleteInput

Arguments#

Name Type Description
id ID! ID of the artifact in Artifact Registry, as returned by the id field on a package or image. Not a GitLab global ID.
name String! Name of the repository holding the artifact, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted artifact. Counters were read before the deletion applied, so they can lag its result. Null when the deletion was not applied.

artifactRegistryContainerTagDelete#

히스토리

Deletes a container tag, identified by its name. Applies only to container repositories in Docker or OCI format. This mutation never reads the repository kind. Artifact Registry decides the outcome from its own records. On a hosted repository, deletion permanently removes the tag. On a remote repository, it evicts the cached tag reference. On a virtual repository, the request is passed through for Artifact Registry to decide. Deleting a tag never removes the manifest it pointed at. Artifact Registry accepts the request rather than completing it, so this mutation reports acceptance, not completion.

Input type: ArtifactRegistryContainerTagDeleteInput

Arguments#

Name Type Description
imageId ID! ID of the image holding the tag in Artifact Registry, as returned by the id field on an image. Not a GitLab global ID.
name String! Name of the repository holding the tag, unique within the organization.
tagName String! Name of the tag to delete. Limited to 1024 characters.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted tag. A tag delete moves no repository counter. Null when the deletion was not accepted.

artifactRegistryDisable#

히스토리

Disables Artifact Registry for the organization resolved from the request context (the X-GitLab-Organization-ID header, or the user default organization).

Input type: ArtifactRegistryDisableInput

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ArtifactRegistry Registry after the transition. Null when the transition was rejected, for example an unknown namespace.

artifactRegistryEnable#

히스토리

Enables Artifact Registry for the organization resolved from the request context (the X-GitLab-Organization-ID header, or the user default organization).

Input type: ArtifactRegistryEnableInput

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ArtifactRegistry Registry after the transition. Null when the transition was rejected, for example an unknown namespace.

artifactRegistryManifestDelete#

히스토리

Deletes a manifest, identified by its digest. Applies only to Docker or OCI container repositories, whose kind this mutation never reads. Artifact Registry decides the outcome from its records, permanently removing the manifest on a hosted repository, evicting the cached copy on a remote one, or passing the request through on a virtual one. Deleting a manifest removes tags pointing at it and index entries where it is the parent, though a manifest it indexed survives untagged. Artifact Registry accepts rather than completes the request, so this reports acceptance. Re-read the image's manifests afterward for the result. Deletion is refused if another manifest indexes the target as a child, and the error lists at most 10 blocking digests plus the total count.

Input type: ArtifactRegistryManifestDeleteInput

Arguments#

Name Type Description
digest String! Content-addressable digest of the manifest, as returned by the digest field on a manifest. Limited to 512 characters.
imageId ID! ID of the image holding the manifest in Artifact Registry, as returned by the id field on an image. Not a GitLab global ID.
name String! Name of the repository holding the manifest, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted manifest. Counters were read before the deletion applied, so they can lag its result. Null when the deletion was not accepted.

artifactRegistryNpmDistTagDelete#

히스토리

Deletes one dist-tag of an npm package in an Artifact Registry repository, addressed by its Artifact Registry ID. Applies to npm repositories only. A non-npm repository is refused before any request reaches Artifact Registry, and the refusal appears in the payload errors. A remote repository is refused the same way, because Artifact Registry holds the dist-tags of a remote repository as a rewritten document rather than as individually addressable rows, so there is no dist-tag row to delete. Removes the dist-tag alone, never the version it named. The mutation reports acceptance rather than completion.

Input type: ArtifactRegistryNpmDistTagDeleteInput

Arguments#

Name Type Description
id ID! ID of the dist-tag in Artifact Registry. Not a GitLab global ID.
name String! Name of the repository holding the dist-tag, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted dist-tag. A dist-tag delete moves no repository counter. Null when the deletion was not accepted.

artifactRegistryRepositoryArtifactsDelete#

히스토리

Deletes every artifact of an Artifact Registry repository. Permanently deletes published artifacts on a hosted repository and evicts cached artifacts on a remote repository, following the kind of the repository addressed. Artifact Registry accepts the request rather than completing it, so the mutation reports acceptance rather than completion. Re-read the artifact list to see the result.

Input type: ArtifactRegistryRepositoryArtifactsDeleteInput

Arguments#

Name Type Description
name String! Name of the repository whose artifacts are deleted, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository the deletion targeted. Counters were read before the deletion applied, so they can lag its result. Null when the deletion was not applied.

artifactRegistryRepositoryCreate#

히스토리

Creates a repository in Artifact Registry.

Input type: ArtifactRegistryRepositoryCreateInput

Arguments#

Name Type Description
description String Human-readable description of the repository.
format ArtifactRegistryRepositoryFormat! Package format the repository holds. Cannot be changed after creation.
kind ArtifactRegistryRepositoryKind How the repository sources its artifacts. Defaults to hosted in Artifact Registry.
name String! Name of the repository, unique within the organization.
settings ArtifactRegistryRemoteSettingsInput Introduced as an experiment in GitLab 19.4.

Upstream configuration. Required on a remote repository create, rejected on any other kind.
upstreamRepositoryIds [ID!] Introduced as an experiment in GitLab 19.5.

Upstream repositories of a virtual repository, as Artifact Registry repository IDs in resolution order. On update, replaces the whole upstream list, and an empty list removes every upstream. Rejected on any other kind. Maximum is 1000 IDs per request. Artifact Registry sets a lower limit on how many upstreams a repository can have.
visibility ArtifactRegistryRepositoryVisibility Who can read the repository.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
refusedUpstreamRepositoryId ID Introduced as an experiment in GitLab 19.5.

Artifact Registry ID of the first upstream list entry that Artifact Registry refused. Null unless an entry was refused.
repository ArtifactRegistryRepository Repository created. Null when the creation was not applied.

artifactRegistryRepositoryDelete#

히스토리

Deletes a repository in Artifact Registry and removes every artifact it holds. Deleting an already-absent repository still succeeds.

Input type: ArtifactRegistryRepositoryDeleteInput

Arguments#

Name Type Description
name String! Name of the repository to delete, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

artifactRegistryRepositoryTestConnection#

히스토리

Tests the upstream connection of a remote repository in Artifact Registry.

Input type: ArtifactRegistryRepositoryTestConnectionInput

Arguments#

Name Type Description
name String! Name of the repository to test, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
httpStatus Int Status the upstream answered the probe with. Null when the probe failed in transport and no response arrived, and when no probe ran.
lastHealthCheckedAt Time Timestamp of the most recent health probe of the upstream, as it reads after this probe. Null when no verdict is recorded, including when this probe's own write did not land.
lastHealthStatus ArtifactRegistryHealthStatus Stored health verdict as it reads after the probe. Can differ from passed, because Artifact Registry moves it to UNHEALTHY only once consecutive failures reach its threshold. UNKNOWN when no verdict is recorded, including when this probe's own write did not land, and for a status this schema does not recognize. Null when no probe ran.
passed Boolean Indicates the upstream answered the probe with a status below 500. Reports reachability rather than credential validity, so an upstream 401 or 404 passes. Null when no probe ran.

artifactRegistryRepositoryUpdate#

히스토리

Updates a repository in Artifact Registry. Artifact Registry writes the metadata fields and the settings in separate transactions, metadata first, so a failed update can leave a visibility or description change applied while the settings did not change. Re-sending the same mutation converges.

Input type: ArtifactRegistryRepositoryUpdateInput

Arguments#

Name Type Description
description String Human-readable description of the repository.
name String! Name of the repository to update, unique within the organization. Cannot be changed.
settings ArtifactRegistryRemoteSettingsInput Introduced as an experiment in GitLab 19.4.

Upstream configuration. Required on a remote repository create, rejected on any other kind.
upstreamRepositoryIds [ID!] Introduced as an experiment in GitLab 19.5.

Upstream repositories of a virtual repository, as Artifact Registry repository IDs in resolution order. On update, replaces the whole upstream list, and an empty list removes every upstream. Rejected on any other kind. Maximum is 1000 IDs per request. Artifact Registry sets a lower limit on how many upstreams a repository can have.
visibility ArtifactRegistryRepositoryVisibility Who can read the repository.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
refusedUpstreamRepositoryId ID Introduced as an experiment in GitLab 19.5.

Artifact Registry ID of the first upstream list entry that Artifact Registry refused. Null unless an entry was refused.
repository ArtifactRegistryRepository Repository updated. Null when the update was not applied.

artifactRegistryRoleBulkGrant#

히스토리

Grants Artifact Registry roles to users on resources in a single all-or-nothing operation. Replaces any role a user already holds on that resource.

Input type: ArtifactRegistryRoleBulkGrantInput

Arguments#

Name Type Description
assignments [ArtifactRegistryRoleAssignmentInput!]! Role assignments to grant. All succeed or none are written. A maximum of 1000 assignments is allowed per request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
grantedRoleCount Int Number of role assignments granted. Present only on success.

artifactRegistryRoleBulkRevoke#

히스토리

Revokes Artifact Registry roles from users on resources in a single all-or-nothing operation. Users can revoke their own role.

Input type: ArtifactRegistryRoleBulkRevokeInput

Arguments#

Name Type Description
revocations [ArtifactRegistryRoleRevocationInput!]! Role revocations to apply. All succeed or none are applied. A maximum of 1000 revocations is allowed per request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
revokedRoleCount Int Number of role assignments revoked. Present only on success.

artifactRegistryRoleGrant#

히스토리

Grants an Artifact Registry role to a user on a resource. Replaces any role the user already holds on that resource.

Input type: ArtifactRegistryRoleGrantInput

Arguments#

Name Type Description
assigneeId UserID! Global ID of the user to grant the role to.
resourceId String! UUID of the Artifact Registry resource (repository or namespace) the role applies to.
role ArtifactRegistryRole! Artifact Registry role to grant.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

artifactRegistryRoleRevoke#

히스토리

Revokes a user's Artifact Registry role on a resource. Names no role: a user holds one role per resource, and revoking removes it. Users can revoke their own role.

Input type: ArtifactRegistryRoleRevokeInput

Arguments#

Name Type Description
assigneeId UserID! Global ID of the user to revoke the role from.
resourceId String! UUID of the Artifact Registry resource (repository or namespace) the role is assigned on.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

artifactRegistryUpstreamRepositoryDissociate#

히스토리

Removes an upstream repository association from a virtual repository in Artifact Registry. The upstream repository and its artifacts remain unchanged, and Artifact Registry compacts the remaining upstream positions. Succeeds even when the association is already gone, or the repository is missing, inaccessible, not virtual, or not of the given format.

Input type: ArtifactRegistryUpstreamRepositoryDissociateInput

Arguments#

Name Type Description
associationId ID! ID of the upstream repository association to remove, as returned by the id field on an upstream repository association. Not a GitLab global ID.
format ArtifactRegistryRepositoryFormat! Package format of the virtual repository.
name String! Name of the virtual repository holding the upstream repository, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

artifactRegistryUpstreamTestConnection#

히스토리

Tests a supplied upstream connection for the remote repository create form in Artifact Registry, before any repository exists to hold it.

Input type: ArtifactRegistryUpstreamTestConnectionInput

Arguments#

Name Type Description
credentials ArtifactRegistryRemoteCredentialsInput Upstream 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.
format ArtifactRegistryRepositoryFormat! Package format of the upstream to probe. Decides the credential shape and the probe auth.
url String! Base URL of the upstream to probe.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
httpStatus Int Status the upstream answered the probe with. Null when the probe failed in transport and no response arrived, and when no probe ran.
passed Boolean Indicates the upstream answered the probe with a status below 500. Reports reachability rather than credential validity, so an upstream 401 or 404 passes. Null when no probe ran.

artifactRegistryVersionDelete#

히스토리

Deletes one version of a package in an Artifact Registry repository. Permanently deletes a published version on a hosted repository and evicts a cached version on a remote repository, following the kind of the repository addressed. Artifact Registry accepts the request rather than completing it, so the mutation reports acceptance rather than completion. Re-read the version list to see the result. Applies to Maven and npm repositories only.

Input type: ArtifactRegistryVersionDeleteInput

Arguments#

Name Type Description
id ID! ID of the version in Artifact Registry, as returned by the id field on a version. Not a GitLab global ID.
name String! Name of the repository holding the version, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted version. Counters were read before the deletion applied, so they can lag its result. Null when the deletion was not applied.

ascpComponentCreate#

히스토리

Input type: AscpComponentCreateInput

Arguments#

Name Type Description
description String Component description.
expectedUserBehavior String Expected user behavior for the component.
projectPath ID! Full path of the project.
scanId SecurityAscpScanID! ID of the scan when the component was discovered.
subDirectory String! Sub-directory path containing the component.
title String! Component title.

Fields#

Name Type Description
component AscpComponent Introduced as an experiment in GitLab 18.11.

Created component.
errors [String!]! Errors encountered during the mutation.

ascpScanCreate#

히스토리

Input type: AscpScanCreateInput

Arguments#

Name Type Description Default
baseCommitSha String Base commit SHA for incremental scans.
baseScanId SecurityAscpScanID ID of the base scan for incremental scans.
commitSha String! Git commit SHA that was scanned.
projectPath ID! Full path of the project.
scanType AscpScanType Type of scan (default: full). FULL

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
scan AscpScan Introduced as an experiment in GitLab 18.10.

Created scan.

ascpSecurityContextCreate#

히스토리

Input type: AscpSecurityContextCreateInput

Arguments#

Name Type Description
authenticationModel String How users authenticate to the component.
authorizationModel String How access is controlled.
componentId SecurityAscpComponentID! ID of the component.
dataSensitivity String Types of sensitive data handled.
guidelines [AscpSecurityGuidelineInput!]! List of security guidelines.
projectPath ID! Full path of the project.
scanId SecurityAscpScanID! ID of the scan when the security context was created.
securityBoundary [AscpSecurityBoundary!] Security boundaries the component sits on.
summary String High-level threat model summary.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityContext AscpSecurityContext Introduced as an experiment in GitLab 18.11.

Created security context.

auditEventsAmazonS3ConfigurationCreate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsCreate with amazonS3 category instead.

Input type: AuditEventsAmazonS3ConfigurationCreateInput

Arguments#

Name Type Description
accessKeyXid String! Access key ID of the Amazon S3 account.
awsRegion String! AWS region where the bucket is created.
bucketName String! Name of the bucket where the audit events would be logged.
groupPath ID! Group path.
name String Destination name.
secretAccessKey String! Secret access key of the Amazon S3 account.

Fields#

Name Type Description
amazonS3Configuration AmazonS3ConfigurationType configuration created.
errors [String!]! Errors encountered during the mutation.

auditEventsAmazonS3ConfigurationDelete#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsDelete instead.

Input type: AuditEventsAmazonS3ConfigurationDeleteInput

Arguments#

Name Type Description
id AuditEventsAmazonS3ConfigurationID! ID of the Amazon S3 configuration to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsAmazonS3ConfigurationUpdate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsUpdate instead.

Input type: AuditEventsAmazonS3ConfigurationUpdateInput

Arguments#

Name Type Description
accessKeyXid String Access key ID of the Amazon S3 account.
active Boolean Active status of the destination.
awsRegion String AWS region where the bucket is created.
bucketName String Name of the bucket where the audit events would be logged.
id AuditEventsAmazonS3ConfigurationID! ID of the Amazon S3 configuration to update.
name String Destination name.
secretAccessKey String Secret access key of the Amazon S3 account.

Fields#

Name Type Description
amazonS3Configuration AmazonS3ConfigurationType Updated Amazon S3 configuration.
errors [String!]! Errors encountered during the mutation.

auditEventsGroupDestinationDenylistEventsAdd#

히스토리

Input type: AuditEventsGroupDestinationDenylistEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add to the denylist.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of denylisted event type filters for the audit event external destination.

auditEventsGroupDestinationDenylistEventsDelete#

히스토리

Input type: AuditEventsGroupDestinationDenylistEventsDeleteInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from the denylist.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsGroupDestinationEventsAdd#

히스토리

Input type: AuditEventsGroupDestinationEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add for streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of event type filters for the audit event external destination.

auditEventsGroupDestinationEventsDelete#

히스토리

Input type: AuditEventsGroupDestinationEventsDeleteInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsGroupDestinationNamespaceFilterCreate#

히스토리

Input type: AuditEventsGroupDestinationNamespaceFilterCreateInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination ID.
namespacePath String Full path of the namespace(only project or group).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceFilter GroupAuditEventNamespaceFilter Namespace filter created.

auditEventsGroupDestinationNamespaceFilterDelete#

히스토리

Input type: AuditEventsGroupDestinationNamespaceFilterDeleteInput

Arguments#

Name Type Description
namespaceFilterId AuditEventsGroupNamespaceFilterID! Namespace filter ID.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsInstanceAmazonS3ConfigurationCreate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsCreate with amazonS3 category instead.

Input type: AuditEventsInstanceAmazonS3ConfigurationCreateInput

Arguments#

Name Type Description
accessKeyXid String! Access key ID of the Amazon S3 account.
awsRegion String! AWS region where the bucket is created.
bucketName String! Name of the bucket where the audit events would be logged.
name String Destination name.
secretAccessKey String! Secret access key of the Amazon S3 account.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceAmazonS3Configuration InstanceAmazonS3ConfigurationType Created instance Amazon S3 configuration.

auditEventsInstanceAmazonS3ConfigurationDelete#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsDelete instead.

Input type: AuditEventsInstanceAmazonS3ConfigurationDeleteInput

Arguments#

Name Type Description
id AuditEventsInstanceAmazonS3ConfigurationID! ID of the instance-level Amazon S3 configuration to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsInstanceAmazonS3ConfigurationUpdate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsUpdate instead.

Input type: AuditEventsInstanceAmazonS3ConfigurationUpdateInput

Arguments#

Name Type Description
accessKeyXid String Access key ID of the Amazon S3 account.
active Boolean Active status of the destination.
awsRegion String AWS region where the bucket is created.
bucketName String Name of the bucket where the audit events would be logged.
id AuditEventsInstanceAmazonS3ConfigurationID! ID of the instance-level Amazon S3 configuration to update.
name String Destination name.
secretAccessKey String Secret access key of the Amazon S3 account.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceAmazonS3Configuration InstanceAmazonS3ConfigurationType Updated instance-level Amazon S3 configuration.

auditEventsInstanceDestinationEventsAdd#

히스토리

Input type: AuditEventsInstanceDestinationEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add for streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of event type filters for the audit event external destination.

auditEventsInstanceDestinationEventsDelete#

히스토리

Input type: AuditEventsInstanceDestinationEventsDeleteInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsInstanceDestinationNamespaceFilterCreate#

히스토리

Input type: AuditEventsInstanceDestinationNamespaceFilterCreateInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalStreamingDestinationID! Destination ID.
namespacePath String Full path of the namespace. Project or group namespaces only.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceFilter InstanceAuditEventNamespaceFilter Namespace filter to be created.

auditEventsInstanceDestinationNamespaceFilterDelete#

히스토리

Input type: AuditEventsInstanceDestinationNamespaceFilterDeleteInput

Arguments#

Name Type Description
namespaceFilterId AuditEventsInstanceNamespaceFilterID! Namespace filter ID.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingDestinationEventsAdd#

Deprecated in GitLab 18.10. Use auditEventsGroupDestinationEventsAdd instead.

Input type: AuditEventsStreamingDestinationEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsExternalAuditEventDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add for streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of event type filters for the audit event external destination.

auditEventsStreamingDestinationEventsRemove#

Deprecated in GitLab 18.10. Use auditEventsGroupDestinationEventsRemove instead.

Input type: AuditEventsStreamingDestinationEventsRemoveInput

Arguments#

Name Type Description
destinationId AuditEventsExternalAuditEventDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingDestinationInstanceEventsAdd#

Deprecated in GitLab 18.10. Use auditEventsInstanceDestinationEventsAdd instead.

Input type: AuditEventsStreamingDestinationInstanceEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalAuditEventDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add for streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of event type filters for the audit event external destination.

auditEventsStreamingDestinationInstanceEventsRemove#

Deprecated in GitLab 18.10. Use auditEventsInstanceDestinationEventsRemove instead.

Input type: AuditEventsStreamingDestinationInstanceEventsRemoveInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalAuditEventDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingHeadersCreate#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use groupAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingHeadersCreateInput

Arguments#

Name Type Description Default
active Boolean Boolean option determining whether header is active or not. true
destinationId AuditEventsExternalAuditEventDestinationID! Destination to associate header with.
key String! Header key.
value String! Header value.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
header AuditEventStreamingHeader Created header.

auditEventsStreamingHeadersDestroy#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use groupAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingHeadersDestroyInput

Arguments#

Name Type Description
headerId AuditEventsStreamingHeaderID! Header to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingHeadersUpdate#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use groupAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingHeadersUpdateInput

Arguments#

Name Type Description Default
active Boolean Boolean option determining whether header is active or not. null
headerId AuditEventsStreamingHeaderID! Header to update.
key String Header key. null
value String Header value. null

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
header AuditEventStreamingHeader Updates header.

auditEventsStreamingHttpNamespaceFiltersAdd#

Deprecated in GitLab 18.10. Use auditEventsGroupDestinationNamespaceFilterCreate instead.

Input type: AuditEventsStreamingHTTPNamespaceFiltersAddInput

Arguments#

Name Type Description
destinationId AuditEventsExternalAuditEventDestinationID! Destination ID.
groupPath ID Full path of the group.
projectPath ID Full path of the project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceFilter AuditEventStreamingHTTPNamespaceFilter Namespace filter created.

auditEventsStreamingHttpNamespaceFiltersDelete#

Deprecated in GitLab 18.10. Use auditEventsGroupDestinationNamespaceFilterDelete instead.

Input type: AuditEventsStreamingHTTPNamespaceFiltersDeleteInput

Arguments#

Name Type Description
namespaceFilterId AuditEventsStreamingHTTPNamespaceFilterID! Namespace filter ID.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingInstanceHeadersCreate#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use instanceAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingInstanceHeadersCreateInput

Arguments#

Name Type Description Default
active Boolean Boolean option determining whether header is active or not. true
destinationId AuditEventsInstanceExternalAuditEventDestinationID! Instance level external destination to associate header with.
key String! Header key.
value String! Header value.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
header AuditEventsStreamingInstanceHeader Created header.

auditEventsStreamingInstanceHeadersDestroy#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use instanceAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingInstanceHeadersDestroyInput

Arguments#

Name Type Description
headerId AuditEventsStreamingInstanceHeaderID! Header to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingInstanceHeadersUpdate#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use instanceAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingInstanceHeadersUpdateInput

Arguments#

Name Type Description Default
active Boolean Boolean option determining whether header is active or not. null
headerId AuditEventsStreamingInstanceHeaderID! Header to update.
key String Header key. null
value String Header value. null

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
header AuditEventsStreamingInstanceHeader Updates header.

awardEmojiAdd#

Input type: AwardEmojiAddInput

Arguments#

Name Type Description
awardableId AwardableID! Global ID of the awardable resource.
name String! Emoji name.

Fields#

Name Type Description
awardEmoji AwardEmoji Emoji reactions after mutation.
errors [String!]! Errors encountered during the mutation.

awardEmojiRemove#

Input type: AwardEmojiRemoveInput

Arguments#

Name Type Description
awardableId AwardableID! Global ID of the awardable resource.
name String! Emoji name.

Fields#

Name Type Description
awardEmoji AwardEmoji Emoji reactions after mutation.
errors [String!]! Errors encountered during the mutation.

awardEmojiToggle#

Input type: AwardEmojiToggleInput

Arguments#

Name Type Description
awardableId AwardableID! Global ID of the awardable resource.
name String! Emoji name.

Fields#

Name Type Description
awardEmoji AwardEmoji Emoji reactions after mutation.
errors [String!]! Errors encountered during the mutation.
toggledOn Boolean! Indicates the status of the emoji. True if the toggle awarded the emoji, and false if the toggle removed the emoji.

boardEpicCreate#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: BoardEpicCreateInput

Arguments#

Name Type Description
boardId BoardsEpicBoardID! Global ID of the board that the epic is in.
groupPath ID! Group the epic to create is in.
listId BoardsEpicListID! Global ID of the epic board list in which epic will be created.
title String! Title of the epic.

Fields#

Name Type Description
epic Epic Epic after creation.
errors [String!]! Errors encountered during the mutation.

boardListCreate#

Input type: BoardListCreateInput

Arguments#

Name Type Description
assigneeId UserID Global ID of an existing user.
backlog Boolean Create the backlog list.
boardId BoardID! Global ID of the issue board to mutate.
iterationId IterationID Global ID of an existing iteration.
labelId LabelID Global ID of an existing label.
milestoneId MilestoneID Global ID of an existing milestone.
position Int Position of the list.
statusId WorkItemsStatusesStatusID Introduced as an experiment in GitLab 18.0.

Global ID of an existing status.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list BoardList Issue list in the issue board.

boardListUpdateLimitMetrics#

Input type: BoardListUpdateLimitMetricsInput

Arguments#

Name Type Description
limitMetric ListLimitMetric New limit metric type for the list.
listId ListID! Global ID of the list.
maxIssueCount Int New maximum issue count limit.
maxIssueWeight Int New maximum issue weight limit.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list BoardList Updated list.

branchDelete#

Input type: BranchDeleteInput

Arguments#

Name Type Description
name String! Name of the branch.
projectPath ID! Project full path the branch is associated with.

Fields#

Name Type Description
branch Branch Branch after mutation.
errors [String!]! Errors encountered during the mutation.

branchRuleApprovalProjectRuleCreate#

히스토리

Input type: branchRuleApprovalProjectRuleCreateInput

Arguments#

Name Type Description
approvalsRequired Int! How many approvals are required to satisfy rule.
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule to destroy.
coverageMinimumThreshold Float Minimum 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.
name String! Name of the approval rule.
userIds [ID!] List of IDs of Users that can approval rule.

Fields#

Name Type Description
approvalRule ApprovalProjectRule Approval rule after mutation.
errors [String!]! Errors encountered during the mutation.

branchRuleCreate#

히스토리

Input type: BranchRuleCreateInput

Arguments#

Name Type Description
name String! Branch name, with wildcards, for the branch rules.
projectPath ID! Full path to the project that the branch is associated with.

Fields#

Name Type Description
branchRule BranchRule Branch rule after mutation.
errors [String!]! Errors encountered during the mutation.

branchRuleDelete#

히스토리

Input type: BranchRuleDeleteInput

Arguments#

Name Type Description
id ProjectsBranchRuleID! Global ID of the branch rule to destroy.

Fields#

Name Type Description
branchRule BranchRule Branch rule after mutation.
errors [String!]! Errors encountered during the mutation.

branchRuleExternalStatusCheckCreate#

히스토리

Create a new external status check from a branch rule.

Input type: BranchRuleExternalStatusCheckCreateInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule to update.
externalUrl String! URL of external status check resource.
name String! Name of the external status check.
sharedSecret String HMAC shared secret for authenticating external status check requests.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalStatusCheck ExternalStatusCheck New status check after mutation.

branchRuleExternalStatusCheckDestroy#

히스토리

Destroy an external status check from a branch rule.

Input type: BranchRuleExternalStatusCheckDestroyInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.
id MergeRequestsExternalStatusCheckID! Global ID of the external status check to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

branchRuleExternalStatusCheckUpdate#

히스토리

Update an external status check from a branch rule.

Input type: BranchRuleExternalStatusCheckUpdateInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.
externalUrl String! External URL of the external status check.
id MergeRequestsExternalStatusCheckID! Global ID of the external status check to update.
name String! Name of the external status check.
sharedSecret String HMAC shared secret for authenticating external status check requests.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalStatusCheck ExternalStatusCheck Updated external status check after mutation.

branchRuleSquashOptionCreate#

히스토리

Create a squash option for a branch rule.

Input type: BranchRuleSquashOptionCreateInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.
squashOption SquashOptionSetting! Squash option to set for the branch rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
squashOption SquashOption Created squash option after mutation.

branchRuleSquashOptionDelete#

히스토리

Delete a squash option for a branch rule.

Input type: BranchRuleSquashOptionDeleteInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

branchRuleSquashOptionUpdate#

히스토리

Update a squash option for a branch rule.

Input type: BranchRuleSquashOptionUpdateInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.
squashOption SquashOptionSetting! Squash option after mutation.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
squashOption SquashOption Updated squash option after mutation.

branchRuleUpdate#

히스토리

Input type: BranchRuleUpdateInput

Arguments#

Name Type Description
branchProtection BranchProtectionInput Branch protections configured for the branch rule.
id ProjectsBranchRuleID! Global ID of the branch rule to update.
name String! Branch name, with wildcards, for the branch rules.

Fields#

Name Type Description
branchRule BranchRule Branch rule after mutation.
errors [String!]! Errors encountered during the mutation.

bulkDestroyJobArtifacts#

히스토리

Input type: BulkDestroyJobArtifactsInput

Arguments#

Name Type Description
ids [CiJobArtifactID!]! Global IDs of the job artifacts to destroy.
projectId ProjectID! Global Project ID of the job artifacts to destroy. Incompatible with projectPath.

Fields#

Name Type Description
destroyedCount Int Number of job artifacts deleted.
destroyedIds [CiJobArtifactID!] IDs of job artifacts that were deleted.
errors [String!]! Errors encountered during the mutation.

bulkEnableDevopsAdoptionNamespaces#

Status: Beta.

Input type: BulkEnableDevopsAdoptionNamespacesInput

Arguments#

Name Type Description
displayNamespaceId NamespaceID Display namespace ID.
namespaceIds [NamespaceID!]! List of Namespace IDs.

Fields#

Name Type Description
enabledNamespaces [DevopsAdoptionEnabledNamespace!] Enabled namespaces after mutation.
errors [String!]! Errors encountered during the mutation.

bulkRunnerDelete#

히스토리

Input type: BulkRunnerDeleteInput

Arguments#

Name Type Description
ids [CiRunnerID!] IDs of the runners to delete.

Fields#

Name Type Description
deletedCount Int Number of records effectively deleted. Only present if operation was performed synchronously.
deletedIds [CiRunnerID!] IDs of records effectively deleted. Only present if operation was performed synchronously.
errors [String!]! Errors encountered during the mutation.

bulkSetVulnerabilityFindingsDueDates#

Bulk set due dates for vulnerability findings using individual UUID entries. This operation is best-effort: valid updates are applied even if some fail.

Input type: BulkSetVulnerabilityFindingsDueDatesInput

Arguments#

Name Type Description
projectFullPath String! Full path of the project.
updates [FindingDueDatesSetInput!]! List of finding UUIDs with due dates. A maximum of 1000 updates is allowed per request.

Fields#

Name Type Description
assigned Int Number of findings for which a due date was successfully assigned.
errors [FindingDueDatesSetError!]! Errors encountered during the mutation. A maximum of 1000 errors are returned per request.
removed Int Number of findings for which a due date was successfully removed.
skipped Int Number of findings that were skipped due to errors or not found.

bulkUpdateAiToolRules#

히스토리

Bulk updates permission settings for multiple AI tool rules.

Input type: BulkUpdateAiToolRulesInput

Arguments#

Name Type Description
fullPath ID! Full path of the root namespace to update tool rules for.
projectPath ID Full 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). Each entry replaces the whole rule, so a partial entry clears the access types it omits.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
results [BulkToolRuleResult!]! Results for each tool rule update, including any per-item errors.

bulkUpdateSecurityAttributes#

Input type: BulkUpdateSecurityAttributesInput

Arguments#

Name Type Description
attributes [SecurityAttributeID!]! Global IDs of security attributes to apply.
items [ID!]! Global IDs of groups and projects to update.
mode SecurityAttributeBulkUpdateMode! Update mode: add, remove, or replace attributes.

Fields#

Name Type Description
errors [String!]! Errors encountered while initiating the bulk update operation.

cancelVulnerabilityWorkflow#

히스토리

Cancels a vulnerability workflow execution.

Input type: CancelVulnerabilityWorkflowInput

Arguments#

Name Type Description
projectId ProjectID! Global ID of the project.
workflow VulnerabilityDuoWorkflow! Workflow to cancel.

Fields#

Name Type Description
errorReason VulnerabilityWorkflowErrorReason Machine-readable reason for the mutation error.
errors [String!]! Errors encountered during the mutation.
execution VulnerabilityWorkflowExecution Workflow execution.

catalogResourcesCreate#

히스토리

Input type: CatalogResourcesCreateInput

Arguments#

Name Type Description
projectPath ID! Project path belonging to the catalog resource.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

catalogResourcesDestroy#

히스토리

Input type: CatalogResourcesDestroyInput

Arguments#

Name Type Description
projectPath ID! Project path belonging to the catalog resource.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

cdApplicationCreate#

히스토리

Creates a continuous deployment application in an organization.

Input type: CdApplicationCreateInput

Arguments#

Name Type Description
description String Description of the application.
name String! Name of the application.
organizationId OrganizationsOrganizationID! Global ID of the organization to create the application in.
services [CdServiceInput!] Services to create in the application, up to 1000.

Fields#

Name Type Description
application CdApplication Application created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdApplicationFlowDefinitionCreate#

히스토리

Creates a new pipeline version of a continuous deployment application flow definition.

Input type: CdApplicationFlowDefinitionCreateInput

Arguments#

Name Type Description
applicationId CdApplicationID! Global ID of the application to create the flow definition for.
definition String! Body of the flow definition.

Fields#

Name Type Description
applicationFlowDefinition CdApplicationFlowDefinition Application flow definition created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdApplicationLinkCreate#

히스토리

Creates a link on a continuous deployment application.

Input type: CdApplicationLinkCreateInput

Arguments#

Name Type Description
applicationId CdApplicationID! Global ID of the application to create the link in.
linkType CdApplicationLinkType! Type of the link.
name String! Name of the link.
url String! URL of the link.

Fields#

Name Type Description
applicationLink CdApplicationLink Link created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdApplicationLinkDelete#

히스토리

Deletes a link on a continuous deployment application.

Input type: CdApplicationLinkDeleteInput

Arguments#

Name Type Description
id CdApplicationLinkID! Global ID of the link to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

cdApplicationLinkUpdate#

히스토리

Updates a link on a continuous deployment application.

Input type: CdApplicationLinkUpdateInput

Arguments#

Name Type Description
id CdApplicationLinkID! Global ID of the link to update.
linkType CdApplicationLinkType Type of the link.
name String Name of the link.
url String URL of the link.

Fields#

Name Type Description
applicationLink CdApplicationLink Link updated by the mutation.
errors [String!]! Errors encountered during the mutation.

cdApplicationUpdate#

히스토리

Updates a continuous deployment application.

Input type: CdApplicationUpdateInput

Arguments#

Name Type Description
description String Description of the application.
id CdApplicationID! Global ID of the application to update.
name String Name of the application.

Fields#

Name Type Description
application CdApplication Application updated by the mutation.
errors [String!]! Errors encountered during the mutation.

cdArtifactSourceCreate#

히스토리

Creates a continuous deployment artifact source for a service.

Input type: CdArtifactSourceCreateInput

Arguments#

Name Type Description
name String! Name of the artifact source.
serviceId CdServiceID! Global ID of the service to create the artifact source for.
sourceConfig JSON Configuration of the artifact source, defined by the consuming driver.
sourceRef String! Reference of the artifact source.

Fields#

Name Type Description
artifactSource CdArtifactSource Artifact source created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdEnvironmentCreate#

히스토리

Creates a continuous deployment environment in an organization.

Input type: CdEnvironmentCreateInput

Arguments#

Name Type Description
description String Description of the environment.
environmentDriverBinding CdEnvironmentDriverBindingInput! Driver binding to create for the environment.
name String! Name of the environment.
organizationId OrganizationsOrganizationID! Global ID of the organization to create the environment in.
tier CdEnvironmentTier! Tier of the environment.

Fields#

Name Type Description
environment CdEnvironment Environment created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdEnvironmentDriverBindingCreate#

히스토리

Creates a new versioned driver binding for a continuous deployment environment.

Input type: CdEnvironmentDriverBindingCreateInput

Arguments#

Name Type Description
environmentDriverBinding CdEnvironmentDriverBindingInput! Driver binding to create for the environment.
environmentId CdEnvironmentID! Global ID of the environment to bind the driver to.

Fields#

Name Type Description
environmentDriverBinding CdEnvironmentDriverBinding Environment driver binding created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdEnvironmentUpdate#

히스토리

Updates a continuous deployment environment.

Input type: CdEnvironmentUpdateInput

Arguments#

Name Type Description
description String Description of the environment.
id CdEnvironmentID! Global ID of the environment to update.
name String Name of the environment.
tier CdEnvironmentTier Tier of the environment.

Fields#

Name Type Description
environment CdEnvironment Environment updated by the mutation.
errors [String!]! Errors encountered during the mutation.

cdRolloutCreate#

히스토리

Creates a continuous deployment rollout in an organization.

Input type: CdRolloutCreateInput

Arguments#

Name Type Description
organizationId OrganizationsOrganizationID! Global ID of the organization to create the rollout in.
versionSetId CdVersionSetID! Global ID of the version set the rollout deploys.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
rollout CdRollout Rollout created by the mutation.

cdRolloutGateResolve#

히스토리

Resolves an open approval gate on a continuous deployment rollout by recording the decision in the rollout transition journal.

Input type: CdRolloutGateResolveInput

Arguments#

Name Type Description
id CdRolloutID! Global ID of the rollout whose approval gate is being resolved.
resolutionReason String Reason for the decision.
status CdRolloutGateStatus! Decision to record for the approval gate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
rolloutTransition CdRolloutTransition Rollout transition journal entry created by the mutation.

cdServiceCreate#

히스토리

Creates a continuous deployment service in an application.

Input type: CdServiceCreateInput

Arguments#

Name Type Description
applicationId CdApplicationID! Global ID of the application to create the service in.
description String Description of the service.
name String! Name of the service.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
service CdService Service created by the mutation.

cdServiceUpdate#

히스토리

Updates a continuous deployment service.

Input type: CdServiceUpdateInput

Arguments#

Name Type Description
description String Description of the service.
id CdServiceID! Global ID of the service to update.
name String Name of the service.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
service CdService Service updated by the mutation.

cdVersionCreate#

히스토리

Creates a continuous deployment version from a free-text name, for artifacts GitLab did not observe being pushed.

Input type: CdVersionCreateInput

Arguments#

Name Type Description
artifactSourceId CdArtifactSourceID! Global ID of the artifact source to create the version for.
name String! Name of the version.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
version CdVersion Version created by the mutation.

cdVersionSetCreate#

히스토리

Creates a continuous deployment version set in an application.

Input type: CdVersionSetCreateInput

Arguments#

Name Type Description
applicationId CdApplicationID! Global ID of the application to create the version set in.
description String Description of the version set.
name String! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
versionSet CdVersionSet Version set created by the mutation.

ciJobTokenScopeAddGroupOrProject#

Input type: CiJobTokenScopeAddGroupOrProjectInput

Arguments#

Name Type Description Default
defaultPermissions Boolean Introduced as an experiment in GitLab 17.8.

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

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

Fields#

Name Type Description
ciJobTokenScope CiJobTokenScopeType CI job token's access scope.
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciJobTokenScopeAddProject#

Input type: CiJobTokenScopeAddProjectInput

Arguments#

Name Type Description
direction CiJobTokenScopeDirection Deprecated in GitLab 16.0. Outbound job token scope is being removed. This field can now only be set to INBOUND.
projectPath ID! Project that the CI job token scope belongs to.
targetProjectPath ID! Project to be added to the CI job token scope.

Fields#

Name Type Description
ciJobTokenScope CiJobTokenScopeType CI job token's access scope.
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciJobTokenScopeRemoveGroup#

Input type: CiJobTokenScopeRemoveGroupInput

Arguments#

Name Type Description
projectPath ID! Project that the CI job token scope belongs to.
targetGroupPath ID! Group to be removed from the CI job token scope.

Fields#

Name Type Description
ciJobTokenScope CiJobTokenScopeType CI job token's access scope.
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciJobTokenScopeRemoveProject#

Input type: CiJobTokenScopeRemoveProjectInput

Arguments#

Name Type Description
direction CiJobTokenScopeDirection Deprecated in GitLab 16.9. Outbound job token scope is being removed. This field can now only be set to INBOUND.
projectPath ID! Project that the CI job token scope belongs to.
targetProjectPath ID! Project to be removed from the CI job token scope.

Fields#

Name Type Description
ciJobTokenScope CiJobTokenScopeType CI job token's access scope.
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciJobTokenScopeUpdatePolicies#

히스토리

Input type: CiJobTokenScopeUpdatePoliciesInput

Arguments#

Name Type Description
defaultPermissions Boolean! 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.
projectPath ID! Project that the CI job token scope belongs to.
targetPath ID! Group or project that the CI job token targets.

Fields#

Name Type Description
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciLint#

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

Input type: CiLintInput

Arguments#

Name Type Description
content String! Contents of .gitlab-ci.yml.
dryRun Boolean Run pipeline creation simulation, or only do static check.
projectPath ID! Project of the CI config.
ref String Ref to use when linting. Default is the project default branch.

Fields#

Name Type Description
config CiConfigV2 Linted CI config and metadata.
errors [String!]! Errors encountered during the mutation.

clusterAgentDelete#

Input type: ClusterAgentDeleteInput

Arguments#

Name Type Description
id ClustersAgentID! Global ID of the cluster agent that will be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

clusterAgentTokenCreate#

Input type: ClusterAgentTokenCreateInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! Global ID of the cluster agent that will be associated with the new token.
description String Description of the token.
name String! Name of the token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
secret String Token secret value. Make sure you save it - you won't be able to access it again.
token ClusterAgentToken Token created after mutation.

clusterAgentTokenRevoke#

Input type: ClusterAgentTokenRevokeInput

Arguments#

Name Type Description
id ClustersAgentTokenID! Global ID of the agent token that will be revoked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

clusterAgentUrlConfigurationCreate#

Input type: ClusterAgentUrlConfigurationCreateInput

Arguments#

Name Type Description
caCert String Base64-encoded CA certificate in PEM format to verify the agent endpoint.
clientCert String Base64-encoded client certificate in PEM format if mTLS authentication should be used. Must be provided with client_key.
clientKey String Base64-encoded client key in PEM format if mTLS authentication should be used. Must be provided with client_cert.
clusterAgentId ClustersAgentID! Global ID of the cluster agent that will be associated with the new URL configuration.
tlsHost String TLS host name to verify the server name in agent endpoint certificate.
url String! URL for the new URL configuration.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
urlConfiguration ClusterAgentUrlConfiguration URL configuration created after mutation.

clusterAgentUrlConfigurationDelete#

Input type: ClusterAgentUrlConfigurationDeleteInput

Arguments#

Name Type Description
id ClustersAgentsUrlConfigurationID! Global ID of the agent URL configuration that will be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

commitCreate#

Input type: CommitCreateInput

Arguments#

Name Type Description Default
actions [CommitAction!] Array of action hashes to commit as a batch. []
allowEmpty Boolean Indicates whether an empty commit can be created. Defaults to false. false
branch String! Name of the branch to commit into, it can be a new branch.
message String! Raw commit message.
projectPath ID! Project full path the branch is associated with.
startBranch String If on a new branch, name of the original branch.
startProjectPath ID Full path of the project to start the commit from. Must be the project itself or a project it was forked from.
startSha String SHA of the commit to start the new branch from. Mutually exclusive with startBranch.

Fields#

Name Type Description
commit Commit Commit after mutation.
commitPipelinePath String ETag path for the commit's pipeline.
content [String!] Contents of the commit.
errors [String!]! Errors encountered during the mutation.

configureContainerScanning#

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

Input type: ConfigureContainerScanningInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

configureDependencyScanning#

Enable dependency scanning .gitlab-ci.yml file in a new branch. The new branch and a URL to create a merge request are a part of the response.

Input type: ConfigureDependencyScanningInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

configureSast#

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

Input type: ConfigureSastInput

Arguments#

Name Type Description
configuration SastCiConfigurationInput! SAST CI configuration for the project.
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

configureSastIac#

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

Input type: ConfigureSastIacInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

configureSecretDetection#

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

Input type: ConfigureSecretDetectionInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

containerCacheEntryDelete#

히스토리

Input type: ContainerCacheEntryDeleteInput

Arguments#

Name Type Description
id String! ID of the cache entry.

Fields#

Name Type Description
cacheEntry ContainerUpstreamCacheEntry Deleted container cache entry.
errors [String!]! Errors encountered during the mutation.

containerUpstreamCacheDelete#

히스토리

Input type: ContainerUpstreamCacheDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesContainerUpstreamID! ID of the container virtual registry upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream ContainerUpstream Container virtual registry upstream.

containerUpstreamCreate#

히스토리

Input type: ContainerUpstreamCreateInput

Arguments#

Name Type Description Default
cacheValidityHours Int Cache validity period. Defaults to 24 hours. 24
description String Description of the upstream registry.
id VirtualRegistriesContainerRegistryID! ID of the upstream registry.
name String! Name of upstream registry.
password String Password of the upstream registry.
url String! URL of the upstream registry.
username String Username of the upstream registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream ContainerUpstreamDetails Container upstream after the mutation.

containerUpstreamDelete#

히스토리

Input type: ContainerUpstreamDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesContainerUpstreamID! ID of the upstream to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream ContainerUpstreamDetails Destroyed upstream.

containerUpstreamTest#

히스토리

Input type: ContainerUpstreamTestInput

Arguments#

Name Type Description
groupPath ID Full path of the group to test the upstream registry against. Required when id is not provided.
id VirtualRegistriesContainerUpstreamID ID of the upstream registry to test. When provided, groupPath, url, username, and password are ignored.
password String Password for authenticating with the upstream registry. Used when id is not provided.
url String URL of the upstream registry to test. Required when GraphqlExplorerControllerid is not provided.
username String Username for authenticating with the upstream registry. Used when id is not provided.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Whether the upstream connectivity test was successful.

containerUpstreamUpdate#

히스토리

Input type: ContainerUpstreamUpdateInput

Arguments#

Name Type Description
cacheValidityHours Int Cache validity period.
description String Description of the upstream registry.
id VirtualRegistriesContainerUpstreamID! ID of the container virtual registry upstream.
name String Name of upstream registry.
password String Password of the upstream registry.
url String URL of the upstream registry.
username String Username of the upstream registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream ContainerUpstreamDetails Container upstream after the mutation.

containerVirtualRegistryCacheDelete#

히스토리

Input type: ContainerVirtualRegistryCacheDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesContainerRegistryID! ID of the container virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ContainerRegistry Container virtual registry.

containerVirtualRegistryCreate#

히스토리

Input type: ContainerVirtualRegistryCreateInput

Arguments#

Name Type Description
description String Description of the virtual registry.
groupPath ID Full path of the group with which the resource is associated.
name String! Name of virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ContainerRegistry Container virtual registry after the mutation.

containerVirtualRegistryDelete#

히스토리

Input type: ContainerVirtualRegistryDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesContainerRegistryID! ID of the container virtual registry to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ContainerRegistry Deleted container virtual registry.

containerVirtualRegistryUpdate#

히스토리

Input type: ContainerVirtualRegistryUpdateInput

Arguments#

Name Type Description
description String Description of the virtual registry.
id VirtualRegistriesContainerRegistryID! ID of the container virtual registry to be updated.
name String Name of virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ContainerRegistry Container virtual registry after the mutation.

containerVirtualRegistryUpstreamCreate#

히스토리

Input type: ContainerVirtualRegistryUpstreamCreateInput

Arguments#

Name Type Description
registryId VirtualRegistriesContainerRegistryID! ID of the container virtual registry.
upstreamId VirtualRegistriesContainerUpstreamID! ID of the upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream ContainerRegistryUpstreamWithRegistry Container registry upstream after association.

containerVirtualRegistryUpstreamDelete#

히스토리

Input type: ContainerVirtualRegistryUpstreamDeleteInput

Arguments#

Name Type Description
upstreamId VirtualRegistriesContainerRegistryUpstreamID! ID of the container virtual registry upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream ContainerRegistryUpstreamWithRegistry Deleted container registry upstream.

containerVirtualRegistryUpstreamUpdate#

히스토리

Input type: ContainerVirtualRegistryUpstreamUpdateInput

Arguments#

Name Type Description
id VirtualRegistriesContainerRegistryUpstreamID! ID of the container virtual registry upstream.
position Int! Priority order of an upstream within a virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream ContainerRegistryUpstreamWithRegistry Container registry upstream after update.

corpusCreate#

Input type: CorpusCreateInput

Arguments#

Name Type Description
fullPath ID! Project the corpus belongs to.
packageId PackagesPackageID! ID of the corpus package.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

createAlertIssue#

Input type: CreateAlertIssueInput

Arguments#

Name Type Description
iid String! IID of the alert to mutate.
projectPath ID! Project the alert to mutate is in.

Fields#

Name Type Description
alert AlertManagementAlert Alert after mutation.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.
todo Todo To-do item after mutation.

createAnnotation#

Deprecated in GitLab 16.0. Underlying feature was removed in 16.0.

Input type: CreateAnnotationInput

Arguments#

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

Fields#

Name Type Description
annotation MetricsDashboardAnnotation Created annotation.
errors [String!]! Errors encountered during the mutation.

createBoard#

Input type: CreateBoardInput

Arguments#

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

Fields#

Name Type Description
board Board Board after mutation.
errors [String!]! Errors encountered during the mutation.

createBranch#

Input type: CreateBranchInput

Arguments#

Name Type Description
name String! Name of the branch.
projectPath ID! Project full path the branch is associated with.
ref String! Branch name or commit SHA to create branch from.

Fields#

Name Type Description
branch Branch Branch after mutation.
errors [String!]! Errors encountered during the mutation.

createClusterAgent#

Input type: CreateClusterAgentInput

Arguments#

Name Type Description
name String! Name of the cluster agent.
projectPath ID! Full path of the associated project for the cluster agent.

Fields#

Name Type Description
clusterAgent ClusterAgent Cluster agent created after mutation.
errors [String!]! Errors encountered during the mutation.

createComplianceFramework#

Input type: CreateComplianceFrameworkInput

Arguments#

Name Type Description
namespacePath ID! Full path of the namespace to add the compliance framework to.
params ComplianceFrameworkInput! Parameters to update the compliance framework with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
framework ComplianceFramework Created compliance framework.

createComplianceFrameworkFromTemplate#

히스토리

Input type: CreateComplianceFrameworkFromTemplateInput

Arguments#

Name Type Description
color String Override the color of the compliance framework in hex format. e.g. #FCA121.
default Boolean Set the compliance framework as the default framework for the group.
description String Override the description of the compliance framework.
name String Override the name of the compliance framework.
namespacePath ID! Full path of the namespace to add the compliance framework to.
templateId ComplianceManagementFrameworksTemplateRegistryTemplateID! Unique identifier of the template to create the framework from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
framework ComplianceFramework Created compliance framework.

createComplianceRequirement#

히스토리

Input type: CreateComplianceRequirementInput

Arguments#

Name Type Description
complianceFrameworkId ComplianceManagementFrameworkID! Global ID of the compliance framework of the new requirement.
controls [ComplianceRequirementsControlInput!] Controls to add to the compliance requirement.
params ComplianceRequirementInput! Parameters to update the compliance requirement with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirement ComplianceRequirement Created compliance requirement.

createComplianceRequirementsControl#

히스토리

Input type: CreateComplianceRequirementsControlInput

Arguments#

Name Type Description
complianceRequirementId ComplianceManagementComplianceFrameworkComplianceRequirementID! Global ID of the compliance requirement of the new control.
params ComplianceRequirementsControlInput! Parameters to create the compliance requirement control.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirementsControl ComplianceRequirementsControl Created compliance requirements control.

createContainerProtectionRepositoryRule#

Creates a repository protection rule to restrict access to a project's container registry.

Input type: CreateContainerProtectionRepositoryRuleInput

Arguments#

Name Type Description
minimumAccessLevelForDelete ContainerProtectionRepositoryRuleAccessLevel Introduced as an experiment 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.
minimumAccessLevelForPush ContainerProtectionRepositoryRuleAccessLevel Minimum 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.
projectPath ID! Full path of the project where a protection rule is located.
repositoryPathPattern String! 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.

Fields#

Name Type Description
containerProtectionRepositoryRule ContainerProtectionRepositoryRule Container repository protection rule after mutation.
errors [String!]! Errors encountered during the mutation.

createContainerProtectionTagRule#

히스토리

Creates a protection rule to control which user roles can modify container image tags matching a specified pattern.

Input type: createContainerProtectionTagRuleInput

Arguments#

Name Type Description
minimumAccessLevelForDelete ContainerProtectionTagRuleAccessLevel Minimum 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.
minimumAccessLevelForPush ContainerProtectionTagRuleAccessLevel Minimum 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.
projectPath ID! Full path of the project containing the container image tags.
tagNamePattern String! The pattern that matches container image tags to protect. For example, v1.*. Wildcard character * allowed.

Fields#

Name Type Description
containerProtectionTagRule ContainerProtectionTagRule Protection rule for container image tags after creation.
errors [String!]! Errors encountered during the mutation.

createCustomDashboard#

히스토리

Creates a custom dashboard in an organization.

Input type: CreateCustomDashboardInput

Arguments#

Name Type Description
config CustomDashboardConfigInput! Dashboard layout/config.
description String Dashboard description.
name String! Dashboard name.
namespaceId NamespaceID Namespace to scope the dashboard to.
organizationId OrganizationsOrganizationID Organization the dashboard belongs to. Defaults to the current organization if not provided.

Fields#

Name Type Description
dashboard CustomDashboard Newly created dashboard.
errors [String!]! Errors encountered during creation.

createCustomEmoji#

Input type: CreateCustomEmojiInput

Arguments#

Name Type Description
groupPath ID! Namespace full path the emoji is associated with.
name String! Name of the emoji.
url String! Location of the emoji file.

Fields#

Name Type Description
customEmoji CustomEmoji New custom emoji.
errors [String!]! Errors encountered during the mutation.

createDiffNote#

Input type: CreateDiffNoteInput

Arguments#

Name Type Description
body String! Content of the note.
internal Boolean Internal flag for a note. Default is false.
noteableId NoteableID! Global ID of the resource to add a note to.
position DiffPositionInput! Position of the note on a diff.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createDiscussion#

Input type: CreateDiscussionInput

Arguments#

Name Type Description
body String! Content of the note.
internal Boolean Internal flag for a note. Default is false.
noteableId NoteableID! Global ID of the resource to add a note to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createEpic#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: CreateEpicInput

Arguments#

Name Type Description
addLabelIds [ID!] IDs of labels to be added to the epic.
addLabels [String!] Array of labels to be added to the epic.
color Color Color of the epic.
confidential Boolean Indicates if the epic is confidential.
description String Description of the epic.
dueDateFixed String End date of the epic.
dueDateIsFixed Boolean Indicates end date should be sourced from due_date_fixed field not the issue milestones.
groupPath ID! Group the epic to mutate is in.
removeLabelIds [ID!] IDs of labels to be removed from the epic.
startDateFixed String Start date of the epic.
startDateIsFixed Boolean Indicates start date should be sourced from start_date_fixed field not the issue milestones.
title String Title of the epic.

Fields#

Name Type Description
epic Epic Created epic.
errors [String!]! Errors encountered during the mutation.

createFunctionalVerificationWorkflow#

히스토리

Input type: CreateFunctionalVerificationWorkflowInput

Arguments#

Name Type Description
checkType FunctionalVerificationCheckType! Type of functional verification check to run.
fullPath ID! Full path of the namespace to run the verification check against.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workflowId AiDuoWorkflowsWorkflowID Global ID of the workflow created for the run.

createImageDiffNote#

Input type: CreateImageDiffNoteInput

Arguments#

Name Type Description
body String! Content of the note.
internal Boolean Internal flag for a note. Default is false.
noteableId NoteableID! Global ID of the resource to add a note to.
position DiffImagePositionInput! Position of the note on a diff.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createIssue#

Input type: CreateIssueInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

createIteration#

Deprecated in GitLab 14.0. Use iterationCreate.

Input type: CreateIterationInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iteration Iteration Created iteration.

createLatestDiffNote#

히스토리

Creates a diff note on a merge request using minimal parameters. SHAs, file paths, and position type are resolved automatically from the latest merge request diff.

Input type: CreateLatestDiffNoteInput

Arguments#

Name Type Description
body String! Content of the note.
endNewLine Int End 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.
endOldLine Int End 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.
filePath String! Path of the file to comment on. For renamed files, either the old or new path can be used.
headSha String! 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.
internal Boolean Internal flag for a note. Default is false.
newLine Int Line 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.
noteableId MergeRequestID! Global ID of the merge request to add a diff note to.
oldLine Int Line 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createNote#

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

Input type: CreateNoteInput

Arguments#

Name Type Description
body String! Content of the note.
discussionId DiscussionID Global ID of the discussion the note is in reply to.
internal Boolean Internal flag for a note. Default is false.
mergeRequestDiffHeadSha String SHA of the head commit which is used to ensure that the merge request has not been updated since the request was sent.
noteableId NoteableID! Global ID of the resource to add a note to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createPackagesProtectionRule#

Creates a protection rule to restrict access to project packages.

Input type: CreatePackagesProtectionRuleInput

Arguments#

Name Type Description
minimumAccessLevelForDelete PackagesProtectionRuleAccessLevelForDelete Introduced as an experiment 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.
minimumAccessLevelForPush PackagesProtectionRuleAccessLevel Minimum 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.
packageNamePattern String! Package name protected by the protection rule. For example, @my-scope/my-package-*. Wildcard character * allowed.
packageType PackagesProtectionRulePackageType! Package type protected by the protection rule. For example, NPM, PYPI.
projectPath ID! Full path of the project where a protection rule is located.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packageProtectionRule PackagesProtectionRule Packages protection rule after mutation.

createRequirement#

Input type: CreateRequirementInput

Arguments#

Name Type Description
description String Description of the requirement.
projectPath ID! Full project path the requirement is associated with.
title String Title of the requirement.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirement Requirement Requirement after mutation.

createSnippet#

Input type: CreateSnippetInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
snippet Snippet Snippet after mutation.

createTerraformStateProtectionRule#

히스토리

Creates a protection rule for a Terraform state backend.

Input type: CreateTerraformStateProtectionRuleInput

Arguments#

Name Type Description Default
allowedFrom TerraformStateProtectionRuleAllowedFrom Introduced as an experiment 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
minimumAccessLevelForWrite TerraformStateProtectionRuleAccessLevel! Minimum GitLab access level required to perform write operations on the Terraform state. Valid values include DEVELOPER, MAINTAINER, OWNER, or ADMIN.
projectPath ID! Full path of the project where the protection rule is located.
stateName String! Terraform state name protected by the rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
terraformStateProtectionRule TerraformStateProtectionRule Introduced as an experiment in GitLab 19.1.

Terraform state protection rule after mutation.

createTestCase#

Input type: CreateTestCaseInput

Arguments#

Name Type Description
confidential Boolean Sets the test case confidentiality.
description String Test case description.
labelIds [ID!] IDs of labels to be added to the test case.
projectPath ID! Project full path to create the test case in.
title String! Test case title.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
testCase Issue Test case created.

customFieldArchive#

히스토리

Input type: CustomFieldArchiveInput

Arguments#

Name Type Description
id IssuablesCustomFieldID! Global ID of the custom field.

Fields#

Name Type Description
customField CustomField Archived custom field.
errors [String!]! Errors encountered during the mutation.

customFieldCreate#

히스토리

Input type: CustomFieldCreateInput

Arguments#

Name Type Description
fieldType CustomFieldType! Type of custom field.
groupPath ID! Group path where the custom field is created.
name String! 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.

Fields#

Name Type Description
customField CustomField Created custom field.
errors [String!]! Errors encountered during the mutation.

customFieldUnarchive#

히스토리

Input type: CustomFieldUnarchiveInput

Arguments#

Name Type Description
id IssuablesCustomFieldID! Global ID of the custom field.

Fields#

Name Type Description
customField CustomField Unarchived custom field.
errors [String!]! Errors encountered during the mutation.

customFieldUpdate#

히스토리

Input type: CustomFieldUpdateInput

Arguments#

Name Type Description
id IssuablesCustomFieldID! Global ID of the custom field.
name String 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.

Fields#

Name Type Description
customField CustomField Updated custom field.
errors [String!]! Errors encountered during the mutation.

customerRelationsContactCreate#

Input type: CustomerRelationsContactCreateInput

Arguments#

Name Type Description
description String Description of or notes for the contact.
email String Email address of the contact.
firstName String! First name of the contact.
groupId GroupID! Group for the contact.
lastName String! Last name of the contact.
organizationId CustomerRelationsOrganizationID Organization for the contact.
phone String Phone number of the contact.

Fields#

Name Type Description
contact CustomerRelationsContact Contact after the mutation.
errors [String!]! Errors encountered during the mutation.

customerRelationsContactUpdate#

Input type: CustomerRelationsContactUpdateInput

Arguments#

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

Fields#

Name Type Description
contact CustomerRelationsContact Contact after the mutation.
errors [String!]! Errors encountered during the mutation.

customerRelationsOrganizationCreate#

Input type: CustomerRelationsOrganizationCreateInput

Arguments#

Name Type Description
defaultRate Float Standard billing rate for the organization.
description String Description of or notes for the organization.
groupId GroupID! Group for the organization.
name String! Name of the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization CustomerRelationsOrganization Organization after the mutation.

customerRelationsOrganizationUpdate#

Input type: CustomerRelationsOrganizationUpdateInput

Arguments#

Name Type Description
active Boolean State of the organization.
defaultRate Float Standard billing rate for the organization.
description String Description of or notes for the organization.
id CustomerRelationsOrganizationID! Global ID of the organization.
name String Name of the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization CustomerRelationsOrganization! Organization after the mutation.

dastOnDemandScanCreate#

Input type: DastOnDemandScanCreateInput

Arguments#

Name Type Description
dastScannerProfileId DastScannerProfileID ID of the scanner profile to be used for the scan.
dastSiteProfileId DastSiteProfileID! ID of the site profile to be used for the scan.
fullPath ID! Project the site profile belongs to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineUrl String URL of the pipeline that was created.

dastProfileCreate#

Input type: DastProfileCreateInput

Arguments#

Name Type Description Default
branchName String Associated branch.
dastProfileSchedule DastProfileScheduleInput Represents a DAST Profile Schedule.
dastScannerProfileId DastScannerProfileID! ID of the scanner profile to be associated.
dastSiteProfileId DastSiteProfileID! ID of the site profile to be associated.
description String Description of the profile. Defaults to an empty string. ""
fullPath ID! Project the profile belongs to.
name String! Name of the profile.
runAfterCreate Boolean Run scan using profile after creation. Defaults to false. false
tagList [String!] Indicates the runner tags associated with the profile.

Fields#

Name Type Description
dastProfile DastProfile Created profile.
errors [String!]! Errors encountered during the mutation.
pipelineUrl String URL of the pipeline that was created. Requires runAfterCreate to be set to true.

dastProfileDelete#

Input type: DastProfileDeleteInput

Arguments#

Name Type Description
id DastProfileID! ID of the profile to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

dastProfileRun#

Input type: DastProfileRunInput

Arguments#

Name Type Description
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastProfileID! ID of the profile to be used for the scan.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineUrl String URL of the pipeline that was created.

dastProfileUpdate#

Input type: DastProfileUpdateInput

Arguments#

Name Type Description Default
branchName String Associated branch.
dastProfileSchedule DastProfileScheduleInput Represents a DAST profile schedule.
dastScannerProfileId DastScannerProfileID ID of the scanner profile to be associated.
dastSiteProfileId DastSiteProfileID ID of the site profile to be associated.
description String Description of the profile. Defaults to an empty string. ""
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastProfileID! ID of the profile to be deleted.
name String Name of the profile.
runAfterUpdate Boolean Run scan using profile after update. Defaults to false. false
tagList [String!] Indicates the runner tags associated with the profile.

Fields#

Name Type Description
dastProfile DastProfile Updated profile.
errors [String!]! Errors encountered during the mutation.
pipelineUrl String The URL of the pipeline that was created. Requires the input argument runAfterUpdate to be set to true when calling the mutation, otherwise no pipeline will be created.

dastScannerProfileCreate#

Input type: DastScannerProfileCreateInput

Arguments#

Name Type Description Default
fullPath ID! Project the scanner profile belongs to.
profileName String! Name of the scanner profile.
scanType DastScanTypeEnum Indicates the type of DAST scan that will run. Either a Passive Scan or an Active Scan. PASSIVE
showDebugMessages Boolean Indicates if debug messages should be included in DAST console output. True to include the debug messages. false
spiderTimeout Int Maximum number of minutes allowed for the spider to traverse the site.
tagList [String!] Deprecated in GitLab 15.8. Moved to DastProfile.
targetTimeout Int Maximum number of seconds allowed for the site under test to respond to a request.
useAjaxSpider Boolean Indicates 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

Fields#

Name Type Description
dastScannerProfile DastScannerProfile Created scanner profile.
errors [String!]! Errors encountered during the mutation.
id DastScannerProfileID Deprecated in GitLab 14.10. use dastScannerProfile field.

dastScannerProfileDelete#

Input type: DastScannerProfileDeleteInput

Arguments#

Name Type Description
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastScannerProfileID! ID of the scanner profile to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

dastScannerProfileUpdate#

Input type: DastScannerProfileUpdateInput

Arguments#

Name Type Description
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastScannerProfileID! ID of the scanner profile to be updated.
profileName String! Name of the scanner profile.
scanType DastScanTypeEnum Indicates the type of DAST scan that will run. Either a Passive Scan or an Active Scan.
showDebugMessages Boolean Indicates if debug messages should be included in DAST console output. True to include the debug messages.
spiderTimeout Int! Maximum number of minutes allowed for the spider to traverse the site.
tagList [String!] Deprecated in GitLab 15.8. Moved to DastProfile.
targetTimeout Int! Maximum number of seconds allowed for the site under test to respond to a request.
useAjaxSpider Boolean Indicates 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.

Fields#

Name Type Description
dastScannerProfile DastScannerProfile Updated scanner profile.
errors [String!]! Errors encountered during the mutation.
id DastScannerProfileID Deprecated in GitLab 14.10. use dastScannerProfile field.

dastSiteProfileCreate#

Input type: DastSiteProfileCreateInput

Arguments#

Name Type Description Default
auth DastSiteProfileAuthInput Parameters for authentication.
excludedUrls [String!] URLs to skip during an authenticated scan. Defaults to []. []
fullPath ID! Project the site profile belongs to.
optionalVariables [JSON!] Optional variables that can be configured for DAST scans. []
profileName String! Name of the site profile.
requestHeaders String Comma-separated list of request header names and values to be added to every request made by DAST.
scanFilePath String File Path or URL used as input for the scan method.
scanMethod DastScanMethodType Scan method by the scanner.
targetType DastTargetTypeEnum Type of target to be scanned.
targetUrl String URL of the target to be scanned.

Fields#

Name Type Description
dastSiteProfile DastSiteProfile Site Profile object.
errors [String!]! Errors encountered during the mutation.
id DastSiteProfileID Deprecated in GitLab 14.10. use dastSiteProfile.id field.

dastSiteProfileDelete#

Input type: DastSiteProfileDeleteInput

Arguments#

Name Type Description
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastSiteProfileID! ID of the site profile to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

dastSiteProfileUpdate#

Input type: DastSiteProfileUpdateInput

Arguments#

Name Type Description
auth DastSiteProfileAuthInput Parameters for authentication.
excludedUrls [String!] URLs to skip during an authenticated scan.
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastSiteProfileID! ID of the site profile to be updated.
optionalVariables [JSON!] Optional variables that can be configured for DAST scans.
profileName String! Name of the site profile.
requestHeaders String Comma-separated list of request header names and values to be added to every request made by DAST.
scanFilePath String File Path or URL used as input for the scan method.
scanMethod DastScanMethodType Scan method by the scanner.
targetType DastTargetTypeEnum Type of target to be scanned.
targetUrl String URL of the target to be scanned.

Fields#

Name Type Description
dastSiteProfile DastSiteProfile Site profile object.
errors [String!]! Errors encountered during the mutation.
id DastSiteProfileID Deprecated in GitLab 14.10. use dastSiteProfile.id field.

dastSiteTokenCreate#

Input type: DastSiteTokenCreateInput

Arguments#

Name Type Description
fullPath ID! Project the site token belongs to.
targetUrl String URL of the target to be validated.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
id DastSiteTokenID ID of the site token.
status DastSiteProfileValidationStatusEnum Current validation status of the target.
token String Token string.

dastSiteValidationCreate#

Input type: DastSiteValidationCreateInput

Arguments#

Name Type Description
dastSiteTokenId DastSiteTokenID! ID of the site token.
fullPath ID! Project the site profile belongs to.
strategy DastSiteValidationStrategyEnum Validation strategy to be used.
validationPath String! Path to be requested during validation.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
id DastSiteValidationID ID of the site validation.
status DastSiteProfileValidationStatusEnum Current validation status.

dastSiteValidationRevoke#

Input type: DastSiteValidationRevokeInput

Arguments#

Name Type Description
fullPath ID! Project the site validation belongs to.
normalizedTargetUrl String! Normalized URL of the target to be revoked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

deleteAnnotation#

Deprecated in GitLab 16.0. Underlying feature was removed in 16.0.

Input type: DeleteAnnotationInput

Arguments#

Name Type Description
id String! Global ID of the annotation to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

deleteContainerProtectionRepositoryRule#

Deletes a container repository protection rule.

Input type: DeleteContainerProtectionRepositoryRuleInput

Arguments#

Name Type Description
id ContainerRegistryProtectionRuleID! Global ID of the container repository protection rule to delete.

Fields#

Name Type Description
containerProtectionRepositoryRule ContainerProtectionRepositoryRule Container repository protection rule that was deleted successfully.
errors [String!]! Errors encountered during the mutation.

deleteContainerProtectionTagRule#

히스토리

Deletes a protection rule that controls which user roles can modify container image tags matching a specified pattern.

Input type: DeleteContainerProtectionTagRuleInput

Arguments#

Name Type Description
id ContainerRegistryProtectionTagRuleID! Global ID of the tag protection rule to delete.

Fields#

Name Type Description
containerProtectionTagRule ContainerProtectionTagRule Deleted protection rule for container image tags.
errors [String!]! Errors encountered during the mutation.

deleteConversationThread#

히스토리

Input type: DeleteConversationThreadInput

Arguments#

Name Type Description
threadId AiConversationThreadID! Global ID of the thread to delete.

Fields#

Name Type Description
errors [String!]! List of errors that occurred whilst trying to delete the thread.
success Boolean! Returns true if thread was successfully deleted.

deleteCustomDashboard#

히스토리

Deletes a custom dashboard.

Input type: DeleteCustomDashboardInput

Arguments#

Name Type Description
id AnalyticsCustomDashboardsDashboardID! Global ID of the dashboard to delete.

Fields#

Name Type Description
dashboard CustomDashboard Deleted dashboard.
errors [String!]! Errors encountered during deletion.

deleteDuoWorkflowsWorkflow#

히스토리

Input type: DeleteDuoWorkflowsWorkflowInput

Arguments#

Name Type Description
workflowId AiDuoWorkflowsWorkflowID! Global ID of the workflow to delete.

Fields#

Name Type Description
errors [String!]! List of errors that occurred whilst trying to delete the workflow.
success Boolean! Returns true if workflow was successfully deleted.

deleteGroupCustomAttribute#

히스토리

Deletes a custom attribute from a group. Only available to admins.

Input type: DeleteGroupCustomAttributeInput

Arguments#

Name Type Description
groupPath ID! Full path of the group.
key String! Key of the custom attribute to delete.

Fields#

Name Type Description
customAttribute CustomAttribute Deleted custom attribute.
errors [String!]! Errors encountered during the mutation.

deletePackagesProtectionRule#

Deletes a protection rule for packages.

Input type: DeletePackagesProtectionRuleInput

Arguments#

Name Type Description
id PackagesProtectionRuleID! Global ID of the package protection rule to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packageProtectionRule PackagesProtectionRule Packages protection rule that was deleted successfully.

deletePagesDeployment#

히스토리

Deletes a Pages deployment.

Input type: DeletePagesDeploymentInput

Arguments#

Name Type Description
id PagesDeploymentID! ID of the Pages Deployment.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pagesDeployment PagesDeployment! Deleted Pages Deployment.

deleteProjectCustomAttribute#

히스토리

Deletes a custom attribute from a project. Only available to admins.

Input type: DeleteProjectCustomAttributeInput

Arguments#

Name Type Description
key String! Key of the custom attribute to delete.
projectPath ID! Full path of the project.

Fields#

Name Type Description
customAttribute CustomAttribute Deleted custom attribute.
errors [String!]! Errors encountered during the mutation.

deleteTerraformStateProtectionRule#

히스토리

Deletes a protection rule for a Terraform state backend.

Input type: DeleteTerraformStateProtectionRuleInput

Arguments#

Name Type Description
id TerraformStateProtectionRuleID! Global ID of the Terraform state protection rule to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
terraformStateProtectionRule TerraformStateProtectionRule Introduced as an experiment in GitLab 19.1.

Terraform state protection rule that was deleted.

deleteUserCustomAttribute#

히스토리

Deletes a custom attribute from a user. Only available to admins.

Input type: DeleteUserCustomAttributeInput

Arguments#

Name Type Description
key String! Key of the custom attribute to delete.
userId UserID! Global ID of the user.

Fields#

Name Type Description
customAttribute CustomAttribute Deleted custom attribute.
errors [String!]! Errors encountered during the mutation.

designManagementDelete#

Input type: DesignManagementDeleteInput

Arguments#

Name Type Description
filenames [String!]! Filenames of the designs to delete.
iid ID! IID of the issue to modify designs for.
projectPath ID! Project where the issue is to upload designs for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
version DesignVersion New version in which the designs are deleted.

designManagementMove#

Input type: DesignManagementMoveInput

Arguments#

Name Type Description
id DesignManagementDesignID! ID of the design to move.
next DesignManagementDesignID ID of the immediately following design.
previous DesignManagementDesignID ID of the immediately preceding design.

Fields#

Name Type Description
designCollection DesignCollection Current state of the collection.
errors [String!]! Errors encountered during the mutation.

designManagementUpdate#

Input type: DesignManagementUpdateInput

Arguments#

Name Type Description
description String Description of the design.
id DesignManagementDesignID! ID of the design to update.

Fields#

Name Type Description
design Design! Updated design.
errors [String!]! Errors encountered during the mutation.

designManagementUpload#

Input type: DesignManagementUploadInput

Arguments#

Name Type Description
files [Upload!]! Files to upload.
iid ID! IID of the issue to modify designs for.
projectPath ID! Project where the issue is to upload designs for.

Fields#

Name Type Description
designs [Design!]! Designs that were uploaded by the mutation.
errors [String!]! Errors encountered during the mutation.
skippedDesigns [Design!]! Any designs that were skipped from the upload due to there being no change to their content since their last version.

destroyBoard#

Input type: DestroyBoardInput

Arguments#

Name Type Description
id BoardID! Global ID of the board to destroy.

Fields#

Name Type Description
board Board Board after mutation.
errors [String!]! Errors encountered during the mutation.

destroyBoardList#

Input type: DestroyBoardListInput

Arguments#

Name Type Description
listId ListID! Global ID of the list to destroy. Only label lists are accepted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list BoardList List after mutation.

destroyComplianceFramework#

Input type: DestroyComplianceFrameworkInput

Arguments#

Name Type Description
id ComplianceManagementFrameworkID! Global ID of the compliance framework to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyComplianceRequirement#

히스토리

Input type: DestroyComplianceRequirementInput

Arguments#

Name Type Description
id ComplianceManagementComplianceFrameworkComplianceRequirementID! Global ID of the compliance requirement to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyComplianceRequirementsControl#

히스토리

Input type: DestroyComplianceRequirementsControlInput

Arguments#

Name Type Description
id ComplianceManagementComplianceFrameworkComplianceRequirementsControlID! Global ID of the compliance requirement control to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyContainerRepository#

Input type: DestroyContainerRepositoryInput

Arguments#

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

Fields#

Name Type Description
containerRepository ContainerRepository! Container repository policy after scheduling the deletion.
errors [String!]! Errors encountered during the mutation.

destroyContainerRepositoryTags#

Input type: DestroyContainerRepositoryTagsInput

Arguments#

Name Type Description
id ContainerRepositoryID! ID of the container repository.
tagNames [String!]! Container repository tag(s) to delete. Total number can't be greater than 20.

Fields#

Name Type Description
deletedTagNames [String!]! Deleted container repository tags.
errors [String!]! Errors encountered during the mutation.

destroyCustomEmoji#

Input type: DestroyCustomEmojiInput

Arguments#

Name Type Description
id CustomEmojiID! Global ID of the custom emoji to destroy.

Fields#

Name Type Description
customEmoji CustomEmoji Deleted custom emoji.
errors [String!]! Errors encountered during the mutation.

destroyEpicBoard#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: DestroyEpicBoardInput

Arguments#

Name Type Description
id BoardsEpicBoardID! Global ID of the board to destroy.

Fields#

Name Type Description
epicBoard EpicBoard Epic board after mutation.
errors [String!]! Errors encountered during the mutation.

destroyNote#

Input type: DestroyNoteInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

destroyPackage#

Input type: DestroyPackageInput

Arguments#

Name Type Description
id PackagesPackageID! ID of the Package.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyPackageFile#

Input type: DestroyPackageFileInput

Arguments#

Name Type Description
id PackagesPackageFileID! ID of the Package file.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyPackageFiles#

Input type: DestroyPackageFilesInput

Arguments#

Name Type Description
ids [PackagesPackageFileID!]! IDs of the Package file.
projectPath ID! Project path where the packages cleanup policy is located.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyPackages#

Input type: DestroyPackagesInput

Arguments#

Name Type Description
ids [PackagesPackageID!]! Global IDs of the Packages. Max 100.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroySnippet#

Input type: DestroySnippetInput

Arguments#

Name Type Description
id SnippetID! Global ID of the snippet to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
snippet Snippet Snippet after mutation.

devfileValidate#

히스토리

Input type: DevfileValidateInput

Arguments#

Name Type Description
devfileYaml String! Input devfile.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
valid Boolean Status whether devfile is valid or not.

disableDevopsAdoptionNamespace#

Status: Beta.

Input type: DisableDevopsAdoptionNamespaceInput

Arguments#

Name Type Description
id [AnalyticsDevopsAdoptionEnabledNamespaceID!]! One or many IDs of the enabled namespaces to disable.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

discussionToggleResolve#

Toggles the resolved state of a discussion.

Input type: DiscussionToggleResolveInput

Arguments#

Name Type Description
id DiscussionID! Global ID of the discussion.
resolve Boolean! Will resolve the discussion when true, and unresolve the discussion when false.

Fields#

Name Type Description
discussion Discussion Discussion after mutation.
errors [String!]! Errors encountered during the mutation.

dismissPolicyViolations#

히스토리

Dismisses policy violations linked to a merge request.

Input type: DismissPolicyViolationsInput

Arguments#

Name Type Description
comment String! Comment explaining the dismissal of the policy violations.
dismissalTypes [DismissalType!]! Type of dismissal for the policy violations.
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
securityPolicyIds [ID!]! IDs of warn mode policies with violations to dismiss.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

duoSettingsUpdate#

히스토리

Updates GitLab Duo settings.

Input type: DuoSettingsUpdateInput

Arguments#

Name Type Description
aiGatewayTimeoutSeconds Int Timeout for the AI Gateway request.
aiGatewayUrl String URL for the local AI Gateway server.
allowAllUnixSockets Boolean Introduced as an experiment in GitLab 19.0.

Whether to allow all Unix sockets for network access.
allowProjectExtension Boolean Introduced as an experiment in GitLab 19.0.

Whether to allow projects to extend the network access domain allowlist.
duoAgentPlatformServiceUrl String URL for the local Duo Agent Platform service.
duoCliEnabled Boolean Introduced as an experiment in GitLab 19.0.

Indicates whether GitLab Duo CLI access is enabled.
duoCoreFeaturesEnabled Boolean Indicates whether GitLab Duo Core features are enabled.
includeRecommendedAllowed Boolean Introduced as an experiment in GitLab 19.0.

Whether to include recommended domains in the network access allowlist.
minimumAccessLevelEnableOnProjects AccessLevelEnum Introduced as an experiment in GitLab 18.7.

Minimum access level for enable on Duo Agent Platform. Ignored if dap_instance_customizable_permissions feature flag is disabled.
minimumAccessLevelExecute AccessLevelEnum Introduced as an experiment in GitLab 18.7.

Minimum access level for execute on Duo Agent Platform. Ignored if dap_instance_customizable_permissions feature flag is disabled.
minimumAccessLevelExecuteAsync AccessLevelEnum Introduced as an experiment 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.
minimumAccessLevelManage AccessLevelEnum Introduced as an experiment in GitLab 18.7.

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

Fields#

Name Type Description
duoSettings DuoSettings! GitLab Duo settings after mutation.
errors [String!]! Errors encountered during the mutation.

duoUserFeedback#

히스토리

Input type: DuoUserFeedbackInput

Arguments#

Name Type Description
aiMessageId String! ID of the AI Message.
trackingEvent TrackingEventInput Tracking event data.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

echoCreate#

A mutation that does not perform any changes.

This is expected to be used for testing of endpoints, to verify that a user has mutation access.

Input type: EchoCreateInput

Arguments#

Name Type Description
errors [String!] Errors to return to the user.
messages [String!] Messages to return to the user.

Fields#

Name Type Description
echoes [String!] Messages returned to the user.
errors [String!]! Errors encountered during the mutation.

enableDevopsAdoptionNamespace#

Status: Beta.

Input type: EnableDevopsAdoptionNamespaceInput

Arguments#

Name Type Description
displayNamespaceId NamespaceID Display namespace ID.
namespaceId NamespaceID! Namespace ID.

Fields#

Name Type Description
enabledNamespace DevopsAdoptionEnabledNamespace Enabled namespace after mutation.
errors [String!]! Errors encountered during the mutation.

environmentCreate#

Create an environment.

Input type: EnvironmentCreateInput

Arguments#

Name Type Description
autoStopSetting AutoStopSetting Auto stop setting of the environment.
clusterAgentId ClustersAgentID Cluster agent of the environment.
description String Description of the environment.
externalUrl String External URL of the environment.
fluxResourcePath String Flux resource path of the environment.
kubernetesNamespace String Kubernetes namespace of the environment.
name String! Name of the environment.
projectPath ID! Full path of the project.
tier DeploymentTier Tier of the environment.

Fields#

Name Type Description
environment Environment Created environment.
errors [String!]! Errors encountered during the mutation.

environmentDelete#

Delete an environment.

Input type: EnvironmentDeleteInput

Arguments#

Name Type Description
id EnvironmentID! Global ID of the environment to Delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

environmentStop#

Stop an environment.

Input type: EnvironmentStopInput

Arguments#

Name Type Description
force Boolean Force environment to stop without executing on_stop actions.
id EnvironmentID! Global ID of the environment to stop.

Fields#

Name Type Description
environment Environment Environment after attempt to stop.
errors [String!]! Errors encountered during the mutation.

environmentUpdate#

Update an environment.

Input type: EnvironmentUpdateInput

Arguments#

Name Type Description
autoStopSetting AutoStopSetting Auto stop setting of the environment.
clusterAgentId ClustersAgentID Cluster agent of the environment.
description String Description of the environment.
externalUrl String External URL of the environment.
fluxResourcePath String Flux resource path of the environment.
id EnvironmentID! Global ID of the environment to update.
kubernetesNamespace String Kubernetes namespace of the environment.
tier DeploymentTier Tier of the environment.

Fields#

Name Type Description
environment Environment Environment after attempt to update.
errors [String!]! Errors encountered during the mutation.

environmentsCanaryIngressUpdate#

Deprecated This endpoint is planned to be removed along with certificate-based clusters. See this epic for more information.

Input type: EnvironmentsCanaryIngressUpdateInput

Arguments#

Name Type Description
id EnvironmentID! Global ID of the environment to update.
weight Int! Weight of the Canary Ingress.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

epicAddIssue#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: EpicAddIssueInput

Arguments#

Name Type Description
groupPath ID! Group the epic to mutate belongs to.
iid ID! IID of the epic to mutate.
issueIid String! IID of the issue to be added.
projectPath ID! Full path of the project the issue belongs to.

Fields#

Name Type Description
epic Epic Epic after mutation.
epicIssue EpicIssue Epic-issue relationship.
errors [String!]! Errors encountered during the mutation.

epicBoardCreate#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicBoardCreateInput

Arguments#

Name Type Description
displayColors Boolean Whether or not display epic colors.
groupPath ID Full path of the group with which the resource is associated.
hideBacklogList Boolean Whether or not backlog list is hidden.
hideClosedList Boolean Whether or not closed list is hidden.
labelIds [LabelID!] IDs of labels to be added to the board.
labels [String!] Labels of the issue.
name String Board name.

Fields#

Name Type Description
epicBoard EpicBoard Created epic board.
errors [String!]! Errors encountered during the mutation.

epicBoardListCreate#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicBoardListCreateInput

Arguments#

Name Type Description
backlog Boolean Create the backlog list.
boardId BoardsEpicBoardID! Global ID of the issue board to mutate.
labelId LabelID Global ID of an existing label.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list EpicList Epic list in the epic board.

epicBoardListDestroy#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicBoardListDestroyInput

Arguments#

Name Type Description
listId BoardsEpicListID! Global ID of the epic board list to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list EpicList Epic board list. null if the board was destroyed successfully.

epicBoardUpdate#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicBoardUpdateInput

Arguments#

Name Type Description
displayColors Boolean Whether or not display epic colors.
hideBacklogList Boolean Whether or not backlog list is hidden.
hideClosedList Boolean Whether or not closed list is hidden.
id BoardsEpicBoardID! Epic board global ID.
labelIds [LabelID!] IDs of labels to be added to the board.
labels [String!] Labels of the issue.
name String Board name.

Fields#

Name Type Description
epicBoard EpicBoard Updated epic board.
errors [String!]! Errors encountered during the mutation.

epicMoveList#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicMoveListInput

Arguments#

Name Type Description
boardId BoardsEpicBoardID! Global ID of the board that the epic is in.
epicId EpicID! ID of the epic to mutate.
fromListId BoardsEpicListID ID of the board list that the epic will be moved from. Required if moving between lists.
moveAfterId EpicID ID of epic that should be placed after the current epic.
moveBeforeId EpicID ID of epic that should be placed before the current epic.
positionInList Int Position of epics within the board list. Positions start at 0. Use -1 to move to the end of the list.
toListId BoardsEpicListID! ID of the list the epic will be in after mutation.

Fields#

Name Type Description
epic Epic Epic after mutation.
errors [String!]! Errors encountered during the mutation.

epicSetSubscription#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: EpicSetSubscriptionInput

Arguments#

Name Type Description
groupPath ID! Group the epic to mutate belongs to.
iid ID! IID of the epic to mutate.
subscribedState Boolean! Desired state of the subscription.

Fields#

Name Type Description
epic Epic Epic after mutation.
errors [String!]! Errors encountered during the mutation.

epicTreeReorder#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicTreeReorderInput

Arguments#

Name Type Description
baseEpicId EpicID! ID of the base epic of the tree.
moved EpicTreeNodeFieldsInputType! Parameters for updating the tree positions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

escalationPolicyCreate#

Input type: EscalationPolicyCreateInput

Arguments#

Name Type Description
description String Description of the escalation policy.
name String! Name of the escalation policy.
projectPath ID! Project to create the escalation policy for.
rules [EscalationRuleInput!]! Steps of the escalation policy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
escalationPolicy EscalationPolicyType Escalation policy.

escalationPolicyDestroy#

Input type: EscalationPolicyDestroyInput

Arguments#

Name Type Description
id IncidentManagementEscalationPolicyID! Escalation policy internal ID to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
escalationPolicy EscalationPolicyType Escalation policy.

escalationPolicyUpdate#

Input type: EscalationPolicyUpdateInput

Arguments#

Name Type Description
description String Description of the escalation policy.
id IncidentManagementEscalationPolicyID! ID of the on-call schedule to create the on-call rotation in.
name String Name of the escalation policy.
rules [EscalationRuleInput!] Steps of the escalation policy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
escalationPolicy EscalationPolicyType Escalation policy.

exportRequirements#

Input type: ExportRequirementsInput

Arguments#

Name Type Description
authorUsername [String!] Filter requirements by author username.
projectPath ID! Full project path the requirements are associated with.
search String Search query for requirement title.
selectedFields [String!] List of selected requirements fields to be exported.
sort Sort List requirements by sort order.
state RequirementState Filter requirements by state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

externalAuditEventDestinationCreate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsCreate instead.

Input type: ExternalAuditEventDestinationCreateInput

Arguments#

Name Type Description
destinationUrl String! Destination URL.
groupPath ID! Group path.
name String Destination name.
verificationToken String Verification token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination ExternalAuditEventDestination Destination created.

externalAuditEventDestinationDestroy#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsDelete instead.

Input type: ExternalAuditEventDestinationDestroyInput

Arguments#

Name Type Description
id AuditEventsExternalAuditEventDestinationID! ID of external audit event destination to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

externalAuditEventDestinationUpdate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsUpdate instead.

Input type: ExternalAuditEventDestinationUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
destinationUrl String Destination URL to change.
id AuditEventsExternalAuditEventDestinationID! ID of external audit event destination to update.
name String Destination name.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination ExternalAuditEventDestination Updated destination.

geoRegistriesBulkUpdate#

히스토리

Mutates multiple Geo registries for a given registry class.

Input type: GeoRegistriesBulkUpdateInput

Arguments#

Name Type Description
action GeoRegistriesBulkAction! Action to be executed on Geo registries.
ids [GeoBaseRegistryID!] Execute the action on registries selected by their ID.
registryClass GeoRegistryClass! Class of the Geo registries to be updated.
replicationState ReplicationStateEnum Execute the action on registries selected by their replication state.
verificationState VerificationStateEnum Execute the action on registries selected by their verification state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryClass GeoRegistryClass Updated Geo registry class.

geoRegistriesUpdate#

히스토리

Mutates a Geo registry.

Input type: GeoRegistriesUpdateInput

Arguments#

Name Type Description
action GeoRegistryAction! Action to be executed on a Geo registry.
registryId GeoBaseRegistryID! ID of the Geo registry entry to be updated.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry Registrable Updated Geo registry entry.

gitlabSubscriptionActivate#

Input type: GitlabSubscriptionActivateInput

Arguments#

Name Type Description
activationCode String! Activation code received after purchasing a GitLab subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
futureSubscriptions [SubscriptionFutureEntry!] Array of future subscriptions.
license CurrentLicense Current license.

googleCloudLoggingConfigurationCreate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsCreate with gcpLogging category instead.

Input type: GoogleCloudLoggingConfigurationCreateInput

Arguments#

Name Type Description Default
clientEmail String! 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.
googleProjectIdName String! Unique identifier of the Google Cloud project to which the logging configuration belongs.
groupPath ID! Group path.
logIdName String Unique identifier used to distinguish and manage different logs within the same Google Cloud project.(defaults to audit_events). "audit_events"
name String Destination name.
privateKey String! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
googleCloudLoggingConfiguration GoogleCloudLoggingConfigurationType configuration created.

googleCloudLoggingConfigurationDestroy#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsDelete instead.

Input type: GoogleCloudLoggingConfigurationDestroyInput

Arguments#

Name Type Description
id AuditEventsGoogleCloudLoggingConfigurationID! ID of the Google Cloud logging configuration to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

googleCloudLoggingConfigurationUpdate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsUpdate instead.

Input type: GoogleCloudLoggingConfigurationUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
clientEmail String 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.
googleProjectIdName String Unique identifier of the Google Cloud project to which the logging configuration belongs.
id AuditEventsGoogleCloudLoggingConfigurationID! ID of the google Cloud configuration to update.
logIdName String Unique identifier used to distinguish and manage different logs within the same Google Cloud project.
name String Destination name.
privateKey String 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
googleCloudLoggingConfiguration GoogleCloudLoggingConfigurationType configuration updated.

governPolicyCreate#

히스토리

Creates a policy in the policy store for an organization or group.

Input type: GovernPolicyCreateInput

Arguments#

Name Type Description
actions [JSON!] Actions the policy takes. No more than 1000 actions.
description String Description of the policy.
groupPath ID Full path of the top-level group whose policy store to use. Exactly one of organizationId or groupPath is required.
lifecycleState String Lifecycle state of the policy.
mode String Enforcement mode of the policy.
name String! Name of the policy.
organizationId OrganizationsOrganizationID Global ID of the organization whose policy store to use. Exactly one of organizationId or groupPath is required.
policyScope JSON Authored scope of the policy. Mutually exclusive with scopeRego.
rules [JSON!]! Rules of the policy, at least one. No more than 1000 rules.
scopeRego String Rego expression scoping the policy. Mutually exclusive with policyScope.
triggerType String! Trigger the policy responds to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
policy GovernPolicy Policy created in the policy store.

governPolicyDelete#

히스토리

Deletes a policy from the policy store for an organization or group.

Input type: GovernPolicyDeleteInput

Arguments#

Name Type Description
groupPath ID Full path of the top-level group whose policy store to use. Exactly one of organizationId or groupPath is required.
id Int! ID of the policy to delete.
organizationId OrganizationsOrganizationID Global ID of the organization whose policy store to use. Exactly one of organizationId or groupPath is required.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

governPolicyUpdate#

히스토리

Updates a policy in the policy store for an organization or group. Only the supplied fields are changed; omitted fields keep their current values, while an explicit null clears a nullable field.

Input type: GovernPolicyUpdateInput

Arguments#

Name Type Description
actions [JSON!] Actions the policy takes. No more than 1000 actions.
description String Description of the policy.
groupPath ID Full path of the top-level group whose policy store to use. Exactly one of organizationId or groupPath is required.
lifecycleState String Lifecycle state of the policy.
mode String Enforcement mode of the policy.
name String Name of the policy.
organizationId OrganizationsOrganizationID Global ID of the organization whose policy store to use. Exactly one of organizationId or groupPath is required.
policyId Int! ID of the policy.
policyScope JSON Authored scope of the policy. Mutually exclusive with scopeRego.
rules [JSON!] Rules of the policy, at least one when supplied. No more than 1000 rules.
scopeRego String Rego expression scoping the policy. Mutually exclusive with policyScope.
triggerType String Trigger the policy responds to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
policy GovernPolicy Policy updated in the policy store.

groupAuditEventStreamingDestinationsCreate#

히스토리

Input type: GroupAuditEventStreamingDestinationsCreateInput

Arguments#

Name Type Description
category String! Destination category.
config JSON! Destination config.
groupPath ID! Group path.
name String Destination name.
secretToken String Secret token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination GroupAuditEventStreamingDestination Destination created.

groupAuditEventStreamingDestinationsDelete#

히스토리

Input type: GroupAuditEventStreamingDestinationsDeleteInput

Arguments#

Name Type Description
id AuditEventsGroupExternalStreamingDestinationID! ID of the audit events external streaming destination to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

groupAuditEventStreamingDestinationsUpdate#

히스토리

Input type: GroupAuditEventStreamingDestinationsUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
category String Destination category.
config JSON Destination config.
id AuditEventsGroupExternalStreamingDestinationID! ID of external audit event destination to update.
name String Destination name.
secretToken String Secret token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination GroupAuditEventStreamingDestination Updated destination.

groupMemberBulkUpdate#

Input type: GroupMemberBulkUpdateInput

Arguments#

Name Type Description
accessLevel MemberAccessLevel! Access level to update the members to.
expiresAt Time Date and time the membership expires.
groupId GroupID! Global ID of the group.
userIds [UserID!]! Global IDs of the members.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupMembers [GroupMember!] Group members after mutation.
queuedMemberApprovals MemberApprovalConnection List of queued pending members approvals. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.

groupMembersExport#

히스토리

Input type: GroupMembersExportInput

Arguments#

Name Type Description
groupId GroupID! Global ID of the group.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Export request result message.

groupSavedReplyCreate#

히스토리

Input type: GroupSavedReplyCreateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
groupId GroupID! Group for the save reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply GroupSavedReply Saved reply after mutation.

groupSavedReplyDestroy#

히스토리

Input type: GroupSavedReplyDestroyInput

Arguments#

Name Type Description
id GroupsSavedReplyID! Global ID of the group-level saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply GroupSavedReply Saved reply after mutation.

groupSavedReplyUpdate#

히스토리

Input type: GroupSavedReplyUpdateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
id GroupsSavedReplyID! Global ID of the group-level saved reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply GroupSavedReply Saved reply after mutation.

groupSecretCreate#

Input type: GroupSecretCreateInput

Arguments#

Name Type Description
description String Description of the group secret.
environment String! Environment that can access the secret.
groupPath ID! Group of the secret.
name String! Name of the group secret.
protected Boolean! Whether the secret is only accessible from protected branches.
rotationIntervalDays Int Number of days between rotation reminders for the secret.
secret String! Value of the group secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecret GroupSecret Group secret.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

groupSecretDelete#

Input type: GroupSecretDeleteInput

Arguments#

Name Type Description
groupPath ID! Group of the secret.
name String! Name of the group secret to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecret GroupSecret Deleted group secret.

groupSecretUpdate#

Input type: GroupSecretUpdateInput

Arguments#

Name Type Description
description String New description of the group secret.
environment String New environment that can access the secret.
groupPath ID! Group of the secret.
metadataCas Int! This should match the current metadata version of the group secret being updated.
name String! Name of the group secret to update.
protected Boolean Whether the secret is only accessible from protected branches.
rotationIntervalDays Int Number of days between rotation reminders for the secret.
secret String New value of the group secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecret GroupSecret Updated group secret.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

groupSecretsManagerDeprovision#

Input type: GroupSecretsManagerDeprovisionInput

Arguments#

Name Type Description
groupPath ID! Group of the secrets manager.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecretsManager GroupSecretsManager Group secrets manager.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

groupSecretsManagerInitialize#

Input type: GroupSecretsManagerInitializeInput

Arguments#

Name Type Description
groupPath ID! Group of the secrets manager.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecretsManager GroupSecretsManager Group secrets manager.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

groupSecretsPermissionDelete#

Input type: GroupSecretsPermissionDeleteInput

Arguments#

Name Type Description
groupPath ID! Group permissions for the secret.
principal PrincipalInput! Whose permission to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.
secretsPermission GroupSecretsPermission Deleted Secrets Permission.

groupSecretsPermissionUpdate#

Input type: GroupSecretsPermissionUpdateInput

Arguments#

Name Type Description
actions [SecretsManagementAction!]! Actions that can be performed on secrets.
expiredAt ISO8601Date Expiration date for Secret Permission (optional).
groupPath ID! Group to which the permissions are added.
principal PrincipalInput! User/MemberRole/Role that is provided access.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.
secretsPermission GroupSecretsPermission Secrets Permission that was created.

groupTransfer#

히스토리

Input type: GroupTransferInput

Arguments#

Name Type Description
id GroupID! Global ID of the group to transfer.
targetId GroupID Global ID of the target parent group. Omit to make group top-level.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group after mutation.

groupUpdate#

Input type: GroupUpdateInput

Arguments#

Name Type Description
aiAuditEventsStorageEnabled Boolean Introduced as an experiment in GitLab 19.2.

Indicates whether AI audit events are stored for the group.
builtInProjectTemplatesEnabled Boolean Introduced as an experiment in GitLab 19.0.

Indicates whether built-in project templates are available for new projects in the group.
duoAutoModeEnabled Boolean Introduced as an experiment in GitLab 19.5.

Indicates whether Duo Agent Platform auto mode is enabled for the group.
duoFeaturesEnabled Boolean Introduced as an experiment in GitLab 16.10.

Indicates whether GitLab Duo features are enabled for the group.
fullPath ID! Full path of the group that will be updated.
lockAiAuditEventsStorageEnabled Boolean Introduced as an experiment in GitLab 19.2.

Indicates whether AI audit events storage is enforced for all subgroups and projects.
lockBuiltInProjectTemplatesEnabled Boolean Introduced as an experiment in GitLab 19.0.

Indicates if the built-in project templates enabled setting is enforced for all subgroups.
lockDuoAutoModeEnabled Boolean Introduced as an experiment in GitLab 19.5.

Indicates if the Duo Agent Platform auto mode setting is enforced for all subgroups.
lockDuoFeaturesEnabled Boolean Introduced as an experiment in GitLab 16.10.

Indicates if the GitLab Duo features enabled setting is enforced for all subgroups.
lockMathRenderingLimitsEnabled Boolean Indicates if math rendering limits are locked for all descendant groups.
lockToolApprovalForSessionEnabled Boolean Introduced as an experiment in GitLab 18.11.

Indicates if the tool approval for session setting is enforced for all subgroups.
mathRenderingLimitsEnabled Boolean Indicates if math rendering limits are used for the group.
name String Name of the group.
path String Path of the namespace.
sharedRunnersSetting SharedRunnersSetting Shared runners availability for the namespace and its descendants.
stepUpAuthRequiredOauthProvider String OAuth provider required for step-up authentication.
toolApprovalForSessionEnabled Boolean Introduced as an experiment in GitLab 18.11.

Indicates whether tool approval for session is enabled for the group.
visibility VisibilityLevelsEnum Visibility of the namespace.
webBasedCommitSigningEnabled Boolean Introduced as an experiment in GitLab 18.2.

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group after update.

httpIntegrationCreate#

Input type: HttpIntegrationCreateInput

Arguments#

Name Type Description Default
active Boolean! Whether the integration is receiving alerts.
name String! Name of the integration.
payloadAttributeMappings [AlertManagementPayloadAlertFieldInput!] Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExample JsonString Example of an alert payload.
projectPath ID! Project to create the integration in.
type AlertManagementIntegrationType Type of integration to create. Cannot be changed after creation. HTTP

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementHttpIntegration Alerting integration.

httpIntegrationDestroy#

Input type: HttpIntegrationDestroyInput

Arguments#

Name Type Description
id AlertManagementHttpIntegrationID! ID of the integration to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementHttpIntegration Alerting integration.

httpIntegrationResetToken#

Input type: HttpIntegrationResetTokenInput

Arguments#

Name Type Description
id AlertManagementHttpIntegrationID! ID of the integration to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementHttpIntegration Alerting integration.

httpIntegrationUpdate#

Input type: HttpIntegrationUpdateInput

Arguments#

Name Type Description
active Boolean Whether the integration is receiving alerts.
id AlertManagementHttpIntegrationID! ID of the integration to mutate.
name String Name of the integration.
payloadAttributeMappings [AlertManagementPayloadAlertFieldInput!] Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExample JsonString Example of an alert payload.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementHttpIntegration Alerting integration.

importSourceUserCancelReassignment#

히스토리

Input type: ImportSourceUserCancelReassignmentInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserKeepAllAsPlaceholder#

히스토리

Input type: ImportSourceUserKeepAllAsPlaceholderInput

Arguments#

Name Type Description
namespaceId NamespaceID! Global ID of the namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
updatedImportSourceUserCount Int Number of successfully updated mappings of users on source instance to their destination users.

importSourceUserKeepAsPlaceholder#

히스토리

Input type: ImportSourceUserKeepAsPlaceholderInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserReassign#

히스토리

Input type: ImportSourceUserReassignInput

Arguments#

Name Type Description
assigneeUserId UserID! Global ID of the assignee user.
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserResendNotification#

히스토리

Input type: ImportSourceUserResendNotificationInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserRetryFailedReassignment#

히스토리

Input type: ImportSourceUserRetryFailedReassignmentInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserRevoke#

히스토리

Input type: ImportSourceUserRevokeInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserUndoKeepAsPlaceholder#

히스토리

Input type: ImportSourceUserUndoKeepAsPlaceholderInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

instanceAuditEventStreamingDestinationsCreate#

히스토리

Input type: InstanceAuditEventStreamingDestinationsCreateInput

Arguments#

Name Type Description
category String! Destination category.
config JSON! Destination config.
name String Destination name.
secretToken String Secret token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination InstanceAuditEventStreamingDestination Destination created.

instanceAuditEventStreamingDestinationsDelete#

히스토리

Input type: InstanceAuditEventStreamingDestinationsDeleteInput

Arguments#

Name Type Description
id AuditEventsInstanceExternalStreamingDestinationID! ID of the audit events external streaming destination to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

instanceAuditEventStreamingDestinationsUpdate#

히스토리

Input type: InstanceAuditEventStreamingDestinationsUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
category String Destination category.
config JSON Destination config.
id AuditEventsInstanceExternalStreamingDestinationID! ID of external audit event destination to update.
name String Destination name.
secretToken String Secret token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination InstanceAuditEventStreamingDestination Updated destination.

instanceExternalAuditEventDestinationCreate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsCreate instead.

Input type: InstanceExternalAuditEventDestinationCreateInput

Arguments#

Name Type Description
destinationUrl String! Destination URL.
name String Destination name.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceExternalAuditEventDestination InstanceExternalAuditEventDestination Destination created.

instanceExternalAuditEventDestinationDestroy#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsDelete instead.

Input type: InstanceExternalAuditEventDestinationDestroyInput

Arguments#

Name Type Description
id AuditEventsInstanceExternalAuditEventDestinationID! ID of the external instance audit event destination to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

instanceExternalAuditEventDestinationUpdate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsUpdate instead.

Input type: InstanceExternalAuditEventDestinationUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
destinationUrl String Destination URL to change.
id AuditEventsInstanceExternalAuditEventDestinationID! ID of the external instance audit event destination to update.
name String Destination name.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceExternalAuditEventDestination InstanceExternalAuditEventDestination Updated destination.

instanceGoogleCloudLoggingConfigurationCreate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsCreate with gcpLogging category instead.

Input type: InstanceGoogleCloudLoggingConfigurationCreateInput

Arguments#

Name Type Description Default
clientEmail String! 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.
googleProjectIdName String! Unique identifier of the Google Cloud project to which the logging configuration belongs.
logIdName String Unique identifier used to distinguish and manage different logs within the same Google Cloud project.(defaults to audit_events). "audit_events"
name String Destination name.
privateKey String! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceGoogleCloudLoggingConfiguration InstanceGoogleCloudLoggingConfigurationType configuration created.

instanceGoogleCloudLoggingConfigurationDestroy#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsDelete instead.

Input type: InstanceGoogleCloudLoggingConfigurationDestroyInput

Arguments#

Name Type Description
id AuditEventsInstanceGoogleCloudLoggingConfigurationID! ID of the Google Cloud logging configuration to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

instanceGoogleCloudLoggingConfigurationUpdate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsUpdate instead.

Input type: InstanceGoogleCloudLoggingConfigurationUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
clientEmail String 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.
googleProjectIdName String Unique identifier of the Google Cloud project to which the logging configuration belongs.
id AuditEventsInstanceGoogleCloudLoggingConfigurationID! ID of the instance google Cloud configuration to update.
logIdName String Unique identifier used to distinguish and manage different logs within the same Google Cloud project.
name String Destination name.
privateKey String 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceGoogleCloudLoggingConfiguration InstanceGoogleCloudLoggingConfigurationType configuration updated.

instanceSecretsManagerEnroll#

Input type: InstanceSecretsManagerEnrollInput

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

instanceSecretsManagerUnenroll#

Input type: InstanceSecretsManagerUnenrollInput

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

integrationExclusionCreate#

히스토리

Input type: IntegrationExclusionCreateInput

Arguments#

Name Type Description
groupIds [GroupID!] IDs of groups to exclude up to a maximum of 100.
integrationName IntegrationType! Type of integration to exclude.
projectIds [ProjectID!] IDs of projects to exclude up to a maximum of 100.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
exclusions [IntegrationExclusion!] Integration exclusions created by the mutation.

integrationExclusionDelete#

히스토리

Input type: IntegrationExclusionDeleteInput

Arguments#

Name Type Description
groupIds [GroupID!] IDs of excluded groups.
integrationName IntegrationType! Type of integration.
projectIds [ProjectID!] IDs of excluded projects.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
exclusions [IntegrationExclusion!] Project no longer excluded due to the mutation.

issuableResourceLinkCreate#

Input type: IssuableResourceLinkCreateInput

Arguments#

Name Type Description
id IssueID! Incident id to associate the resource link with.
link String! Link of the resource.
linkText String Link text of the resource.
linkType IssuableResourceLinkType Link type of the resource.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issuableResourceLink IssuableResourceLink Issuable resource link.

issuableResourceLinkDestroy#

Input type: IssuableResourceLinkDestroyInput

Arguments#

Name Type Description
id IncidentManagementIssuableResourceLinkID! Issuable resource link ID to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issuableResourceLink IssuableResourceLink Issuable resource link.

issueLinkAlerts#

Input type: IssueLinkAlertsInput

Arguments#

Name Type Description
alertReferences [String!]! Alerts references to be linked to the incident.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueMove#

Input type: IssueMoveInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
targetProjectPath ID! Project to move the issue to.
targetWorkItemTypeId WorkItemsTypeID Work item type to use in the target project. When omitted, the source work item type is preserved.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueMoveList#

Input type: IssueMoveListInput

Arguments#

Name Type Description
boardId BoardID! Global ID of the board that the issue is in.
epicId EpicID Deprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
fromListId ID ID of the board list that the issue will be moved from.
iid String! IID of the issue to mutate.
moveAfterId ID ID of issue that should be placed after the current issue.
moveBeforeId ID ID of issue that should be placed before the current issue.
positionInList Int Position of issue within the board list. Positions start at 0. Use -1 to move to the end of the list.
projectPath ID! Project the issue to mutate is in.
toListId ID ID of the board list that the issue will be moved to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetAssignees#

Input type: IssueSetAssigneesInput

Arguments#

Name Type Description Default
assigneeUsernames [String!]! Usernames to assign to the resource. Replaces existing assignees by default.
iid String! IID of the issue to mutate.
operationMode MutationOperationMode Operation to perform. Defaults to REPLACE. REPLACE
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetConfidential#

Input type: IssueSetConfidentialInput

Arguments#

Name Type Description
confidential Boolean! Whether or not to set the issue as a confidential.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetCrmContacts#

Input type: IssueSetCrmContactsInput

Arguments#

Name Type Description
contactIds [CustomerRelationsContactID!]! Customer relations contact IDs to set. Replaces existing contacts by default.
iid String! IID of the issue to mutate.
operationMode MutationOperationMode Changes the operation mode. Defaults to REPLACE.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetDueDate#

Input type: IssueSetDueDateInput

Arguments#

Name Type Description
dueDate Time Desired due date for the issue. Due date is removed if null.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetEpic#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: IssueSetEpicInput

Arguments#

Name Type Description
epicId EpicID Deprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetEscalationPolicy#

Input type: IssueSetEscalationPolicyInput

Arguments#

Name Type Description
escalationPolicyId IncidentManagementEscalationPolicyID Global ID of the escalation policy to assign to the issue. Policy will be removed if absent or set to null.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetEscalationStatus#

Input type: IssueSetEscalationStatusInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
status IssueEscalationStatus! Set the escalation status.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetIteration#

Input type: IssueSetIterationInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
iterationId IterationID Iteration to assign to the issue.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetLocked#

Input type: IssueSetLockedInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
locked Boolean! Whether or not to lock discussion on the issue.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetSeverity#

Input type: IssueSetSeverityInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
severity IssuableSeverity! Set the incident severity level.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetSubscription#

Input type: IssueSetSubscriptionInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
subscribedState Boolean! Desired state of the subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetWeight#

Input type: IssueSetWeightInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
weight Int The desired weight for the issue. If set to null, weight is removed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueUnlinkAlert#

Input type: IssueUnlinkAlertInput

Arguments#

Name Type Description
alertId AlertManagementAlertID! Global ID of the alert to unlink from the incident.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

iterationCadenceCreate#

Input type: IterationCadenceCreateInput

Arguments#

Name Type Description
active Boolean! Whether the iteration cadence is active.
automatic Boolean! Whether the iteration cadence should automatically generate upcoming iterations.
description String Description of the iteration cadence. Maximum length is 5000 characters.
durationInWeeks Int Duration in weeks of the iterations within the cadence.
groupPath ID! Group where the iteration cadence is created.
iterationsInAdvance Int Number of future iterations to schedule in addition to the current one.
rollOver Boolean Whether the iteration cadence should roll over issues to the next iteration or not.
startDate Time Timestamp of the automation start date.
title String Title of the iteration cadence.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iterationCadence IterationCadence Created iteration cadence.

iterationCadenceDestroy#

Input type: IterationCadenceDestroyInput

Arguments#

Name Type Description
id IterationsCadenceID! Global ID of the iteration cadence.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group! Group the iteration cadence belongs to.

iterationCadenceUpdate#

Input type: IterationCadenceUpdateInput

Arguments#

Name Type Description
active Boolean Whether the iteration cadence is active.
automatic Boolean Whether the iteration cadence should automatically generate upcoming iterations.
description String Description of the iteration cadence. Maximum length is 5000 characters.
durationInWeeks Int Duration in weeks of the iterations within the cadence.
id IterationsCadenceID! Global ID of the iteration cadence.
iterationsInAdvance Int Number of future iterations to schedule in addition to the current one.
rollOver Boolean Whether the iteration cadence should roll over issues to the next iteration or not.
startDate Time Timestamp of the automation start date.
title String Title of the iteration cadence.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iterationCadence IterationCadence Updated iteration cadence.

iterationCreate#

Input type: iterationCreateInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iteration Iteration Created iteration.

iterationDelete#

Input type: IterationDeleteInput

Arguments#

Name Type Description
id IterationID! ID of the iteration.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group! Group the iteration belongs to.

jiraImportStart#

Input type: JiraImportStartInput

Arguments#

Name Type Description
jiraProjectKey String! Project key of the importer Jira project.
jiraProjectName String Deprecated in GitLab 17.4. Argument is not used.
projectPath ID! Project to import the Jira project into.
usersMapping [JiraUsersMappingInputType!] Mapping of Jira to GitLab users.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
jiraImport JiraImport Jira import data after mutation.

jiraImportUsers#

Input type: JiraImportUsersInput

Arguments#

Name Type Description
projectPath ID! Project to import the Jira users into.
startAt Int Index of the record the import should started at, default 0 (50 records returned).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
jiraUsers [JiraUser!] Users returned from Jira, matched by email and name if possible.

jobArtifactsDestroy#

Input type: JobArtifactsDestroyInput

Arguments#

Name Type Description
id CiBuildID! ID of the job to mutate.

Fields#

Name Type Description
destroyedArtifactsCount Int! Number of artifacts deleted.
errors [String!]! Errors encountered during the mutation.
job CiJob Job with artifacts to be deleted.

jobCancel#

Input type: JobCancelInput

Arguments#

Name Type Description
id CiBuildID! ID of the job to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
job CiJob Job after the mutation.

jobPlay#

Input type: JobPlayInput

Arguments#

Name Type Description Default
id CiProcessableID! 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. []

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
job CiJob Job after the mutation.

jobRetry#

Input type: JobRetryInput

Arguments#

Name Type Description Default
id CiProcessableID! 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. []

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
job CiJob Job after the mutation.

jobUnschedule#

Input type: JobUnscheduleInput

Arguments#

Name Type Description
id CiBuildID! ID of the job to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
job CiJob Job after the mutation.

knowledgeGraphExcludedNamespaceCreate#

히스토리

Input type: KnowledgeGraphExcludedNamespaceCreateInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to exclude.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Excluded group.

knowledgeGraphExcludedNamespaceDestroy#

히스토리

Input type: KnowledgeGraphExcludedNamespaceDestroyInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to remove from exclusions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group removed from exclusions.

labelCreate#

Input type: LabelCreateInput

Arguments#

Name Type Description Default
color String The 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"
description String Description of the label.
groupPath ID Full path of the group with which the resource is associated.
projectPath ID Full path of the project with which the resource is associated.
title String! Title of the label.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
label Label Label after mutation.

labelUpdate#

Input type: LabelUpdateInput

Arguments#

Name Type Description
archived Boolean Whether to archive the label. Introduced in GitLab 18.10.
id LabelID! Global ID of the label to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
label Label Label after mutation.

ldapAdminRoleLinkCreate#

히스토리

Creates an instance-level custom admin role LDAP link.

Input type: LdapAdminRoleLinkCreateInput

Arguments#

Name Type Description
adminMemberRoleId MemberRoleID! Global ID of the custom admin role to be assigned to a user.
cn String Common Name (CN) of the LDAP group.
filter String Search filter for the LDAP group.
provider String! LDAP provider for the LDAP link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
ldapAdminRoleLink LdapAdminRoleLink Created instance-level LDAP link.

ldapAdminRoleLinkDestroy#

히스토리

Destroys an instance-level custom admin role LDAP link.

Input type: LdapAdminRoleLinkDestroyInput

Arguments#

Name Type Description
id AuthzLdapAdminRoleLinkID! Global ID of the instance-level LDAP link to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
ldapAdminRoleLink LdapAdminRoleLink Deleted instance-level LDAP link.

lifecycleAttachWorkItemType#

히스토리

Input type: LifecycleAttachWorkItemTypeInput

Arguments#

Name Type Description
lifecycleId WorkItemsStatusesLifecycleID! Global ID of the lifecycle to attach the work item type to.
namespacePath ID! Namespace path where the lifecycle exists.
statusMappings [StatusMappingInput!] Status mappings from the old lifecycle to the new lifecycle.
workItemTypeId WorkItemsTypeID! Global ID of the work item type to attach to the lifecycle.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
lifecycle WorkItemLifecycle Lifecycle after attaching the work item type.

lifecycleCreate#

히스토리

Input type: LifecycleCreateInput

Arguments#

Name Type Description
defaultClosedStatusIndex Int! Index of the default closed status in the statuses array.
defaultDuplicateStatusIndex Int! Index of the default duplicated status in the statuses array.
defaultOpenStatusIndex Int! Index of the default open status in the statuses array.
name String! Name of the lifecycle.
namespacePath ID! Namespace path where the lifecycle will be created.
statuses [WorkItemStatusInput!]! Statuses of the lifecycle. Can be existing (with id) or new (without id).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
lifecycle WorkItemLifecycle Lifecycle created.

lifecycleDelete#

히스토리

Input type: LifecycleDeleteInput

Arguments#

Name Type Description
id WorkItemsStatusesLifecycleID! Global ID of the lifecycle to delete.
namespacePath ID! Namespace path where the lifecycle exists.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
lifecycle WorkItemLifecycle Deleted lifecycle.

lifecycleUpdate#

히스토리

Input type: LifecycleUpdateInput

Arguments#

Name Type Description
defaultClosedStatusIndex Int Index of the default closed status in the statuses array.
defaultDuplicateStatusIndex Int Index of the default duplicated status in the statuses array.
defaultOpenStatusIndex Int Index of the default open status in the statuses array.
id WorkItemsStatusesLifecycleID! Global ID of the lifecycle to be updated.
name String Name of the lifecycle.
namespacePath ID! 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).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
lifecycle WorkItemLifecycle Lifecycle updated.

linkProjectComplianceViolationIssue#

히스토리

Input type: LinkProjectComplianceViolationIssueInput

Arguments#

Name Type Description
issueIid String! IID of the issue to be linked.
projectPath ID! Full path of the project the issue belongs to.
violationId ComplianceManagementProjectsComplianceViolationID! Global ID of the project compliance violation.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
violation ProjectComplianceViolation Updated project compliance violation.

markAsSpamSnippet#

Input type: MarkAsSpamSnippetInput

Arguments#

Name Type Description
id SnippetID! Global ID of the snippet to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
snippet Snippet Snippet after mutation.

mavenCacheEntryDelete#

히스토리

Input type: MavenCacheEntryDeleteInput

Arguments#

Name Type Description
id String! ID of the cache entry.

Fields#

Name Type Description
cacheEntry MavenUpstreamCacheEntry Maven cache entry.
errors [String!]! Errors encountered during the mutation.

mavenUpstreamCacheDelete#

히스토리

Input type: MavenUpstreamCacheDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenUpstreamID! ID of the Maven virtual registry upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream MavenUpstreamDetails Maven virtual registry upstream.

mavenUpstreamCreate#

히스토리

Input type: MavenUpstreamCreateInput

Arguments#

Name Type Description Default
cacheValidityHours Int Cache validity period. Defaults to 24 hours. 24
description String Description of the upstream registry.
id VirtualRegistriesPackagesMavenRegistryID! ID of the upstream registry.
metadataCacheValidityHours Int Metadata cache validity period. Defaults to 24 hours. 24
name String! Name of upstream registry.
password String Password of the upstream registry.
url String! URL of the upstream registry.
username String Username of the upstream registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream MavenUpstreamDetails Maven upstream after the mutation.

mavenUpstreamDelete#

히스토리

Input type: MavenUpstreamDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenUpstreamID! ID of the upstream to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream MavenUpstreamDetails Destroyed upstream.

mavenUpstreamUpdate#

히스토리

Input type: MavenUpstreamUpdateInput

Arguments#

Name Type Description
cacheValidityHours Int Cache validity period.
description String Description of the upstream registry.
id VirtualRegistriesPackagesMavenUpstreamID! ID of the upstream registry.
metadataCacheValidityHours Int Metadata cache validity period.
name String Name of upstream registry.
password String Password of the upstream registry.
url String URL of the upstream registry.
username String Username of the upstream registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream MavenUpstreamDetails Maven upstream after the mutation.

mavenVirtualRegistryCacheDelete#

히스토리

Input type: MavenVirtualRegistryCacheDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenRegistryID! ID of the Maven virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry MavenRegistry Maven virtual registry.

mavenVirtualRegistryCreate#

히스토리

Input type: MavenVirtualRegistryCreateInput

Arguments#

Name Type Description
description String Description of the virtual registry.
groupPath ID Full path of the group with which the resource is associated.
name String! Name of virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry MavenRegistry Maven virtual registry after the mutation.

mavenVirtualRegistryDelete#

히스토리

Input type: MavenVirtualRegistryDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenRegistryID! ID of the Maven virtual registry to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry MavenRegistry Deleted Maven virtual registry.

mavenVirtualRegistryUpdate#

히스토리

Input type: MavenVirtualRegistryUpdateInput

Arguments#

Name Type Description
description String Description of the virtual registry.
id VirtualRegistriesPackagesMavenRegistryID! ID of the Maven virtual registry to be updated.
name String Name of virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry MavenRegistry Maven virtual registry after the mutation.

mavenVirtualRegistryUpstreamDelete#

히스토리

Input type: MavenVirtualRegistryUpstreamDeleteInput

Arguments#

Name Type Description
upstreamId VirtualRegistriesPackagesMavenRegistryUpstreamID! ID of the Maven virtual registry upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream MavenRegistryUpstreamWithRegistry Deleted maven registry upstream.

mavenVirtualRegistryUpstreamUpdate#

히스토리

Input type: MavenVirtualRegistryUpstreamUpdateInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenRegistryUpstreamID! ID of the Maven virtual registry upstream.
position Int! Priority order of an upstream within a virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream MavenRegistryUpstreamWithRegistry Maven registry upstream after update.

memberRoleAdminCreate#

히스토리

Input type: MemberRoleAdminCreateInput

Arguments#

Name Type Description
description String Description of the member role.
name String Name of the member role.
permissions [MemberRoleAdminPermission!] List of all customizable admin permissions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole AdminMemberRole Member role.

memberRoleAdminDelete#

히스토리

Input type: MemberRoleAdminDeleteInput

Arguments#

Name Type Description
id MemberRoleID! ID of the admin member role to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole MemberRole Deleted admin member role.

memberRoleAdminUpdate#

히스토리

Input type: MemberRoleAdminUpdateInput

Arguments#

Name Type Description
description String Description of the member role.
id MemberRoleID! ID of the member role to mutate.
name String Name of the member role.
permissions [MemberRoleAdminPermission!] List of all customizable admin permissions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole AdminMemberRole Member role.

memberRoleCreate#

히스토리

Input type: MemberRoleCreateInput

Arguments#

Name Type Description
baseAccessLevel MemberRolesAccessLevel! Base access level for the custom role.
description String Description of the member role.
groupPath ID Group the member role to mutate is in. Required for SaaS.
name String Name of the member role.
permissions [MemberRolePermission!] List of all customizable permissions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole MemberRole Member role.

memberRoleDelete#

히스토리

Input type: MemberRoleDeleteInput

Arguments#

Name Type Description
id MemberRoleID! ID of the member role to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole MemberRole Deleted member role.

memberRoleToUserAssign#

히스토리

Input type: MemberRoleToUserAssignInput

Arguments#

Name Type Description
memberRoleId MemberRoleID Global 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.
userId UserID! Global ID of the user to be assigned to a custom role.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userMemberRole UserMemberRole Created user member role or nil if the relation was deleted.

memberRoleUpdate#

Input type: MemberRoleUpdateInput

Arguments#

Name Type Description
description String Description of the member role.
id MemberRoleID! ID of the member role to mutate.
name String Name of the member role.
permissions [MemberRolePermission!] List of all customizable permissions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole MemberRole Member role.

mergeRequestAccept#

Accepts a merge request. When accepted, the source branch will be scheduled to merge into the target branch, either immediately if possible, or using one of the automatic merge strategies.

In GitLab 16.5, the merging happens asynchronously. This results in mergeRequest and state not updating after a mutation request, because the merging may not have happened yet.

Input type: MergeRequestAcceptInput

Arguments#

Name Type Description Default
commitMessage String Custom merge commit message.
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
sha String! HEAD SHA at the time when the merge was requested.
shouldRemoveSourceBranch Boolean Should the source branch be removed.
squash Boolean Squash commits on the source branch before merge. false
squashCommitMessage String Custom squash commit message (if squash is true).
strategy MergeStrategyEnum How to merge the merge request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestBypassSecurityPolicy#

히스토리

Bypasses security policies for a merge request.

Input type: MergeRequestBypassSecurityPolicyInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
reason String! Reason for bypassing the security policy.
securityPolicyIds [ID!]! ID of the security policy to bypass.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestCreate#

Input type: MergeRequestCreateInput

Arguments#

Name Type Description
description String Description of the merge request (Markdown rendered as HTML for caching).
labels [String!] Labels of the merge request.
mergeAfter Time Date after which the merge request can be merged.
projectPath ID! Project full path the merge request is associated with.
removeSourceBranch Boolean Indicates if the source branch of the merge request will be deleted after merge.
sourceBranch String! Source branch of the merge request.
targetBranch String! Target branch of the merge request.
title String! Title of the merge request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestCreateWorkItemRelations#

Links work items to a merge request.

Input type: MergeRequestCreateWorkItemRelationsInput

Arguments#

Name Type Description Default
iid String! IID of the merge request to mutate.
linkType MergeRequestWorkItemLinkType Type of relationship to create. Defaults to RELATED. MENTIONED relations are managed automatically and cannot be created. RELATED
projectPath ID! Project the merge request to mutate is in.
workItemIds [WorkItemID!]! Global IDs of the work items to link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.
workItemRelations [MergeRequestWorkItemRelation!] Created merge request to work item relations.

mergeRequestDestroyRequestedChanges#

Input type: MergeRequestDestroyRequestedChangesInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestDestroyWorkItemRelations#

Removes relations between a merge request and work items.

Input type: MergeRequestDestroyWorkItemRelationsInput

Arguments#

Name Type Description
ids [MergeRequestIssueID!]! Global IDs of the relations to remove.
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.
removedRelationIds [MergeRequestIssueID!] Global IDs of the removed relations.

mergeRequestRequestChanges#

Input type: MergeRequestRequestChangesInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestResyncSecurityPolicies#

히스토리

Triggers a re-evaluation of the security approval policies applicable to the merge request.

Input type: MergeRequestResyncSecurityPoliciesInput

Arguments#

Name Type Description
iid String! IID of the merge request to re-evaluate.
projectPath ID! Project the merge request belongs to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after the re-evaluation was scheduled.

mergeRequestReviewerRereview#

Input type: MergeRequestReviewerRereviewInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
userId UserID! User ID for the user that has been requested for a new review.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSavedViewCreate#

히스토리

Creates a saved view on the merge request dashboard. Available only when the mr_dashboard_saved_views feature flag is enabled.

Input type: MergeRequestSavedViewCreateInput

Arguments#

Name Type Description
filters MergeRequestSavedViewFilterInput Merge request filters stored in the saved view.
name String! Name of the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView MergeRequestSavedView Saved view after the mutation.

mergeRequestSavedViewDelete#

히스토리

Deletes a saved view from the merge request dashboard. Available only when the mr_dashboard_saved_views feature flag is enabled.

Input type: MergeRequestSavedViewDeleteInput

Arguments#

Name Type Description
id MergeRequestsSavedViewID! Global ID of the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView MergeRequestSavedView Saved view after the mutation.

mergeRequestSavedViewUpdate#

히스토리

Updates a saved view on the merge request dashboard. Available only when the mr_dashboard_saved_views feature flag is enabled.

Input type: MergeRequestSavedViewUpdateInput

Arguments#

Name Type Description
filters MergeRequestSavedViewFilterInput Merge request filters stored in the saved view.
id MergeRequestsSavedViewID! Global ID of the saved view.
name String Name of the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView MergeRequestSavedView Saved view after the mutation.

mergeRequestSetAssignees#

Input type: MergeRequestSetAssigneesInput

Arguments#

Name Type Description Default
assigneeUsernames [String!]! Usernames to assign to the resource. Replaces existing assignees by default.
iid String! IID of the merge request to mutate.
operationMode MutationOperationMode Operation to perform. Defaults to REPLACE. REPLACE
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetBlockingMergeRequests#

Input type: MergeRequestSetBlockingMergeRequestsInput

Arguments#

Name Type Description
blockingMergeRequestReferences [String!]! Array of blocking merge request references (e.g., "!123", "project!456").
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetDraft#

Input type: MergeRequestSetDraftInput

Arguments#

Name Type Description
draft Boolean! Whether or not to set the merge request as a draft.
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetLabels#

Input type: MergeRequestSetLabelsInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
labelIds [LabelID!]! Label IDs to set. Replaces existing labels by default.
operationMode MutationOperationMode Changes the operation mode. Defaults to REPLACE.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetLocked#

Input type: MergeRequestSetLockedInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
locked Boolean! Whether or not to lock the merge request.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetMilestone#

Input type: MergeRequestSetMilestoneInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
milestoneId MilestoneID Milestone to assign to the merge request.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetReviewers#

Input type: MergeRequestSetReviewersInput

Arguments#

Name Type Description Default
iid String! IID of the merge request to mutate.
operationMode MutationOperationMode Operation to perform. Defaults to REPLACE. REPLACE
projectPath ID! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetSubscription#

Input type: MergeRequestSetSubscriptionInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
subscribedState Boolean! Desired state of the subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestUpdate#

Update attributes of a merge request.

Input type: MergeRequestUpdateInput

Arguments#

Name Type Description
description String Description of the merge request (Markdown rendered as HTML for caching).
iid String! IID of the merge request to mutate.
mergeAfter Time Date after which the merge request can be merged.
overrideRequestedChanges Boolean Override all requested changes. Can only be set by users who have permissionto merge this merge request.
projectPath ID! Project the merge request to mutate is in.
removeSourceBranch Boolean Indicates if the source branch of the merge request will be deleted after merge.
state MergeRequestNewState Action to perform to change the state.
targetBranch String Target branch of the merge request.
timeEstimate String Estimated time to complete the merge request. Use null or 0 to remove the current estimate.
title String Title of the merge request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestUpdateApprovalRule#

Input type: MergeRequestUpdateApprovalRuleInput

Arguments#

Name Type Description Default
approvalRuleId Int! ID of an approval rule.
approvalsRequired Int! Number of required approvals for a given rule.
groupIds [String!] IDs of groups as approvers. []
iid String! IID of the merge request to mutate.
name String! Name of the approval rule.
projectPath ID! Project the merge request to mutate is in.
removeHiddenGroups Boolean Whether hidden groups should be removed. false
userIds [String!] IDs of users as approvers. []

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeTrainsDeleteCar#

히스토리

Input type: MergeTrainsDeleteCarInput

Arguments#

Name Type Description
carId MergeTrainsCarID! Global ID of the car.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

mlModelCreate#

히스토리

Input type: MlModelCreateInput

Arguments#

Name Type Description
description String Description of the model.
name String! Name of the model.
projectPath ID! Project the model to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
model MlModel Model after mutation.

mlModelDelete#

히스토리

Input type: MlModelDeleteInput

Arguments#

Name Type Description
id MlModelID! Global ID of the model to be deleted.
projectPath ID! Project the model to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
model MlModel Model after mutation.

mlModelDestroy#

히스토리

Input type: MlModelDestroyInput

Arguments#

Name Type Description
id MlModelID! Global ID of the model to be deleted.
projectPath ID! Project the model to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Model deletion result message.
model MlModel Model after mutation.

mlModelEdit#

히스토리

Input type: MlModelEditInput

Arguments#

Name Type Description
description String Description of the model.
modelId Int Id of the model.
name String! Name of the model.
projectPath ID! Project the model to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
model MlModel Model after mutation.

mlModelVersionCreate#

히스토리

Input type: MlModelVersionCreateInput

Arguments#

Name Type Description
candidateId MlCandidateID Global ID of a candidate to promote optionally.
description String Description of the model version.
modelId MlModelID! Global ID of the model the version belongs to.
projectPath ID! Project the model to mutate is in.
version String Model version.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
modelVersion MlModelVersion Model after mutation.

mlModelVersionDelete#

히스토리

Input type: MlModelVersionDeleteInput

Arguments#

Name Type Description
id MlModelVersionID! Global ID of the model version to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
modelVersion MlModelVersion Deleted model version.

mlModelVersionEdit#

히스토리

Input type: MlModelVersionEditInput

Arguments#

Name Type Description
description String! Description of the model version.
modelId MlModelID! Global ID of the model the version belongs to.
projectPath ID! Project the model to mutate is in.
version String! Model version.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
modelVersion MlModelVersion Model after mutation.

namespaceBanDestroy#

Input type: NamespaceBanDestroyInput

Arguments#

Name Type Description
id NamespacesNamespaceBanID! Global ID of the namespace ban to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceBan NamespaceBan Namespace Ban.

namespaceCiCdSettingsUpdate#

Input type: NamespaceCiCdSettingsUpdateInput

Arguments#

Name Type Description
allowStaleRunnerPruning Boolean Indicates if stale runners directly belonging to the namespace should be periodically pruned.
fullPath ID! Full path of the namespace the settings belong to.

Fields#

Name Type Description
ciCdSettings NamespaceCiCdSetting! CI/CD settings after mutation.
errors [String!]! Errors encountered during the mutation.

namespaceCreateRemoteDevelopmentClusterAgentMapping#

Input type: NamespaceCreateRemoteDevelopmentClusterAgentMappingInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! GlobalID of the cluster agent to be associated with the namespace.
namespaceId GroupID! GlobalID of the group to be associated with the cluster agent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceClusterAgentMapping NamespaceClusterAgentMapping Introduced as an experiment in GitLab 17.10.

Created namespace cluster agent mapping.

namespaceDeleteRemoteDevelopmentClusterAgentMapping#

Input type: NamespaceDeleteRemoteDevelopmentClusterAgentMappingInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! GlobalID of the cluster agent to be un-associated from the namespace.
namespaceId GroupID! GlobalID of the group to be un-associated from the cluster agent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceClusterAgentMapping NamespaceClusterAgentMapping Introduced as an experiment in GitLab 17.11.

Created namespace cluster agent mapping.

namespaceSecretsManagerEnroll#

Input type: NamespaceSecretsManagerEnrollInput

Arguments#

Name Type Description
namespacePath ID! Full path of the namespace to enroll.

Fields#

Name Type Description
enrollment SecretsManagerEnrollment Enrollment record.
errors [String!]! Errors encountered during the mutation.

namespaceSecretsManagerUnenroll#

Input type: NamespaceSecretsManagerUnenrollInput

Arguments#

Name Type Description
namespacePath ID! Full path of the namespace to unenroll.

Fields#

Name Type Description
enrollment SecretsManagerEnrollment Enrollment record.
errors [String!]! Errors encountered during the mutation.

namespaceSettingsUpdate#

히스토리

Input type: NamespaceSettingsUpdateInput

Arguments#

Name Type Description
fullPath ID! Full path of the namespace the settings belong to.
pipelineVariablesDefaultRole PipelineVariablesDefaultRoleType Indicates the default minimum role required to override pipeline variables in the namespace.

Fields#

Name Type Description
ciCdSettings CiCdSettings! Namespace CI/CD settings after mutation.
errors [String!]! Errors encountered during the mutation.

namespacesRegenerateNewWorkItemEmailAddress#

히스토리

Input type: NamespacesRegenerateNewWorkItemEmailAddressInput

Arguments#

Name Type Description
fullPath ID! Full path of the namespace to regenerate the new work item email address for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespace Namespace Namespace after regenerating the new work item email address.

noteConvertToThread#

Convert a standard comment to a resolvable thread.

Input type: NoteConvertToThreadInput

Arguments#

Name Type Description
id NoteID! Global ID of the Note to convert.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

oncallRotationCreate#

Input type: OncallRotationCreateInput

Arguments#

Name Type Description
activePeriod OncallRotationActivePeriodInputType Active period of time that the on-call rotation should take place.
endsAt OncallRotationDateInputType End date and time of the on-call rotation, in the timezone of the on-call schedule.
name String! Name of the on-call rotation.
participants [OncallUserInputType!]! Usernames of users participating in the on-call rotation. A maximum limit of 100 participants applies.
projectPath ID! Project to create the on-call schedule in.
rotationLength OncallRotationLengthInputType! Rotation length of the on-call rotation.
scheduleIid String! IID of the on-call schedule to create the on-call rotation in.
startsAt OncallRotationDateInputType! Start date and time of the on-call rotation, in the timezone of the on-call schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallRotation IncidentManagementOncallRotation On-call rotation.

oncallRotationDestroy#

Input type: OncallRotationDestroyInput

Arguments#

Name Type Description
id IncidentManagementOncallRotationID! ID of the on-call rotation to remove.
projectPath ID! Project to remove the on-call schedule from.
scheduleIid String! IID of the on-call schedule to the on-call rotation belongs to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallRotation IncidentManagementOncallRotation On-call rotation.

oncallRotationUpdate#

Input type: OncallRotationUpdateInput

Arguments#

Name Type Description
activePeriod OncallRotationActivePeriodInputType Active period of time that the on-call rotation should take place.
endsAt OncallRotationDateInputType End date and time of the on-call rotation, in the timezone of the on-call schedule.
id IncidentManagementOncallRotationID! ID of the on-call schedule to create the on-call rotation in.
name String Name of the on-call rotation.
participants [OncallUserInputType!] Usernames of users participating in the on-call rotation. A maximum limit of 100 participants applies.
rotationLength OncallRotationLengthInputType Rotation length of the on-call rotation.
startsAt OncallRotationDateInputType Start date and time of the on-call rotation, in the timezone of the on-call schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallRotation IncidentManagementOncallRotation On-call rotation.

oncallScheduleCreate#

Input type: OncallScheduleCreateInput

Arguments#

Name Type Description
description String Description of the on-call schedule.
name String! Name of the on-call schedule.
projectPath ID! Project to create the on-call schedule in.
timezone String! Timezone of the on-call schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallSchedule IncidentManagementOncallSchedule On-call schedule.

oncallScheduleDestroy#

Input type: OncallScheduleDestroyInput

Arguments#

Name Type Description
iid String! On-call schedule internal ID to remove.
projectPath ID! Project to remove the on-call schedule from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallSchedule IncidentManagementOncallSchedule On-call schedule.

oncallScheduleUpdate#

Input type: OncallScheduleUpdateInput

Arguments#

Name Type Description
description String Description of the on-call schedule.
iid String! On-call schedule internal ID to update.
name String Name of the on-call schedule.
projectPath ID! Project to update the on-call schedule in.
timezone String Timezone of the on-call schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallSchedule IncidentManagementOncallSchedule On-call schedule.

orbitStartTrial#

히스토리

Input type: OrbitStartTrialInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group the trial was requested for, also returned on error. Read knowledgeGraphEnabled and orbitTrial from it.

orbitUpdate#

히스토리

Input type: OrbitUpdateInput

Arguments#

Name Type Description
enabled Boolean! Whether to enable or disable the Knowledge Graph for the group.
groupPath ID! Full path of the group to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group after mutation.

organizationConfirm#

히스토리

Input type: OrganizationConfirmInput

Arguments#

Name Type Description
groups [GroupID!] Global IDs of top-level groups to transfer to the organization.
id OrganizationsOrganizationID! Global ID of the organization to confirm.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Organization after mutation.

organizationCreate#

히스토리

Input type: OrganizationCreateInput

Arguments#

Name Type Description
avatar Upload Avatar for the organization.
description String Description of the organization.
name String! Name for the organization.
path String! Path for the organization.
visibility OrganizationVisibility Visibility for the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Organization after mutation.

organizationCreateClusterAgentMapping#

히스토리

Input type: OrganizationCreateClusterAgentMappingInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! GlobalID of the cluster agent to be associated with the organization.
organizationId OrganizationsOrganizationID! GlobalID of the organization to be associated with the cluster agent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

organizationDelete#

히스토리

Input type: OrganizationDeleteInput

Arguments#

Name Type Description
avatar Upload Avatar for the organization.
description String Description of the organization.
id OrganizationsOrganizationID! ID of the organization to soft-delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Soft-deleted organization.

organizationDeleteClusterAgentMapping#

히스토리

Input type: OrganizationDeleteClusterAgentMappingInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! GlobalID of the cluster agent to be dissociated with the organization.
organizationId OrganizationsOrganizationID! GlobalID of the organization to be dissociated with the cluster agent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

organizationRestore#

히스토리

Input type: OrganizationRestoreInput

Arguments#

Name Type Description
id OrganizationsOrganizationID! ID of the organization to restore.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Restored organization.

organizationUpdate#

히스토리

Input type: OrganizationUpdateInput

Arguments#

Name Type Description
avatar Upload Avatar for the organization.
description String Description of the organization.
id OrganizationsOrganizationID! ID of the organization to mutate.
name String Name for the organization.
path String Path for the organization.
policyStoreExperimentEnabled Boolean Introduced as an experiment 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.
visibility OrganizationVisibility Visibility for the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Organization after mutation.

organizationUserCreate#

히스토리

Input type: OrganizationUserCreateInput

Arguments#

Name Type Description
organizationId OrganizationsOrganizationID! ID of the organization to add the user to.
userType OrganizationUserType! Type to add the organization user with.
username String! Username of the user to add to the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organizationUser OrganizationUser Introduced as an experiment in GitLab 19.3.

Organization user added by the mutation.

organizationUserDelete#

히스토리

Input type: OrganizationUserDeleteInput

Arguments#

Name Type Description
id OrganizationsOrganizationUserID! ID of the organization user to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organizationUser OrganizationUser Introduced as an experiment in GitLab 19.3.

Organization user that was deleted.

organizationUserUpdate#

히스토리

Input type: OrganizationUserUpdateInput

Arguments#

Name Type Description
accessLevel OrganizationUserAccessLevel! Access level to update the organization user to.
id OrganizationsOrganizationUserID! ID of the organization user to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organizationUser OrganizationUser Introduced as an experiment in GitLab 17.5.

Organization user after mutation.

pagesMarkOnboardingComplete#

Input type: PagesMarkOnboardingCompleteInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
onboardingComplete Boolean! Indicates the new onboarding_complete state of the project's Pages metadata.

personalAccessTokenCreate#

히스토리

Creates a personal access token for the current user.

Input type: PersonalAccessTokenCreateInput

Arguments#

Name Type Description Default
description String Description of the token.
expiresAt ISO8601Date Expiration date of the token.
granularScopes [GranularScopeInput!]! List of granular scopes to assign to the token.
name String! Name of the token.
sudo Boolean Whether the token can impersonate other users with sudo. Requires the token owner to be an administrator. false

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
token String Created personal access token.

personalAccessTokenRevoke#

히스토리

Revokes a specified personal access token.

Input type: PersonalAccessTokenRevokeInput

Arguments#

Name Type Description
id PersonalAccessTokenID! Global ID of the personal access token that will be revoked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

personalAccessTokenRotate#

히스토리

Rotate a specified personal access token.

Input type: PersonalAccessTokenRotateInput

Arguments#

Name Type Description
expiresAt ISO8601Date Expiration date of the token.
id PersonalAccessTokenID! Global ID of the personal access token that will be rotated.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
token String Created personal access token.

pipelineCancel#

Input type: PipelineCancelInput

Arguments#

Name Type Description
id CiPipelineID! ID of the pipeline to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipeline Pipeline Pipeline after mutation.

pipelineCreate#

Input type: PipelineCreateInput

Arguments#

Name Type Description
async Boolean Introduced as an experiment 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.
inputs [CiInputsInput!] Introduced as an experiment in GitLab 17.10.

Inputs for the pipeline.
mergeRequestIid String IID of the merge request to create pipeline for.
projectPath ID! Full path of the project that is triggering the pipeline.
ref String! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipeline Pipeline Pipeline created after mutation. Null if async: true.
requestId String Introduced as an experiment in GitLab 17.8.

ID for checking the pipeline creation status. Null if async: false.

pipelineDestroy#

Input type: PipelineDestroyInput

Arguments#

Name Type Description
id CiPipelineID! ID of the pipeline to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

pipelineExecutionSchedulePolicyTestRun#

히스토리

Triggers a test-run for a Scheduled Pipeline Execution Policy on a specific project.

Input type: PipelineExecutionSchedulePolicyTestRunInput

Arguments#

Name Type Description
policyId SecurityPolicyID! Global ID of the pipeline execution schedule policy to test.
projectPath ID! Full path of the project to run the test on.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
testRun PolicyScheduleTestRun Test-run record created.

pipelineRetry#

Input type: PipelineRetryInput

Arguments#

Name Type Description
id CiPipelineID! ID of the pipeline to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipeline Pipeline Pipeline after mutation.

pipelineScheduleCreate#

Input type: PipelineScheduleCreateInput

Arguments#

Name Type Description
active Boolean Indicates if the pipeline schedule should be active or not.
cron String! Cron expression of the pipeline schedule.
cronTimezone String Cron time zone supported by ActiveSupport::TimeZone. For example: Pacific Time (US & Canada) (default: UTC).
description String! Description of the pipeline schedule.
inputs [CiInputsInput!] Introduced as an experiment in GitLab 17.10.

Inputs for the pipeline schedule.
projectPath ID! Full path of the project the pipeline schedule is associated with.
ref String! Ref of the pipeline schedule.
variables [PipelineScheduleVariableInput!] Variables for the pipeline schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineSchedule PipelineSchedule Created pipeline schedule.

pipelineScheduleDelete#

Input type: PipelineScheduleDeleteInput

Arguments#

Name Type Description
id CiPipelineScheduleID! ID of the pipeline schedule to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

pipelineSchedulePlay#

Input type: PipelineSchedulePlayInput

Arguments#

Name Type Description
id CiPipelineScheduleID! ID of the pipeline schedule to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineSchedule PipelineSchedule Pipeline schedule after mutation.

pipelineScheduleTakeOwnership#

Input type: PipelineScheduleTakeOwnershipInput

Arguments#

Name Type Description
id CiPipelineScheduleID! ID of the pipeline schedule to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineSchedule PipelineSchedule Updated pipeline schedule ownership.

pipelineScheduleUpdate#

Input type: PipelineScheduleUpdateInput

Arguments#

Name Type Description
active Boolean Indicates if the pipeline schedule should be active or not.
cron String Cron expression of the pipeline schedule.
cronTimezone String Cron time zone supported by ActiveSupport::TimeZone. For example: Pacific Time (US & Canada) (default: UTC).
description String Description of the pipeline schedule.
id CiPipelineScheduleID! ID of the pipeline schedule to mutate.
inputs [CiInputsInput!] Introduced as an experiment in GitLab 17.11.

Inputs for the pipeline schedule.
ref String Ref of the pipeline schedule.
variables [PipelineScheduleVariableInput!] Variables for the pipeline schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineSchedule PipelineSchedule Updated pipeline schedule.

pipelineTriggerCreate#

히스토리

Input type: PipelineTriggerCreateInput

Arguments#

Name Type Description
description String! Description of the pipeline trigger token.
expiresAt Time Timestamp of when the pipeline trigger token expires.
projectPath ID! Full path of the project that the pipeline trigger token to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineTrigger PipelineTrigger Mutated pipeline trigger token.

pipelineTriggerDelete#

히스토리

Input type: PipelineTriggerDeleteInput

Arguments#

Name Type Description
id CiTriggerID! ID of the pipeline trigger token to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

pipelineTriggerUpdate#

히스토리

Input type: PipelineTriggerUpdateInput

Arguments#

Name Type Description
description String! Description of the pipeline trigger token.
id CiTriggerID! ID of the pipeline trigger token to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineTrigger PipelineTrigger Mutated pipeline trigger token.

processUserBillablePromotionRequest#

히스토리

Input type: ProcessUserBillablePromotionRequestInput

Arguments#

Name Type Description
status MemberApprovalStatusType! Status for the member approval request (approved, denied, pending).
userId UserID! Global ID of user to be promoted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
result UserPromotionStatusType Status of the user promotion process (success, partial_success, failed).

projectBlobsRemove#

히스토리

Input type: projectBlobsRemoveInput

Arguments#

Name Type Description
blobOids [String!]! List of blob oids.
projectPath ID! Full path of the project to replace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

projectCiCdSettingsUpdate#

Input type: ProjectCiCdSettingsUpdateInput

Arguments#

Name Type Description
crossProjectPushForJobTokenAllowed Boolean Indicates the ability to push to this repository using a job token from an allowlisted project.
displayPipelineVariables Boolean Indicates whether pipeline variables can be displayed in the UI.
fullPath ID! Full Path of the project the settings belong to.
groupRunnersEnabled Boolean Indicates whether group runners are enabled for the project.
inboundJobTokenScopeEnabled Boolean Indicates whether CI/CD job tokens generated in other projects have restricted access to this project.
jobTokenScopeEnabled Boolean Deprecated in GitLab 16.0. Outbound job token scope is being removed. This field can now only be set to false.
keepLatestArtifact Boolean Indicates whether the latest artifact should be kept for the project.
maxPipelinesPerMergeTrain Int Maximum number of parallel pipelines per merge train.
mergePipelinesEnabled Boolean Indicates if merged results pipelines are enabled for the project.
mergeTrainEnforcement MergeTrainEnforcement Merge train enforcement level for the project.
mergeTrainsEnabled Boolean Indicates if merge trains are enabled for the project.
mergeTrainsSkipTrainAllowed Boolean Indicates whether an option is allowed to merge without refreshing the merge train. Ignored unless the merge_trains_skip_train feature flag is also enabled.
pipelineVariablesMinimumOverrideRole String Minimum role required to set variables when creating a pipeline or running a job.
pushRepositoryForJobTokenAllowed Boolean Indicates the ability to push to the original project repository using a job token.
resourceGroupDefaultProcessMode ResourceGroupsProcessMode Default process mode for resource groups in the project.
skipBranchPipelinesForMrs Boolean Indicates whether branch pipelines are skipped if a merge request is open.

Fields#

Name Type Description
ciCdSettings ProjectCiCdSetting! CI/CD settings after mutation.
errors [String!]! Errors encountered during the mutation.

projectCustomAttributeSet#

히스토리

Sets (creates or updates) a custom attribute on a project. Only available to admins.

Input type: ProjectCustomAttributeSetInput

Arguments#

Name Type Description
key String! Key of the custom attribute.
projectPath ID! Full path of the project.
value String! Value of the custom attribute.

Fields#

Name Type Description
customAttribute CustomAttribute Custom attribute after mutation.
errors [String!]! Errors encountered during the mutation.

projectMemberBulkUpdate#

Updates multiple members of a project. To use this mutation, you must have at least the Maintainer role.

Input type: ProjectMemberBulkUpdateInput

Arguments#

Name Type Description
accessLevel MemberAccessLevel! Access level to update the members to.
expiresAt Time Date and time the membership expires.
projectId ProjectID! Global ID of the project.
userIds [UserID!]! Global IDs of the members.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectMembers [ProjectMember!] Project members after mutation.
queuedMemberApprovals MemberApprovalConnection List of queued pending members approvals. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.

projectSavedReplyCreate#

히스토리

Input type: ProjectSavedReplyCreateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
name String! Name of the saved reply.
projectId ProjectID! Project for the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply ProjectSavedReply Saved reply after mutation.

projectSavedReplyDestroy#

히스토리

Input type: ProjectSavedReplyDestroyInput

Arguments#

Name Type Description
id ProjectsSavedReplyID! Global ID of the project-level saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply ProjectSavedReply Saved reply after mutation.

projectSavedReplyUpdate#

히스토리

Input type: ProjectSavedReplyUpdateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
id ProjectsSavedReplyID! Global ID of the project-level saved reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply ProjectSavedReply Saved reply after mutation.

projectSecretCreate#

Input type: ProjectSecretCreateInput

Arguments#

Name Type Description
branch String! Branches that can access the secret.
description String Description of the project secret.
environment String! Environments that can access the secret.
name String! Name of the project secret.
projectPath ID! Project of the secret.
rotationIntervalDays Int Number of days between rotation reminders for the secret.
secret String! Value of the project secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecret ProjectSecret Project secret.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

projectSecretDelete#

Input type: ProjectSecretDeleteInput

Arguments#

Name Type Description
name String! Name of the project secret.
projectPath ID! Project of the secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecret ProjectSecret Deleted project secret.

projectSecretUpdate#

Input type: ProjectSecretUpdateInput

Arguments#

Name Type Description
branch String New branches that can access the secret.
description String New description of the project secret.
environment String New environments that can access the secret.
metadataCas Int! This should match the current metadata version of the project secret being updated.
name String! Name of the project secret to update.
projectPath ID! Project of the secret.
rotationIntervalDays Int Number of days between rotation reminders for the secret.
secret String New value of the project secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecret ProjectSecret Updated project secret.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

projectSecretsManagerDeprovision#

Input type: ProjectSecretsManagerDeprovisionInput

Arguments#

Name Type Description
projectPath ID! Project of the secrets manager.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecretsManager ProjectSecretsManager Project secrets manager.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

projectSecretsManagerInitialize#

Input type: ProjectSecretsManagerInitializeInput

Arguments#

Name Type Description
projectPath ID! Project of the secrets manager.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecretsManager ProjectSecretsManager Project secrets manager.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

projectSecretsPermissionDelete#

Input type: ProjectSecretsPermissionDeleteInput

Arguments#

Name Type Description
principal PrincipalInput! User/MemberRole/Role whose access is being removed.
projectPath ID! Project from which the permissions are removed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.
secretsPermission ProjectSecretsPermission Secrets Permission that was deleted.

projectSecretsPermissionUpdate#

Input type: ProjectSecretsPermissionUpdateInput

Arguments#

Name Type Description
actions [SecretsManagementAction!]! Actions that can be performed on secrets.
expiredAt ISO8601Date Expiration date for Secret Permission (optional).
principal PrincipalInput! User/MemberRole/Role that is provided access.
projectPath ID! Project to which the permissions are added.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.
secretsPermission ProjectSecretsPermission Secrets Permission that was created.

projectSecurityExclusionCreate#

Input type: ProjectSecurityExclusionCreateInput

Arguments#

Name Type Description
active Boolean! Whether the exclusion is active.
description String Optional description for the exclusion.
projectPath ID! Full path of the project the exclusion will be associated with.
scanner ExclusionScannerEnum! Scanner to ignore values for based on the exclusion.
type ExclusionTypeEnum! Type of the exclusion.
value String! Value of the exclusion.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityExclusion ProjectSecurityExclusion Project security exclusion created.

projectSecurityExclusionDelete#

Input type: ProjectSecurityExclusionDeleteInput

Arguments#

Name Type Description
id SecurityProjectSecurityExclusionID! Global ID of the exclusion to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

projectSecurityExclusionUpdate#

Input type: ProjectSecurityExclusionUpdateInput

Arguments#

Name Type Description
active Boolean Whether the exclusion is active.
description String Optional description for the exclusion.
id SecurityProjectSecurityExclusionID! Global ID of the exclusion to be updated.
scanner ExclusionScannerEnum Scanner to ignore values for based on the exclusion.
type ExclusionTypeEnum Type of the exclusion.
value String Value of the exclusion.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityExclusion ProjectSecurityExclusion Project security exclusion updated.

projectSetComplianceFramework#

Deprecated in GitLab 17.11. Use mutation ProjectUpdateComplianceFrameworks instead of this.

Input type: ProjectSetComplianceFrameworkInput

Arguments#

Name Type Description
complianceFrameworkId ComplianceManagementFrameworkID ID of the compliance framework to assign to the project. Set to null to unset.
projectId ProjectID! ID of the project to change the compliance framework of.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

projectSetContinuousVulnerabilityScanning#

Deprecated in GitLab 17.3. CVS has been enabled permanently. See this epic for more information.

Input type: ProjectSetContinuousVulnerabilityScanningInput

Arguments#

Name Type Description
enable Boolean! Desired status for continuous vulnerability scanning feature.
projectPath ID! Full path of the project.

Fields#

Name Type Description
continuousVulnerabilityScanningEnabled Boolean! Whether feature is enabled.
errors [String!]! Errors encountered during the mutation.

projectSetLocked#

Input type: ProjectSetLockedInput

Arguments#

Name Type Description
filePath String! Full path to the file.
lock Boolean! Whether or not to lock the file path.
projectPath ID! Full path of the project to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

projectSettingsUpdate#

히스토리

Input type: ProjectSettingsUpdateInput

Arguments#

Name Type Description
aiAuditEventsStorageEnabled Boolean Introduced as an experiment in GitLab 19.2.

Indicates whether AI audit events are stored for the project.
duoAutoModeEnabled Boolean Indicates whether Duo Agent Platform auto mode is enabled for the project.
duoContextExclusionSettings DuoContextExclusionSettingsInput Settings for excluding files from Duo context.
duoFeaturesEnabled Boolean Indicates whether GitLab Duo features are enabled for the project.
duoSastFpDetectionEnabled Boolean Indicates whether SAST False Positive Detection is enabled for the project.
duoSastVrWorkflowEnabled Boolean Indicates whether SAST Vulnerability Resolution workflow is enabled for the project.
duoSecretDetectionFpEnabled Boolean Indicates whether Secret Detection False Positive Detection is enabled for the project.
fullPath ID! Full Path of the project the settings belong to.
toolApprovalForSessionEnabled Boolean Indicates whether tool approval for Duo Workflow sessions is enabled for the project.
webBasedCommitSigningEnabled Boolean Introduced as an experiment in GitLab 18.2.

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSettings ProjectSetting! Project settings after mutation.

projectSubscriptionCreate#

Input type: ProjectSubscriptionCreateInput

Arguments#

Name Type Description
projectPath String! Full path of the downstream project of the Project Subscription.
upstreamPath String! Full path of the upstream project of the Project Subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
subscription CiSubscriptionsProject Project Subscription created by the mutation.

projectSubscriptionDelete#

Input type: ProjectSubscriptionDeleteInput

Arguments#

Name Type Description
subscriptionId CiSubscriptionsProjectID! ID of the subscription to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

projectSyncFork#

히스토리

Input type: ProjectSyncForkInput

Arguments#

Name Type Description
projectPath ID! Full path of the project to initialize.
targetBranch String! Ref of the fork to fetch into.

Fields#

Name Type Description
details ForkDetails Updated fork details.
errors [String!]! Errors encountered during the mutation.

projectTargetBranchRuleCreate#

Input type: ProjectTargetBranchRuleCreateInput

Arguments#

Name Type Description
name String! Name for the target branch rule.
projectId ProjectID! Project ID for the target branch rule.
targetBranch String! Target branch for the target branch rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
targetBranchRule ProjectTargetBranchRule Target branch rule after mutation.

projectTargetBranchRuleDestroy#

Input type: ProjectTargetBranchRuleDestroyInput

Arguments#

Name Type Description
id ProjectsTargetBranchRuleID! ID for the target branch rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

projectTextReplace#

히스토리

Input type: projectTextReplaceInput

Arguments#

Name Type Description
projectPath ID! Full path of the project to replace.
replacements [String!]! List of text patterns to replace project-wide.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

projectTransfer#

히스토리

Input type: ProjectTransferInput

Arguments#

Name Type Description
id ProjectID! Global ID of the project to transfer.
namespaceId NamespaceID! Global ID of the target namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

projectUpdateComplianceFrameworks#

Update compliance frameworks for a project.

Input type: ProjectUpdateComplianceFrameworksInput

Arguments#

Name Type Description
complianceFrameworkIds [ComplianceManagementFrameworkID!]! IDs of the compliance framework to update for the project.
projectId ProjectID! ID of the project to change the compliance framework of.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

prometheusIntegrationCreate#

Deprecated in GitLab 18.2. Use HttpIntegrationCreate.

Input type: PrometheusIntegrationCreateInput

Arguments#

Name Type Description Default
active Boolean! Whether the integration is receiving alerts.
apiUrl String Deprecated in GitLab 18.2. Feature removed in 16.0.
name String Name of the integration. "Prometheus"
payloadAttributeMappings [AlertManagementPayloadAlertFieldInput!] Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExample JsonString Example of an alert payload.
projectPath ID! Project to create the integration in.
type AlertManagementIntegrationType Type of integration to create. Cannot be changed after creation. HTTP

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementPrometheusIntegration Newly created integration.

prometheusIntegrationResetToken#

Deprecated in GitLab 18.2. Use HttpIntegrationResetToken.

Input type: PrometheusIntegrationResetTokenInput

Arguments#

Name Type Description
id IntegrationsPrometheusID! ID of the integration to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementPrometheusIntegration Updated integration.

prometheusIntegrationUpdate#

Deprecated in GitLab 18.2. Use HttpIntegrationUpdate.

Input type: PrometheusIntegrationUpdateInput

Arguments#

Name Type Description
active Boolean Whether the integration is receiving alerts.
apiUrl String Deprecated in GitLab 18.2. Feature removed in 16.0.
id IntegrationsPrometheusID! ID of the integration to mutate.
name String Name of the integration.
payloadAttributeMappings [AlertManagementPayloadAlertFieldInput!] Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExample JsonString Example of an alert payload.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementPrometheusIntegration Updated integration.

promoteToEpic#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: PromoteToEpicInput

Arguments#

Name Type Description
groupPath ID Group the promoted epic will belong to.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
epic Epic Epic after issue promotion.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

refreshFindingTokenStatus#

Input type: RefreshFindingTokenStatusInput

Arguments#

Name Type Description
vulnerabilityId VulnerabilityID! Global ID of the Vulnerability whose token status should be refreshed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
findingTokenStatus VulnerabilityFindingTokenStatus Updated token status record for the given finding.

refreshSecurityFindingTokenStatus#

Input type: RefreshSecurityFindingTokenStatusInput

Arguments#

Name Type Description
securityFindingUuid String! UUID of the Security::Finding whose token status should be refreshed (MR context).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
findingTokenStatus SecurityFindingTokenStatus Updated token status record for the given Security::Finding.

refreshStandardsAdherenceChecks#

Input type: RefreshStandardsAdherenceChecksInput

Arguments#

Name Type Description
groupPath ID! Group path.

Fields#

Name Type Description
adherenceChecksStatus StandardsAdherenceChecksStatus Progress of standards adherence checks.
errors [String!]! Errors encountered during the mutation.

refreshVulnerabilityFindingTokenStatus#

Input type: RefreshVulnerabilityFindingTokenStatusInput

Arguments#

Name Type Description
vulnerabilityId VulnerabilityID! Global ID of the Vulnerability whose token status should be refreshed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
findingTokenStatus VulnerabilityFindingTokenStatus Updated token status record for the given Vulnerabilities::Finding.

releaseAssetLinkCreate#

Input type: ReleaseAssetLinkCreateInput

Arguments#

Name Type Description Default
directAssetPath String Relative path for a direct asset link.
linkType ReleaseAssetLinkType Type of the asset link. OTHER
name String! Name of the asset link.
projectPath ID! Full path of the project the asset link is associated with.
tagName String! Name of the associated release's tag.
url String! URL of the asset link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
link ReleaseAssetLink Asset link after mutation.

releaseAssetLinkDelete#

Input type: ReleaseAssetLinkDeleteInput

Arguments#

Name Type Description
id ReleasesLinkID! ID of the release asset link to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
link ReleaseAssetLink Deleted release asset link.

releaseAssetLinkUpdate#

Input type: ReleaseAssetLinkUpdateInput

Arguments#

Name Type Description
directAssetPath String Relative path for a direct asset link.
id ReleasesLinkID! ID of the release asset link to update.
linkType ReleaseAssetLinkType Type of the asset link.
name String Name of the asset link.
url String URL of the asset link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
link ReleaseAssetLink Asset link after mutation.

releaseCreate#

Input type: ReleaseCreateInput

Arguments#

Name Type Description
assets ReleaseAssetsInput Assets associated to the release.
description String Description (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.
name String Name of the release.
projectPath ID! Full path of the project the release is associated with.
ref String Commit SHA or branch name to use if creating a new tag.
releasedAt Time Date 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.
tagMessage String Message to use if creating a new annotated tag.
tagName String! Name of the tag to associate with the release.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
release Release Release after mutation.

releaseDelete#

Input type: ReleaseDeleteInput

Arguments#

Name Type Description
projectPath ID! Full path of the project the release is associated with.
tagName String! Name of the tag associated with the release to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
release Release Deleted release.

releaseUpdate#

Input type: ReleaseUpdateInput

Arguments#

Name Type Description
description String Description (release notes) of the release.
milestones [String!] Title of each milestone the release is associated with. GitLab Premium customers can specify group milestones.
name String Name of the release.
projectPath ID! Full path of the project the release is associated with.
releasedAt Time Release date.
tagName String! Name of the tag associated with the release.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
release Release Release after mutation.

removeProjectFromSecurityDashboard#

Input type: RemoveProjectFromSecurityDashboardInput

Arguments#

Name Type Description
id ProjectID! ID of the project to remove from the Instance Security Dashboard.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

repositionImageDiffNote#

Repositions a DiffNote on an image (a Note where the position.positionType is "image").

Input type: RepositionImageDiffNoteInput

Arguments#

Name Type Description
id DiffNoteID! Global ID of the DiffNote to update.
position UpdateDiffImagePositionInput! Position of the note on a diff.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

restorePagesDeployment#

히스토리

Restores a Pages deployment that has been scheduled for deletion.

Input type: RestorePagesDeploymentInput

Arguments#

Name Type Description
id PagesDeploymentID! ID of the Pages Deployment.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pagesDeployment PagesDeployment! Restored Pages Deployment.

resyncSecurityPolicies#

히스토리

Triggers a resynchronization of security policies linked to the given project or group (full_path).

Input type: ResyncSecurityPoliciesInput

Arguments#

Name Type Description Default
fullPath String! Full path of the project or group.
relationship RelationshipType Relationship of the policies to resync. DIRECT

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerAssignToProject#

히스토리

Input type: RunnerAssignToProjectInput

Arguments#

Name Type Description
projectPath ID! Full path of the project to which the runner will be assigned.
runnerId CiRunnerID! ID of the runner to assign to the project .

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerBulkPause#

히스토리

Input type: RunnerBulkPauseInput

Arguments#

Name Type Description
ids [CiRunnerID!]! IDs of the runners to pause or unpause.
paused Boolean! Indicates the runner is not allowed to receive jobs.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
updatedCount Int Number of records effectively updated. Only present if operation was performed synchronously.
updatedRunners [CiRunner!] Runners after mutation.

runnerCacheClear#

Input type: RunnerCacheClearInput

Arguments#

Name Type Description
projectId ProjectID! Global ID of the project that will have its runner cache cleared.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerCreate#

히스토리

Input type: RunnerCreateInput

Arguments#

Name Type Description
accessLevel CiRunnerAccessLevel Access level of the runner.
description String Description of the runner.
groupId GroupID Global ID of the group that the runner is created in (valid only for group runner).
locked Boolean Indicates the runner is locked.
maintenanceNote String Runner's maintenance notes.
maximumTimeout Int Maximum timeout (in seconds) for jobs processed by the runner.
paused Boolean Indicates the runner is not allowed to receive jobs.
privateProjectsMinutesCostFactor Float Introduced as an experiment in GitLab 17.7.

Private projects' "compute cost factor" associated with the runner (GitLab.com only).
projectId ProjectID Global ID of the project that the runner is created in (valid only for project runner).
publicProjectsMinutesCostFactor Float Introduced as an experiment in GitLab 17.7.

Public projects' "compute cost factor" associated with the runner (GitLab.com only).
runUntagged Boolean Indicates the runner is able to run untagged jobs.
runnerType CiRunnerType! Type of the runner to create.
tagList [String!] Tags associated with the runner.
tokenExpiresAt Time Token expiration time (ISO 8601 format). Must be between 5 minutes and 21 days in the future, and cannot exceed instance/group/project limits.
tokenRotationDeadline Time Introduced as an experiment 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
runner CiRunner Runner after mutation.

runnerDelete#

Input type: RunnerDeleteInput

Arguments#

Name Type Description
id CiRunnerID! ID of the runner to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerUnassignFromProject#

히스토리

Input type: RunnerUnassignFromProjectInput

Arguments#

Name Type Description
projectPath ID! Full path of the project from which the runner will be unassigned.
runnerId CiRunnerID! ID of the runner to unassign from the project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerUpdate#

Input type: RunnerUpdateInput

Arguments#

Name Type Description
accessLevel CiRunnerAccessLevel Access level of the runner.
active Boolean Deprecated in GitLab 14.8. Renamed. Use paused instead.
associatedProjects [ProjectID!] Projects associated with the runner. Available only for project runners.
description String Description of the runner.
id CiRunnerID! ID of the runner to update.
locked Boolean Indicates the runner is locked.
maintenanceNote String Runner's maintenance notes.
maximumTimeout Int Maximum timeout (in seconds) for jobs processed by the runner.
paused Boolean Indicates the runner is not allowed to receive jobs.
privateProjectsMinutesCostFactor Float Introduced as an experiment in GitLab 17.7.

Private projects' "compute cost factor" associated with the runner (GitLab.com only).
publicProjectsMinutesCostFactor Float Introduced as an experiment in GitLab 17.7.

Public projects' "compute cost factor" associated with the runner (GitLab.com only).
runUntagged Boolean Indicates the runner is able to run untagged jobs.
tagList [String!] Tags associated with the runner.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
runner CiRunner Runner after mutation.

runnersExportUsage#

Input type: RunnersExportUsageInput

Arguments#

Name Type Description Default
fromDate ISO8601Date UTC start date of the period to report on. Defaults to the start of last full month.
fullPath ID Filter 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.
maxProjectCount Int Maximum number of projects to return. All other runner usage will be attributed to an entry. Defaults to 1000 projects. 1000
runnerType CiRunnerType Scope of the runners to include in the report.
toDate ISO8601Date UTC end date of the period to report on. " \ "Defaults to the end of the month specified by fromDate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnersRegistrationTokenReset#

Deprecated in GitLab 17.7. Underlying feature was deprecated in 15.6 and will be removed in 18.0.

Input type: RunnersRegistrationTokenResetInput

Arguments#

Name Type Description
id ID ID of the project or group to reset the token for. Omit if resetting instance runner token.
type CiRunnerType! Scope of the object to reset the token for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
token String Runner token after mutation.

safeDisablePipelineVariables#

Input type: SafeDisablePipelineVariablesInput

Arguments#

Name Type Description
fullPath ID! Full path of the group to disable pipeline variables for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Indicates whether the migration was successfully enqueued.

savedReplyCreate#

Input type: SavedReplyCreateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply SavedReply Saved reply after mutation.

savedReplyDestroy#

Input type: SavedReplyDestroyInput

Arguments#

Name Type Description
id UsersSavedReplyID! Global ID of the user saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply SavedReply Saved reply after mutation.

savedReplyUpdate#

Input type: SavedReplyUpdateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
id UsersSavedReplyID! Global ID of the user saved reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply SavedReply Saved reply after mutation.

scanExecutionPolicyCommit#

Commits the policy_yaml content to the assigned security policy project for the given project (full_path).

Input type: ScanExecutionPolicyCommitInput

Arguments#

Name Type Description
fullPath String Full path of the project.
name String! Name of the policy. If the name is null, the name field from policy_yaml is used.
operationMode MutationOperationMode! Changes the operation mode.
policyYaml String! YAML snippet of the policy.
projectPath ID Deprecated in GitLab 14.10. Use fullPath.

Fields#

Name Type Description
branch String Name of the branch to which the policy changes are committed.
errors [String!]! Errors encountered during the mutation.
validationErrors [SecurityPolicyValidationError!] Validation errors encountered during execution of the mutation.

secretsManagerEnableAddOn#

히스토리

Input type: SecretsManagerEnableAddOnInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to enable the Secrets Manager add-on for.

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Secrets Manager entitlement state after enabling the add-on. Null when enabling failed; see errors for the reason.
errors [String!]! Errors encountered during the mutation.

secretsManagerInstanceEnableAddOn#

히스토리

Input type: SecretsManagerInstanceEnableAddOnInput

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Instance-level Secrets Manager entitlement state after enabling the add-on. Null when enabling failed; see errors for the reason.
errors [String!]! Errors encountered during the mutation.

secretsManagerInstanceRefreshEntitlement#

히스토리

Input type: SecretsManagerInstanceRefreshEntitlementInput

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Instance-wide Secrets Manager entitlement state as the subscription service reports it now. Null when refreshing failed; see errors for the reason.
errors [String!]! Errors encountered during the mutation.

secretsManagerInstanceStartTrial#

히스토리

Input type: SecretsManagerInstanceStartTrialInput

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Instance-wide Secrets Manager entitlement state after starting the trial. Null when the post-trial state cannot be resolved; query secretsManagerInstanceEntitlement instead.
errors [String!]! Errors encountered during the mutation.

secretsManagerRefreshEntitlement#

히스토리

Input type: SecretsManagerRefreshEntitlementInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to refresh the Secrets Manager entitlement for.

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Secrets Manager entitlement state as the subscription service reports it now. Null when the subscription service could not be reached; see errors.
errors [String!]! Errors encountered during the mutation.

secretsManagerStartTrial#

히스토리

Input type: SecretsManagerStartTrialInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to start a Secrets Manager trial for.

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Secrets Manager entitlement state after starting the trial. Null when the post-trial state cannot be resolved; query the group entitlement directly instead.
errors [String!]! Errors encountered during the mutation.

securityAttributeCreate#

Input type: SecurityAttributeCreateInput

Arguments#

Name Type Description
attributes [SecurityAttributeInput!]! Attributes to create.
categoryId SecurityCategoryID! Global ID of the security category.
namespaceId NamespaceID! Global ID of the namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityAttributes [SecurityAttribute!] Created security attributes.

securityAttributeDestroy#

Input type: SecurityAttributeDestroyInput

Arguments#

Name Type Description
id SecurityAttributeID! Global ID of the security attribute to destroy.

Fields#

Name Type Description
deletedAttributeGid SecurityAttributeID Global ID of the destroyed security attribute.
errors [String!]! Errors encountered during the mutation.

securityAttributeProjectUpdate#

Input type: SecurityAttributeProjectUpdateInput

Arguments#

Name Type Description
addAttributeIds [SecurityAttributeID!] Global IDs of the security attributes to add to the project.
projectId ProjectID! Global ID of the project.
removeAttributeIds [SecurityAttributeID!] Global IDs of the security attributes to remove from the project.

Fields#

Name Type Description
addedCount Int Number of attributes added.
errors [String!]! Errors encountered during the mutation.
project Project Updated project.
removedCount Int Number of attributes removed.

securityAttributeUpdate#

Input type: SecurityAttributeUpdateInput

Arguments#

Name Type Description
color Color Color of the security attribute.
description String Description of the security attribute.
id SecurityAttributeID! Global ID of the security attribute.
name String Name of the security attribute.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityAttribute SecurityAttribute Updated security attribute.

securityCategoryCreate#

Input type: SecurityCategoryCreateInput

Arguments#

Name Type Description
description String Description of the security category.
multipleSelection Boolean Whether multiple attributes can be selected.
name String! Name of the security category.
namespaceId NamespaceID! Global ID of the category namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityCategory SecurityCategory Created security category.

securityCategoryDestroy#

Input type: SecurityCategoryDestroyInput

Arguments#

Name Type Description
id SecurityCategoryID! Global ID of the security category to destroy.

Fields#

Name Type Description
deletedAttributesGid [SecurityAttributeID!] Global IDs of the deleted security attributes.
deletedCategoryGid SecurityCategoryID Global ID of the deleted security category.
errors [String!]! Errors encountered during the mutation.

securityCategoryUpdate#

Input type: SecurityCategoryUpdateInput

Arguments#

Name Type Description
description String Description of the security category.
id SecurityCategoryID! Global ID of the security category.
name String Name of the security category.
namespaceId NamespaceID! Global ID of the category namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityCategory SecurityCategory Updated security category.

securityFindingCreateIssue#

Input type: SecurityFindingCreateIssueInput

Arguments#

Name Type Description
project ProjectID! ID of the project to attach the issue to.
uuid String! UUID of the security finding to be used to create an issue.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.

securityFindingCreateMergeRequest#

Input type: SecurityFindingCreateMergeRequestInput

Arguments#

Name Type Description
uuid String! UUID of the security finding to be used to create a merge request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge Request created after mutation.

securityFindingCreateVulnerability#

히스토리

Input type: SecurityFindingCreateVulnerabilityInput

Arguments#

Name Type Description
uuid String! UUID of the security finding to be used to create a vulnerability.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability created after mutation.

securityFindingDismiss#

Input type: SecurityFindingDismissInput

Arguments#

Name Type Description
comment String Comment why finding should be dismissed.
dismissalReason VulnerabilityDismissalReason Reason why finding should be dismissed.
uuid String! UUID of the finding to be dismissed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityFinding PipelineSecurityReportFinding Dismissed finding.
uuid String UUID of dismissed finding.

securityFindingExternalIssueLinkCreate#

Input type: SecurityFindingExternalIssueLinkCreateInput

Arguments#

Name Type Description
externalTracker VulnerabilityExternalIssueLinkExternalTracker! External tracker type of the external issue link.
linkType VulnerabilityExternalIssueLinkType! Type of the external issue link.
project ProjectID! ID of the project to attach the issue to.
uuid String! UUID of the security finding to be used to create an issue.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalIssueLink VulnerabilityExternalIssueLink Created external issue link.

securityFindingJiraIssueFormUrlCreate#

히스토리

Input type: SecurityFindingJiraIssueFormUrlCreateInput

Arguments#

Name Type Description
project ProjectID! ID of the project to attach the issue to.
uuid String! UUID of the security finding to be used to create an issue.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
jiraIssueFormUrl String URL to Jira issue creation form with pre-filled vulnerability data.

securityFindingRevertToDetected#

Input type: SecurityFindingRevertToDetectedInput

Arguments#

Name Type Description
comment String Comment that explains why finding was reverted to detected status.
uuid String! UUID of the finding to be dismissed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityFinding PipelineSecurityReportFinding Finding reverted to detected.

securityFindingSeverityOverride#

Input type: SecurityFindingSeverityOverrideInput

Arguments#

Name Type Description
severity VulnerabilitySeverity! New severity value for the finding.
uuid String! UUID of the finding to modify.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityFinding PipelineSecurityReportFinding Finding of which the severity was modified.

securityPolicyProjectAssign#

Assigns the specified project(security_policy_project_id) as security policy project for the given project(full_path). If the project already has a security policy project, this reassigns the project's security policy project with the given security_policy_project_id.

Input type: SecurityPolicyProjectAssignInput

Arguments#

Name Type Description
fullPath String Full path of the project or group.
projectPath ID Deprecated in GitLab 14.10. Use fullPath.
securityPolicyProjectId ProjectID! ID of the security policy project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityPolicyProjectCreate#

Creates and assigns a security policy project for the given project or group (full_path).

Input type: SecurityPolicyProjectCreateInput

Arguments#

Name Type Description
fullPath String Full path of the project or group.
projectPath ID Deprecated in GitLab 14.10. Use fullPath.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Security Policy Project that was created.

securityPolicyProjectCreateAsync#

히스토리

Creates and assigns a security policy project for the given project or group (full_path) async.

Input type: SecurityPolicyProjectCreateAsyncInput

Arguments#

Name Type Description
fullPath String! Full path of the project or group.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityPolicyProjectUnassign#

Unassigns the security policy project for the given project (full_path).

Input type: SecurityPolicyProjectUnassignInput

Arguments#

Name Type Description
fullPath String Full path of the project or group.
projectPath ID Deprecated in GitLab 14.10. Use fullPath.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityRefsTrack#

히스토리

Input type: SecurityRefsTrackInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.
refs [SecurityRefInput!]! Array of refs to be tracked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the operation.
trackedRefs [SecurityTrackedRef!] Refs that were successfully tracked.

securityRefsUntrack#

히스토리

Input type: SecurityRefsUntrackInput

Arguments#

Name Type Description
refIds [SecurityProjectTrackedContextID!]! Global IDs of the tracked refs to stop tracking.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
untrackedRefIds [ID!] Global IDs of refs that were successfully untracked.

securityScanProfileAttach#

히스토리

Input type: SecurityScanProfileAttachInput

Arguments#

Name Type Description Default
groupIds [GroupID!] Group IDs to attach the profile to. []
projectIds [ProjectID!] Project IDs to attach the profile to. []
securityScanProfileId SecurityScanProfileID! Security scan profile ID to attach.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityScanProfileCreate#

히스토리

Input type: SecurityScanProfileCreateInput

Arguments#

Name Type Description Default
description String! Description of the scan profile.
name String! Name of the scan profile.
namespaceId NamespaceID! Global ID of the top level namespace to create the scan profile for.
scanType SecurityScanProfileType! Type of the scan profile.
stripDefaults Boolean When 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
scanProfile ScanProfileType Created scan profile.

securityScanProfileDelete#

히스토리

Input type: SecurityScanProfileDeleteInput

Arguments#

Name Type Description
id SecurityScanProfileID! Global ID of the scan profile to delete.

Fields#

Name Type Description
deletedScanProfileId SecurityScanProfileID Global ID of the deleted scan profile.
errors [String!]! Errors encountered during the mutation.

securityScanProfileDetach#

히스토리

Input type: SecurityScanProfileDetachInput

Arguments#

Name Type Description Default
groupIds [GroupID!] Group IDs to detach the profile from. []
projectIds [ProjectID!] Project IDs to detach the profile from. []
securityScanProfileId SecurityScanProfileID! Security scan profile ID to detach.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityScanProfileUpdate#

히스토리

Input type: SecurityScanProfileUpdateInput

Arguments#

Name Type Description Default
description String Description of the scan profile.
id SecurityScanProfileID! Global ID of the scan profile to update.
name String Name of the scan profile.
stripDefaults Boolean When 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
scanProfile ScanProfileType Updated scan profile.

securityTrainingUpdate#

Input type: SecurityTrainingUpdateInput

Arguments#

Name Type Description
isEnabled Boolean! Sets the training provider as enabled for the project.
isPrimary Boolean Sets the training provider as primary for the project.
projectPath ID! Full path of the project.
providerId SecurityTrainingProviderID! ID of the provider.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
training ProjectSecurityTraining Represents the training entity subject to mutation.

setContainerScanningForRegistry#

Enable/disable container scanning for registry for the given project.

Input type: SetContainerScanningForRegistryInput

Arguments#

Name Type Description
enable Boolean! Desired status for container scanning for registry feature.
namespacePath ID! Full path of the namespace (project).

Fields#

Name Type Description
containerScanningForRegistryEnabled Boolean Whether the feature is enabled.
errors [String!]! Errors encountered during the mutation.

setCvsForContainerScanning#

히스토리

Enable or disable continuous vulnerability scanning for container scanning for the given project.

Input type: SetCvsForContainerScanningInput

Arguments#

Name Type Description
enable Boolean! Desired status for CVS for container scanning.
projectPath ID! Full path of the project.

Fields#

Name Type Description
cvsForContainerScanningEnabled Boolean Whether CVS for container scanning is enabled.
errors [String!]! Errors encountered during the mutation.

setCvsForDependencyScanning#

히스토리

Enable or disable continuous vulnerability scanning for dependency scanning for the given project.

Input type: SetCvsForDependencyScanningInput

Arguments#

Name Type Description
enable Boolean! Desired status for CVS for dependency scanning.
projectPath ID! Full path of the project.

Fields#

Name Type Description
cvsForDependencyScanningEnabled Boolean Whether CVS for dependency scanning is enabled.
errors [String!]! Errors encountered during the mutation.

setGroupCustomAttribute#

히스토리

Creates or updates a custom attribute on a group. Only available to admins.

Input type: SetGroupCustomAttributeInput

Arguments#

Name Type Description
groupPath ID! Full path of the group.
key String! Key of the custom attribute.
value String! Value of the custom attribute.

Fields#

Name Type Description
customAttribute CustomAttribute Custom attribute after mutation.
errors [String!]! Errors encountered during the mutation.

setGroupSecretPushProtection#

Enable or disable secret push protection for a group.

Input type: SetGroupSecretPushProtectionInput

Arguments#

Name Type Description
namespacePath ID! Full path of the group.
projectsToExclude [Int!] IDs of projects to exclude from the feature.
secretPushProtectionEnabled Boolean! Whether to enable the feature.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

setGroupValidityChecks#

Enable or disable Validity Checks for a group.

Input type: SetGroupValidityChecksInput

Arguments#

Name Type Description
namespacePath ID! Full path of the group.
projectsToExclude [Int!] IDs of projects to exclude from validity checks configuration.
validityChecksEnabled Boolean! Whether to enable validity checks for all projects in the group.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
validityChecksEnabled Boolean! Indicates whether validity checks have been enabled for the group.

setLicenseConfigurationSource#

Set the license information source for a given project.

Input type: SetLicenseConfigurationSourceInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.
source SecurityPreferredLicenseSourceConfiguration! Preferred source of license information for dependencies.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
licenseConfigurationSource SecurityPreferredLicenseSourceConfiguration Preferred source of license information for dependencies.

setLicenseScanningForCyclonedx#

Enable/disable license scanning for CycloneDX SBOM files for the given project.

Input type: SetLicenseScanningForCyclonedxInput

Arguments#

Name Type Description
enable Boolean! Desired status for license scanning for CycloneDX files.
projectPath ID! Full path of the project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
licenseScanningForCyclonedxEnabled Boolean Whether license scanning for CycloneDX files is enabled.

setPagesForceHttps#

Input type: SetPagesForceHttpsInput

Arguments#

Name Type Description
projectPath ID! Path of the project to set the pages force HTTPS.
value Boolean! Indicates user wants to enforce HTTPS on their pages.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project that was updated.

setPagesUseUniqueDomain#

Input type: SetPagesUseUniqueDomainInput

Arguments#

Name Type Description
projectPath ID! Path of the project to set the pages to use unique domains.
value Boolean! Indicates user wants to use unique subdomains for their pages.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project that was updated.

setPreReceiveSecretDetection#

Enable/disable secret push protection for the given project.

Input type: SetPreReceiveSecretDetectionInput

Arguments#

Name Type Description
enable Boolean! Desired status for secret push protection feature.
namespacePath ID! Full path of the namespace (project).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
preReceiveSecretDetectionEnabled Boolean Whether the feature is enabled.
secretPushProtectionEnabled Boolean Whether the feature is enabled.

setSecretPushProtection#

Enable/disable secret push protection for the given project.

Input type: SetSecretPushProtectionInput

Arguments#

Name Type Description
enable Boolean! Desired status for secret push protection feature.
namespacePath ID! Full path of the namespace (project).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
preReceiveSecretDetectionEnabled Boolean Whether the feature is enabled.
secretPushProtectionEnabled Boolean Whether the feature is enabled.

setValidityChecks#

Enable/disable secret detection validity checks for the given project.

Input type: SetValidityChecksInput

Arguments#

Name Type Description
enable Boolean! Desired status for validity checks feature.
namespacePath ID! Full path of the namespace (project).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
validityChecksEnabled Boolean Whether the feature is enabled.

starProject#

히스토리

Input type: StarProjectInput

Arguments#

Name Type Description
projectId ProjectID! Full path of the project to star or unstar.
starred Boolean! Indicates whether to star or unstar the project.

Fields#

Name Type Description
count String! Number of stars for the project.
errors [String!]! Errors encountered during the mutation.

startVulnerabilityWorkflow#

히스토리

Creates and starts a vulnerability workflow execution.

Input type: StartVulnerabilityWorkflowInput

Arguments#

Name Type Description
findingUuids [String!] Finding UUIDs to process, up to 1000. If omitted, all project findings are processed.
projectId ProjectID! Global ID of the project.
severities [VulnerabilitySeverity!] Severities to process. If omitted, all severities are processed.
workflow VulnerabilityDuoWorkflow! Workflow to execute.

Fields#

Name Type Description
errorReason VulnerabilityWorkflowErrorReason Machine-readable reason for the mutation error.
errors [String!]! Errors encountered during the mutation.
execution VulnerabilityWorkflowExecution Workflow execution.

tagCreate#

Creates a tag in a project repository. Rate limited per project by the tags_create_limit application setting.

Input type: TagCreateInput

Arguments#

Name Type Description Default
message String Tagging message. ""
name String! Name of the tag.
projectPath ID! Project full path the branch is associated with.
ref String! Tag name or commit SHA to create tag from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
tag Tag Tag after mutation.

tagDelete#

Input type: TagDeleteInput

Arguments#

Name Type Description
name String! Name of the tag.
projectPath ID! Project full path the branch is associated with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
tag Tag Tag after mutation.

terraformStateDelete#

Input type: TerraformStateDeleteInput

Arguments#

Name Type Description
id TerraformStateID! Global ID of the Terraform state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

terraformStateLock#

Input type: TerraformStateLockInput

Arguments#

Name Type Description
id TerraformStateID! Global ID of the Terraform state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

terraformStateUnlock#

Input type: TerraformStateUnlockInput

Arguments#

Name Type Description
id TerraformStateID! Global ID of the Terraform state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

timelineEventCreate#

히스토리

Input type: TimelineEventCreateInput

Arguments#

Name Type Description
incidentId IssueID! Incident ID of the timeline event.
note String! Text note of the timeline event.
occurredAt Time! Timestamp of when the event occurred.
timelineEventTagNames [String!] Tags for the incident timeline event.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEvent TimelineEventType Timeline event.

timelineEventDestroy#

Input type: TimelineEventDestroyInput

Arguments#

Name Type Description
id IncidentManagementTimelineEventID! Timeline event ID to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEvent TimelineEventType Timeline event.

timelineEventPromoteFromNote#

Input type: TimelineEventPromoteFromNoteInput

Arguments#

Name Type Description
noteId NoteID! Note ID from which the timeline event promoted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEvent TimelineEventType Timeline event.

timelineEventTagCreate#

Input type: TimelineEventTagCreateInput

Arguments#

Name Type Description
name String! Name of the tag.
projectPath ID! Project to create the timeline event tag in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEventTag TimelineEventTagType Timeline event tag.

timelineEventUpdate#

Input type: TimelineEventUpdateInput

Arguments#

Name Type Description
id IncidentManagementTimelineEventID! ID of the timeline event to update.
note String Text note of the timeline event.
occurredAt Time Timestamp when the event occurred.
timelineEventTagNames [String!] Tags for the incident timeline event.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEvent TimelineEventType Timeline event.

timelogCreate#

Input type: TimelogCreateInput

Arguments#

Name Type Description
issuableId IssuableID! Global ID of the issuable (Issue, WorkItem or MergeRequest).
spentAt Time Timestamp of when the time was spent. If empty, defaults to current time.
summary String! Summary of time spent.
timeSpent String! Amount of time spent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelog Timelog Timelog.

timelogDelete#

Input type: TimelogDeleteInput

Arguments#

Name Type Description
id TimelogID! Global ID of the timelog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelog Timelog Timelog.

todoCreate#

Input type: TodoCreateInput

Arguments#

Name Type Description
targetId TodoableID! Global ID of the to-do item's parent. Issues, merge requests, designs, and epics are supported.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo To-do item created.

todoDeleteAllDone#

히스토리

Input type: TodoDeleteAllDoneInput

Arguments#

Name Type Description
updatedBefore Time To-do items marked as done before the timestamp will be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

todoDeleteMany#

히스토리

Input type: TodoDeleteManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

todoMarkDone#

Input type: TodoMarkDoneInput

Arguments#

Name Type Description
id TodoID! Global ID of the to-do item to mark as done.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo! Requested to-do item.

todoResolveMany#

히스토리

Input type: TodoResolveManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Resolved to-do items.

todoRestore#

Input type: TodoRestoreInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo! Requested to-do item.

todoRestoreMany#

Input type: TodoRestoreManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Restored to-do items.

todoSnooze#

히스토리

Input type: TodoSnoozeInput

Arguments#

Name Type Description
id TodoID! Global ID of the to-do item to be snoozed.
snoozeUntil Time! Time until which the todo should be snoozed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo! Requested to-do item.

todoSnoozeMany#

히스토리

Input type: TodoSnoozeManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).
snoozeUntil Time! Time until which the todos should be snoozed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Snoozed to-do items.

todoUnSnooze#

히스토리

Input type: TodoUnSnoozeInput

Arguments#

Name Type Description
id TodoID! Global ID of the to-do item to be snoozed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo! Requested to-do item.

todoUnsnoozeMany#

히스토리

Input type: TodoUnsnoozeManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Unsnoozed to-do items.

todosMarkAllDone#

Input type: TodosMarkAllDoneInput

Arguments#

Name Type Description
action [TodoActionEnum!] Action to be filtered.
authorId [ID!] ID of an author.
groupId [ID!] ID of a group.
projectId [ID!] ID of a project.
targetId TodoableID Global 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Updated to-do items.

unlinkProjectComplianceViolationIssue#

히스토리

Input type: UnlinkProjectComplianceViolationIssueInput

Arguments#

Name Type Description
issueIid String! IID of the issue to be unlinked.
projectPath ID! Full path of the project the issue belongs to.
violationId ComplianceManagementProjectsComplianceViolationID! Global ID of the project compliance violation.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
violation ProjectComplianceViolation Updated project compliance violation.

updateAiToolRule#

히스토리

Updates the permission settings for an AI tool rule.

Input type: UpdateAiToolRuleInput

Arguments#

Name Type Description
backgroundAccess AiBackgroundToolPermission Introduced as an experiment in GitLab 19.3.

Permission mode for the background-flow surface.
fullPath ID! Full path of the root namespace to update the tool rule for.
localAccess AiToolPermission Permission mode for local or IDE surface.
projectPath ID Full 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.
toolId String! Tool name string identifying the tool to update. For example, "create_issue".
unsetAccessTypes [AiToolAccessType!] Introduced as an experiment in GitLab 19.5.

Access types to clear so they fall back to their defaults. The rule is deleted when every access type is unset.
webAccess AiToolPermission Permission mode for web surface.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
toolRule AiToolRule Updated tool rule after mutation.

updateAlertStatus#

Input type: UpdateAlertStatusInput

Arguments#

Name Type Description
iid String! IID of the alert to mutate.
projectPath ID! Project the alert to mutate is in.
status AlertManagementStatus! Status to set the alert.

Fields#

Name Type Description
alert AlertManagementAlert Alert after mutation.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.
todo Todo To-do item after mutation.

updateBoard#

Input type: UpdateBoardInput

Arguments#

Name Type Description
assigneeId UserID ID of user to be assigned to the board.
hideBacklogList Boolean Whether or not backlog list is hidden.
hideClosedList Boolean Whether or not closed list is hidden.
id BoardID! Board global ID.
iterationCadenceId IterationsCadenceID ID of iteration cadence to be assigned to the board.
iterationId IterationID ID of iteration to be assigned to the board.
labelIds [LabelID!] IDs of labels to be added to the board.
labels [String!] Labels of the issue.
milestoneId MilestoneID ID of milestone to be assigned to the board.
name String Board name.
weight Int Weight value to be assigned to the board.

Fields#

Name Type Description
board Board Board after mutation.
errors [String!]! Errors encountered during the mutation.

updateBoardEpicUserPreferences#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: UpdateBoardEpicUserPreferencesInput

Arguments#

Name Type Description
boardId BoardID! Board global ID.
collapsed Boolean! Whether the epic should be collapsed in the board.
epicId EpicID! ID of an epic to set preferences for.

Fields#

Name Type Description
epicUserPreferences BoardEpicUserPreferences User preferences for the epic in the board after mutation.
errors [String!]! Errors encountered during the mutation.

updateBoardList#

Input type: UpdateBoardListInput

Arguments#

Name Type Description
collapsed Boolean Indicates if the list is collapsed for the user.
listId ListID! Global ID of the list.
position Int Position of list within the board.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list BoardList Mutated list.

updateComplianceFramework#

Input type: UpdateComplianceFrameworkInput

Arguments#

Name Type Description
id ComplianceManagementFrameworkID! Global ID of the compliance framework to update.
params ComplianceFrameworkInput! Parameters to update the compliance framework with.

Fields#

Name Type Description
complianceFramework ComplianceFramework Compliance framework after mutation.
errors [String!]! Errors encountered during the mutation.

updateComplianceRequirement#

히스토리

Input type: UpdateComplianceRequirementInput

Arguments#

Name Type Description
controls [ComplianceRequirementsControlInput!] Controls to add or update to the compliance requirement.
id ComplianceManagementComplianceFrameworkComplianceRequirementID! Global ID of the compliance requirement to update.
params ComplianceRequirementInput! Parameters to update the compliance requirement with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirement ComplianceRequirement Compliance requirement after updation.

updateComplianceRequirementsControl#

히스토리

Input type: UpdateComplianceRequirementsControlInput

Arguments#

Name Type Description
id ComplianceManagementComplianceFrameworkComplianceRequirementsControlID! Global ID of the compliance requirement control to update.
params ComplianceRequirementsControlInput! Parameters to update the compliance requirement control with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirementsControl ComplianceRequirementsControl Compliance requirement control after updation.

updateContainerExpirationPolicy#

Input type: UpdateContainerExpirationPolicyInput

Arguments#

Name Type Description
cadence ContainerExpirationPolicyCadenceEnum Schedule of the container expiration policy.
enabled Boolean Indicates whether the container expiration policy is enabled.
keepN ContainerExpirationPolicyKeepEnum Number of tags to retain.
nameRegex UntrustedRegexp Tags with names matching the regex pattern will expire.
nameRegexKeep UntrustedRegexp Tags with names matching the regex pattern will be preserved.
olderThan ContainerExpirationPolicyOlderThanEnum Tags older than the given age will expire.
projectPath ID! Project path where the container expiration policy is located.

Fields#

Name Type Description
containerExpirationPolicy ContainerExpirationPolicy Deprecated in GitLab 17.5. Use container_tags_expiration_policy.
containerTagsExpirationPolicy ContainerTagsExpirationPolicy Container tags expiration policy after mutation.
errors [String!]! Errors encountered during the mutation.

updateContainerProtectionRepositoryRule#

Updates a container repository protection rule that controls who can modify container images based on user roles.

Input type: UpdateContainerProtectionRepositoryRuleInput

Arguments#

Name Type Description
id ContainerRegistryProtectionRuleID! Global ID of the container repository protection rule to be updated.
minimumAccessLevelForDelete ContainerProtectionRepositoryRuleAccessLevel Introduced as an experiment 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.
minimumAccessLevelForPush ContainerProtectionRepositoryRuleAccessLevel Minimum 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.
repositoryPathPattern String 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.

Fields#

Name Type Description
containerProtectionRepositoryRule ContainerProtectionRepositoryRule Container repository protection rule after mutation.
errors [String!]! Errors encountered during the mutation.

updateContainerProtectionTagRule#

히스토리

Updates a protection rule that controls which user roles can modify container image tags matching a specified pattern.

Input type: UpdateContainerProtectionTagRuleInput

Arguments#

Name Type Description
id ContainerRegistryProtectionTagRuleID! Global ID of the tag protection rule to update.
minimumAccessLevelForDelete ContainerProtectionTagRuleAccessLevel Minimum 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.
minimumAccessLevelForPush ContainerProtectionTagRuleAccessLevel Minimum 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.
tagNamePattern String The pattern that matches container image tags to protect. For example, v1.*. Wildcard character * allowed.

Fields#

Name Type Description
containerProtectionTagRule ContainerProtectionTagRule Protection rule for container image tags after creation.
errors [String!]! Errors encountered during the mutation.

updateCustomDashboard#

히스토리

Updates a custom dashboard.

Input type: UpdateCustomDashboardInput

Arguments#

Name Type Description
config CustomDashboardConfigInput Dashboard layout/config.
description String Dashboard description.
id AnalyticsCustomDashboardsDashboardID! Global ID of the dashboard to update.
name String Dashboard name.

Fields#

Name Type Description
dashboard CustomDashboard Updated dashboard.
errors [String!]! Errors encountered during update.

updateDependencyProxyImageTtlGroupPolicy#

These settings can be adjusted only by the group Owner.

Input type: UpdateDependencyProxyImageTtlGroupPolicyInput

Arguments#

Name Type Description
enabled Boolean Indicates whether the policy is enabled or disabled.
groupPath ID! Group path for the group dependency proxy image TTL policy.
ttl Int Number of days to retain a cached image file.

Fields#

Name Type Description
dependencyProxyImageTtlPolicy DependencyProxyImageTtlGroupPolicy Group image TTL policy after mutation.
errors [String!]! Errors encountered during the mutation.

updateDependencyProxyPackagesSettings#

Updates or creates dependency proxy for packages settings. Requires the packages and dependency proxy to be enabled in the config. Requires the packages feature to be enabled at the project level.

Input type: UpdateDependencyProxyPackagesSettingsInput

Arguments#

Name Type Description
enabled Boolean Indicates whether the dependency proxy for packages is enabled for the project.
mavenExternalRegistryPassword String Password for the external Maven packages registry. Introduced in 16.5: This feature is an Experiment. It can be changed or removed at any time.
mavenExternalRegistryUrl String URL for the external Maven packages registry.
mavenExternalRegistryUsername String Username for the external Maven packages registry.
projectPath ID! Project path for the dependency proxy for packages settings.

Fields#

Name Type Description
dependencyProxyPackagesSetting DependencyProxyPackagesSetting Dependency proxy for packages settings after mutation.
errors [String!]! Errors encountered during the mutation.

updateDependencyProxySettings#

These settings can be adjusted only by the group Owner.

Input type: UpdateDependencyProxySettingsInput

Arguments#

Name Type Description
enabled Boolean Indicates whether the policy is enabled or disabled.
groupPath ID! Group path for the group dependency proxy.
identity String Identity 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)).
secret String Secret credential used to authenticate with Docker Hub when pulling images. Can be a password, personal access token (PAT), or organization access token (OAT).

Fields#

Name Type Description
dependencyProxySetting DependencyProxySetting Group dependency proxy settings after mutation.
errors [String!]! Errors encountered during the mutation.

updateDuoWorkflowAgentPrivileges#

히스토리

Input type: UpdateDuoWorkflowAgentPrivilegesInput

Arguments#

Name Type Description
agentPrivileges [Int!] Replaces the set of actions the agent is allowed to perform.
preApprovedAgentPrivileges [Int!] Replaces the set of actions the agent can perform without asking for approval.
workflowId AiDuoWorkflowsWorkflowID! Global ID of the workflow to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during update.
workflow DuoWorkflow Updated workflow.

updateDuoWorkflowToolCallApprovals#

히스토리

Input type: UpdateDuoWorkflowToolCallApprovalsInput

Arguments#

Name Type Description
approvalSource DuoWorkflowToolCallApprovalSource Introduced as an experiment in GitLab 19.3.

Source of the approval decision, for audit purposes.
pattern String Glob pattern to approve for matching tool call arguments.
toolCallArgs JSON Arguments for the tool call.
toolName String! Name of the tool to approve.
workflowId AiDuoWorkflowsWorkflowID! Global ID of the workflow to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during update.
workflow DuoWorkflow Updated workflow with new tool approvals.

updateDuoWorkflowWebSearch#

히스토리

Input type: UpdateDuoWorkflowWebSearchInput

Arguments#

Name Type Description
webSearchEnabled Boolean! Whether web search should be enabled for the session.
workflowId AiDuoWorkflowsWorkflowID! Global ID of the workflow to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during update.
workflow DuoWorkflow Updated workflow.

updateEpic#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: UpdateEpicInput

Arguments#

Name Type Description
addLabelIds [ID!] IDs of labels to be added to the epic.
addLabels [String!] Array of labels to be added to the epic.
color Color Color of the epic.
confidential Boolean Indicates if the epic is confidential.
description String Description of the epic.
dueDateFixed String End date of the epic.
dueDateIsFixed Boolean Indicates end date should be sourced from due_date_fixed field not the issue milestones.
groupPath ID! Group the epic to mutate is in.
iid ID! 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.
startDateFixed String Start date of the epic.
startDateIsFixed Boolean Indicates start date should be sourced from start_date_fixed field not the issue milestones.
stateEvent EpicStateEvent State event for the epic.
title String Title of the epic.

Fields#

Name Type Description
epic Epic Epic after mutation.
errors [String!]! Errors encountered during the mutation.

updateEpicBoardList#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: UpdateEpicBoardListInput

Arguments#

Name Type Description
collapsed Boolean Indicates if the list is collapsed for the user.
listId BoardsEpicListID! Global ID of the epic list.
position Int Position of list within the board.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list EpicList Mutated epic list.

updateImageDiffNote#

Updates a DiffNote on an image (a Note where the position.positionType is "image"). If the body of the Note contains only quick actions, the Note will be destroyed during an update, and no Note will be returned.

Input type: UpdateImageDiffNoteInput

Arguments#

Name Type Description
body String Content of the note.
id NoteID! Global ID of the note to update.
position UpdateDiffImagePositionInput Position of the note on a diff.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

updateIssue#

Input type: UpdateIssueInput

Arguments#

Name Type Description
addLabelIds [ID!] IDs of labels to be added to the issue.
confidential Boolean Indicates the issue is confidential.
description String Description of the issue.
dueDate ISO8601Date Due date of the issue.
epicId EpicID Deprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
healthStatus HealthStatus Desired health status.
iid String! IID of the issue to mutate.
labelIds [ID!] IDs of labels to be set. Replaces existing issue labels.
locked Boolean Indicates discussion is locked on the issue.
milestoneId ID ID 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.
projectPath ID! Project the issue to mutate is in.
removeLabelIds [ID!] IDs of labels to be removed from the issue.
stateEvent IssueStateEvent Close or reopen an issue.
timeEstimate String Estimated time to complete the issue. Use null or 0 to remove the current estimate.
title String Title of the issue.
type IssueType Type of the issue.
weight Int Weight of the issue.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

updateIteration#

Input type: UpdateIterationInput

Arguments#

Name Type Description
description String Description of the iteration.
dueDate String End date of the iteration.
groupPath ID! Group of the iteration.
id ID! Global ID of the iteration.
startDate String Start date of the iteration.
title String Title of the iteration.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iteration Iteration Updated iteration.

updateNamespacePackageSettings#

These settings can be adjusted only by the group Owner.

Input type: UpdateNamespacePackageSettingsInput

Arguments#

Name Type Description
auditEventsEnabled Boolean Indicates whether audit events are created when publishing or deleting a package in the namespace (Premium and Ultimate only).
genericDuplicateExceptionRegex UntrustedRegexp When 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.
genericDuplicatesAllowed Boolean Indicates whether duplicate generic packages are allowed for the namespace.
lockMavenPackageRequestsForwarding Boolean Indicates whether Maven package forwarding is locked for all descendent namespaces.
lockNpmPackageRequestsForwarding Boolean Indicates whether npm package forwarding is locked for all descendent namespaces.
lockPypiPackageRequestsForwarding Boolean Indicates whether PyPI package forwarding is locked for all descendent namespaces.
lockRubygemsPackageRequestsForwarding Boolean Indicates whether RubyGems package forwarding is locked for all descendent namespaces.
mavenDuplicateExceptionRegex UntrustedRegexp When 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.
mavenDuplicatesAllowed Boolean Indicates whether duplicate Maven packages are allowed for the namespace.
mavenPackageRequestsForwarding Boolean Indicates whether Maven package forwarding is allowed for the namespace.
namespacePath ID! Namespace path where the namespace package setting is located.
npmPackageRequestsForwarding Boolean Indicates whether npm package forwarding is allowed for the namespace.
nugetDuplicateExceptionRegex UntrustedRegexp When 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.
nugetDuplicatesAllowed Boolean Indicates whether duplicate NuGet packages are allowed for the namespace.
nugetSymbolServerEnabled Boolean Indicates whether the NuGet symbol server is enabled for the namespace.
pypiPackageRequestsForwarding Boolean Indicates whether PyPI package forwarding is allowed for the namespace.
rubygemsPackageRequestsForwarding Boolean Indicates whether RubyGems package forwarding is allowed for the namespace.
terraformModuleDuplicateExceptionRegex UntrustedRegexp When 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.
terraformModuleDuplicatesAllowed Boolean Indicates whether duplicate Terraform packages are allowed for the namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packageSettings PackageSettings Namespace package setting after mutation.

updateNote#

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

Input type: UpdateNoteInput

Arguments#

Name Type Description
body String Content of the note.
id NoteID! Global ID of the note to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

updatePackagesCleanupPolicy#

Input type: UpdatePackagesCleanupPolicyInput

Arguments#

Name Type Description
keepNDuplicatedPackageFiles PackagesCleanupKeepDuplicatedPackageFilesEnum Number of duplicated package files to retain.
projectPath ID! Project path where the packages cleanup policy is located.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packagesCleanupPolicy PackagesCleanupPolicy Packages cleanup policy after mutation.

updatePackagesProtectionRule#

Updates a package protection rule to restrict access to project packages. You can prevent users without certain permissions from altering packages.

Input type: UpdatePackagesProtectionRuleInput

Arguments#

Name Type Description
id PackagesProtectionRuleID! Global ID of the package protection rule to be updated.
minimumAccessLevelForDelete PackagesProtectionRuleAccessLevelForDelete Introduced as an experiment 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.
minimumAccessLevelForPush PackagesProtectionRuleAccessLevel Minimum 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.
packageNamePattern String Package name protected by the protection rule. For example, @my-scope/my-package-*. Wildcard character * allowed.
packageType PackagesProtectionRulePackageType Package type protected by the protection rule. For example, NPM, PYPI.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packageProtectionRule PackagesProtectionRule Packages protection rule after mutation.

updateProjectComplianceViolation#

히스토리

Input type: UpdateProjectComplianceViolationInput

Arguments#

Name Type Description
id ComplianceManagementProjectsComplianceViolationID! Global ID of the project compliance violation to update.
status ComplianceViolationStatus! New status for the project compliance violation.

Fields#

Name Type Description
complianceViolation ProjectComplianceViolation Compliance violation after status update.
errors [String!]! Errors encountered during the mutation.

updateRequirement#

Input type: UpdateRequirementInput

Arguments#

Name Type Description
description String Description of the requirement.
iid String Deprecated in GitLab 15.8. Use work_item_iid instead.
lastTestReportState TestReportState Creates a test report for the requirement with the given state.
projectPath ID! Full project path the requirement is associated with.
state RequirementState State of the requirement.
title String Title of the requirement.
workItemIid String IID of the requirement work item to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirement Requirement Requirement after mutation.

updateSnippet#

Input type: UpdateSnippetInput

Arguments#

Name Type Description
blobActions [SnippetBlobActionInputType!] Actions to perform over the snippet repository and blobs.
description String Description of the snippet.
id SnippetID! Global ID of the snippet to update.
title String Title of the snippet.
visibilityLevel VisibilityLevelsEnum Visibility level of the snippet.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
snippet Snippet Snippet after mutation.

updateTerraformStateProtectionRule#

히스토리

Updates a protection rule for a Terraform state backend.

Input type: UpdateTerraformStateProtectionRuleInput

Arguments#

Name Type Description
allowedFrom TerraformStateProtectionRuleAllowedFrom Introduced as an experiment 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.
id TerraformStateProtectionRuleID! Global ID of the Terraform state protection rule to update.
minimumAccessLevelForWrite TerraformStateProtectionRuleAccessLevel Introduced as an experiment 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.
stateName String Introduced as an experiment in GitLab 18.11.

Terraform state name protected by the rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
terraformStateProtectionRule TerraformStateProtectionRule Introduced as an experiment in GitLab 18.11.

Terraform state protection rule after mutation.

updateVirtualRegistriesSetting#

히스토리

Updates or creates virtual registries settings for a root group.

Input type: UpdateVirtualRegistriesSettingInput

Arguments#

Name Type Description
enabled Boolean Enable or disable the virtual registries.
fullPath ID! Group path for the group virtual registries.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
virtualRegistriesSetting VirtualRegistriesSetting Virtual registries settings after mutation.

uploadCreate#

히스토리

Creates an upload (uploads a file to a project or group for use in Markdown).

Input type: UploadCreateInput

Arguments#

Name Type Description
file Upload! File to upload.
groupPath ID Full path of the group with which the resource is associated.
projectPath ID Full path of the project with which the resource is associated.

Fields#

Name Type Description
alt String Alt text for the uploaded file. Usually the name of the file.
errors [String!]! Errors encountered during the mutation.
fullPath String Full path to the file.
markdown String Markdown-formatted link to the file.
upload FileUpload Uploaded file.
url String URL to access the file.

uploadDelete#

Deletes an upload.

Input type: UploadDeleteInput

Arguments#

Name Type Description
filename String! Upload filename.
groupPath ID Full path of the group with which the resource is associated.
projectPath ID Full path of the project with which the resource is associated.
secret String! Secret part of upload path.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upload FileUpload Deleted upload.

upsertFlatUserCap#

Update the flat per-user budget cap for a subscription.

Input type: UpsertFlatUserCapInput

Arguments#

Name Type Description
flatUserCap Float! Default per-user budget cap applied to all users.
flatUserCapEnabled Boolean! Whether the flat per-user budget cap is enabled.
namespacePath String Path of the top-level group namespace. Omit for self-managed instance scope.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
flatUserCap Float Updated flat per-user budget cap.
flatUserCapEnabled Boolean Whether the flat per-user budget cap is enabled.

upsertUserBudgetCapOverrides#

Bulk upsert per-user budget cap overrides.

Input type: UpsertUserBudgetCapOverridesInput

Arguments#

Name Type Description
namespacePath String Path of the top-level group namespace. Omit for self-managed instance scope.
overrides [BudgetCapUserOverrideInput!]! List of per-user budget cap overrides to upsert.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userOverrides [GitlabSubscriptionBudgetCapUserOverride!] Updated user budget cap overrides.

userAchievementPrioritiesUpdate#

Input type: UserAchievementPrioritiesUpdateInput

Arguments#

Name Type Description
userAchievementIds [AchievementsUserAchievementID!]! Global IDs of the user achievements being prioritized, ordered from highest to lowest priority.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievements [UserAchievement!]! Updated user achievements.

userAchievementsDelete#

Input type: UserAchievementsDeleteInput

Arguments#

Name Type Description
userAchievementId AchievementsUserAchievementID! Global ID of the user achievement being deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievement UserAchievement Deleted user achievement.

userAchievementsUpdate#

Input type: UserAchievementsUpdateInput

Arguments#

Name Type Description
awardMessage String Message to associate with the awarded achievement.
showOnProfile Boolean Indicates whether or not the user achievement is visible on the profile.
userAchievementId AchievementsUserAchievementID! Global ID of the user achievement being updated.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievement UserAchievement Achievement award.

userAddOnAssignmentBulkCreate#

Input type: UserAddOnAssignmentBulkCreateInput

Arguments#

Name Type Description
addOnPurchaseId GitlabSubscriptionsAddOnPurchaseID! Global ID of AddOnPurchase to be assigned to.
userIds [UserID!]! Global IDs of user to be assigned.

Fields#

Name Type Description
addOnPurchase AddOnPurchase AddOnPurchase state after mutation.
errors [String!]! Errors encountered during the mutation.
users AddOnUserConnection Users who the add-on purchase was assigned to. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.

userAddOnAssignmentBulkRemove#

Input type: UserAddOnAssignmentBulkRemoveInput

Arguments#

Name Type Description
addOnPurchaseId GitlabSubscriptionsAddOnPurchaseID! Global ID of AddOnPurchase to be unassigned from.
userIds [UserID!]! Global IDs of user to be unassigned.

Fields#

Name Type Description
addOnPurchase AddOnPurchase AddOnPurchase state after mutation.
errors [String!]! Errors encountered during the mutation.
users AddOnUserConnection Users who was unassigned from the add-on purchase. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.

userAddOnAssignmentCreate#

Input type: UserAddOnAssignmentCreateInput

Arguments#

Name Type Description
addOnPurchaseId GitlabSubscriptionsAddOnPurchaseID! Global ID of AddOnPurchase to be assigned to.
userId UserID! Global ID of user to be assigned.

Fields#

Name Type Description
addOnPurchase AddOnPurchase AddOnPurchase state after mutation.
errors [String!]! Errors encountered during the mutation.
user AddOnUser User who the add-on purchase was assigned to.

userAddOnAssignmentRemove#

Input type: UserAddOnAssignmentRemoveInput

Arguments#

Name Type Description
addOnPurchaseId GitlabSubscriptionsAddOnPurchaseID! Global ID of AddOnPurchase assignment belongs to.
userId UserID! Global ID of user whose assignment will be removed.

Fields#

Name Type Description
addOnPurchase AddOnPurchase AddOnPurchase state after mutation.
errors [String!]! Errors encountered during the mutation.
user AddOnUser User that the add-on was removed from.

userCalloutCreate#

Input type: UserCalloutCreateInput

Arguments#

Name Type Description
featureName String! Feature name you want to dismiss the callout for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userCallout UserCallout! User callout dismissed.

userCustomAttributeSet#

히스토리

Creates or updates a custom attribute on a user. Only available to admins.

Input type: UserCustomAttributeSetInput

Arguments#

Name Type Description
key String! Key of the custom attribute.
userId UserID! Global ID of the user.
value String! Value of the custom attribute.

Fields#

Name Type Description
customAttribute CustomAttribute Custom attribute after mutation.
errors [String!]! Errors encountered during the mutation.

userGroupCalloutCreate#

Input type: UserGroupCalloutCreateInput

Arguments#

Name Type Description
featureName String! Feature name you want to dismiss the callout for.
groupId GroupID! Group for the callout.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userGroupCallout UserGroupCallout! User group callout dismissed.

userPreferencesUpdate#

Input type: UserPreferencesUpdateInput

Arguments#

Name Type Description
duoDefaultNamespaceId Int Default namespace context for Duo features when namespace can not be inferred.
extensionsMarketplaceOptInStatus ExtensionsMarketplaceOptInStatus Status of the Web IDE Extension Marketplace opt-in for the user.
issuesSort IssueSort Sort order for issue lists.
knowledgeGraphGoverningNamespaceId Int Governing and billing namespace for Orbit.
mergeRequestDashboardListType MergeRequestsDashboardListType Merge request dashboard list rendering type.
mergeRequestDashboardShowDrafts Boolean Show draft merge requests on the merge request dashboard.
mergeRequestsSort MergeRequestSort Sort order for issue lists.
orbitSettings JSON Introduced as an experiment in GitLab 19.0.

Orbit agent settings, e.g.: "{ enabled: false }".
organizationGroupsProjectsDisplay OrganizationGroupProjectDisplay Introduced as an experiment in GitLab 17.2.

Default list view for organization groups and projects.
organizationGroupsProjectsSort OrganizationGroupProjectSort Introduced as an experiment in GitLab 17.2.

Sort order for organization groups and projects.
projectsSort ProjectSort Sort order for projects.
useWorkItemsView Boolean Deprecated in GitLab 19.5. Work item view is always used.
visibilityPipelineIdType VisibilityPipelineIdType Determines whether the pipeline list shows ID or IID.
wikiUseAutoCommitMessage Boolean Introduced as an experiment 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.
workItemsDisplaySettings JSON Introduced as an experiment in GitLab 18.1.

Display settings for the work item lists, e.g.: "{ shouldOpenItemsInSidePanel: false }".

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userPreferences UserPreferences User preferences after mutation.

userSetNamespaceCommitEmail#

Input type: UserSetNamespaceCommitEmailInput

Arguments#

Name Type Description
emailId EmailID ID of the email to set.
namespaceId NamespaceID! ID of the namespace to set the namespace commit email for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceCommitEmail NamespaceCommitEmail User namespace commit email after mutation.

valueStreamCreate#

히스토리

Creates a value stream.

Input type: ValueStreamCreateInput

Arguments#

Name Type Description
name String! Value stream name.
namespacePath ID! Full path of the namespace(project or group) the value stream is created in.
setting ValueStreamSettingInput Value stream configuration.
stages [CreateValueStreamStageInput!] Value stream stages.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
valueStream ValueStream Created value stream.

valueStreamDestroy#

히스토리

Destroy a value stream.

Input type: ValueStreamDestroyInput

Arguments#

Name Type Description
id AnalyticsCycleAnalyticsValueStreamID! Global ID of the value stream to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
valueStream ValueStream Value stream deleted after mutation.

valueStreamUpdate#

히스토리

Updates a value stream.

Input type: ValueStreamUpdateInput

Arguments#

Name Type Description
id AnalyticsCycleAnalyticsValueStreamID! Global ID of the value stream to update.
name String Value stream name.
setting ValueStreamSettingInput Value stream configuration.
stages [UpdateValueStreamStageInput!] Value stream stages.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
valueStream ValueStream Updated value stream.

verifiedNamespaceCreate#

Create a verified namespace and mark all child catalog resources with the passed verification level info.

Input type: VerifiedNamespaceCreateInput

Arguments#

Name Type Description
namespacePath ID! Root namespace path.
verificationLevel CiCatalogResourceVerificationLevel! Verification level for a root namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

virtualRegistriesCleanupPolicyUpsert#

히스토리

Create or update virtual registries cleanup policy for a root group.

Input type: VirtualRegistriesCleanupPolicyUpsertInput

Arguments#

Name Type Description
cadence Int Job cadence for the cleanup process. Allowed values are 1, 7, 14, 30, 90. Default is 7.
enabled Boolean Enable or disable the virtual registries cleanup policy. Default is false.
fullPath ID! Group path for the group virtual registries.
keepNDaysAfterDownload Int Keep packages for the period after download. Range is 1-365. Default is 30.
notifyOnFailure Boolean Whether to notify group owners when cleanup runs fail. Default is false.
notifyOnSuccess Boolean Whether to notify group owners when cleanup runs succeed. Default is false.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
virtualRegistriesCleanupPolicy VirtualRegistryCleanupPolicy Virtual registries cleanup policy after mutation.

vulnerabilitiesArchive#

히스토리

Input type: VulnerabilitiesArchiveInput

Arguments#

Name Type Description
date Date! Last update date of vulnerabilities being archived.
projectId ProjectID! ID of the project to attach the vulnerability to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
status String! Status of the action.

vulnerabilitiesCreateIssue#

히스토리

Input type: VulnerabilitiesCreateIssueInput

Arguments#

Name Type Description
project ProjectID! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.

vulnerabilitiesDismiss#

Input type: VulnerabilitiesDismissInput

Arguments#

Name Type Description
comment String Comment why vulnerability was dismissed (maximum 50,000 characters).
dismissalReason VulnerabilityDismissalReason Reason why vulnerability should be dismissed.
vulnerabilityIds [VulnerabilityID!]! IDs of the vulnerabilities to be dismissed (maximum 100 entries).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerabilities [Vulnerability!]! Vulnerabilities after state change.

vulnerabilitiesRemoveAllFromProject#

Remove all Vulnerabilities and related information from a given project. Introduced in GitLab 16.7.

Input type: VulnerabilitiesRemoveAllFromProjectInput

Arguments#

Name Type Description
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.
resolvedOnDefaultBranch Boolean When set as true, deletes only the vulnerabilities no longer detected. When set as false, deletes only the vulnerabilities still detected.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projects [Project!]! Projects for which the deletion was scheduled.

vulnerabilitiesSeverityOverride#

Input type: vulnerabilitiesSeverityOverrideInput

Arguments#

Name Type Description
comment String! Comment why vulnerability severity was changed (maximum 50,000 characters).
severity VulnerabilitySeverity! New severity value for the severities.
vulnerabilityIds [VulnerabilityID!]! IDs of the vulnerabilities for which severity needs to be changed (maximum 100 entries).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerabilities [Vulnerability!]! Vulnerabilities after severity change.

vulnerabilityAutoRemediation#

히스토리

Triggers automated remediation for a single vulnerability. Currently supports dependency (SCA) vulnerabilities, where a remediation merge request is created asynchronously when a fix is available; other report types return UNSUPPORTED.

Input type: VulnerabilityAutoRemediationInput

Arguments#

Name Type Description
vulnerabilityId VulnerabilityID! ID of the vulnerability to remediate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
status VulnerabilityAutoRemediationStatus Outcome of triggering auto-remediation.

vulnerabilityConfirm#

Input type: VulnerabilityConfirmInput

Arguments#

Name Type Description
comment String Comment why vulnerability was confirmed (maximum 50,000 characters).
id VulnerabilityID! ID of the vulnerability to be confirmed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after state change.

vulnerabilityCreate#

Input type: VulnerabilityCreateInput

Arguments#

Name Type Description Default
confirmedAt Time Timestamp of when the vulnerability state changed to confirmed (defaults to creation time if status is confirmed).
description String! Long text section that describes the vulnerability in more detail.
detectedAt Time Timestamp of when the vulnerability was first detected (defaults to creation time).
dismissedAt Time Timestamp 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.
name String! Name of the vulnerability.
project ProjectID! ID of the project to attach the vulnerability to.
projectTrackedContext ProjectTrackedContextInput Tracked context to associate with the vulnerability.
resolvedAt Time Timestamp of when the vulnerability state changed to resolved (defaults to creation time if status is resolved).
scanner VulnerabilityScannerInput! Information about the scanner used to discover the vulnerability.
severity VulnerabilitySeverity Severity of the vulnerability (defaults to unknown). UNKNOWN
solution String Instructions for how to fix the vulnerability.
state VulnerabilityState State of the vulnerability (defaults to detected). DETECTED

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability created.

vulnerabilityDismiss#

Input type: VulnerabilityDismissInput

Arguments#

Name Type Description
comment String Comment why vulnerability was dismissed (maximum 50,000 characters).
dismissalReason VulnerabilityDismissalReason Reason why vulnerability should be dismissed.
id VulnerabilityID! ID of the vulnerability to be dismissed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after state change.

vulnerabilityDismissFalsePositiveFlag#

히스토리

Dismiss a vulnerability false positive flag.

Input type: VulnerabilityDismissFalsePositiveFlagInput

Arguments#

Name Type Description
id VulnerabilityID! ID of the vulnerability to dismiss false positive flag for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after dismissing false positive flag.

vulnerabilityExternalIssueLinkCreate#

Input type: VulnerabilityExternalIssueLinkCreateInput

Arguments#

Name Type Description
externalTracker VulnerabilityExternalIssueLinkExternalTracker! External tracker type of the external issue link.
id VulnerabilityID! ID of the vulnerability.
linkType VulnerabilityExternalIssueLinkType! Type of the external issue link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalIssueLink VulnerabilityExternalIssueLink Created external issue link.

vulnerabilityExternalIssueLinkDestroy#

Input type: VulnerabilityExternalIssueLinkDestroyInput

Arguments#

Name Type Description
id VulnerabilitiesExternalIssueLinkID! Global ID of the vulnerability external issue link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

vulnerabilityIssueLinkCreate#

Input type: VulnerabilityIssueLinkCreateInput

Arguments#

Name Type Description
issueId IssueID! ID of the issue to link to.
vulnerabilityIds [VulnerabilityID!]! IDs of vulnerabilities to link to the given issue. Up to 100 can be provided.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issueLinks [VulnerabilityIssueLink!] Created issue links.

vulnerabilityLinkMergeRequest#

히스토리

Link a merge request to a vulnerability.

Input type: VulnerabilityLinkMergeRequestInput

Arguments#

Name Type Description
mergeRequestId MergeRequestID! ID of the merge request.
readinessScore Float Confidence 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.
vulnerabilityId VulnerabilityID! ID of the vulnerability.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Updated vulnerability.

vulnerabilityResolve#

Input type: VulnerabilityResolveInput

Arguments#

Name Type Description
comment String Comment why vulnerability was resolved (maximum 50,000 characters).
id VulnerabilityID! ID of the vulnerability to be resolved.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after state change.

vulnerabilityRevertToDetected#

Input type: VulnerabilityRevertToDetectedInput

Arguments#

Name Type Description
comment String Comment why vulnerability was reverted to detected (maximum 50,000 characters).
id VulnerabilityID! ID of the vulnerability to be reverted to detected.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after state change.

vulnerabilityUnlinkMergeRequest#

히스토리

Unlink a merge request from a vulnerability.

Input type: VulnerabilityUnlinkMergeRequestInput

Arguments#

Name Type Description
mergeRequestId MergeRequestID! ID of the merge request.
vulnerabilityId VulnerabilityID! ID of the vulnerability.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Updated vulnerability.

wikiPageSubscribe#

히스토리

Input type: WikiPageSubscribeInput

Arguments#

Name Type Description
id WikiPageMetaID! Global ID of the wiki page meta record.
subscribed Boolean! Desired state of the subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
wikiPage WikiPage Wiki page after mutation.

workItemAddClosingMergeRequest#

히스토리

Adds a closing merge request to a work item.

Input type: WorkItemAddClosingMergeRequestInput

Arguments#

Name Type Description
contextNamespacePath ID Full 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.
id WorkItemID! Global ID of the work item.
mergeRequestReference String! Merge request reference (short, full or URL). Example: !1, project_full_path!1 or https://gitlab.com/gitlab-org/gitlab/-/merge_requests/1.

Fields#

Name Type Description
closingMergeRequest WorkItemClosingMergeRequest Closing merge request added to the work item.
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Work item with new closing merge requests.

workItemAddLinkedItems#

히스토리

Add linked items to the work item.

Input type: WorkItemAddLinkedItemsInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
linkType WorkItemRelatedLinkType Type of link. Defaults to RELATED.
workItemsIds [WorkItemID!]! Global IDs of the items to link. Maximum number of IDs you can provide: 10.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Linked items update result message.
workItem WorkItem Updated work item.

workItemAvailabilityToggle#

히스토리

Enables or disables a work item type for a namespace.

Input type: WorkItemAvailabilityToggleInput

Arguments#

Name Type Description
action WorkItemAvailabilityAction! Whether to enable or disable the work item type.
fullPath ID! Full path of the group or project.
scope WorkItemAvailabilityScope! Whether to apply to the namespace or propagate to all existing children.
workItemTypeId WorkItemsTypeID! Global ID of the work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItemType WorkItemType Work item type after the availability change.

workItemBulkMove#

히스토리

Moves work items between projects or groups.

Input type: WorkItemBulkMoveInput

Arguments#

Name Type Description
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.
sourceFullPath String! Full path of the source namespace. For example, gitlab-org/gitlab-foss.
targetFullPath String! Full path of the target namespace. For example, gitlab-org/gitlab-foss. User paths are not supported.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
movedWorkItemCount Int Number of work items that were successfully moved.

workItemBulkUpdate#

히스토리

Allows updating several properties for a set of work items.

Input type: WorkItemBulkUpdateInput

Arguments#

Name Type Description
assigneesWidget WorkItemWidgetAssigneesInput Introduced as an experiment in GitLab 18.2.

Input for assignees widget.
confidential Boolean Introduced as an experiment in GitLab 18.2.

Sets the work item confidentiality.
fullPath ID! Full path of the project or group containing the work items that will be updated. User paths are not supported.
healthStatusWidget WorkItemWidgetHealthStatusInput Introduced as an experiment in GitLab 18.2.

Input for health status widget.
hierarchyWidget WorkItemWidgetHierarchyCreateInput Introduced as an experiment 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.
iterationWidget WorkItemWidgetIterationInput Introduced as an experiment in GitLab 18.2.

Input for iteration widget.
labelsWidget WorkItemWidgetLabelsUpdateInput Input for labels widget.
milestoneWidget WorkItemWidgetMilestoneInput Introduced as an experiment in GitLab 18.2.

Input for milestone widget.
stateEvent WorkItemStateEvent Introduced as an experiment in GitLab 18.2.

Close or reopen multiple work items at once.
statusWidget WorkItemWidgetStatusInput Introduced as an experiment in GitLab 18.3.

Input for status widget.
subscriptionEvent WorkItemSubscriptionEvent Introduced as an experiment in GitLab 18.2.

Subscribe or unsubscribe from the work items.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
updatedWorkItemCount Int Number of work items that were successfully updated.

workItemConvert#

히스토리

Converts the work item to a new type.

Input type: WorkItemConvertInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
workItemTypeId WorkItemsTypeID! Global ID of the new work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Updated work item.

workItemCreate#

히스토리

Creates a work item.

Input type: WorkItemCreateInput

Arguments#

Name Type Description
agentPlanWidget WorkItemWidgetAgentPlanInput Introduced as an experiment in GitLab 19.0.

Input for agent plan widget.
assigneesWidget WorkItemWidgetAssigneesInput Input for assignees widget.
colorWidget WorkItemWidgetColorInput Input for color widget.
confidential Boolean Sets the work item confidentiality.
createSource String Source which triggered the creation of the work item. Used only for tracking purposes.
createdAt Time Timestamp when the work item was created. Available only for admins and project owners.
crmContactsWidget WorkItemWidgetCrmContactsCreateInput Input for CRM contacts widget.
customFieldsWidget [WorkItemWidgetCustomFieldValueInputType!] Introduced as an experiment in GitLab 17.10.

Input for custom fields widget.
description String Deprecated in GitLab 16.9. use description widget instead.
descriptionWidget WorkItemWidgetDescriptionInput Input for description widget.
developmentWidget WorkItemWidgetDevelopmentCreateInput Input for development widget.
discussionsToResolve WorkItemResolveDiscussionsInput Information required to resolve discussions in a noteable, when the work item is created.
healthStatusWidget WorkItemWidgetHealthStatusInput Input for health status widget.
hierarchyWidget WorkItemWidgetHierarchyCreateInput Input for hierarchy widget.
iterationWidget WorkItemWidgetIterationInput Iteration widget of the work item.
labelsWidget WorkItemWidgetLabelsCreateInput Input for labels widget.
linkedItemsWidget WorkItemWidgetLinkedItemsCreateInput Input for linked items widget.
milestoneWidget WorkItemWidgetMilestoneInput Input for milestone widget.
namespacePath ID Full path of the namespace(project or group) the work item is created in.
projectPath ID Deprecated in GitLab 15.10. Please use namespacePath instead. That will cover for both projects and groups.
startAndDueDateWidget WorkItemWidgetStartAndDueDateUpdateInput Input for start and due date widget.
statusWidget WorkItemWidgetStatusInput Introduced as an experiment in GitLab 17.11.

Input for status widget.
title String! Title of the work item.
vulnerabilityId VulnerabilityID Introduced as an experiment in GitLab 17.9.

Input for linking an existing vulnerability to created work item.
weightWidget WorkItemWidgetWeightInput Input for weight widget.
workItemTypeId WorkItemsTypeID! Global ID of a work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Created work item.

workItemCreateFromTask#

히스토리

Creates a work item from a task in another work item's description.

Input type: WorkItemCreateFromTaskInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
workItemData WorkItemConvertTaskInput! Arguments necessary to convert a task into a work item.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
newWorkItem WorkItem New work item created from task.
workItem WorkItem Updated work item.

workItemDecisionArchive#

히스토리

Archives a resolved decision in the decision log of a work item. The decision is kept but marked as archived. Open decisions cannot be archived, and archiving cannot be undone.

Input type: WorkItemDecisionArchiveInput

Arguments#

Name Type Description
id WorkItemsDecisionID! Global ID of the decision.

Fields#

Name Type Description
decision WorkItemDecision Decision after mutation.
errors [String!]! Errors encountered during the mutation.

workItemDecisionCreate#

히스토리

Records a decision in the decision log of a work item.

Input type: WorkItemDecisionCreateInput

Arguments#

Name Type Description
description String Context of the decision.
discussionId DiscussionID Global ID of the originating discussion thread.
options [WorkItemDecisionOptionInput!] Candidate options of the decision. Maximum of 5 options. Incompatible with resolution.
resolution WorkItemDecisionResolutionInput When present, records the decision as resolved at creation. Incompatible with options.
sourceLink String URL of the comment, discussion, or external resource that prompted the decision.
title String Question being decided. Required unless resolution is provided.
workItemId WorkItemID! Global ID of the work item.

Fields#

Name Type Description
decision WorkItemDecision Decision after mutation.
errors [String!]! Errors encountered during the mutation.

workItemDecisionDelete#

히스토리

Deletes an open decision from the decision log of a work item. Resolved or archived decisions cannot be deleted; archive resolved decisions instead.

Input type: WorkItemDecisionDeleteInput

Arguments#

Name Type Description
id WorkItemsDecisionID! Global ID of the decision.

Fields#

Name Type Description
decision WorkItemDecision Deleted decision.
errors [String!]! Errors encountered during the mutation.

workItemDecisionResolve#

히스토리

Resolves a decision in the decision log of a work item.

Input type: WorkItemDecisionResolveInput

Arguments#

Name Type Description
id WorkItemsDecisionID! Global ID of the decision.
resolutionRationale String Reasoning for the resolution.
resolvingNoteId NoteID Global ID of the comment that resolved the decision.
selectedOptionContent String Content of a custom option, added as the only selected option of the decision while every existing option is deselected. Incompatible with selectedOptionIds.
selectedOptionIds [WorkItemsDecisionOptionID!] Global IDs of the selected options. Maximum of 5 options.

Fields#

Name Type Description
decision WorkItemDecision Decision after mutation.
errors [String!]! Errors encountered during the mutation.

workItemDecisionUpdate#

히스토리

Updates a decision in the decision log of a work item.

Input type: WorkItemDecisionUpdateInput

Arguments#

Name Type Description
description String Context of the decision.
discussionId DiscussionID Global ID of the originating discussion thread.
id WorkItemsDecisionID! Global ID of the decision.
options [WorkItemDecisionOptionUpdateInput!] Existing options of the decision to update. Maximum of 6 options.
resolutionRationale String Reasoning for the resolution. Can only be updated on resolved decisions.
resolvedById UserID Global ID of the user who resolved the decision. Can only be updated on resolved decisions.
resolvingNoteId NoteID Global ID of the comment that resolved the decision. Can only be updated on resolved decisions.
selectedOptionContent String Content of the selected option. Unless exactly one option is selected, a new selected option with this content is added and any selected options are deselected. Can only be updated on resolved decisions.
sourceLink String URL of the comment, discussion, or external resource that prompted the decision.
title String Question being decided.

Fields#

Name Type Description
decision WorkItemDecision Decision after mutation.
errors [String!]! Errors encountered during the mutation.

workItemDelete#

히스토리

Deletes a work item.

Input type: WorkItemDeleteInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespace Namespace Namespace the deleted work item belonged to.
project Project Deprecated in GitLab 16.9. Use namespace.

workItemEnableAiPlanning#

히스토리

Enables AI planning for a work item. Once enabled, AI planning cannot be disabled.

Input type: WorkItemEnableAiPlanningInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Work item after mutation.

workItemExport#

Deprecated in GitLab 18.0. Use WorkItemsCsvExport.

Input type: WorkItemExportInput

Arguments#

Name Type Description
assigneeUsernames [String!] Usernames of users assigned to the work item (maximum is 100 usernames).
assigneeWildcardId AssigneeWildcardId Filter by assignee wildcard. Incompatible with assigneeUsernames.
authorUsername String Filter work items by author username.
closedAfter Time Work items closed after the date.
closedBefore Time Work items closed before the date.
confidential Boolean Filter for confidential work items. If false, excludes confidential work items. If true, returns only confidential work items.
createdAfter Time Work items created after the timestamp.
createdBefore Time Work items created before the timestamp.
crmContactId String Filter by ID of CRM contact.
crmOrganizationId String Filter by ID of CRM contact organization.
dueAfter Time Work items due after the timestamp.
dueBefore Time Work items due before the timestamp.
healthStatusFilter HealthStatusFilter Introduced as an experiment in GitLab 18.2.

Health status of the work items, "none" and "any" values are supported.
hierarchyFilters HierarchyFilterInput Introduced as an experiment 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.'.
includeDescendantWorkItems Boolean Introduced as an experiment in GitLab 18.3.

Whether to include work items of descendant parents when filtering by parent_ids.
iterationCadenceId [IterationsCadenceID!] Introduced as an experiment in GitLab 18.2.

Filter by a list of iteration cadence IDs.
iterationId [ID] Introduced as an experiment in GitLab 18.2.

List of iteration Global IDs applied to the work items.
iterationWildcardId IterationWildcardId Introduced as an experiment 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).
milestoneWildcardId MilestoneWildcardId Filter by milestone ID wildcard. Incompatible with milestoneTitle.
myReactionEmoji String Filter by reaction emoji applied by the current user. Wildcard values NONE and ANY are supported.
not NegatedWorkItemFilterInput Negated work item arguments.
or UnionedWorkItemFilterInput List of arguments with inclusive OR.
parentIds [WorkItemID!] Filter work items by global IDs of their parent items (maximum is 100 IDs).
parentWildcardId WorkItemParentWildcardId Introduced as an experiment in GitLab 18.5.

Filter by parent ID wildcard. Incompatible with parentIds.
projectPath ID! Full project path.
releaseTag [String!] Release tag associated with the work item's milestone (maximum is 100 tags). Ignored when parent is a group.
releaseTagWildcardId ReleaseTagWildcardId Filter by release tag wildcard.
search String Search query for title or description.
selectedFields [AvailableExportFields!] List of selected fields to be exported. Omit to export all available fields.
state IssuableState Current state of the work item.
status WorkItemWidgetStatusFilterInput Introduced as an experiment in GitLab 18.7.

Filter by status.
subscribed SubscriptionStatus Work items the current user is subscribed to.
types [IssueType!] Filter work items by the given work item types.
updatedAfter Time Work items updated after the timestamp.
updatedBefore Time Work items updated before the timestamp.
weight String Introduced as an experiment in GitLab 18.2.

Weight applied to the work item, "none" and "any" values are supported.
weightWildcardId WeightWildcardId Introduced as an experiment in GitLab 18.2.

Filter by weight ID wildcard. Incompatible with weight.
workItemTypeIds [WorkItemsTypeID!] Filter work items by work item type global IDs.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Export request result message.

workItemGenerateReadinessScore#

히스토리

Scores the readiness of a work item asynchronously through a Duo Agent Platform flow, instead of Duo Chat. Available only when the workplan_score feature flag is enabled; returns an error otherwise.

Input type: WorkItemGenerateReadinessScoreInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item to score readiness for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workflow DuoWorkflow Duo Agent Platform workflow started to score the readiness.

workItemGenerateWorkplan#

히스토리

Generates a workplan for a work item asynchronously through a Duo Agent Platform flow, instead of Duo Chat. Available only when the duo_workplan_async_flow feature flag is enabled; returns an error otherwise.

Input type: WorkItemGenerateWorkplanInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item to generate a workplan for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workflow DuoWorkflow Duo Agent Platform workflow started to generate the workplan.

workItemHierarchyAddChildrenItems#

히스토리

Adds children to a given work item's hierarchy by Global ID.

Input type: WorkItemHierarchyAddChildrenItemsInput

Arguments#

Name Type Description
childrenIds [WorkItemID!]! Global IDs of children work items.
id WorkItemID! Global ID of the work item.

Fields#

Name Type Description
addedChildren [WorkItem!]! Work items that were added as children.
errors [String!]! Errors encountered during the mutation.

workItemRemoveLinkedItems#

히스토리

Remove items linked to the work item.

Input type: WorkItemRemoveLinkedItemsInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
workItemsIds [WorkItemID!]! Global IDs of the items to unlink. Maximum number of IDs you can provide: 10.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Linked items update result message.
workItem WorkItem Updated work item.

workItemResumeWorkplan#

히스토리

Resumes a paused workplan generation flow that is awaiting input, sending the replies left on the questions the flow asked. Available only when the duo_workplan_async_flow feature flag is enabled; returns an error otherwise.

Input type: WorkItemResumeWorkplanInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item whose workplan generation to resume.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workflow DuoWorkflow Duo Agent Platform workflow that was resumed.

workItemSavedViewCreate#

히스토리

Creates a saved view.

Input type: WorkItemSavedViewCreateInput

Arguments#

Name Type Description
description String Description of the saved view.
displaySettings JSON! Display settings associated with the saved view.
filters WorkItemSavedViewFilterInput! Filters associated with the saved view.
isPrivate Boolean Whether the saved view is private. Default is true.
name String! Name of the saved view.
namespacePath ID! Full path of the namespace to create the saved view in.
private Boolean Deprecated in GitLab 18.10. Replaced by isPrivate argument.
sort WorkItemSort! Sort option associated with the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Created saved view.

workItemSavedViewDelete#

히스토리

Deletes a saved view.

Input type: WorkItemSavedViewDeleteInput

Arguments#

Name Type Description
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Deleted saved view.

workItemSavedViewReorder#

히스토리

Reorders a saved view for the current user.

Input type: WorkItemSavedViewReorderInput

Arguments#

Name Type Description
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view to be reordered.
moveAfterId WorkItemsSavedViewsSavedViewID Global ID of a saved view that the reordered view should be placed after.
moveBeforeId WorkItemsSavedViewsSavedViewID Global ID of a saved view that the reordered view should be placed before.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Reordered saved view.

workItemSavedViewSubscribe#

히스토리

Subscribes the current user to a saved view.

Input type: WorkItemSavedViewSubscribeInput

Arguments#

Name Type Description
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view to subscribe to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Subscribed saved view.

workItemSavedViewUnsubscribe#

히스토리

Unsubscribes the current user from a saved view.

Input type: WorkItemSavedViewUnsubscribeInput

Arguments#

Name Type Description
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view to unsubscribe from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Unsubscribed saved view.

workItemSavedViewUpdate#

히스토리

Updates a saved view.

Input type: WorkItemSavedViewUpdateInput

Arguments#

Name Type Description
description String Description of the saved view.
displaySettings JSON Display settings associated with the saved view.
filters WorkItemSavedViewFilterInput Filters associated with the saved view.
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view.
isPrivate Boolean Whether the saved view is private.
name String Name of the saved view.
private Boolean Deprecated in GitLab 18.10. Replaced by isPrivate argument.
sort WorkItemSort Sorting option associated with the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Updated saved view.

workItemSettingsUpdate#

히스토리

Updates work item settings for a root group or organization. Omit fullPath to update settings for the current organization.

Input type: WorkItemSettingsUpdateInput

Arguments#

Name Type Description
customizableTypeVisibility Boolean Whether namespace admins can configure per-type work item visibility.
fullPath ID Full path of the root group. Omit to use the current organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItemSettings WorkItemSettings Work item settings after mutation.

workItemSubscribe#

히스토리

Input type: WorkItemSubscribeInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
subscribed Boolean! Desired state of the subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Work item after mutation.

workItemTypeCreate#

히스토리

Input type: WorkItemTypeCreateInput

Arguments#

Name Type Description
enabledByDefaultForNewNamespaces Boolean Indicates the type is enabled by default for new child namespaces.
fullPath String Full path of the root group.
iconName String! Icon name for the work item type. Use the workItemTypeIconDefinitions query to retrieve the list of available icon names.
name String! Name for the work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItemType WorkItemType Work item type that was created.

workItemTypeUpdate#

히스토리

Input type: WorkItemTypeUpdateInput

Arguments#

Name Type Description
archive Boolean Whether to archive the work item type.
enabledByDefaultForNewNamespaces Boolean Indicates the type is enabled by default for new child namespaces.
fullPath String Full path of the root group.
iconName String Icon name for the work item type. Use the workItemTypeIconDefinitions query to retrieve the list of available icon names.
id WorkItemsTypeID! Global ID of the work item type to update.
name String New name for the work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItemType WorkItemType Work item type that was updated.

workItemUpdate#

히스토리

Updates a work item by Global ID.

Input type: WorkItemUpdateInput

Arguments#

Name Type Description
agentPlanWidget WorkItemWidgetAgentPlanInput Introduced as an experiment in GitLab 19.0.

Input for agent plan widget.
assigneesWidget WorkItemWidgetAssigneesInput Input for assignees widget.
awardEmojiWidget WorkItemWidgetAwardEmojiUpdateInput Input for emoji reactions widget.
colorWidget WorkItemWidgetColorInput Input for color widget.
confidential Boolean Sets the work item confidentiality.
crmContactsWidget WorkItemWidgetCrmContactsUpdateInput Input for CRM contacts widget.
currentUserTodosWidget WorkItemWidgetCurrentUserTodosInput Input for to-dos widget.
customFieldsWidget [WorkItemWidgetCustomFieldValueInputType!] Introduced as an experiment in GitLab 17.10.

Input for custom fields widget.
descriptionWidget WorkItemWidgetDescriptionInput Input for description widget.
healthStatusWidget WorkItemWidgetHealthStatusInput Input for health status widget.
hierarchyWidget WorkItemWidgetHierarchyUpdateInput Input for hierarchy widget.
id WorkItemID! Global ID of the work item.
iterationWidget WorkItemWidgetIterationInput Input for iteration widget.
labelsWidget WorkItemWidgetLabelsUpdateInput Input for labels widget.
milestoneWidget WorkItemWidgetMilestoneInput Input for milestone widget.
moveAfterId WorkItemID Introduced as an experiment in GitLab 19.2.

Global ID of a work item that should be placed after the work item.
moveBeforeId WorkItemID Introduced as an experiment in GitLab 19.2.

Global ID of a work item that should be placed before the work item.
notesWidget WorkItemWidgetNotesInput Input for notes widget.
notificationsWidget WorkItemWidgetNotificationsUpdateInput Input for notifications widget.
progressWidget WorkItemWidgetProgressInput Input for progress widget.
startAndDueDateWidget WorkItemWidgetStartAndDueDateUpdateInput Input for start and due date widget.
stateEvent WorkItemStateEvent Close or reopen a work item.
statusWidget WorkItemWidgetStatusInput Introduced as an experiment in GitLab 17.11.

Input for status widget.
timeTrackingWidget WorkItemWidgetTimeTrackingInput Input for time tracking widget.
title String Title of the work item.
verificationStatusWidget VerificationStatusInput Input for verification status widget.
weightWidget WorkItemWidgetWeightInput Input for weight widget.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Updated work item.

workItemUserPreferenceUpdate#

히스토리

Create or Update user preferences for a work item type and namespace.

Input type: WorkItemUserPreferenceUpdateInput

Arguments#

Name Type Description Default
displaySettings JSON Display settings for the work item lists.
namespacePath ID! Full path of the namespace on which the preference is set.
sort WorkItemSort Sort order for work item lists. CREATED_ASC
workItemTypeId WorkItemsTypeID Global ID of a work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userPreferences WorkItemTypesUserPreference User preferences.

workItemsCsvExport#

히스토리

Input type: WorkItemsCsvExportInput

Arguments#

Name Type Description
assigneeUsernames [String!] Usernames of users assigned to the work item (maximum is 100 usernames).
assigneeWildcardId AssigneeWildcardId Filter by assignee wildcard. Incompatible with assigneeUsernames.
authorUsername String Filter work items by author username.
closedAfter Time Work items closed after the date.
closedBefore Time Work items closed before the date.
confidential Boolean Filter for confidential work items. If false, excludes confidential work items. If true, returns only confidential work items.
createdAfter Time Work items created after the timestamp.
createdBefore Time Work items created before the timestamp.
crmContactId String Filter by ID of CRM contact.
crmOrganizationId String Filter by ID of CRM contact organization.
dueAfter Time Work items due after the timestamp.
dueBefore Time Work items due before the timestamp.
healthStatusFilter HealthStatusFilter Introduced as an experiment in GitLab 18.2.

Health status of the work items, "none" and "any" values are supported.
hierarchyFilters HierarchyFilterInput Introduced as an experiment 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.'.
includeDescendantWorkItems Boolean Introduced as an experiment in GitLab 18.3.

Whether to include work items of descendant parents when filtering by parent_ids.
iterationCadenceId [IterationsCadenceID!] Introduced as an experiment in GitLab 18.2.

Filter by a list of iteration cadence IDs.
iterationId [ID] Introduced as an experiment in GitLab 18.2.

List of iteration Global IDs applied to the work items.
iterationWildcardId IterationWildcardId Introduced as an experiment 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).
milestoneWildcardId MilestoneWildcardId Filter by milestone ID wildcard. Incompatible with milestoneTitle.
myReactionEmoji String Filter by reaction emoji applied by the current user. Wildcard values NONE and ANY are supported.
not NegatedWorkItemFilterInput Negated work item arguments.
or UnionedWorkItemFilterInput List of arguments with inclusive OR.
parentIds [WorkItemID!] Filter work items by global IDs of their parent items (maximum is 100 IDs).
parentWildcardId WorkItemParentWildcardId Introduced as an experiment in GitLab 18.5.

Filter by parent ID wildcard. Incompatible with parentIds.
projectPath ID! Full project path.
releaseTag [String!] Release tag associated with the work item's milestone (maximum is 100 tags). Ignored when parent is a group.
releaseTagWildcardId ReleaseTagWildcardId Filter by release tag wildcard.
search String Search query for title or description.
selectedFields [AvailableExportFields!] List of selected fields to be exported. Omit to export all available fields.
state IssuableState Current state of the work item.
status WorkItemWidgetStatusFilterInput Introduced as an experiment in GitLab 18.7.

Filter by status.
subscribed SubscriptionStatus Work items the current user is subscribed to.
types [IssueType!] Filter work items by the given work item types.
updatedAfter Time Work items updated after the timestamp.
updatedBefore Time Work items updated before the timestamp.
weight String Introduced as an experiment in GitLab 18.2.

Weight applied to the work item, "none" and "any" values are supported.
weightWildcardId WeightWildcardId Introduced as an experiment in GitLab 18.2.

Filter by weight ID wildcard. Incompatible with weight.
workItemTypeIds [WorkItemsTypeID!] Filter work items by work item type global IDs.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Export request result message.

workItemsCsvImport#

히스토리

Input type: WorkItemsCsvImportInput

Arguments#

Name Type Description
file Upload! CSV file to import work items from.
projectPath ID! Full project path.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Import request result message.

workItemsHierarchyReorder#

히스토리

Reorder a work item in the hierarchy tree.

Input type: workItemsHierarchyReorderInput

Arguments#

Name Type Description
adjacentWorkItemId WorkItemID ID of the work item to move next to. For example, the item above or below.
id WorkItemID! Global ID of the work item to be reordered.
parentId WorkItemID Global ID of the new parent work item.
relativePosition RelativePositionType Position relative to the adjacent work item. Valid values are BEFORE or AFTER.

Fields#

Name Type Description
adjacentWorkItem WorkItem Adjacent work item after mutation.
errors [String!]! Errors encountered during the mutation.
parentWorkItem WorkItem Work item's parent after mutation.
workItem WorkItem Work item after mutation.

workItemsReorder#

히스토리

Reorders a work item.

Input type: workItemsReorderInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item to be reordered.
moveAfterId WorkItemID Global ID of a work item that should be placed after the work item.
moveBeforeId WorkItemID Global ID of a work item that should be placed before the work item.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Work item after mutation.

workspaceCreate#

Input type: WorkspaceCreateInput

Arguments#

Name Type Description Default
clusterAgentId ClustersAgentID! GlobalID of the cluster agent the created workspace will be associated with.
desiredState String! Desired state of the created workspace.
devfilePath String Project path containing the devfile used to configure the workspace. If not provided, the GitLab default devfile is used. null
devfileRef String Deprecated in GitLab 17.8. Argument is renamed to project_ref.
editor String Deprecated in GitLab 17.5. Argument is not used.
maxHoursBeforeTermination Int Deprecated in GitLab 17.9. Field is not used.
projectId ProjectID! ID of the project that will provide the Devfile for the created workspace.
projectRef String Project repo git ref.
variables [WorkspaceVariableInput!] Deprecated in GitLab 18.0. Argument is renamed to workspace_variables. []
workspaceVariables [WorkspaceVariableInput!] Introduced as an experiment in GitLab 18.0.

Variables to inject into the workspace.		 []

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workspace Workspace Created workspace.

workspaceUpdate#

Input type: WorkspaceUpdateInput

Arguments#

Name Type Description
desiredState String! Desired state of the created workspace.
id RemoteDevelopmentWorkspaceID! Global ID of the workspace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workspace Workspace Created workspace.

GraphQL API 뮤테이션

GitLab v19.5
원문 보기

요약

Mutations are the top-level entry points for creating, updating, and deleting data in the GitLab GraphQL API. Deprecated items are planned to be removed in a future release.

Mutations are the top-level entry points for creating, updating, and deleting data in the GitLab GraphQL API. For an introduction, see Mutations.

Warning

Deprecated items are planned to be removed in a future release. For more information, see the GitLab deprecation process.

Calling a mutation#

You call a mutation with one argument, input. You put the mutation's arguments inside input, and then request the fields you want returned:

mutation($id: NoteableID!, $body: String!) {
  # Arguments go inside `input`.
  createNote(input: { noteableId: $id, body: $body }) {
    # Request the fields you want returned.
    note {
      id
      body
    }
    errors
  }
}

Each mutation lists:

  • Input type: The type of input. You need it when you pass all of the arguments as one variable, for example mutation($input: CreateNoteInput!) { createNote(input: $input) { errors } }.
  • Arguments: What you can put inside input. An argument whose type ends in ! is required, unless it has a default value.
  • Fields: What you can request in the result. Every mutation returns errors, a list of error messages. Always request errors so you can see why a mutation failed.

clientMutationId#

Every mutation also accepts an optional clientMutationId argument of type String, and returns the same value in its result. Use it to match each response to its request. It works the same way for every mutation, so it is not listed with each mutation's arguments and fields.

achievementsAward#

Input type: AchievementsAwardInput

Arguments#

Name Type Description
achievementId AchievementsAchievementID! Global ID of the achievement being awarded.
awardMessage String Message to associate with the awarded achievement.
userId UserID! Global ID of the user being awarded the achievement.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievement UserAchievement Achievement award.

achievementsCreate#

Input type: AchievementsCreateInput

Arguments#

Name Type Description
avatar Upload Avatar for the achievement.
description String Description of or notes for the achievement.
name String! Name for the achievement.
namespaceId NamespaceID! Namespace for the achievement.

Fields#

Name Type Description
achievement Achievement Achievement created.
errors [String!]! Errors encountered during the mutation.

achievementsDelete#

Input type: AchievementsDeleteInput

Arguments#

Name Type Description
achievementId AchievementsAchievementID! Global ID of the achievement being deleted.

Fields#

Name Type Description
achievement Achievement Achievement.
errors [String!]! Errors encountered during the mutation.

achievementsRevoke#

Input type: AchievementsRevokeInput

Arguments#

Name Type Description
userAchievementId AchievementsUserAchievementID! Global ID of the user achievement being revoked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievement UserAchievement Achievement award.

achievementsUpdate#

Input type: AchievementsUpdateInput

Arguments#

Name Type Description
achievementId AchievementsAchievementID! Global ID of the achievement being updated.
avatar Upload Avatar for the achievement.
description String Description of or notes for the achievement.
name String Name for the achievement.

Fields#

Name Type Description
achievement Achievement Achievement.
errors [String!]! Errors encountered during the mutation.

addProjectToSecurityDashboard#

Input type: AddProjectToSecurityDashboardInput

Arguments#

Name Type Description
id ProjectID! ID of the project to be added to Instance Security Dashboard.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project that was added to the Instance Security Dashboard.

adminClearDuoAvailability#

히스토리

Clears an admin-locked GitLab Duo availability override from a group.

Input type: AdminClearDuoAvailabilityInput

Arguments#

Name Type Description
groupId GroupID! Group to clear the GitLab Duo availability override from.

Fields#

Name Type Description
adminLocked Boolean Whether the group has an admin-locked GitLab Duo availability override.
availability DuoAvailability Resolved GitLab Duo availability for the group after the override is cleared.
errors [String!]! Errors encountered during the mutation.

adminRolesLdapSync#

히스토리

Input type: AdminRolesLdapSyncInput

Fields#

Name Type Description
errors [String!] Errors encountered during operation.
success Boolean Whether the sync was successfully enqueued.

adminSetDuoAvailability#

히스토리

Sets an admin-locked GitLab Duo availability override on a group.

Input type: AdminSetDuoAvailabilityInput

Arguments#

Name Type Description Default
availability DuoAvailability! GitLab Duo availability state to lock on the group.
clearDescendants Boolean Clear conflicting admin-locked overrides on descendant groups instead of rejecting. false
groupId GroupID! Group to set the GitLab Duo availability override on.

Fields#

Name Type Description
adminLocked Boolean Whether the group has an admin-locked GitLab Duo availability override.
affectedAdminLockedDescendants AdminDuoAvailabilityLockedAncestorConnection Descendant groups with admin-locked overrides that must be cleared before this override can be applied. Present only when clearDescendants was false; the override was not applied. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.
availability DuoAvailability Resolved GitLab Duo availability for the group after the mutation.
conflictingAncestor AdminDuoAvailabilityLockedAncestor Ancestor group whose admin lock blocked the mutation, if any. When present, the override was not applied.
errors [String!]! Errors encountered during the mutation.

adminSidekiqQueuesDeleteJobs#

Input type: AdminSidekiqQueuesDeleteJobsInput

Arguments#

Name Type Description
aiResource String Delete jobs matching ai_resource in the context metadata.
artifactSize String Delete jobs matching artifact_size in the context metadata.
artifactUsedCdn String Delete jobs matching artifact_used_cdn in the context metadata.
artifactsDependenciesCount String Delete jobs matching artifacts_dependencies_count in the context metadata.
artifactsDependenciesSize String Delete jobs matching artifacts_dependencies_size in the context metadata.
bulkImportEntityId String Delete jobs matching bulk_import_entity_id in the context metadata.
callerId String Delete jobs matching caller_id in the context metadata.
clientId String Delete jobs matching client_id in the context metadata.
clientName String Delete jobs matching client_name in the context metadata.
clientType String Delete jobs matching client_type in the context metadata.
clientVersion String Delete jobs matching client_version in the context metadata.
featureCategory String Delete jobs matching feature_category in the context metadata.
glRootNamespaceId String Delete jobs matching gl_root_namespace_id in the context metadata.
glUserId String Delete jobs matching gl_user_id in the context metadata.
jobId String Delete jobs matching job_id in the context metadata.
kubernetesAgentId String Delete jobs matching kubernetes_agent_id in the context metadata.
mergeActionStatus String Delete jobs matching merge_action_status in the context metadata.
mvccManifest String Delete jobs matching mvcc_manifest in the context metadata.
organizationId String Delete jobs matching organization_id in the context metadata.
pipelineId String Delete jobs matching pipeline_id in the context metadata.
project String Delete jobs matching project in the context metadata.
queueName String! Name of the queue to delete jobs from.
relatedClass String Delete jobs matching related_class in the context metadata.
remoteIp String Delete jobs matching remote_ip in the context metadata.
rootCallerId String Delete jobs matching root_caller_id in the context metadata.
rootNamespace String Delete jobs matching root_namespace in the context metadata.
scopedUser String Delete jobs matching scoped_user in the context metadata.
scopedUserId String Delete jobs matching scoped_user_id in the context metadata.
sidekiqDestinationShardRedis String Delete jobs matching sidekiq_destination_shard_redis in the context metadata.
subscriptionPlan String Delete jobs matching subscription_plan in the context metadata.
user String Delete jobs matching user in the context metadata.
userId String Delete jobs matching user_id in the context metadata.
workerClass String Delete jobs with the given worker class.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
result DeleteJobsResponse Information about the status of the deletion request.

aiAction#

히스토리

Input type: AiActionInput

Arguments#

Name Type Description
agenticChat AiAgenticChatInput Input for agentic_chat AI action.
chat AiChatInput Input for chat AI action.
clientSubscriptionId String Client generated ID that can be subscribed to, to receive a response for the mutation.
conversationType AiConversationsThreadsConversationType Conversation type of the thread.
explainVulnerability AiExplainVulnerabilityInput Input for explain_vulnerability AI action.
generateCommitMessage AiGenerateCommitMessageInput Input for generate_commit_message AI action.
generateDescription AiGenerateDescriptionInput Input for generate_description AI action.
measureCommentTemperature AiMeasureCommentTemperatureInput Input for measure_comment_temperature AI action.
platformOrigin String Specifies the origin platform of the request.
projectId ProjectID Global ID of the project the user is acting on.
resolveVulnerability AiResolveVulnerabilityInput Input for resolve_vulnerability AI action.
rootNamespaceId NamespaceID Global ID of the top-level namespace the user is acting on.
summarizeNewMergeRequest AiSummarizeNewMergeRequestInput Input for summarize_new_merge_request AI action.
summarizeReview AiSummarizeReviewInput Input for summarize_review AI action.
threadId AiConversationThreadID Global 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requestId String ID of the request.
threadId AiConversationThreadID Global Id of the thread.

aiCatalogAgentCreate#

히스토리

Input type: AiCatalogAgentCreateInput

Arguments#

Name Type Description
description String! Description for the agent.
mcpServers [AiCatalogMcpServerID!] Introduced as an experiment in GitLab 18.10.

MCP servers to associate with the agent.
mcpTools [String!] Introduced as an experiment in GitLab 18.11.

List of MCP tools enabled for the agent.
name String! Name for the agent.
projectId ProjectID! Project for the agent.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the agent.
systemPrompt String! System prompt for the agent.
tools [AiCatalogBuiltInToolID!] List of GitLab built-in tools enabled for the agent.
userPrompt String User prompt for the agent.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the agent in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogAgent Item created.

aiCatalogAgentDelete#

히스토리

Input type: AiCatalogAgentDeleteInput

Arguments#

Name Type Description
forceHardDelete Boolean When true, the flow will always be hard deleted and never soft deleted. Can only be used by instance admins.
id AiCatalogItemID! Global ID of the catalog Agent to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Returns true if catalog Agent was successfully deleted.

aiCatalogAgentUpdate#

히스토리

Input type: AiCatalogAgentUpdateInput

Arguments#

Name Type Description
description String Description for the agent.
id AiCatalogItemID! Global ID of the catalog Agent to update.
mcpServers [AiCatalogMcpServerID!] Introduced as an experiment in GitLab 18.10.

MCP servers to associate with the agent.
mcpTools [String!] Introduced as an experiment in GitLab 18.11.

List of MCP tools enabled for the agent.
name String Name for the agent.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the agent.
systemPrompt String System prompt for the agent.
tools [AiCatalogBuiltInToolID!] List of GitLab built-in tools enabled for the agent.
userPrompt String User prompt for the agent.
versionBump AiCatalogVersionBump Bump version, calculated from the last released version name.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the agent in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogAgent Agent that was updated.

aiCatalogFlowCreate#

히스토리

Input type: AiCatalogFlowCreateInput

Arguments#

Name Type Description
definition String YAML definition for the flow.
description String! Description for the flow.
name String! Name for the flow.
projectId ProjectID! Project for the flow.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the flow.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the flow in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogFlow Item created.

aiCatalogFlowDelete#

히스토리

Input type: AiCatalogFlowDeleteInput

Arguments#

Name Type Description
forceHardDelete Boolean When true, the flow will always be hard deleted and never soft deleted. Can only be used by instance admins.
id AiCatalogItemID! Global ID of the catalog flow to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Returns true if catalog flow was successfully deleted.

aiCatalogFlowUpdate#

히스토리

Input type: AiCatalogFlowUpdateInput

Arguments#

Name Type Description
definition String YAML definition for the Flow.
description String Description for the flow.
id AiCatalogItemID! Global ID of the catalog flow to update.
name String Name for the flow.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the flow.
versionBump AiCatalogVersionBump Bump version, calculated from the last released version name.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the flow in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogFlow Flow that was updated.

aiCatalogItemConsumerBulkCreate#

히스토리

Input type: AiCatalogItemConsumerBulkCreateInput

Arguments#

Name Type Description
itemId AiCatalogItemID! Global ID of the catalog item to enable.
pinnedVersion AiCatalogPinnedVersion Version 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).
triggerConditions AiCatalogTriggerConditionsInput Introduced as an experiment in GitLab 19.3.

Filter conditions for the auto-created AI Catalog triggers, keyed by event type.
triggerFilter JSON Deprecated in GitLab 19.3. Use triggerConditions.
triggerGoals JSON Introduced as an experiment in GitLab 19.5.

Goals for the auto-created AI Catalog triggers, keyed by event type.
triggerTypes [String!] List of event types to create AI Catalog triggers for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

aiCatalogItemConsumerCreate#

히스토리

Input type: AiCatalogItemConsumerCreateInput

Arguments#

Name Type Description Default
consumerKind AiCatalogItemConsumerKind Type of item configuration. INHERITANCE is only valid for a top-level group target. DIRECT
itemId AiCatalogItemID! Item to configure.
parentItemConsumerId AiCatalogItemConsumerID Parent item consumer belonging to the top-level group.
pinnedVersion AiCatalogPinnedVersion Version 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.
replaceExistingDirectConfigurations Boolean Confirm replacement of a group configuration, and any project configurations, for this item when inheritance is turned on. Required when the item is already configured for the group.
target ItemConsumerTargetInput! Target project or top-level group in which the catalog item is configured.
triggerConditions AiCatalogTriggerConditionsInput Introduced as an experiment in GitLab 19.3.

Filter conditions for the auto-created AI Catalog triggers, keyed by event type.
triggerFilter JSON Deprecated in GitLab 19.3. Use triggerConditions.
triggerGoals JSON Introduced as an experiment in GitLab 19.5.

Goals for the auto-created AI Catalog triggers, keyed by event type.
triggerTypes [String!] List of event types to create AI Catalog triggers for (values can be mention, assign or assign_reviewer).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
itemConsumer AiCatalogItemConsumer Item configuration created.
warnings [String!]! Non-fatal problems encountered while configuring the item. The configuration was still created.

aiCatalogItemConsumerDelete#

히스토리

Input type: AiCatalogItemConsumerDeleteInput

Arguments#

Name Type Description
id AiCatalogItemConsumerID! Global ID of the catalog item consumer to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Returns true if catalog item consumer was successfully deleted.

aiCatalogItemConsumerUpdate#

히스토리

Input type: AiCatalogItemConsumerUpdateInput

Arguments#

Name Type Description
id AiCatalogItemConsumerID! Global ID of the catalog item consumer to update.
pinnedVersion AiCatalogPinnedVersion Version the item is pinned to, in the format n.n.n.
pinnedVersionPrefix AiCatalogPinnedVersion Deprecated in GitLab 19.0. Use pinnedVersion instead.
serviceAccountId UserID Service 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).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
itemConsumer AiCatalogItemConsumer Item consumer that was updated.

aiCatalogItemReport#

히스토리

Input type: AiCatalogItemReportInput

Arguments#

Name Type Description
body String Additional details about the report. Limited to 1000 characters.
id AiCatalogItemID! Global ID of the catalog item to report.
reason AiCatalogItemReportReason! Reason for reporting the catalog item.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

aiCatalogItemStar#

히스토리

Input type: AiCatalogItemStarInput

Arguments#

Name Type Description
id AiCatalogItemID! Global ID of the catalog item to star or unstar.
starred Boolean! Indicates whether to star or unstar the catalog item.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
starCount Int! Number of stars for the catalog item.

aiCatalogItemVersionRestore#

히스토리

Input type: AiCatalogItemVersionRestoreInput

Arguments#

Name Type Description Default
deprecateCurrent Boolean Whether to mark the current latest version as deprecated. false
id AiCatalogItemVersionID! Global ID of the item version to restore from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
itemVersion AiCatalogItemVersion Newly created item version restored from the source version.

aiCatalogMcpServerCreate#

히스토리

Input type: AiCatalogMcpServerCreateInput

Arguments#

Name Type Description
authType AiCatalogMcpServerAuthType! Authentication type for the MCP server.
description String Description for the MCP server.
homepageUrl String Homepage URL for the MCP server.
name String! Name for the MCP server.
oauthClientId String OAuth client ID for the MCP server.
oauthClientSecret String OAuth client secret for the MCP server.
transport AiCatalogMcpServerTransport! Transport type for the MCP server.
url String! URL for the MCP server.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mcpServer AiCatalogMcpServer MCP server created.

aiCatalogMcpServerSetBlock#

히스토리

Blocks or allows an external MCP server for a group or project (kill-switch).

Input type: AiCatalogMcpServerSetBlockInput

Arguments#

Name Type Description
blocked Boolean! Set to true to block the MCP server, false to allow it.
groupFullPath ID Full path of the group to block or allow the MCP server for. Provide exactly one of groupFullPath or projectFullPath.
id AiCatalogMcpServerID! Global ID of the MCP server.
projectFullPath ID Full path of the project to block or allow the MCP server for. Provide exactly one of groupFullPath or projectFullPath.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mcpServer AiCatalogMcpServer MCP server with its updated block status.

aiCatalogMcpServerUpdate#

히스토리

Input type: AiCatalogMcpServerUpdateInput

Arguments#

Name Type Description
authType AiCatalogMcpServerAuthType Authentication type for the MCP server.
description String Description for the MCP server.
homepageUrl String Homepage URL for the MCP server.
id AiCatalogMcpServerID! Global ID of the MCP server to update.
name String Name for the MCP server.
oauthClientId String OAuth client ID for the MCP server.
oauthClientSecret String OAuth client secret for the MCP server.
transport AiCatalogMcpServerTransport Transport type for the MCP server.
url String URL for the MCP server.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mcpServer AiCatalogMcpServer MCP server that was updated.

aiCatalogThirdPartyFlowCreate#

히스토리

Input type: AiCatalogThirdPartyFlowCreateInput

Arguments#

Name Type Description
definition String! YAML definition for the Flow.
description String! Description for the Flow.
name String! Name for the Flow.
projectId ProjectID! Project for the Flow.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the Flow.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the Flow in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogThirdPartyFlow Item created.

aiCatalogThirdPartyFlowDelete#

히스토리

Input type: AiCatalogThirdPartyFlowDeleteInput

Arguments#

Name Type Description
forceHardDelete Boolean When true, the Third Party Flow will always be hard deleted and never soft deleted. Can only be used by instance admins.
id AiCatalogItemID! Global ID of the catalog Third Party Flow to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Returns true if catalog Third Party Flow was successfully deleted.

aiCatalogThirdPartyFlowUpdate#

히스토리

Input type: AiCatalogThirdPartyFlowUpdateInput

Arguments#

Name Type Description
definition String YAML definition for the Flow.
description String Description for the Flow.
id AiCatalogItemID! Global ID of the catalog Flow to update.
name String Name for the Flow.
public Boolean Deprecated in GitLab 19.2. Use visibility.
release Boolean Whether to release the latest version of the Flow.
versionBump AiCatalogVersionBump Bump version, calculated from the last released version name.
visibility AiCatalogItemVisibility Introduced as an experiment in GitLab 19.2.

Visibility of the Flow in the catalog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
item AiCatalogThirdPartyFlow Flow that was updated.

aiDomainSettingsInstanceUpdate#

히스토리

Adds or removes domains from the allowed or denied list for flows running in a sandboxed environment.

Input type: AiDomainSettingsInstanceUpdateInput

Arguments#

Name Type Description
action AiDomainSettingAction! Action to perform on the domain list.
domainSettingType AiDomainSettingType! Type of domain setting to update.
domains [String!]! List of domains to add or remove.

Fields#

Name Type Description
addedDomains [String!] Domains that were added in the operation.
errors [String!]! Errors encountered during the mutation.
removedDomains [String!] Domains that were removed in the operation.

aiDomainSettingsNamespaceUpdate#

히스토리

Adds or removes domains from the allowed or denied list for flows running in a sandboxed environment.

Input type: AiDomainSettingsNamespaceUpdateInput

Arguments#

Name Type Description
action AiDomainSettingAction! Action to perform on the domain list.
domainSettingType AiDomainSettingType! Type of domain setting to update.
domains [String!]! List of domains to add or remove.
namespaceId NamespaceID! Global ID of the root namespace to update.

Fields#

Name Type Description
addedDomains [String!] Domains that were added in the operation.
errors [String!]! Errors encountered during the mutation.
removedDomains [String!] Domains that were removed in the operation.

aiDuoWorkflowCreate#

히스토리

Input type: AiDuoWorkflowCreateInput

Arguments#

Name Type Description
agentPrivileges [Int!] Actions the agent is allowed to perform.
aiCatalogItemVersionId AiCatalogItemVersionID ID of the catalog item the workflow is triggered from.
allowAgentToRequestUser Boolean When enabled, Duo Agent Platform may stop to ask the user questions before proceeding.
environment WorkflowEnvironment Environment for the workflow.
goal String Goal of the workflow.
issueId BigInt IID of the noteable (Issue) that the workflow is associated with.
mergeRequestId BigInt IID of the noteable (MergeRequest) that the workflow is associated with.
namespaceId NamespaceID Global ID of the namespace the user is acting on.
preApprovedAgentPrivileges [Int!] Actions the agent can perform without asking for approval.
projectId ProjectID Global ID of the project the user is acting on.
webSearchEnabled Boolean Enable web search for the session.
workflowDefinition String Workflow type based on its capability.

Fields#

Name Type Description
errors [String!]! Errors encountered during the creation process.
workflow DuoWorkflow Created workflow.

aiFeatureSettingModelAllowlistUpdate#

히스토리

Updates the instance-level model selection allowlist for an AI feature.

Input type: AiFeatureSettingModelAllowlistUpdateInput

Arguments#

Name Type Description
allowlistEnabled Boolean! 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.
feature AiFeatures! AI feature whose model allowlist is being configured.

Fields#

Name Type Description
allowList AiModelSelectionAllowList Model selection allowlist for the feature after the update.
errors [String!]! Errors encountered during the mutation.

aiFeatureSettingUpdate#

히스토리

Updates or creates settings for AI features.

Input type: AiFeatureSettingUpdateInput

Arguments#

Name Type Description
aiSelfHostedModelId AiSelfHostedModelID Global ID of the self-hosted model providing the AI setting.
features [AiFeatures!]! Array of AI features being configured (for single or batch update).
offeredModelRef String Identifier of the selected model for the feature.
provider AiFeatureProviders! Provider for AI setting.

Fields#

Name Type Description
aiFeatureSettings [AiFeatureSetting!]! List of AI feature settings after mutation.
errors [String!]! Errors encountered during the mutation.

aiFlowScheduleCreate#

히스토리

Input type: AiFlowScheduleCreateInput

Arguments#

Name Type Description Default
active Boolean Indicates whether the schedule should be active. true
cron String! Cron expression defining the schedule frequency.
cronTimezone String! IANA timezone for the cron expression.
description String! Description of the schedule.
flowTriggerId AiFlowTriggerID! Global ID of the flow trigger to schedule.

Fields#

Name Type Description
aiFlowSchedule AiFlowScheduleType Created flow schedule.
errors [String!]! Errors encountered during the mutation.

aiFlowScheduleDelete#

히스토리

Input type: AiFlowScheduleDeleteInput

Arguments#

Name Type Description
id AiFlowScheduleID! Global ID of the flow schedule to delete.

Fields#

Name Type Description
aiFlowSchedule AiFlowScheduleType Deleted flow schedule.
errors [String!]! Errors encountered during the mutation.

aiFlowScheduleUpdate#

히스토리

Input type: AiFlowScheduleUpdateInput

Arguments#

Name Type Description
active Boolean Indicates whether the schedule should be active.
cron String Cron expression defining the schedule frequency.
cronTimezone String IANA timezone for the cron expression.
description String Description of the schedule.
id AiFlowScheduleID! Global ID of the flow schedule to update.

Fields#

Name Type Description
aiFlowSchedule AiFlowScheduleType Updated flow schedule.
errors [String!]! Errors encountered during the mutation.

aiFlowTriggerCreate#

히스토리

Input type: AiFlowTriggerCreateInput

Arguments#

Name Type Description
active Boolean Introduced as an experiment in GitLab 19.4.

Indicates whether the AI flow trigger is active. Defaults to true.
aiCatalogItemConsumerId AiCatalogItemConsumerID AI catalog item consumer to use instead of config_path.
configPath String Path to the configuration file for the AI flow trigger.
description String! Description of the AI flow trigger.
eventTypes [Int!] Event types that triggers the AI flow.
filter JSON Introduced as an experiment in GitLab 19.0.

Filter conditions for the AI flow trigger.
goals JSON Introduced as an experiment in GitLab 19.5.

Goals for the AI flow trigger, keyed by event type.
projectPath ID! Full path of the project the AI flow trigger is associated with.
userId UserID Service account for the AI flow trigger.

Fields#

Name Type Description
aiFlowTrigger AiFlowTriggerType Created AI flow trigger.
errors [String!]! Errors encountered during the mutation.

aiFlowTriggerDelete#

히스토리

Input type: AiFlowTriggerDeleteInput

Arguments#

Name Type Description
id AiFlowTriggerID! ID of the flow trigger to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

aiFlowTriggerUpdate#

히스토리

Input type: AiFlowTriggerUpdateInput

Arguments#

Name Type Description
active Boolean Introduced as an experiment in GitLab 19.4.

Indicates whether the AI flow trigger is active. Inactive triggers do not run automatically.
aiCatalogItemConsumerId AiCatalogItemConsumerID AI catalog item consumer to use instead of config_path.
configPath String Path to the configuration file for the AI flow trigger.
description String Description of the AI flow trigger.
eventTypes [Int!] Event types that triggers the AI flow.
filter JSON Introduced as an experiment in GitLab 18.11.

Filter conditions for the AI flow trigger.
goals JSON Introduced as an experiment in GitLab 19.5.

Goals for the AI flow trigger, keyed by event type.
id AiFlowTriggerID! ID of the flow trigger to update.
userId UserID Service account for the AI flow trigger.

Fields#

Name Type Description
aiFlowTrigger AiFlowTriggerType Updated AI flow trigger.
errors [String!]! Errors encountered during the mutation.

aiModelSelectionNamespaceModelAllowlistUpdate#

히스토리

Updates the namespace-level model selection allowlist for an AI feature.

Input type: AiModelSelectionNamespaceModelAllowlistUpdateInput

Arguments#

Name Type Description
allowlistEnabled Boolean! 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.
feature AiFeatures! AI feature whose model allowlist is being configured.
groupId GroupID! Group whose model allowlist is being configured.

Fields#

Name Type Description
allowList AiModelSelectionAllowList Model selection allowlist for the feature after the update.
errors [String!]! Errors encountered during the mutation.

aiModelSelectionNamespaceUpdate#

히스토리

Updates or creates settings for AI features for a namespace.

Input type: AiModelSelectionNamespaceUpdateInput

Arguments#

Name Type Description
features [AiModelSelectionFeatures!]! Array of AI features being configured (for single or batch update).
groupId GroupID! Group for the model selection.
offeredModelRef String! Identifier of the selected model for the feature.

Fields#

Name Type Description
aiFeatureSettings [AiModelSelectionNamespaceFeatureSetting!]! Introduced as an experiment in GitLab 18.1.

List of AI feature settings after mutation.
errors [String!]! Errors encountered during the mutation.

aiSelfHostedModelConnectionCheck#

히스토리

Checks if the AI Gateway can establish a connection with the given model configuration.

Input type: AiSelfHostedModelConnectionCheckInput

Arguments#

Name Type Description
apiToken String API token to access the self-hosted model, if any.
endpoint String Endpoint of the self-hosted model.
iamRole String IAM role ARN that the AI Gateway assumes through STS AssumeRole when calling Amazon Bedrock. Only used by the Amazon Bedrock provider.
identifier String Identifier for 3rd party model provider.
model AiAcceptedSelfHostedModels! AI model deployed.
name String! Deployment name of the self-hosted model.
provider AiSelfHostedModelProvider! Provider for the self-hosted model.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
result CloudConnectorProbeResult Self-hosted hosted connection check result.

aiSelfHostedModelCreate#

히스토리

Input type: AiSelfHostedModelCreateInput

Arguments#

Name Type Description
apiToken String API token to access the self-hosted model, if any.
endpoint String Endpoint of the self-hosted model.
iamRole String IAM role ARN that the AI Gateway assumes through STS AssumeRole when calling Amazon Bedrock. Only used by the Amazon Bedrock provider.
identifier String Identifier for 3rd party model provider.
model AiAcceptedSelfHostedModels! AI model deployed.
name String! Deployment name of the self-hosted model.
provider AiSelfHostedModelProvider! Provider for the self-hosted model.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
selfHostedModel AiSelfHostedModel Self-hosted model after mutation.

aiSelfHostedModelDelete#

히스토리

Deletes a self-hosted model.

Input type: AiSelfHostedModelDeleteInput

Arguments#

Name Type Description
id AiSelfHostedModelID! Global ID of the self-hosted model to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

aiSelfHostedModelUpdate#

히스토리

Updates a self-hosted model.

Input type: AiSelfHostedModelUpdateInput

Arguments#

Name Type Description
apiToken String API token to access the self-hosted model, if any.
endpoint String Endpoint of the self-hosted model.
iamRole String IAM role ARN that the AI Gateway assumes through STS AssumeRole when calling Amazon Bedrock. Only used by the Amazon Bedrock provider.
id AiSelfHostedModelID! Global ID of the self-hosted model to update.
identifier String Identifier for 3rd party model provider.
model AiAcceptedSelfHostedModels! AI model deployed.
name String! Deployment name of the self-hosted model.
provider AiSelfHostedModelProvider! Provider for the self-hosted model.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
selfHostedModel AiSelfHostedModel Self-hosted model after mutation.

alertSetAssignees#

Input type: AlertSetAssigneesInput

Arguments#

Name Type Description
assigneeUsernames [String!]! Usernames to assign to the alert. Replaces existing assignees by default.
iid String! IID of the alert to mutate.
operationMode MutationOperationMode Operation to perform. Defaults to REPLACE.
projectPath ID! Project the alert to mutate is in.

Fields#

Name Type Description
alert AlertManagementAlert Alert after mutation.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.
todo Todo To-do item after mutation.

alertTodoCreate#

Input type: AlertTodoCreateInput

Arguments#

Name Type Description
iid String! IID of the alert to mutate.
projectPath ID! Project the alert to mutate is in.

Fields#

Name Type Description
alert AlertManagementAlert Alert after mutation.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.
todo Todo To-do item after mutation.

approvalProjectRuleDelete#

히스토리

Input type: approvalProjectRuleDeleteInput

Arguments#

Name Type Description
id ApprovalProjectRuleID! Global ID of the approval project rule to delete.

Fields#

Name Type Description
approvalRule ApprovalProjectRule Deleted approval rule.
errors [String!]! Errors encountered during the mutation.

approvalProjectRuleUpdate#

히스토리

Input type: approvalProjectRuleUpdateInput

Arguments#

Name Type Description
approvalsRequired Int! How many approvals are required to satisfy rule.
coverageMinimumThreshold Float Minimum 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.
id ApprovalProjectRuleID! Global ID of the approval rule to destroy.
name String! Name of the approval rule.
userIds [ID!] List of IDs of Users that can approval rule.

Fields#

Name Type Description
approvalRule ApprovalProjectRule Approval rule after mutation.
errors [String!]! Errors encountered during the mutation.

approveDeployment#

Input type: ApproveDeploymentInput

Arguments#

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

Fields#

Name Type Description
deploymentApproval DeploymentApproval DeploymentApproval after mutation.
errors [String!]! Errors encountered during the mutation.

artifactDestroy#

Input type: ArtifactDestroyInput

Arguments#

Name Type Description
id CiJobArtifactID! ID of the artifact to delete.

Fields#

Name Type Description
artifact CiJobArtifact Deleted artifact.
errors [String!]! Errors encountered during the mutation.

artifactRegistryActivate#

히스토리

Activates an Artifact Registry for an organization by claiming a slug.

Input type: ArtifactRegistryActivateInput

Arguments#

Name Type Description
slug String! Slug to claim, Artifact Registry's immutable identifier for the namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ArtifactRegistry Introduced as an experiment in GitLab 19.4.

The organization's registry: the one just provisioned, or the existing one when the organization is already activated. Null on every other refusal.

artifactRegistryArtifactDelete#

히스토리

Deletes one artifact of an Artifact Registry repository. Permanently deletes a published artifact on a hosted repository and evicts a cached artifact on a remote repository, following the kind of the repository addressed. Artifact Registry accepts the request rather than completing it, so the mutation reports acceptance rather than completion. Re-read the artifact list to see the result.

Input type: ArtifactRegistryArtifactDeleteInput

Arguments#

Name Type Description
id ID! ID of the artifact in Artifact Registry, as returned by the id field on a package or image. Not a GitLab global ID.
name String! Name of the repository holding the artifact, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted artifact. Counters were read before the deletion applied, so they can lag its result. Null when the deletion was not applied.

artifactRegistryContainerTagDelete#

히스토리

Deletes a container tag, identified by its name. Applies only to container repositories in Docker or OCI format. This mutation never reads the repository kind. Artifact Registry decides the outcome from its own records. On a hosted repository, deletion permanently removes the tag. On a remote repository, it evicts the cached tag reference. On a virtual repository, the request is passed through for Artifact Registry to decide. Deleting a tag never removes the manifest it pointed at. Artifact Registry accepts the request rather than completing it, so this mutation reports acceptance, not completion.

Input type: ArtifactRegistryContainerTagDeleteInput

Arguments#

Name Type Description
imageId ID! ID of the image holding the tag in Artifact Registry, as returned by the id field on an image. Not a GitLab global ID.
name String! Name of the repository holding the tag, unique within the organization.
tagName String! Name of the tag to delete. Limited to 1024 characters.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted tag. A tag delete moves no repository counter. Null when the deletion was not accepted.

artifactRegistryDisable#

히스토리

Disables Artifact Registry for the organization resolved from the request context (the X-GitLab-Organization-ID header, or the user default organization).

Input type: ArtifactRegistryDisableInput

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ArtifactRegistry Registry after the transition. Null when the transition was rejected, for example an unknown namespace.

artifactRegistryEnable#

히스토리

Enables Artifact Registry for the organization resolved from the request context (the X-GitLab-Organization-ID header, or the user default organization).

Input type: ArtifactRegistryEnableInput

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ArtifactRegistry Registry after the transition. Null when the transition was rejected, for example an unknown namespace.

artifactRegistryManifestDelete#

히스토리

Deletes a manifest, identified by its digest. Applies only to Docker or OCI container repositories, whose kind this mutation never reads. Artifact Registry decides the outcome from its records, permanently removing the manifest on a hosted repository, evicting the cached copy on a remote one, or passing the request through on a virtual one. Deleting a manifest removes tags pointing at it and index entries where it is the parent, though a manifest it indexed survives untagged. Artifact Registry accepts rather than completes the request, so this reports acceptance. Re-read the image's manifests afterward for the result. Deletion is refused if another manifest indexes the target as a child, and the error lists at most 10 blocking digests plus the total count.

Input type: ArtifactRegistryManifestDeleteInput

Arguments#

Name Type Description
digest String! Content-addressable digest of the manifest, as returned by the digest field on a manifest. Limited to 512 characters.
imageId ID! ID of the image holding the manifest in Artifact Registry, as returned by the id field on an image. Not a GitLab global ID.
name String! Name of the repository holding the manifest, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted manifest. Counters were read before the deletion applied, so they can lag its result. Null when the deletion was not accepted.

artifactRegistryNpmDistTagDelete#

히스토리

Deletes one dist-tag of an npm package in an Artifact Registry repository, addressed by its Artifact Registry ID. Applies to npm repositories only. A non-npm repository is refused before any request reaches Artifact Registry, and the refusal appears in the payload errors. A remote repository is refused the same way, because Artifact Registry holds the dist-tags of a remote repository as a rewritten document rather than as individually addressable rows, so there is no dist-tag row to delete. Removes the dist-tag alone, never the version it named. The mutation reports acceptance rather than completion.

Input type: ArtifactRegistryNpmDistTagDeleteInput

Arguments#

Name Type Description
id ID! ID of the dist-tag in Artifact Registry. Not a GitLab global ID.
name String! Name of the repository holding the dist-tag, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted dist-tag. A dist-tag delete moves no repository counter. Null when the deletion was not accepted.

artifactRegistryRepositoryArtifactsDelete#

히스토리

Deletes every artifact of an Artifact Registry repository. Permanently deletes published artifacts on a hosted repository and evicts cached artifacts on a remote repository, following the kind of the repository addressed. Artifact Registry accepts the request rather than completing it, so the mutation reports acceptance rather than completion. Re-read the artifact list to see the result.

Input type: ArtifactRegistryRepositoryArtifactsDeleteInput

Arguments#

Name Type Description
name String! Name of the repository whose artifacts are deleted, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository the deletion targeted. Counters were read before the deletion applied, so they can lag its result. Null when the deletion was not applied.

artifactRegistryRepositoryCreate#

히스토리

Creates a repository in Artifact Registry.

Input type: ArtifactRegistryRepositoryCreateInput

Arguments#

Name Type Description
description String Human-readable description of the repository.
format ArtifactRegistryRepositoryFormat! Package format the repository holds. Cannot be changed after creation.
kind ArtifactRegistryRepositoryKind How the repository sources its artifacts. Defaults to hosted in Artifact Registry.
name String! Name of the repository, unique within the organization.
settings ArtifactRegistryRemoteSettingsInput Introduced as an experiment in GitLab 19.4.

Upstream configuration. Required on a remote repository create, rejected on any other kind.
upstreamRepositoryIds [ID!] Introduced as an experiment in GitLab 19.5.

Upstream repositories of a virtual repository, as Artifact Registry repository IDs in resolution order. On update, replaces the whole upstream list, and an empty list removes every upstream. Rejected on any other kind. Maximum is 1000 IDs per request. Artifact Registry sets a lower limit on how many upstreams a repository can have.
visibility ArtifactRegistryRepositoryVisibility Who can read the repository.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
refusedUpstreamRepositoryId ID Introduced as an experiment in GitLab 19.5.

Artifact Registry ID of the first upstream list entry that Artifact Registry refused. Null unless an entry was refused.
repository ArtifactRegistryRepository Repository created. Null when the creation was not applied.

artifactRegistryRepositoryDelete#

히스토리

Deletes a repository in Artifact Registry and removes every artifact it holds. Deleting an already-absent repository still succeeds.

Input type: ArtifactRegistryRepositoryDeleteInput

Arguments#

Name Type Description
name String! Name of the repository to delete, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

artifactRegistryRepositoryTestConnection#

히스토리

Tests the upstream connection of a remote repository in Artifact Registry.

Input type: ArtifactRegistryRepositoryTestConnectionInput

Arguments#

Name Type Description
name String! Name of the repository to test, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
httpStatus Int Status the upstream answered the probe with. Null when the probe failed in transport and no response arrived, and when no probe ran.
lastHealthCheckedAt Time Timestamp of the most recent health probe of the upstream, as it reads after this probe. Null when no verdict is recorded, including when this probe's own write did not land.
lastHealthStatus ArtifactRegistryHealthStatus Stored health verdict as it reads after the probe. Can differ from passed, because Artifact Registry moves it to UNHEALTHY only once consecutive failures reach its threshold. UNKNOWN when no verdict is recorded, including when this probe's own write did not land, and for a status this schema does not recognize. Null when no probe ran.
passed Boolean Indicates the upstream answered the probe with a status below 500. Reports reachability rather than credential validity, so an upstream 401 or 404 passes. Null when no probe ran.

artifactRegistryRepositoryUpdate#

히스토리

Updates a repository in Artifact Registry. Artifact Registry writes the metadata fields and the settings in separate transactions, metadata first, so a failed update can leave a visibility or description change applied while the settings did not change. Re-sending the same mutation converges.

Input type: ArtifactRegistryRepositoryUpdateInput

Arguments#

Name Type Description
description String Human-readable description of the repository.
name String! Name of the repository to update, unique within the organization. Cannot be changed.
settings ArtifactRegistryRemoteSettingsInput Introduced as an experiment in GitLab 19.4.

Upstream configuration. Required on a remote repository create, rejected on any other kind.
upstreamRepositoryIds [ID!] Introduced as an experiment in GitLab 19.5.

Upstream repositories of a virtual repository, as Artifact Registry repository IDs in resolution order. On update, replaces the whole upstream list, and an empty list removes every upstream. Rejected on any other kind. Maximum is 1000 IDs per request. Artifact Registry sets a lower limit on how many upstreams a repository can have.
visibility ArtifactRegistryRepositoryVisibility Who can read the repository.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
refusedUpstreamRepositoryId ID Introduced as an experiment in GitLab 19.5.

Artifact Registry ID of the first upstream list entry that Artifact Registry refused. Null unless an entry was refused.
repository ArtifactRegistryRepository Repository updated. Null when the update was not applied.

artifactRegistryRoleBulkGrant#

히스토리

Grants Artifact Registry roles to users on resources in a single all-or-nothing operation. Replaces any role a user already holds on that resource.

Input type: ArtifactRegistryRoleBulkGrantInput

Arguments#

Name Type Description
assignments [ArtifactRegistryRoleAssignmentInput!]! Role assignments to grant. All succeed or none are written. A maximum of 1000 assignments is allowed per request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
grantedRoleCount Int Number of role assignments granted. Present only on success.

artifactRegistryRoleBulkRevoke#

히스토리

Revokes Artifact Registry roles from users on resources in a single all-or-nothing operation. Users can revoke their own role.

Input type: ArtifactRegistryRoleBulkRevokeInput

Arguments#

Name Type Description
revocations [ArtifactRegistryRoleRevocationInput!]! Role revocations to apply. All succeed or none are applied. A maximum of 1000 revocations is allowed per request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
revokedRoleCount Int Number of role assignments revoked. Present only on success.

artifactRegistryRoleGrant#

히스토리

Grants an Artifact Registry role to a user on a resource. Replaces any role the user already holds on that resource.

Input type: ArtifactRegistryRoleGrantInput

Arguments#

Name Type Description
assigneeId UserID! Global ID of the user to grant the role to.
resourceId String! UUID of the Artifact Registry resource (repository or namespace) the role applies to.
role ArtifactRegistryRole! Artifact Registry role to grant.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

artifactRegistryRoleRevoke#

히스토리

Revokes a user's Artifact Registry role on a resource. Names no role: a user holds one role per resource, and revoking removes it. Users can revoke their own role.

Input type: ArtifactRegistryRoleRevokeInput

Arguments#

Name Type Description
assigneeId UserID! Global ID of the user to revoke the role from.
resourceId String! UUID of the Artifact Registry resource (repository or namespace) the role is assigned on.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

artifactRegistryUpstreamRepositoryDissociate#

히스토리

Removes an upstream repository association from a virtual repository in Artifact Registry. The upstream repository and its artifacts remain unchanged, and Artifact Registry compacts the remaining upstream positions. Succeeds even when the association is already gone, or the repository is missing, inaccessible, not virtual, or not of the given format.

Input type: ArtifactRegistryUpstreamRepositoryDissociateInput

Arguments#

Name Type Description
associationId ID! ID of the upstream repository association to remove, as returned by the id field on an upstream repository association. Not a GitLab global ID.
format ArtifactRegistryRepositoryFormat! Package format of the virtual repository.
name String! Name of the virtual repository holding the upstream repository, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

artifactRegistryUpstreamTestConnection#

히스토리

Tests a supplied upstream connection for the remote repository create form in Artifact Registry, before any repository exists to hold it.

Input type: ArtifactRegistryUpstreamTestConnectionInput

Arguments#

Name Type Description
credentials ArtifactRegistryRemoteCredentialsInput Upstream 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.
format ArtifactRegistryRepositoryFormat! Package format of the upstream to probe. Decides the credential shape and the probe auth.
url String! Base URL of the upstream to probe.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
httpStatus Int Status the upstream answered the probe with. Null when the probe failed in transport and no response arrived, and when no probe ran.
passed Boolean Indicates the upstream answered the probe with a status below 500. Reports reachability rather than credential validity, so an upstream 401 or 404 passes. Null when no probe ran.

artifactRegistryVersionDelete#

히스토리

Deletes one version of a package in an Artifact Registry repository. Permanently deletes a published version on a hosted repository and evicts a cached version on a remote repository, following the kind of the repository addressed. Artifact Registry accepts the request rather than completing it, so the mutation reports acceptance rather than completion. Re-read the version list to see the result. Applies to Maven and npm repositories only.

Input type: ArtifactRegistryVersionDeleteInput

Arguments#

Name Type Description
id ID! ID of the version in Artifact Registry, as returned by the id field on a version. Not a GitLab global ID.
name String! Name of the repository holding the version, unique within the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
repository ArtifactRegistryRepository Repository holding the deleted version. Counters were read before the deletion applied, so they can lag its result. Null when the deletion was not applied.

ascpComponentCreate#

히스토리

Input type: AscpComponentCreateInput

Arguments#

Name Type Description
description String Component description.
expectedUserBehavior String Expected user behavior for the component.
projectPath ID! Full path of the project.
scanId SecurityAscpScanID! ID of the scan when the component was discovered.
subDirectory String! Sub-directory path containing the component.
title String! Component title.

Fields#

Name Type Description
component AscpComponent Introduced as an experiment in GitLab 18.11.

Created component.
errors [String!]! Errors encountered during the mutation.

ascpScanCreate#

히스토리

Input type: AscpScanCreateInput

Arguments#

Name Type Description Default
baseCommitSha String Base commit SHA for incremental scans.
baseScanId SecurityAscpScanID ID of the base scan for incremental scans.
commitSha String! Git commit SHA that was scanned.
projectPath ID! Full path of the project.
scanType AscpScanType Type of scan (default: full). FULL

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
scan AscpScan Introduced as an experiment in GitLab 18.10.

Created scan.

ascpSecurityContextCreate#

히스토리

Input type: AscpSecurityContextCreateInput

Arguments#

Name Type Description
authenticationModel String How users authenticate to the component.
authorizationModel String How access is controlled.
componentId SecurityAscpComponentID! ID of the component.
dataSensitivity String Types of sensitive data handled.
guidelines [AscpSecurityGuidelineInput!]! List of security guidelines.
projectPath ID! Full path of the project.
scanId SecurityAscpScanID! ID of the scan when the security context was created.
securityBoundary [AscpSecurityBoundary!] Security boundaries the component sits on.
summary String High-level threat model summary.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityContext AscpSecurityContext Introduced as an experiment in GitLab 18.11.

Created security context.

auditEventsAmazonS3ConfigurationCreate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsCreate with amazonS3 category instead.

Input type: AuditEventsAmazonS3ConfigurationCreateInput

Arguments#

Name Type Description
accessKeyXid String! Access key ID of the Amazon S3 account.
awsRegion String! AWS region where the bucket is created.
bucketName String! Name of the bucket where the audit events would be logged.
groupPath ID! Group path.
name String Destination name.
secretAccessKey String! Secret access key of the Amazon S3 account.

Fields#

Name Type Description
amazonS3Configuration AmazonS3ConfigurationType configuration created.
errors [String!]! Errors encountered during the mutation.

auditEventsAmazonS3ConfigurationDelete#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsDelete instead.

Input type: AuditEventsAmazonS3ConfigurationDeleteInput

Arguments#

Name Type Description
id AuditEventsAmazonS3ConfigurationID! ID of the Amazon S3 configuration to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsAmazonS3ConfigurationUpdate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsUpdate instead.

Input type: AuditEventsAmazonS3ConfigurationUpdateInput

Arguments#

Name Type Description
accessKeyXid String Access key ID of the Amazon S3 account.
active Boolean Active status of the destination.
awsRegion String AWS region where the bucket is created.
bucketName String Name of the bucket where the audit events would be logged.
id AuditEventsAmazonS3ConfigurationID! ID of the Amazon S3 configuration to update.
name String Destination name.
secretAccessKey String Secret access key of the Amazon S3 account.

Fields#

Name Type Description
amazonS3Configuration AmazonS3ConfigurationType Updated Amazon S3 configuration.
errors [String!]! Errors encountered during the mutation.

auditEventsGroupDestinationDenylistEventsAdd#

히스토리

Input type: AuditEventsGroupDestinationDenylistEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add to the denylist.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of denylisted event type filters for the audit event external destination.

auditEventsGroupDestinationDenylistEventsDelete#

히스토리

Input type: AuditEventsGroupDestinationDenylistEventsDeleteInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from the denylist.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsGroupDestinationEventsAdd#

히스토리

Input type: AuditEventsGroupDestinationEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add for streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of event type filters for the audit event external destination.

auditEventsGroupDestinationEventsDelete#

히스토리

Input type: AuditEventsGroupDestinationEventsDeleteInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsGroupDestinationNamespaceFilterCreate#

히스토리

Input type: AuditEventsGroupDestinationNamespaceFilterCreateInput

Arguments#

Name Type Description
destinationId AuditEventsGroupExternalStreamingDestinationID! Destination ID.
namespacePath String Full path of the namespace(only project or group).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceFilter GroupAuditEventNamespaceFilter Namespace filter created.

auditEventsGroupDestinationNamespaceFilterDelete#

히스토리

Input type: AuditEventsGroupDestinationNamespaceFilterDeleteInput

Arguments#

Name Type Description
namespaceFilterId AuditEventsGroupNamespaceFilterID! Namespace filter ID.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsInstanceAmazonS3ConfigurationCreate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsCreate with amazonS3 category instead.

Input type: AuditEventsInstanceAmazonS3ConfigurationCreateInput

Arguments#

Name Type Description
accessKeyXid String! Access key ID of the Amazon S3 account.
awsRegion String! AWS region where the bucket is created.
bucketName String! Name of the bucket where the audit events would be logged.
name String Destination name.
secretAccessKey String! Secret access key of the Amazon S3 account.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceAmazonS3Configuration InstanceAmazonS3ConfigurationType Created instance Amazon S3 configuration.

auditEventsInstanceAmazonS3ConfigurationDelete#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsDelete instead.

Input type: AuditEventsInstanceAmazonS3ConfigurationDeleteInput

Arguments#

Name Type Description
id AuditEventsInstanceAmazonS3ConfigurationID! ID of the instance-level Amazon S3 configuration to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsInstanceAmazonS3ConfigurationUpdate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsUpdate instead.

Input type: AuditEventsInstanceAmazonS3ConfigurationUpdateInput

Arguments#

Name Type Description
accessKeyXid String Access key ID of the Amazon S3 account.
active Boolean Active status of the destination.
awsRegion String AWS region where the bucket is created.
bucketName String Name of the bucket where the audit events would be logged.
id AuditEventsInstanceAmazonS3ConfigurationID! ID of the instance-level Amazon S3 configuration to update.
name String Destination name.
secretAccessKey String Secret access key of the Amazon S3 account.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceAmazonS3Configuration InstanceAmazonS3ConfigurationType Updated instance-level Amazon S3 configuration.

auditEventsInstanceDestinationEventsAdd#

히스토리

Input type: AuditEventsInstanceDestinationEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add for streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of event type filters for the audit event external destination.

auditEventsInstanceDestinationEventsDelete#

히스토리

Input type: AuditEventsInstanceDestinationEventsDeleteInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalStreamingDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsInstanceDestinationNamespaceFilterCreate#

히스토리

Input type: AuditEventsInstanceDestinationNamespaceFilterCreateInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalStreamingDestinationID! Destination ID.
namespacePath String Full path of the namespace. Project or group namespaces only.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceFilter InstanceAuditEventNamespaceFilter Namespace filter to be created.

auditEventsInstanceDestinationNamespaceFilterDelete#

히스토리

Input type: AuditEventsInstanceDestinationNamespaceFilterDeleteInput

Arguments#

Name Type Description
namespaceFilterId AuditEventsInstanceNamespaceFilterID! Namespace filter ID.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingDestinationEventsAdd#

Deprecated in GitLab 18.10. Use auditEventsGroupDestinationEventsAdd instead.

Input type: AuditEventsStreamingDestinationEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsExternalAuditEventDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add for streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of event type filters for the audit event external destination.

auditEventsStreamingDestinationEventsRemove#

Deprecated in GitLab 18.10. Use auditEventsGroupDestinationEventsRemove instead.

Input type: AuditEventsStreamingDestinationEventsRemoveInput

Arguments#

Name Type Description
destinationId AuditEventsExternalAuditEventDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingDestinationInstanceEventsAdd#

Deprecated in GitLab 18.10. Use auditEventsInstanceDestinationEventsAdd instead.

Input type: AuditEventsStreamingDestinationInstanceEventsAddInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalAuditEventDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to add for streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
eventTypeFilters [String!] List of event type filters for the audit event external destination.

auditEventsStreamingDestinationInstanceEventsRemove#

Deprecated in GitLab 18.10. Use auditEventsInstanceDestinationEventsRemove instead.

Input type: AuditEventsStreamingDestinationInstanceEventsRemoveInput

Arguments#

Name Type Description
destinationId AuditEventsInstanceExternalAuditEventDestinationID! Destination id.
eventTypeFilters [String!]! List of event type filters to remove from streaming.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingHeadersCreate#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use groupAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingHeadersCreateInput

Arguments#

Name Type Description Default
active Boolean Boolean option determining whether header is active or not. true
destinationId AuditEventsExternalAuditEventDestinationID! Destination to associate header with.
key String! Header key.
value String! Header value.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
header AuditEventStreamingHeader Created header.

auditEventsStreamingHeadersDestroy#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use groupAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingHeadersDestroyInput

Arguments#

Name Type Description
headerId AuditEventsStreamingHeaderID! Header to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingHeadersUpdate#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use groupAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingHeadersUpdateInput

Arguments#

Name Type Description Default
active Boolean Boolean option determining whether header is active or not. null
headerId AuditEventsStreamingHeaderID! Header to update.
key String Header key. null
value String Header value. null

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
header AuditEventStreamingHeader Updates header.

auditEventsStreamingHttpNamespaceFiltersAdd#

Deprecated in GitLab 18.10. Use auditEventsGroupDestinationNamespaceFilterCreate instead.

Input type: AuditEventsStreamingHTTPNamespaceFiltersAddInput

Arguments#

Name Type Description
destinationId AuditEventsExternalAuditEventDestinationID! Destination ID.
groupPath ID Full path of the group.
projectPath ID Full path of the project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceFilter AuditEventStreamingHTTPNamespaceFilter Namespace filter created.

auditEventsStreamingHttpNamespaceFiltersDelete#

Deprecated in GitLab 18.10. Use auditEventsGroupDestinationNamespaceFilterDelete instead.

Input type: AuditEventsStreamingHTTPNamespaceFiltersDeleteInput

Arguments#

Name Type Description
namespaceFilterId AuditEventsStreamingHTTPNamespaceFilterID! Namespace filter ID.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingInstanceHeadersCreate#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use instanceAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingInstanceHeadersCreateInput

Arguments#

Name Type Description Default
active Boolean Boolean option determining whether header is active or not. true
destinationId AuditEventsInstanceExternalAuditEventDestinationID! Instance level external destination to associate header with.
key String! Header key.
value String! Header value.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
header AuditEventsStreamingInstanceHeader Created header.

auditEventsStreamingInstanceHeadersDestroy#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use instanceAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingInstanceHeadersDestroyInput

Arguments#

Name Type Description
headerId AuditEventsStreamingInstanceHeaderID! Header to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

auditEventsStreamingInstanceHeadersUpdate#

Deprecated in GitLab 18.10. Configure headers by using the streaming destination configuration. Use instanceAuditEventStreamingDestinationsUpdate.

Input type: AuditEventsStreamingInstanceHeadersUpdateInput

Arguments#

Name Type Description Default
active Boolean Boolean option determining whether header is active or not. null
headerId AuditEventsStreamingInstanceHeaderID! Header to update.
key String Header key. null
value String Header value. null

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
header AuditEventsStreamingInstanceHeader Updates header.

awardEmojiAdd#

Input type: AwardEmojiAddInput

Arguments#

Name Type Description
awardableId AwardableID! Global ID of the awardable resource.
name String! Emoji name.

Fields#

Name Type Description
awardEmoji AwardEmoji Emoji reactions after mutation.
errors [String!]! Errors encountered during the mutation.

awardEmojiRemove#

Input type: AwardEmojiRemoveInput

Arguments#

Name Type Description
awardableId AwardableID! Global ID of the awardable resource.
name String! Emoji name.

Fields#

Name Type Description
awardEmoji AwardEmoji Emoji reactions after mutation.
errors [String!]! Errors encountered during the mutation.

awardEmojiToggle#

Input type: AwardEmojiToggleInput

Arguments#

Name Type Description
awardableId AwardableID! Global ID of the awardable resource.
name String! Emoji name.

Fields#

Name Type Description
awardEmoji AwardEmoji Emoji reactions after mutation.
errors [String!]! Errors encountered during the mutation.
toggledOn Boolean! Indicates the status of the emoji. True if the toggle awarded the emoji, and false if the toggle removed the emoji.

boardEpicCreate#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: BoardEpicCreateInput

Arguments#

Name Type Description
boardId BoardsEpicBoardID! Global ID of the board that the epic is in.
groupPath ID! Group the epic to create is in.
listId BoardsEpicListID! Global ID of the epic board list in which epic will be created.
title String! Title of the epic.

Fields#

Name Type Description
epic Epic Epic after creation.
errors [String!]! Errors encountered during the mutation.

boardListCreate#

Input type: BoardListCreateInput

Arguments#

Name Type Description
assigneeId UserID Global ID of an existing user.
backlog Boolean Create the backlog list.
boardId BoardID! Global ID of the issue board to mutate.
iterationId IterationID Global ID of an existing iteration.
labelId LabelID Global ID of an existing label.
milestoneId MilestoneID Global ID of an existing milestone.
position Int Position of the list.
statusId WorkItemsStatusesStatusID Introduced as an experiment in GitLab 18.0.

Global ID of an existing status.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list BoardList Issue list in the issue board.

boardListUpdateLimitMetrics#

Input type: BoardListUpdateLimitMetricsInput

Arguments#

Name Type Description
limitMetric ListLimitMetric New limit metric type for the list.
listId ListID! Global ID of the list.
maxIssueCount Int New maximum issue count limit.
maxIssueWeight Int New maximum issue weight limit.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list BoardList Updated list.

branchDelete#

Input type: BranchDeleteInput

Arguments#

Name Type Description
name String! Name of the branch.
projectPath ID! Project full path the branch is associated with.

Fields#

Name Type Description
branch Branch Branch after mutation.
errors [String!]! Errors encountered during the mutation.

branchRuleApprovalProjectRuleCreate#

히스토리

Input type: branchRuleApprovalProjectRuleCreateInput

Arguments#

Name Type Description
approvalsRequired Int! How many approvals are required to satisfy rule.
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule to destroy.
coverageMinimumThreshold Float Minimum 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.
name String! Name of the approval rule.
userIds [ID!] List of IDs of Users that can approval rule.

Fields#

Name Type Description
approvalRule ApprovalProjectRule Approval rule after mutation.
errors [String!]! Errors encountered during the mutation.

branchRuleCreate#

히스토리

Input type: BranchRuleCreateInput

Arguments#

Name Type Description
name String! Branch name, with wildcards, for the branch rules.
projectPath ID! Full path to the project that the branch is associated with.

Fields#

Name Type Description
branchRule BranchRule Branch rule after mutation.
errors [String!]! Errors encountered during the mutation.

branchRuleDelete#

히스토리

Input type: BranchRuleDeleteInput

Arguments#

Name Type Description
id ProjectsBranchRuleID! Global ID of the branch rule to destroy.

Fields#

Name Type Description
branchRule BranchRule Branch rule after mutation.
errors [String!]! Errors encountered during the mutation.

branchRuleExternalStatusCheckCreate#

히스토리

Create a new external status check from a branch rule.

Input type: BranchRuleExternalStatusCheckCreateInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule to update.
externalUrl String! URL of external status check resource.
name String! Name of the external status check.
sharedSecret String HMAC shared secret for authenticating external status check requests.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalStatusCheck ExternalStatusCheck New status check after mutation.

branchRuleExternalStatusCheckDestroy#

히스토리

Destroy an external status check from a branch rule.

Input type: BranchRuleExternalStatusCheckDestroyInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.
id MergeRequestsExternalStatusCheckID! Global ID of the external status check to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

branchRuleExternalStatusCheckUpdate#

히스토리

Update an external status check from a branch rule.

Input type: BranchRuleExternalStatusCheckUpdateInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.
externalUrl String! External URL of the external status check.
id MergeRequestsExternalStatusCheckID! Global ID of the external status check to update.
name String! Name of the external status check.
sharedSecret String HMAC shared secret for authenticating external status check requests.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalStatusCheck ExternalStatusCheck Updated external status check after mutation.

branchRuleSquashOptionCreate#

히스토리

Create a squash option for a branch rule.

Input type: BranchRuleSquashOptionCreateInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.
squashOption SquashOptionSetting! Squash option to set for the branch rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
squashOption SquashOption Created squash option after mutation.

branchRuleSquashOptionDelete#

히스토리

Delete a squash option for a branch rule.

Input type: BranchRuleSquashOptionDeleteInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

branchRuleSquashOptionUpdate#

히스토리

Update a squash option for a branch rule.

Input type: BranchRuleSquashOptionUpdateInput

Arguments#

Name Type Description
branchRuleId ProjectsBranchRuleID! Global ID of the branch rule.
squashOption SquashOptionSetting! Squash option after mutation.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
squashOption SquashOption Updated squash option after mutation.

branchRuleUpdate#

히스토리

Input type: BranchRuleUpdateInput

Arguments#

Name Type Description
branchProtection BranchProtectionInput Branch protections configured for the branch rule.
id ProjectsBranchRuleID! Global ID of the branch rule to update.
name String! Branch name, with wildcards, for the branch rules.

Fields#

Name Type Description
branchRule BranchRule Branch rule after mutation.
errors [String!]! Errors encountered during the mutation.

bulkDestroyJobArtifacts#

히스토리

Input type: BulkDestroyJobArtifactsInput

Arguments#

Name Type Description
ids [CiJobArtifactID!]! Global IDs of the job artifacts to destroy.
projectId ProjectID! Global Project ID of the job artifacts to destroy. Incompatible with projectPath.

Fields#

Name Type Description
destroyedCount Int Number of job artifacts deleted.
destroyedIds [CiJobArtifactID!] IDs of job artifacts that were deleted.
errors [String!]! Errors encountered during the mutation.

bulkEnableDevopsAdoptionNamespaces#

Status: Beta.

Input type: BulkEnableDevopsAdoptionNamespacesInput

Arguments#

Name Type Description
displayNamespaceId NamespaceID Display namespace ID.
namespaceIds [NamespaceID!]! List of Namespace IDs.

Fields#

Name Type Description
enabledNamespaces [DevopsAdoptionEnabledNamespace!] Enabled namespaces after mutation.
errors [String!]! Errors encountered during the mutation.

bulkRunnerDelete#

히스토리

Input type: BulkRunnerDeleteInput

Arguments#

Name Type Description
ids [CiRunnerID!] IDs of the runners to delete.

Fields#

Name Type Description
deletedCount Int Number of records effectively deleted. Only present if operation was performed synchronously.
deletedIds [CiRunnerID!] IDs of records effectively deleted. Only present if operation was performed synchronously.
errors [String!]! Errors encountered during the mutation.

bulkSetVulnerabilityFindingsDueDates#

Bulk set due dates for vulnerability findings using individual UUID entries. This operation is best-effort: valid updates are applied even if some fail.

Input type: BulkSetVulnerabilityFindingsDueDatesInput

Arguments#

Name Type Description
projectFullPath String! Full path of the project.
updates [FindingDueDatesSetInput!]! List of finding UUIDs with due dates. A maximum of 1000 updates is allowed per request.

Fields#

Name Type Description
assigned Int Number of findings for which a due date was successfully assigned.
errors [FindingDueDatesSetError!]! Errors encountered during the mutation. A maximum of 1000 errors are returned per request.
removed Int Number of findings for which a due date was successfully removed.
skipped Int Number of findings that were skipped due to errors or not found.

bulkUpdateAiToolRules#

히스토리

Bulk updates permission settings for multiple AI tool rules.

Input type: BulkUpdateAiToolRulesInput

Arguments#

Name Type Description
fullPath ID! Full path of the root namespace to update tool rules for.
projectPath ID Full 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). Each entry replaces the whole rule, so a partial entry clears the access types it omits.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
results [BulkToolRuleResult!]! Results for each tool rule update, including any per-item errors.

bulkUpdateSecurityAttributes#

Input type: BulkUpdateSecurityAttributesInput

Arguments#

Name Type Description
attributes [SecurityAttributeID!]! Global IDs of security attributes to apply.
items [ID!]! Global IDs of groups and projects to update.
mode SecurityAttributeBulkUpdateMode! Update mode: add, remove, or replace attributes.

Fields#

Name Type Description
errors [String!]! Errors encountered while initiating the bulk update operation.

cancelVulnerabilityWorkflow#

히스토리

Cancels a vulnerability workflow execution.

Input type: CancelVulnerabilityWorkflowInput

Arguments#

Name Type Description
projectId ProjectID! Global ID of the project.
workflow VulnerabilityDuoWorkflow! Workflow to cancel.

Fields#

Name Type Description
errorReason VulnerabilityWorkflowErrorReason Machine-readable reason for the mutation error.
errors [String!]! Errors encountered during the mutation.
execution VulnerabilityWorkflowExecution Workflow execution.

catalogResourcesCreate#

히스토리

Input type: CatalogResourcesCreateInput

Arguments#

Name Type Description
projectPath ID! Project path belonging to the catalog resource.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

catalogResourcesDestroy#

히스토리

Input type: CatalogResourcesDestroyInput

Arguments#

Name Type Description
projectPath ID! Project path belonging to the catalog resource.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

cdApplicationCreate#

히스토리

Creates a continuous deployment application in an organization.

Input type: CdApplicationCreateInput

Arguments#

Name Type Description
description String Description of the application.
name String! Name of the application.
organizationId OrganizationsOrganizationID! Global ID of the organization to create the application in.
services [CdServiceInput!] Services to create in the application, up to 1000.

Fields#

Name Type Description
application CdApplication Application created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdApplicationFlowDefinitionCreate#

히스토리

Creates a new pipeline version of a continuous deployment application flow definition.

Input type: CdApplicationFlowDefinitionCreateInput

Arguments#

Name Type Description
applicationId CdApplicationID! Global ID of the application to create the flow definition for.
definition String! Body of the flow definition.

Fields#

Name Type Description
applicationFlowDefinition CdApplicationFlowDefinition Application flow definition created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdApplicationLinkCreate#

히스토리

Creates a link on a continuous deployment application.

Input type: CdApplicationLinkCreateInput

Arguments#

Name Type Description
applicationId CdApplicationID! Global ID of the application to create the link in.
linkType CdApplicationLinkType! Type of the link.
name String! Name of the link.
url String! URL of the link.

Fields#

Name Type Description
applicationLink CdApplicationLink Link created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdApplicationLinkDelete#

히스토리

Deletes a link on a continuous deployment application.

Input type: CdApplicationLinkDeleteInput

Arguments#

Name Type Description
id CdApplicationLinkID! Global ID of the link to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

cdApplicationLinkUpdate#

히스토리

Updates a link on a continuous deployment application.

Input type: CdApplicationLinkUpdateInput

Arguments#

Name Type Description
id CdApplicationLinkID! Global ID of the link to update.
linkType CdApplicationLinkType Type of the link.
name String Name of the link.
url String URL of the link.

Fields#

Name Type Description
applicationLink CdApplicationLink Link updated by the mutation.
errors [String!]! Errors encountered during the mutation.

cdApplicationUpdate#

히스토리

Updates a continuous deployment application.

Input type: CdApplicationUpdateInput

Arguments#

Name Type Description
description String Description of the application.
id CdApplicationID! Global ID of the application to update.
name String Name of the application.

Fields#

Name Type Description
application CdApplication Application updated by the mutation.
errors [String!]! Errors encountered during the mutation.

cdArtifactSourceCreate#

히스토리

Creates a continuous deployment artifact source for a service.

Input type: CdArtifactSourceCreateInput

Arguments#

Name Type Description
name String! Name of the artifact source.
serviceId CdServiceID! Global ID of the service to create the artifact source for.
sourceConfig JSON Configuration of the artifact source, defined by the consuming driver.
sourceRef String! Reference of the artifact source.

Fields#

Name Type Description
artifactSource CdArtifactSource Artifact source created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdEnvironmentCreate#

히스토리

Creates a continuous deployment environment in an organization.

Input type: CdEnvironmentCreateInput

Arguments#

Name Type Description
description String Description of the environment.
environmentDriverBinding CdEnvironmentDriverBindingInput! Driver binding to create for the environment.
name String! Name of the environment.
organizationId OrganizationsOrganizationID! Global ID of the organization to create the environment in.
tier CdEnvironmentTier! Tier of the environment.

Fields#

Name Type Description
environment CdEnvironment Environment created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdEnvironmentDriverBindingCreate#

히스토리

Creates a new versioned driver binding for a continuous deployment environment.

Input type: CdEnvironmentDriverBindingCreateInput

Arguments#

Name Type Description
environmentDriverBinding CdEnvironmentDriverBindingInput! Driver binding to create for the environment.
environmentId CdEnvironmentID! Global ID of the environment to bind the driver to.

Fields#

Name Type Description
environmentDriverBinding CdEnvironmentDriverBinding Environment driver binding created by the mutation.
errors [String!]! Errors encountered during the mutation.

cdEnvironmentUpdate#

히스토리

Updates a continuous deployment environment.

Input type: CdEnvironmentUpdateInput

Arguments#

Name Type Description
description String Description of the environment.
id CdEnvironmentID! Global ID of the environment to update.
name String Name of the environment.
tier CdEnvironmentTier Tier of the environment.

Fields#

Name Type Description
environment CdEnvironment Environment updated by the mutation.
errors [String!]! Errors encountered during the mutation.

cdRolloutCreate#

히스토리

Creates a continuous deployment rollout in an organization.

Input type: CdRolloutCreateInput

Arguments#

Name Type Description
organizationId OrganizationsOrganizationID! Global ID of the organization to create the rollout in.
versionSetId CdVersionSetID! Global ID of the version set the rollout deploys.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
rollout CdRollout Rollout created by the mutation.

cdRolloutGateResolve#

히스토리

Resolves an open approval gate on a continuous deployment rollout by recording the decision in the rollout transition journal.

Input type: CdRolloutGateResolveInput

Arguments#

Name Type Description
id CdRolloutID! Global ID of the rollout whose approval gate is being resolved.
resolutionReason String Reason for the decision.
status CdRolloutGateStatus! Decision to record for the approval gate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
rolloutTransition CdRolloutTransition Rollout transition journal entry created by the mutation.

cdServiceCreate#

히스토리

Creates a continuous deployment service in an application.

Input type: CdServiceCreateInput

Arguments#

Name Type Description
applicationId CdApplicationID! Global ID of the application to create the service in.
description String Description of the service.
name String! Name of the service.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
service CdService Service created by the mutation.

cdServiceUpdate#

히스토리

Updates a continuous deployment service.

Input type: CdServiceUpdateInput

Arguments#

Name Type Description
description String Description of the service.
id CdServiceID! Global ID of the service to update.
name String Name of the service.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
service CdService Service updated by the mutation.

cdVersionCreate#

히스토리

Creates a continuous deployment version from a free-text name, for artifacts GitLab did not observe being pushed.

Input type: CdVersionCreateInput

Arguments#

Name Type Description
artifactSourceId CdArtifactSourceID! Global ID of the artifact source to create the version for.
name String! Name of the version.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
version CdVersion Version created by the mutation.

cdVersionSetCreate#

히스토리

Creates a continuous deployment version set in an application.

Input type: CdVersionSetCreateInput

Arguments#

Name Type Description
applicationId CdApplicationID! Global ID of the application to create the version set in.
description String Description of the version set.
name String! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
versionSet CdVersionSet Version set created by the mutation.

ciJobTokenScopeAddGroupOrProject#

Input type: CiJobTokenScopeAddGroupOrProjectInput

Arguments#

Name Type Description Default
defaultPermissions Boolean Introduced as an experiment in GitLab 17.8.

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

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

Fields#

Name Type Description
ciJobTokenScope CiJobTokenScopeType CI job token's access scope.
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciJobTokenScopeAddProject#

Input type: CiJobTokenScopeAddProjectInput

Arguments#

Name Type Description
direction CiJobTokenScopeDirection Deprecated in GitLab 16.0. Outbound job token scope is being removed. This field can now only be set to INBOUND.
projectPath ID! Project that the CI job token scope belongs to.
targetProjectPath ID! Project to be added to the CI job token scope.

Fields#

Name Type Description
ciJobTokenScope CiJobTokenScopeType CI job token's access scope.
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciJobTokenScopeRemoveGroup#

Input type: CiJobTokenScopeRemoveGroupInput

Arguments#

Name Type Description
projectPath ID! Project that the CI job token scope belongs to.
targetGroupPath ID! Group to be removed from the CI job token scope.

Fields#

Name Type Description
ciJobTokenScope CiJobTokenScopeType CI job token's access scope.
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciJobTokenScopeRemoveProject#

Input type: CiJobTokenScopeRemoveProjectInput

Arguments#

Name Type Description
direction CiJobTokenScopeDirection Deprecated in GitLab 16.9. Outbound job token scope is being removed. This field can now only be set to INBOUND.
projectPath ID! Project that the CI job token scope belongs to.
targetProjectPath ID! Project to be removed from the CI job token scope.

Fields#

Name Type Description
ciJobTokenScope CiJobTokenScopeType CI job token's access scope.
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciJobTokenScopeUpdatePolicies#

히스토리

Input type: CiJobTokenScopeUpdatePoliciesInput

Arguments#

Name Type Description
defaultPermissions Boolean! 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.
projectPath ID! Project that the CI job token scope belongs to.
targetPath ID! Group or project that the CI job token targets.

Fields#

Name Type Description
ciJobTokenScopeAllowlistEntry CiJobTokenScopeAllowlistEntry Introduced as an experiment in GitLab 17.6.

Allowlist entry for the CI job token's access scope.
errors [String!]! Errors encountered during the mutation.

ciLint#

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

Input type: CiLintInput

Arguments#

Name Type Description
content String! Contents of .gitlab-ci.yml.
dryRun Boolean Run pipeline creation simulation, or only do static check.
projectPath ID! Project of the CI config.
ref String Ref to use when linting. Default is the project default branch.

Fields#

Name Type Description
config CiConfigV2 Linted CI config and metadata.
errors [String!]! Errors encountered during the mutation.

clusterAgentDelete#

Input type: ClusterAgentDeleteInput

Arguments#

Name Type Description
id ClustersAgentID! Global ID of the cluster agent that will be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

clusterAgentTokenCreate#

Input type: ClusterAgentTokenCreateInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! Global ID of the cluster agent that will be associated with the new token.
description String Description of the token.
name String! Name of the token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
secret String Token secret value. Make sure you save it - you won't be able to access it again.
token ClusterAgentToken Token created after mutation.

clusterAgentTokenRevoke#

Input type: ClusterAgentTokenRevokeInput

Arguments#

Name Type Description
id ClustersAgentTokenID! Global ID of the agent token that will be revoked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

clusterAgentUrlConfigurationCreate#

Input type: ClusterAgentUrlConfigurationCreateInput

Arguments#

Name Type Description
caCert String Base64-encoded CA certificate in PEM format to verify the agent endpoint.
clientCert String Base64-encoded client certificate in PEM format if mTLS authentication should be used. Must be provided with client_key.
clientKey String Base64-encoded client key in PEM format if mTLS authentication should be used. Must be provided with client_cert.
clusterAgentId ClustersAgentID! Global ID of the cluster agent that will be associated with the new URL configuration.
tlsHost String TLS host name to verify the server name in agent endpoint certificate.
url String! URL for the new URL configuration.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
urlConfiguration ClusterAgentUrlConfiguration URL configuration created after mutation.

clusterAgentUrlConfigurationDelete#

Input type: ClusterAgentUrlConfigurationDeleteInput

Arguments#

Name Type Description
id ClustersAgentsUrlConfigurationID! Global ID of the agent URL configuration that will be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

commitCreate#

Input type: CommitCreateInput

Arguments#

Name Type Description Default
actions [CommitAction!] Array of action hashes to commit as a batch. []
allowEmpty Boolean Indicates whether an empty commit can be created. Defaults to false. false
branch String! Name of the branch to commit into, it can be a new branch.
message String! Raw commit message.
projectPath ID! Project full path the branch is associated with.
startBranch String If on a new branch, name of the original branch.
startProjectPath ID Full path of the project to start the commit from. Must be the project itself or a project it was forked from.
startSha String SHA of the commit to start the new branch from. Mutually exclusive with startBranch.

Fields#

Name Type Description
commit Commit Commit after mutation.
commitPipelinePath String ETag path for the commit's pipeline.
content [String!] Contents of the commit.
errors [String!]! Errors encountered during the mutation.

configureContainerScanning#

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

Input type: ConfigureContainerScanningInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

configureDependencyScanning#

Enable dependency scanning .gitlab-ci.yml file in a new branch. The new branch and a URL to create a merge request are a part of the response.

Input type: ConfigureDependencyScanningInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

configureSast#

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

Input type: ConfigureSastInput

Arguments#

Name Type Description
configuration SastCiConfigurationInput! SAST CI configuration for the project.
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

configureSastIac#

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

Input type: ConfigureSastIacInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

configureSecretDetection#

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

Input type: ConfigureSecretDetectionInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
branch String Branch that has the new/modified .gitlab-ci.yml file.
errors [String!]! Errors encountered during the mutation.
successPath String Redirect path to use when the response is successful.

containerCacheEntryDelete#

히스토리

Input type: ContainerCacheEntryDeleteInput

Arguments#

Name Type Description
id String! ID of the cache entry.

Fields#

Name Type Description
cacheEntry ContainerUpstreamCacheEntry Deleted container cache entry.
errors [String!]! Errors encountered during the mutation.

containerUpstreamCacheDelete#

히스토리

Input type: ContainerUpstreamCacheDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesContainerUpstreamID! ID of the container virtual registry upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream ContainerUpstream Container virtual registry upstream.

containerUpstreamCreate#

히스토리

Input type: ContainerUpstreamCreateInput

Arguments#

Name Type Description Default
cacheValidityHours Int Cache validity period. Defaults to 24 hours. 24
description String Description of the upstream registry.
id VirtualRegistriesContainerRegistryID! ID of the upstream registry.
name String! Name of upstream registry.
password String Password of the upstream registry.
url String! URL of the upstream registry.
username String Username of the upstream registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream ContainerUpstreamDetails Container upstream after the mutation.

containerUpstreamDelete#

히스토리

Input type: ContainerUpstreamDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesContainerUpstreamID! ID of the upstream to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream ContainerUpstreamDetails Destroyed upstream.

containerUpstreamTest#

히스토리

Input type: ContainerUpstreamTestInput

Arguments#

Name Type Description
groupPath ID Full path of the group to test the upstream registry against. Required when id is not provided.
id VirtualRegistriesContainerUpstreamID ID of the upstream registry to test. When provided, groupPath, url, username, and password are ignored.
password String Password for authenticating with the upstream registry. Used when id is not provided.
url String URL of the upstream registry to test. Required when GraphqlExplorerControllerid is not provided.
username String Username for authenticating with the upstream registry. Used when id is not provided.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Whether the upstream connectivity test was successful.

containerUpstreamUpdate#

히스토리

Input type: ContainerUpstreamUpdateInput

Arguments#

Name Type Description
cacheValidityHours Int Cache validity period.
description String Description of the upstream registry.
id VirtualRegistriesContainerUpstreamID! ID of the container virtual registry upstream.
name String Name of upstream registry.
password String Password of the upstream registry.
url String URL of the upstream registry.
username String Username of the upstream registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream ContainerUpstreamDetails Container upstream after the mutation.

containerVirtualRegistryCacheDelete#

히스토리

Input type: ContainerVirtualRegistryCacheDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesContainerRegistryID! ID of the container virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ContainerRegistry Container virtual registry.

containerVirtualRegistryCreate#

히스토리

Input type: ContainerVirtualRegistryCreateInput

Arguments#

Name Type Description
description String Description of the virtual registry.
groupPath ID Full path of the group with which the resource is associated.
name String! Name of virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ContainerRegistry Container virtual registry after the mutation.

containerVirtualRegistryDelete#

히스토리

Input type: ContainerVirtualRegistryDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesContainerRegistryID! ID of the container virtual registry to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ContainerRegistry Deleted container virtual registry.

containerVirtualRegistryUpdate#

히스토리

Input type: ContainerVirtualRegistryUpdateInput

Arguments#

Name Type Description
description String Description of the virtual registry.
id VirtualRegistriesContainerRegistryID! ID of the container virtual registry to be updated.
name String Name of virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry ContainerRegistry Container virtual registry after the mutation.

containerVirtualRegistryUpstreamCreate#

히스토리

Input type: ContainerVirtualRegistryUpstreamCreateInput

Arguments#

Name Type Description
registryId VirtualRegistriesContainerRegistryID! ID of the container virtual registry.
upstreamId VirtualRegistriesContainerUpstreamID! ID of the upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream ContainerRegistryUpstreamWithRegistry Container registry upstream after association.

containerVirtualRegistryUpstreamDelete#

히스토리

Input type: ContainerVirtualRegistryUpstreamDeleteInput

Arguments#

Name Type Description
upstreamId VirtualRegistriesContainerRegistryUpstreamID! ID of the container virtual registry upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream ContainerRegistryUpstreamWithRegistry Deleted container registry upstream.

containerVirtualRegistryUpstreamUpdate#

히스토리

Input type: ContainerVirtualRegistryUpstreamUpdateInput

Arguments#

Name Type Description
id VirtualRegistriesContainerRegistryUpstreamID! ID of the container virtual registry upstream.
position Int! Priority order of an upstream within a virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream ContainerRegistryUpstreamWithRegistry Container registry upstream after update.

corpusCreate#

Input type: CorpusCreateInput

Arguments#

Name Type Description
fullPath ID! Project the corpus belongs to.
packageId PackagesPackageID! ID of the corpus package.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

createAlertIssue#

Input type: CreateAlertIssueInput

Arguments#

Name Type Description
iid String! IID of the alert to mutate.
projectPath ID! Project the alert to mutate is in.

Fields#

Name Type Description
alert AlertManagementAlert Alert after mutation.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.
todo Todo To-do item after mutation.

createAnnotation#

Deprecated in GitLab 16.0. Underlying feature was removed in 16.0.

Input type: CreateAnnotationInput

Arguments#

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

Fields#

Name Type Description
annotation MetricsDashboardAnnotation Created annotation.
errors [String!]! Errors encountered during the mutation.

createBoard#

Input type: CreateBoardInput

Arguments#

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

Fields#

Name Type Description
board Board Board after mutation.
errors [String!]! Errors encountered during the mutation.

createBranch#

Input type: CreateBranchInput

Arguments#

Name Type Description
name String! Name of the branch.
projectPath ID! Project full path the branch is associated with.
ref String! Branch name or commit SHA to create branch from.

Fields#

Name Type Description
branch Branch Branch after mutation.
errors [String!]! Errors encountered during the mutation.

createClusterAgent#

Input type: CreateClusterAgentInput

Arguments#

Name Type Description
name String! Name of the cluster agent.
projectPath ID! Full path of the associated project for the cluster agent.

Fields#

Name Type Description
clusterAgent ClusterAgent Cluster agent created after mutation.
errors [String!]! Errors encountered during the mutation.

createComplianceFramework#

Input type: CreateComplianceFrameworkInput

Arguments#

Name Type Description
namespacePath ID! Full path of the namespace to add the compliance framework to.
params ComplianceFrameworkInput! Parameters to update the compliance framework with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
framework ComplianceFramework Created compliance framework.

createComplianceFrameworkFromTemplate#

히스토리

Input type: CreateComplianceFrameworkFromTemplateInput

Arguments#

Name Type Description
color String Override the color of the compliance framework in hex format. e.g. #FCA121.
default Boolean Set the compliance framework as the default framework for the group.
description String Override the description of the compliance framework.
name String Override the name of the compliance framework.
namespacePath ID! Full path of the namespace to add the compliance framework to.
templateId ComplianceManagementFrameworksTemplateRegistryTemplateID! Unique identifier of the template to create the framework from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
framework ComplianceFramework Created compliance framework.

createComplianceRequirement#

히스토리

Input type: CreateComplianceRequirementInput

Arguments#

Name Type Description
complianceFrameworkId ComplianceManagementFrameworkID! Global ID of the compliance framework of the new requirement.
controls [ComplianceRequirementsControlInput!] Controls to add to the compliance requirement.
params ComplianceRequirementInput! Parameters to update the compliance requirement with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirement ComplianceRequirement Created compliance requirement.

createComplianceRequirementsControl#

히스토리

Input type: CreateComplianceRequirementsControlInput

Arguments#

Name Type Description
complianceRequirementId ComplianceManagementComplianceFrameworkComplianceRequirementID! Global ID of the compliance requirement of the new control.
params ComplianceRequirementsControlInput! Parameters to create the compliance requirement control.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirementsControl ComplianceRequirementsControl Created compliance requirements control.

createContainerProtectionRepositoryRule#

Creates a repository protection rule to restrict access to a project's container registry.

Input type: CreateContainerProtectionRepositoryRuleInput

Arguments#

Name Type Description
minimumAccessLevelForDelete ContainerProtectionRepositoryRuleAccessLevel Introduced as an experiment 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.
minimumAccessLevelForPush ContainerProtectionRepositoryRuleAccessLevel Minimum 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.
projectPath ID! Full path of the project where a protection rule is located.
repositoryPathPattern String! 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.

Fields#

Name Type Description
containerProtectionRepositoryRule ContainerProtectionRepositoryRule Container repository protection rule after mutation.
errors [String!]! Errors encountered during the mutation.

createContainerProtectionTagRule#

히스토리

Creates a protection rule to control which user roles can modify container image tags matching a specified pattern.

Input type: createContainerProtectionTagRuleInput

Arguments#

Name Type Description
minimumAccessLevelForDelete ContainerProtectionTagRuleAccessLevel Minimum 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.
minimumAccessLevelForPush ContainerProtectionTagRuleAccessLevel Minimum 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.
projectPath ID! Full path of the project containing the container image tags.
tagNamePattern String! The pattern that matches container image tags to protect. For example, v1.*. Wildcard character * allowed.

Fields#

Name Type Description
containerProtectionTagRule ContainerProtectionTagRule Protection rule for container image tags after creation.
errors [String!]! Errors encountered during the mutation.

createCustomDashboard#

히스토리

Creates a custom dashboard in an organization.

Input type: CreateCustomDashboardInput

Arguments#

Name Type Description
config CustomDashboardConfigInput! Dashboard layout/config.
description String Dashboard description.
name String! Dashboard name.
namespaceId NamespaceID Namespace to scope the dashboard to.
organizationId OrganizationsOrganizationID Organization the dashboard belongs to. Defaults to the current organization if not provided.

Fields#

Name Type Description
dashboard CustomDashboard Newly created dashboard.
errors [String!]! Errors encountered during creation.

createCustomEmoji#

Input type: CreateCustomEmojiInput

Arguments#

Name Type Description
groupPath ID! Namespace full path the emoji is associated with.
name String! Name of the emoji.
url String! Location of the emoji file.

Fields#

Name Type Description
customEmoji CustomEmoji New custom emoji.
errors [String!]! Errors encountered during the mutation.

createDiffNote#

Input type: CreateDiffNoteInput

Arguments#

Name Type Description
body String! Content of the note.
internal Boolean Internal flag for a note. Default is false.
noteableId NoteableID! Global ID of the resource to add a note to.
position DiffPositionInput! Position of the note on a diff.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createDiscussion#

Input type: CreateDiscussionInput

Arguments#

Name Type Description
body String! Content of the note.
internal Boolean Internal flag for a note. Default is false.
noteableId NoteableID! Global ID of the resource to add a note to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createEpic#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: CreateEpicInput

Arguments#

Name Type Description
addLabelIds [ID!] IDs of labels to be added to the epic.
addLabels [String!] Array of labels to be added to the epic.
color Color Color of the epic.
confidential Boolean Indicates if the epic is confidential.
description String Description of the epic.
dueDateFixed String End date of the epic.
dueDateIsFixed Boolean Indicates end date should be sourced from due_date_fixed field not the issue milestones.
groupPath ID! Group the epic to mutate is in.
removeLabelIds [ID!] IDs of labels to be removed from the epic.
startDateFixed String Start date of the epic.
startDateIsFixed Boolean Indicates start date should be sourced from start_date_fixed field not the issue milestones.
title String Title of the epic.

Fields#

Name Type Description
epic Epic Created epic.
errors [String!]! Errors encountered during the mutation.

createFunctionalVerificationWorkflow#

히스토리

Input type: CreateFunctionalVerificationWorkflowInput

Arguments#

Name Type Description
checkType FunctionalVerificationCheckType! Type of functional verification check to run.
fullPath ID! Full path of the namespace to run the verification check against.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workflowId AiDuoWorkflowsWorkflowID Global ID of the workflow created for the run.

createImageDiffNote#

Input type: CreateImageDiffNoteInput

Arguments#

Name Type Description
body String! Content of the note.
internal Boolean Internal flag for a note. Default is false.
noteableId NoteableID! Global ID of the resource to add a note to.
position DiffImagePositionInput! Position of the note on a diff.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createIssue#

Input type: CreateIssueInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

createIteration#

Deprecated in GitLab 14.0. Use iterationCreate.

Input type: CreateIterationInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iteration Iteration Created iteration.

createLatestDiffNote#

히스토리

Creates a diff note on a merge request using minimal parameters. SHAs, file paths, and position type are resolved automatically from the latest merge request diff.

Input type: CreateLatestDiffNoteInput

Arguments#

Name Type Description
body String! Content of the note.
endNewLine Int End 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.
endOldLine Int End 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.
filePath String! Path of the file to comment on. For renamed files, either the old or new path can be used.
headSha String! 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.
internal Boolean Internal flag for a note. Default is false.
newLine Int Line 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.
noteableId MergeRequestID! Global ID of the merge request to add a diff note to.
oldLine Int Line 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createNote#

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

Input type: CreateNoteInput

Arguments#

Name Type Description
body String! Content of the note.
discussionId DiscussionID Global ID of the discussion the note is in reply to.
internal Boolean Internal flag for a note. Default is false.
mergeRequestDiffHeadSha String SHA of the head commit which is used to ensure that the merge request has not been updated since the request was sent.
noteableId NoteableID! Global ID of the resource to add a note to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

createPackagesProtectionRule#

Creates a protection rule to restrict access to project packages.

Input type: CreatePackagesProtectionRuleInput

Arguments#

Name Type Description
minimumAccessLevelForDelete PackagesProtectionRuleAccessLevelForDelete Introduced as an experiment 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.
minimumAccessLevelForPush PackagesProtectionRuleAccessLevel Minimum 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.
packageNamePattern String! Package name protected by the protection rule. For example, @my-scope/my-package-*. Wildcard character * allowed.
packageType PackagesProtectionRulePackageType! Package type protected by the protection rule. For example, NPM, PYPI.
projectPath ID! Full path of the project where a protection rule is located.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packageProtectionRule PackagesProtectionRule Packages protection rule after mutation.

createRequirement#

Input type: CreateRequirementInput

Arguments#

Name Type Description
description String Description of the requirement.
projectPath ID! Full project path the requirement is associated with.
title String Title of the requirement.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirement Requirement Requirement after mutation.

createSnippet#

Input type: CreateSnippetInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
snippet Snippet Snippet after mutation.

createTerraformStateProtectionRule#

히스토리

Creates a protection rule for a Terraform state backend.

Input type: CreateTerraformStateProtectionRuleInput

Arguments#

Name Type Description Default
allowedFrom TerraformStateProtectionRuleAllowedFrom Introduced as an experiment 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
minimumAccessLevelForWrite TerraformStateProtectionRuleAccessLevel! Minimum GitLab access level required to perform write operations on the Terraform state. Valid values include DEVELOPER, MAINTAINER, OWNER, or ADMIN.
projectPath ID! Full path of the project where the protection rule is located.
stateName String! Terraform state name protected by the rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
terraformStateProtectionRule TerraformStateProtectionRule Introduced as an experiment in GitLab 19.1.

Terraform state protection rule after mutation.

createTestCase#

Input type: CreateTestCaseInput

Arguments#

Name Type Description
confidential Boolean Sets the test case confidentiality.
description String Test case description.
labelIds [ID!] IDs of labels to be added to the test case.
projectPath ID! Project full path to create the test case in.
title String! Test case title.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
testCase Issue Test case created.

customFieldArchive#

히스토리

Input type: CustomFieldArchiveInput

Arguments#

Name Type Description
id IssuablesCustomFieldID! Global ID of the custom field.

Fields#

Name Type Description
customField CustomField Archived custom field.
errors [String!]! Errors encountered during the mutation.

customFieldCreate#

히스토리

Input type: CustomFieldCreateInput

Arguments#

Name Type Description
fieldType CustomFieldType! Type of custom field.
groupPath ID! Group path where the custom field is created.
name String! 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.

Fields#

Name Type Description
customField CustomField Created custom field.
errors [String!]! Errors encountered during the mutation.

customFieldUnarchive#

히스토리

Input type: CustomFieldUnarchiveInput

Arguments#

Name Type Description
id IssuablesCustomFieldID! Global ID of the custom field.

Fields#

Name Type Description
customField CustomField Unarchived custom field.
errors [String!]! Errors encountered during the mutation.

customFieldUpdate#

히스토리

Input type: CustomFieldUpdateInput

Arguments#

Name Type Description
id IssuablesCustomFieldID! Global ID of the custom field.
name String 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.

Fields#

Name Type Description
customField CustomField Updated custom field.
errors [String!]! Errors encountered during the mutation.

customerRelationsContactCreate#

Input type: CustomerRelationsContactCreateInput

Arguments#

Name Type Description
description String Description of or notes for the contact.
email String Email address of the contact.
firstName String! First name of the contact.
groupId GroupID! Group for the contact.
lastName String! Last name of the contact.
organizationId CustomerRelationsOrganizationID Organization for the contact.
phone String Phone number of the contact.

Fields#

Name Type Description
contact CustomerRelationsContact Contact after the mutation.
errors [String!]! Errors encountered during the mutation.

customerRelationsContactUpdate#

Input type: CustomerRelationsContactUpdateInput

Arguments#

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

Fields#

Name Type Description
contact CustomerRelationsContact Contact after the mutation.
errors [String!]! Errors encountered during the mutation.

customerRelationsOrganizationCreate#

Input type: CustomerRelationsOrganizationCreateInput

Arguments#

Name Type Description
defaultRate Float Standard billing rate for the organization.
description String Description of or notes for the organization.
groupId GroupID! Group for the organization.
name String! Name of the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization CustomerRelationsOrganization Organization after the mutation.

customerRelationsOrganizationUpdate#

Input type: CustomerRelationsOrganizationUpdateInput

Arguments#

Name Type Description
active Boolean State of the organization.
defaultRate Float Standard billing rate for the organization.
description String Description of or notes for the organization.
id CustomerRelationsOrganizationID! Global ID of the organization.
name String Name of the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization CustomerRelationsOrganization! Organization after the mutation.

dastOnDemandScanCreate#

Input type: DastOnDemandScanCreateInput

Arguments#

Name Type Description
dastScannerProfileId DastScannerProfileID ID of the scanner profile to be used for the scan.
dastSiteProfileId DastSiteProfileID! ID of the site profile to be used for the scan.
fullPath ID! Project the site profile belongs to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineUrl String URL of the pipeline that was created.

dastProfileCreate#

Input type: DastProfileCreateInput

Arguments#

Name Type Description Default
branchName String Associated branch.
dastProfileSchedule DastProfileScheduleInput Represents a DAST Profile Schedule.
dastScannerProfileId DastScannerProfileID! ID of the scanner profile to be associated.
dastSiteProfileId DastSiteProfileID! ID of the site profile to be associated.
description String Description of the profile. Defaults to an empty string. ""
fullPath ID! Project the profile belongs to.
name String! Name of the profile.
runAfterCreate Boolean Run scan using profile after creation. Defaults to false. false
tagList [String!] Indicates the runner tags associated with the profile.

Fields#

Name Type Description
dastProfile DastProfile Created profile.
errors [String!]! Errors encountered during the mutation.
pipelineUrl String URL of the pipeline that was created. Requires runAfterCreate to be set to true.

dastProfileDelete#

Input type: DastProfileDeleteInput

Arguments#

Name Type Description
id DastProfileID! ID of the profile to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

dastProfileRun#

Input type: DastProfileRunInput

Arguments#

Name Type Description
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastProfileID! ID of the profile to be used for the scan.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineUrl String URL of the pipeline that was created.

dastProfileUpdate#

Input type: DastProfileUpdateInput

Arguments#

Name Type Description Default
branchName String Associated branch.
dastProfileSchedule DastProfileScheduleInput Represents a DAST profile schedule.
dastScannerProfileId DastScannerProfileID ID of the scanner profile to be associated.
dastSiteProfileId DastSiteProfileID ID of the site profile to be associated.
description String Description of the profile. Defaults to an empty string. ""
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastProfileID! ID of the profile to be deleted.
name String Name of the profile.
runAfterUpdate Boolean Run scan using profile after update. Defaults to false. false
tagList [String!] Indicates the runner tags associated with the profile.

Fields#

Name Type Description
dastProfile DastProfile Updated profile.
errors [String!]! Errors encountered during the mutation.
pipelineUrl String The URL of the pipeline that was created. Requires the input argument runAfterUpdate to be set to true when calling the mutation, otherwise no pipeline will be created.

dastScannerProfileCreate#

Input type: DastScannerProfileCreateInput

Arguments#

Name Type Description Default
fullPath ID! Project the scanner profile belongs to.
profileName String! Name of the scanner profile.
scanType DastScanTypeEnum Indicates the type of DAST scan that will run. Either a Passive Scan or an Active Scan. PASSIVE
showDebugMessages Boolean Indicates if debug messages should be included in DAST console output. True to include the debug messages. false
spiderTimeout Int Maximum number of minutes allowed for the spider to traverse the site.
tagList [String!] Deprecated in GitLab 15.8. Moved to DastProfile.
targetTimeout Int Maximum number of seconds allowed for the site under test to respond to a request.
useAjaxSpider Boolean Indicates 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

Fields#

Name Type Description
dastScannerProfile DastScannerProfile Created scanner profile.
errors [String!]! Errors encountered during the mutation.
id DastScannerProfileID Deprecated in GitLab 14.10. use dastScannerProfile field.

dastScannerProfileDelete#

Input type: DastScannerProfileDeleteInput

Arguments#

Name Type Description
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastScannerProfileID! ID of the scanner profile to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

dastScannerProfileUpdate#

Input type: DastScannerProfileUpdateInput

Arguments#

Name Type Description
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastScannerProfileID! ID of the scanner profile to be updated.
profileName String! Name of the scanner profile.
scanType DastScanTypeEnum Indicates the type of DAST scan that will run. Either a Passive Scan or an Active Scan.
showDebugMessages Boolean Indicates if debug messages should be included in DAST console output. True to include the debug messages.
spiderTimeout Int! Maximum number of minutes allowed for the spider to traverse the site.
tagList [String!] Deprecated in GitLab 15.8. Moved to DastProfile.
targetTimeout Int! Maximum number of seconds allowed for the site under test to respond to a request.
useAjaxSpider Boolean Indicates 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.

Fields#

Name Type Description
dastScannerProfile DastScannerProfile Updated scanner profile.
errors [String!]! Errors encountered during the mutation.
id DastScannerProfileID Deprecated in GitLab 14.10. use dastScannerProfile field.

dastSiteProfileCreate#

Input type: DastSiteProfileCreateInput

Arguments#

Name Type Description Default
auth DastSiteProfileAuthInput Parameters for authentication.
excludedUrls [String!] URLs to skip during an authenticated scan. Defaults to []. []
fullPath ID! Project the site profile belongs to.
optionalVariables [JSON!] Optional variables that can be configured for DAST scans. []
profileName String! Name of the site profile.
requestHeaders String Comma-separated list of request header names and values to be added to every request made by DAST.
scanFilePath String File Path or URL used as input for the scan method.
scanMethod DastScanMethodType Scan method by the scanner.
targetType DastTargetTypeEnum Type of target to be scanned.
targetUrl String URL of the target to be scanned.

Fields#

Name Type Description
dastSiteProfile DastSiteProfile Site Profile object.
errors [String!]! Errors encountered during the mutation.
id DastSiteProfileID Deprecated in GitLab 14.10. use dastSiteProfile.id field.

dastSiteProfileDelete#

Input type: DastSiteProfileDeleteInput

Arguments#

Name Type Description
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastSiteProfileID! ID of the site profile to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

dastSiteProfileUpdate#

Input type: DastSiteProfileUpdateInput

Arguments#

Name Type Description
auth DastSiteProfileAuthInput Parameters for authentication.
excludedUrls [String!] URLs to skip during an authenticated scan.
fullPath ID Deprecated in GitLab 14.5. Full path not required to qualify Global ID.
id DastSiteProfileID! ID of the site profile to be updated.
optionalVariables [JSON!] Optional variables that can be configured for DAST scans.
profileName String! Name of the site profile.
requestHeaders String Comma-separated list of request header names and values to be added to every request made by DAST.
scanFilePath String File Path or URL used as input for the scan method.
scanMethod DastScanMethodType Scan method by the scanner.
targetType DastTargetTypeEnum Type of target to be scanned.
targetUrl String URL of the target to be scanned.

Fields#

Name Type Description
dastSiteProfile DastSiteProfile Site profile object.
errors [String!]! Errors encountered during the mutation.
id DastSiteProfileID Deprecated in GitLab 14.10. use dastSiteProfile.id field.

dastSiteTokenCreate#

Input type: DastSiteTokenCreateInput

Arguments#

Name Type Description
fullPath ID! Project the site token belongs to.
targetUrl String URL of the target to be validated.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
id DastSiteTokenID ID of the site token.
status DastSiteProfileValidationStatusEnum Current validation status of the target.
token String Token string.

dastSiteValidationCreate#

Input type: DastSiteValidationCreateInput

Arguments#

Name Type Description
dastSiteTokenId DastSiteTokenID! ID of the site token.
fullPath ID! Project the site profile belongs to.
strategy DastSiteValidationStrategyEnum Validation strategy to be used.
validationPath String! Path to be requested during validation.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
id DastSiteValidationID ID of the site validation.
status DastSiteProfileValidationStatusEnum Current validation status.

dastSiteValidationRevoke#

Input type: DastSiteValidationRevokeInput

Arguments#

Name Type Description
fullPath ID! Project the site validation belongs to.
normalizedTargetUrl String! Normalized URL of the target to be revoked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

deleteAnnotation#

Deprecated in GitLab 16.0. Underlying feature was removed in 16.0.

Input type: DeleteAnnotationInput

Arguments#

Name Type Description
id String! Global ID of the annotation to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

deleteContainerProtectionRepositoryRule#

Deletes a container repository protection rule.

Input type: DeleteContainerProtectionRepositoryRuleInput

Arguments#

Name Type Description
id ContainerRegistryProtectionRuleID! Global ID of the container repository protection rule to delete.

Fields#

Name Type Description
containerProtectionRepositoryRule ContainerProtectionRepositoryRule Container repository protection rule that was deleted successfully.
errors [String!]! Errors encountered during the mutation.

deleteContainerProtectionTagRule#

히스토리

Deletes a protection rule that controls which user roles can modify container image tags matching a specified pattern.

Input type: DeleteContainerProtectionTagRuleInput

Arguments#

Name Type Description
id ContainerRegistryProtectionTagRuleID! Global ID of the tag protection rule to delete.

Fields#

Name Type Description
containerProtectionTagRule ContainerProtectionTagRule Deleted protection rule for container image tags.
errors [String!]! Errors encountered during the mutation.

deleteConversationThread#

히스토리

Input type: DeleteConversationThreadInput

Arguments#

Name Type Description
threadId AiConversationThreadID! Global ID of the thread to delete.

Fields#

Name Type Description
errors [String!]! List of errors that occurred whilst trying to delete the thread.
success Boolean! Returns true if thread was successfully deleted.

deleteCustomDashboard#

히스토리

Deletes a custom dashboard.

Input type: DeleteCustomDashboardInput

Arguments#

Name Type Description
id AnalyticsCustomDashboardsDashboardID! Global ID of the dashboard to delete.

Fields#

Name Type Description
dashboard CustomDashboard Deleted dashboard.
errors [String!]! Errors encountered during deletion.

deleteDuoWorkflowsWorkflow#

히스토리

Input type: DeleteDuoWorkflowsWorkflowInput

Arguments#

Name Type Description
workflowId AiDuoWorkflowsWorkflowID! Global ID of the workflow to delete.

Fields#

Name Type Description
errors [String!]! List of errors that occurred whilst trying to delete the workflow.
success Boolean! Returns true if workflow was successfully deleted.

deleteGroupCustomAttribute#

히스토리

Deletes a custom attribute from a group. Only available to admins.

Input type: DeleteGroupCustomAttributeInput

Arguments#

Name Type Description
groupPath ID! Full path of the group.
key String! Key of the custom attribute to delete.

Fields#

Name Type Description
customAttribute CustomAttribute Deleted custom attribute.
errors [String!]! Errors encountered during the mutation.

deletePackagesProtectionRule#

Deletes a protection rule for packages.

Input type: DeletePackagesProtectionRuleInput

Arguments#

Name Type Description
id PackagesProtectionRuleID! Global ID of the package protection rule to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packageProtectionRule PackagesProtectionRule Packages protection rule that was deleted successfully.

deletePagesDeployment#

히스토리

Deletes a Pages deployment.

Input type: DeletePagesDeploymentInput

Arguments#

Name Type Description
id PagesDeploymentID! ID of the Pages Deployment.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pagesDeployment PagesDeployment! Deleted Pages Deployment.

deleteProjectCustomAttribute#

히스토리

Deletes a custom attribute from a project. Only available to admins.

Input type: DeleteProjectCustomAttributeInput

Arguments#

Name Type Description
key String! Key of the custom attribute to delete.
projectPath ID! Full path of the project.

Fields#

Name Type Description
customAttribute CustomAttribute Deleted custom attribute.
errors [String!]! Errors encountered during the mutation.

deleteTerraformStateProtectionRule#

히스토리

Deletes a protection rule for a Terraform state backend.

Input type: DeleteTerraformStateProtectionRuleInput

Arguments#

Name Type Description
id TerraformStateProtectionRuleID! Global ID of the Terraform state protection rule to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
terraformStateProtectionRule TerraformStateProtectionRule Introduced as an experiment in GitLab 19.1.

Terraform state protection rule that was deleted.

deleteUserCustomAttribute#

히스토리

Deletes a custom attribute from a user. Only available to admins.

Input type: DeleteUserCustomAttributeInput

Arguments#

Name Type Description
key String! Key of the custom attribute to delete.
userId UserID! Global ID of the user.

Fields#

Name Type Description
customAttribute CustomAttribute Deleted custom attribute.
errors [String!]! Errors encountered during the mutation.

designManagementDelete#

Input type: DesignManagementDeleteInput

Arguments#

Name Type Description
filenames [String!]! Filenames of the designs to delete.
iid ID! IID of the issue to modify designs for.
projectPath ID! Project where the issue is to upload designs for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
version DesignVersion New version in which the designs are deleted.

designManagementMove#

Input type: DesignManagementMoveInput

Arguments#

Name Type Description
id DesignManagementDesignID! ID of the design to move.
next DesignManagementDesignID ID of the immediately following design.
previous DesignManagementDesignID ID of the immediately preceding design.

Fields#

Name Type Description
designCollection DesignCollection Current state of the collection.
errors [String!]! Errors encountered during the mutation.

designManagementUpdate#

Input type: DesignManagementUpdateInput

Arguments#

Name Type Description
description String Description of the design.
id DesignManagementDesignID! ID of the design to update.

Fields#

Name Type Description
design Design! Updated design.
errors [String!]! Errors encountered during the mutation.

designManagementUpload#

Input type: DesignManagementUploadInput

Arguments#

Name Type Description
files [Upload!]! Files to upload.
iid ID! IID of the issue to modify designs for.
projectPath ID! Project where the issue is to upload designs for.

Fields#

Name Type Description
designs [Design!]! Designs that were uploaded by the mutation.
errors [String!]! Errors encountered during the mutation.
skippedDesigns [Design!]! Any designs that were skipped from the upload due to there being no change to their content since their last version.

destroyBoard#

Input type: DestroyBoardInput

Arguments#

Name Type Description
id BoardID! Global ID of the board to destroy.

Fields#

Name Type Description
board Board Board after mutation.
errors [String!]! Errors encountered during the mutation.

destroyBoardList#

Input type: DestroyBoardListInput

Arguments#

Name Type Description
listId ListID! Global ID of the list to destroy. Only label lists are accepted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list BoardList List after mutation.

destroyComplianceFramework#

Input type: DestroyComplianceFrameworkInput

Arguments#

Name Type Description
id ComplianceManagementFrameworkID! Global ID of the compliance framework to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyComplianceRequirement#

히스토리

Input type: DestroyComplianceRequirementInput

Arguments#

Name Type Description
id ComplianceManagementComplianceFrameworkComplianceRequirementID! Global ID of the compliance requirement to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyComplianceRequirementsControl#

히스토리

Input type: DestroyComplianceRequirementsControlInput

Arguments#

Name Type Description
id ComplianceManagementComplianceFrameworkComplianceRequirementsControlID! Global ID of the compliance requirement control to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyContainerRepository#

Input type: DestroyContainerRepositoryInput

Arguments#

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

Fields#

Name Type Description
containerRepository ContainerRepository! Container repository policy after scheduling the deletion.
errors [String!]! Errors encountered during the mutation.

destroyContainerRepositoryTags#

Input type: DestroyContainerRepositoryTagsInput

Arguments#

Name Type Description
id ContainerRepositoryID! ID of the container repository.
tagNames [String!]! Container repository tag(s) to delete. Total number can't be greater than 20.

Fields#

Name Type Description
deletedTagNames [String!]! Deleted container repository tags.
errors [String!]! Errors encountered during the mutation.

destroyCustomEmoji#

Input type: DestroyCustomEmojiInput

Arguments#

Name Type Description
id CustomEmojiID! Global ID of the custom emoji to destroy.

Fields#

Name Type Description
customEmoji CustomEmoji Deleted custom emoji.
errors [String!]! Errors encountered during the mutation.

destroyEpicBoard#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: DestroyEpicBoardInput

Arguments#

Name Type Description
id BoardsEpicBoardID! Global ID of the board to destroy.

Fields#

Name Type Description
epicBoard EpicBoard Epic board after mutation.
errors [String!]! Errors encountered during the mutation.

destroyNote#

Input type: DestroyNoteInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

destroyPackage#

Input type: DestroyPackageInput

Arguments#

Name Type Description
id PackagesPackageID! ID of the Package.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyPackageFile#

Input type: DestroyPackageFileInput

Arguments#

Name Type Description
id PackagesPackageFileID! ID of the Package file.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyPackageFiles#

Input type: DestroyPackageFilesInput

Arguments#

Name Type Description
ids [PackagesPackageFileID!]! IDs of the Package file.
projectPath ID! Project path where the packages cleanup policy is located.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroyPackages#

Input type: DestroyPackagesInput

Arguments#

Name Type Description
ids [PackagesPackageID!]! Global IDs of the Packages. Max 100.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

destroySnippet#

Input type: DestroySnippetInput

Arguments#

Name Type Description
id SnippetID! Global ID of the snippet to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
snippet Snippet Snippet after mutation.

devfileValidate#

히스토리

Input type: DevfileValidateInput

Arguments#

Name Type Description
devfileYaml String! Input devfile.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
valid Boolean Status whether devfile is valid or not.

disableDevopsAdoptionNamespace#

Status: Beta.

Input type: DisableDevopsAdoptionNamespaceInput

Arguments#

Name Type Description
id [AnalyticsDevopsAdoptionEnabledNamespaceID!]! One or many IDs of the enabled namespaces to disable.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

discussionToggleResolve#

Toggles the resolved state of a discussion.

Input type: DiscussionToggleResolveInput

Arguments#

Name Type Description
id DiscussionID! Global ID of the discussion.
resolve Boolean! Will resolve the discussion when true, and unresolve the discussion when false.

Fields#

Name Type Description
discussion Discussion Discussion after mutation.
errors [String!]! Errors encountered during the mutation.

dismissPolicyViolations#

히스토리

Dismisses policy violations linked to a merge request.

Input type: DismissPolicyViolationsInput

Arguments#

Name Type Description
comment String! Comment explaining the dismissal of the policy violations.
dismissalTypes [DismissalType!]! Type of dismissal for the policy violations.
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
securityPolicyIds [ID!]! IDs of warn mode policies with violations to dismiss.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

duoSettingsUpdate#

히스토리

Updates GitLab Duo settings.

Input type: DuoSettingsUpdateInput

Arguments#

Name Type Description
aiGatewayTimeoutSeconds Int Timeout for the AI Gateway request.
aiGatewayUrl String URL for the local AI Gateway server.
allowAllUnixSockets Boolean Introduced as an experiment in GitLab 19.0.

Whether to allow all Unix sockets for network access.
allowProjectExtension Boolean Introduced as an experiment in GitLab 19.0.

Whether to allow projects to extend the network access domain allowlist.
duoAgentPlatformServiceUrl String URL for the local Duo Agent Platform service.
duoCliEnabled Boolean Introduced as an experiment in GitLab 19.0.

Indicates whether GitLab Duo CLI access is enabled.
duoCoreFeaturesEnabled Boolean Indicates whether GitLab Duo Core features are enabled.
includeRecommendedAllowed Boolean Introduced as an experiment in GitLab 19.0.

Whether to include recommended domains in the network access allowlist.
minimumAccessLevelEnableOnProjects AccessLevelEnum Introduced as an experiment in GitLab 18.7.

Minimum access level for enable on Duo Agent Platform. Ignored if dap_instance_customizable_permissions feature flag is disabled.
minimumAccessLevelExecute AccessLevelEnum Introduced as an experiment in GitLab 18.7.

Minimum access level for execute on Duo Agent Platform. Ignored if dap_instance_customizable_permissions feature flag is disabled.
minimumAccessLevelExecuteAsync AccessLevelEnum Introduced as an experiment 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.
minimumAccessLevelManage AccessLevelEnum Introduced as an experiment in GitLab 18.7.

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

Fields#

Name Type Description
duoSettings DuoSettings! GitLab Duo settings after mutation.
errors [String!]! Errors encountered during the mutation.

duoUserFeedback#

히스토리

Input type: DuoUserFeedbackInput

Arguments#

Name Type Description
aiMessageId String! ID of the AI Message.
trackingEvent TrackingEventInput Tracking event data.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

echoCreate#

A mutation that does not perform any changes.

This is expected to be used for testing of endpoints, to verify that a user has mutation access.

Input type: EchoCreateInput

Arguments#

Name Type Description
errors [String!] Errors to return to the user.
messages [String!] Messages to return to the user.

Fields#

Name Type Description
echoes [String!] Messages returned to the user.
errors [String!]! Errors encountered during the mutation.

enableDevopsAdoptionNamespace#

Status: Beta.

Input type: EnableDevopsAdoptionNamespaceInput

Arguments#

Name Type Description
displayNamespaceId NamespaceID Display namespace ID.
namespaceId NamespaceID! Namespace ID.

Fields#

Name Type Description
enabledNamespace DevopsAdoptionEnabledNamespace Enabled namespace after mutation.
errors [String!]! Errors encountered during the mutation.

environmentCreate#

Create an environment.

Input type: EnvironmentCreateInput

Arguments#

Name Type Description
autoStopSetting AutoStopSetting Auto stop setting of the environment.
clusterAgentId ClustersAgentID Cluster agent of the environment.
description String Description of the environment.
externalUrl String External URL of the environment.
fluxResourcePath String Flux resource path of the environment.
kubernetesNamespace String Kubernetes namespace of the environment.
name String! Name of the environment.
projectPath ID! Full path of the project.
tier DeploymentTier Tier of the environment.

Fields#

Name Type Description
environment Environment Created environment.
errors [String!]! Errors encountered during the mutation.

environmentDelete#

Delete an environment.

Input type: EnvironmentDeleteInput

Arguments#

Name Type Description
id EnvironmentID! Global ID of the environment to Delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

environmentStop#

Stop an environment.

Input type: EnvironmentStopInput

Arguments#

Name Type Description
force Boolean Force environment to stop without executing on_stop actions.
id EnvironmentID! Global ID of the environment to stop.

Fields#

Name Type Description
environment Environment Environment after attempt to stop.
errors [String!]! Errors encountered during the mutation.

environmentUpdate#

Update an environment.

Input type: EnvironmentUpdateInput

Arguments#

Name Type Description
autoStopSetting AutoStopSetting Auto stop setting of the environment.
clusterAgentId ClustersAgentID Cluster agent of the environment.
description String Description of the environment.
externalUrl String External URL of the environment.
fluxResourcePath String Flux resource path of the environment.
id EnvironmentID! Global ID of the environment to update.
kubernetesNamespace String Kubernetes namespace of the environment.
tier DeploymentTier Tier of the environment.

Fields#

Name Type Description
environment Environment Environment after attempt to update.
errors [String!]! Errors encountered during the mutation.

environmentsCanaryIngressUpdate#

Deprecated This endpoint is planned to be removed along with certificate-based clusters. See this epic for more information.

Input type: EnvironmentsCanaryIngressUpdateInput

Arguments#

Name Type Description
id EnvironmentID! Global ID of the environment to update.
weight Int! Weight of the Canary Ingress.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

epicAddIssue#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: EpicAddIssueInput

Arguments#

Name Type Description
groupPath ID! Group the epic to mutate belongs to.
iid ID! IID of the epic to mutate.
issueIid String! IID of the issue to be added.
projectPath ID! Full path of the project the issue belongs to.

Fields#

Name Type Description
epic Epic Epic after mutation.
epicIssue EpicIssue Epic-issue relationship.
errors [String!]! Errors encountered during the mutation.

epicBoardCreate#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicBoardCreateInput

Arguments#

Name Type Description
displayColors Boolean Whether or not display epic colors.
groupPath ID Full path of the group with which the resource is associated.
hideBacklogList Boolean Whether or not backlog list is hidden.
hideClosedList Boolean Whether or not closed list is hidden.
labelIds [LabelID!] IDs of labels to be added to the board.
labels [String!] Labels of the issue.
name String Board name.

Fields#

Name Type Description
epicBoard EpicBoard Created epic board.
errors [String!]! Errors encountered during the mutation.

epicBoardListCreate#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicBoardListCreateInput

Arguments#

Name Type Description
backlog Boolean Create the backlog list.
boardId BoardsEpicBoardID! Global ID of the issue board to mutate.
labelId LabelID Global ID of an existing label.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list EpicList Epic list in the epic board.

epicBoardListDestroy#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicBoardListDestroyInput

Arguments#

Name Type Description
listId BoardsEpicListID! Global ID of the epic board list to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list EpicList Epic board list. null if the board was destroyed successfully.

epicBoardUpdate#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicBoardUpdateInput

Arguments#

Name Type Description
displayColors Boolean Whether or not display epic colors.
hideBacklogList Boolean Whether or not backlog list is hidden.
hideClosedList Boolean Whether or not closed list is hidden.
id BoardsEpicBoardID! Epic board global ID.
labelIds [LabelID!] IDs of labels to be added to the board.
labels [String!] Labels of the issue.
name String Board name.

Fields#

Name Type Description
epicBoard EpicBoard Updated epic board.
errors [String!]! Errors encountered during the mutation.

epicMoveList#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicMoveListInput

Arguments#

Name Type Description
boardId BoardsEpicBoardID! Global ID of the board that the epic is in.
epicId EpicID! ID of the epic to mutate.
fromListId BoardsEpicListID ID of the board list that the epic will be moved from. Required if moving between lists.
moveAfterId EpicID ID of epic that should be placed after the current epic.
moveBeforeId EpicID ID of epic that should be placed before the current epic.
positionInList Int Position of epics within the board list. Positions start at 0. Use -1 to move to the end of the list.
toListId BoardsEpicListID! ID of the list the epic will be in after mutation.

Fields#

Name Type Description
epic Epic Epic after mutation.
errors [String!]! Errors encountered during the mutation.

epicSetSubscription#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: EpicSetSubscriptionInput

Arguments#

Name Type Description
groupPath ID! Group the epic to mutate belongs to.
iid ID! IID of the epic to mutate.
subscribedState Boolean! Desired state of the subscription.

Fields#

Name Type Description
epic Epic Epic after mutation.
errors [String!]! Errors encountered during the mutation.

epicTreeReorder#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: EpicTreeReorderInput

Arguments#

Name Type Description
baseEpicId EpicID! ID of the base epic of the tree.
moved EpicTreeNodeFieldsInputType! Parameters for updating the tree positions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

escalationPolicyCreate#

Input type: EscalationPolicyCreateInput

Arguments#

Name Type Description
description String Description of the escalation policy.
name String! Name of the escalation policy.
projectPath ID! Project to create the escalation policy for.
rules [EscalationRuleInput!]! Steps of the escalation policy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
escalationPolicy EscalationPolicyType Escalation policy.

escalationPolicyDestroy#

Input type: EscalationPolicyDestroyInput

Arguments#

Name Type Description
id IncidentManagementEscalationPolicyID! Escalation policy internal ID to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
escalationPolicy EscalationPolicyType Escalation policy.

escalationPolicyUpdate#

Input type: EscalationPolicyUpdateInput

Arguments#

Name Type Description
description String Description of the escalation policy.
id IncidentManagementEscalationPolicyID! ID of the on-call schedule to create the on-call rotation in.
name String Name of the escalation policy.
rules [EscalationRuleInput!] Steps of the escalation policy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
escalationPolicy EscalationPolicyType Escalation policy.

exportRequirements#

Input type: ExportRequirementsInput

Arguments#

Name Type Description
authorUsername [String!] Filter requirements by author username.
projectPath ID! Full project path the requirements are associated with.
search String Search query for requirement title.
selectedFields [String!] List of selected requirements fields to be exported.
sort Sort List requirements by sort order.
state RequirementState Filter requirements by state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

externalAuditEventDestinationCreate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsCreate instead.

Input type: ExternalAuditEventDestinationCreateInput

Arguments#

Name Type Description
destinationUrl String! Destination URL.
groupPath ID! Group path.
name String Destination name.
verificationToken String Verification token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination ExternalAuditEventDestination Destination created.

externalAuditEventDestinationDestroy#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsDelete instead.

Input type: ExternalAuditEventDestinationDestroyInput

Arguments#

Name Type Description
id AuditEventsExternalAuditEventDestinationID! ID of external audit event destination to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

externalAuditEventDestinationUpdate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsUpdate instead.

Input type: ExternalAuditEventDestinationUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
destinationUrl String Destination URL to change.
id AuditEventsExternalAuditEventDestinationID! ID of external audit event destination to update.
name String Destination name.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination ExternalAuditEventDestination Updated destination.

geoRegistriesBulkUpdate#

히스토리

Mutates multiple Geo registries for a given registry class.

Input type: GeoRegistriesBulkUpdateInput

Arguments#

Name Type Description
action GeoRegistriesBulkAction! Action to be executed on Geo registries.
ids [GeoBaseRegistryID!] Execute the action on registries selected by their ID.
registryClass GeoRegistryClass! Class of the Geo registries to be updated.
replicationState ReplicationStateEnum Execute the action on registries selected by their replication state.
verificationState VerificationStateEnum Execute the action on registries selected by their verification state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryClass GeoRegistryClass Updated Geo registry class.

geoRegistriesUpdate#

히스토리

Mutates a Geo registry.

Input type: GeoRegistriesUpdateInput

Arguments#

Name Type Description
action GeoRegistryAction! Action to be executed on a Geo registry.
registryId GeoBaseRegistryID! ID of the Geo registry entry to be updated.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry Registrable Updated Geo registry entry.

gitlabSubscriptionActivate#

Input type: GitlabSubscriptionActivateInput

Arguments#

Name Type Description
activationCode String! Activation code received after purchasing a GitLab subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
futureSubscriptions [SubscriptionFutureEntry!] Array of future subscriptions.
license CurrentLicense Current license.

googleCloudLoggingConfigurationCreate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsCreate with gcpLogging category instead.

Input type: GoogleCloudLoggingConfigurationCreateInput

Arguments#

Name Type Description Default
clientEmail String! 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.
googleProjectIdName String! Unique identifier of the Google Cloud project to which the logging configuration belongs.
groupPath ID! Group path.
logIdName String Unique identifier used to distinguish and manage different logs within the same Google Cloud project.(defaults to audit_events). "audit_events"
name String Destination name.
privateKey String! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
googleCloudLoggingConfiguration GoogleCloudLoggingConfigurationType configuration created.

googleCloudLoggingConfigurationDestroy#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsDelete instead.

Input type: GoogleCloudLoggingConfigurationDestroyInput

Arguments#

Name Type Description
id AuditEventsGoogleCloudLoggingConfigurationID! ID of the Google Cloud logging configuration to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

googleCloudLoggingConfigurationUpdate#

Deprecated in GitLab 18.10. Use groupAuditEventStreamingDestinationsUpdate instead.

Input type: GoogleCloudLoggingConfigurationUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
clientEmail String 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.
googleProjectIdName String Unique identifier of the Google Cloud project to which the logging configuration belongs.
id AuditEventsGoogleCloudLoggingConfigurationID! ID of the google Cloud configuration to update.
logIdName String Unique identifier used to distinguish and manage different logs within the same Google Cloud project.
name String Destination name.
privateKey String 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
googleCloudLoggingConfiguration GoogleCloudLoggingConfigurationType configuration updated.

governPolicyCreate#

히스토리

Creates a policy in the policy store for an organization or group.

Input type: GovernPolicyCreateInput

Arguments#

Name Type Description
actions [JSON!] Actions the policy takes. No more than 1000 actions.
description String Description of the policy.
groupPath ID Full path of the top-level group whose policy store to use. Exactly one of organizationId or groupPath is required.
lifecycleState String Lifecycle state of the policy.
mode String Enforcement mode of the policy.
name String! Name of the policy.
organizationId OrganizationsOrganizationID Global ID of the organization whose policy store to use. Exactly one of organizationId or groupPath is required.
policyScope JSON Authored scope of the policy. Mutually exclusive with scopeRego.
rules [JSON!]! Rules of the policy, at least one. No more than 1000 rules.
scopeRego String Rego expression scoping the policy. Mutually exclusive with policyScope.
triggerType String! Trigger the policy responds to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
policy GovernPolicy Policy created in the policy store.

governPolicyDelete#

히스토리

Deletes a policy from the policy store for an organization or group.

Input type: GovernPolicyDeleteInput

Arguments#

Name Type Description
groupPath ID Full path of the top-level group whose policy store to use. Exactly one of organizationId or groupPath is required.
id Int! ID of the policy to delete.
organizationId OrganizationsOrganizationID Global ID of the organization whose policy store to use. Exactly one of organizationId or groupPath is required.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

governPolicyUpdate#

히스토리

Updates a policy in the policy store for an organization or group. Only the supplied fields are changed; omitted fields keep their current values, while an explicit null clears a nullable field.

Input type: GovernPolicyUpdateInput

Arguments#

Name Type Description
actions [JSON!] Actions the policy takes. No more than 1000 actions.
description String Description of the policy.
groupPath ID Full path of the top-level group whose policy store to use. Exactly one of organizationId or groupPath is required.
lifecycleState String Lifecycle state of the policy.
mode String Enforcement mode of the policy.
name String Name of the policy.
organizationId OrganizationsOrganizationID Global ID of the organization whose policy store to use. Exactly one of organizationId or groupPath is required.
policyId Int! ID of the policy.
policyScope JSON Authored scope of the policy. Mutually exclusive with scopeRego.
rules [JSON!] Rules of the policy, at least one when supplied. No more than 1000 rules.
scopeRego String Rego expression scoping the policy. Mutually exclusive with policyScope.
triggerType String Trigger the policy responds to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
policy GovernPolicy Policy updated in the policy store.

groupAuditEventStreamingDestinationsCreate#

히스토리

Input type: GroupAuditEventStreamingDestinationsCreateInput

Arguments#

Name Type Description
category String! Destination category.
config JSON! Destination config.
groupPath ID! Group path.
name String Destination name.
secretToken String Secret token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination GroupAuditEventStreamingDestination Destination created.

groupAuditEventStreamingDestinationsDelete#

히스토리

Input type: GroupAuditEventStreamingDestinationsDeleteInput

Arguments#

Name Type Description
id AuditEventsGroupExternalStreamingDestinationID! ID of the audit events external streaming destination to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

groupAuditEventStreamingDestinationsUpdate#

히스토리

Input type: GroupAuditEventStreamingDestinationsUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
category String Destination category.
config JSON Destination config.
id AuditEventsGroupExternalStreamingDestinationID! ID of external audit event destination to update.
name String Destination name.
secretToken String Secret token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination GroupAuditEventStreamingDestination Updated destination.

groupMemberBulkUpdate#

Input type: GroupMemberBulkUpdateInput

Arguments#

Name Type Description
accessLevel MemberAccessLevel! Access level to update the members to.
expiresAt Time Date and time the membership expires.
groupId GroupID! Global ID of the group.
userIds [UserID!]! Global IDs of the members.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupMembers [GroupMember!] Group members after mutation.
queuedMemberApprovals MemberApprovalConnection List of queued pending members approvals. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.

groupMembersExport#

히스토리

Input type: GroupMembersExportInput

Arguments#

Name Type Description
groupId GroupID! Global ID of the group.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Export request result message.

groupSavedReplyCreate#

히스토리

Input type: GroupSavedReplyCreateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
groupId GroupID! Group for the save reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply GroupSavedReply Saved reply after mutation.

groupSavedReplyDestroy#

히스토리

Input type: GroupSavedReplyDestroyInput

Arguments#

Name Type Description
id GroupsSavedReplyID! Global ID of the group-level saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply GroupSavedReply Saved reply after mutation.

groupSavedReplyUpdate#

히스토리

Input type: GroupSavedReplyUpdateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
id GroupsSavedReplyID! Global ID of the group-level saved reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply GroupSavedReply Saved reply after mutation.

groupSecretCreate#

Input type: GroupSecretCreateInput

Arguments#

Name Type Description
description String Description of the group secret.
environment String! Environment that can access the secret.
groupPath ID! Group of the secret.
name String! Name of the group secret.
protected Boolean! Whether the secret is only accessible from protected branches.
rotationIntervalDays Int Number of days between rotation reminders for the secret.
secret String! Value of the group secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecret GroupSecret Group secret.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

groupSecretDelete#

Input type: GroupSecretDeleteInput

Arguments#

Name Type Description
groupPath ID! Group of the secret.
name String! Name of the group secret to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecret GroupSecret Deleted group secret.

groupSecretUpdate#

Input type: GroupSecretUpdateInput

Arguments#

Name Type Description
description String New description of the group secret.
environment String New environment that can access the secret.
groupPath ID! Group of the secret.
metadataCas Int! This should match the current metadata version of the group secret being updated.
name String! Name of the group secret to update.
protected Boolean Whether the secret is only accessible from protected branches.
rotationIntervalDays Int Number of days between rotation reminders for the secret.
secret String New value of the group secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecret GroupSecret Updated group secret.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

groupSecretsManagerDeprovision#

Input type: GroupSecretsManagerDeprovisionInput

Arguments#

Name Type Description
groupPath ID! Group of the secrets manager.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecretsManager GroupSecretsManager Group secrets manager.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

groupSecretsManagerInitialize#

Input type: GroupSecretsManagerInitializeInput

Arguments#

Name Type Description
groupPath ID! Group of the secrets manager.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
groupSecretsManager GroupSecretsManager Group secrets manager.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

groupSecretsPermissionDelete#

Input type: GroupSecretsPermissionDeleteInput

Arguments#

Name Type Description
groupPath ID! Group permissions for the secret.
principal PrincipalInput! Whose permission to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.
secretsPermission GroupSecretsPermission Deleted Secrets Permission.

groupSecretsPermissionUpdate#

Input type: GroupSecretsPermissionUpdateInput

Arguments#

Name Type Description
actions [SecretsManagementAction!]! Actions that can be performed on secrets.
expiredAt ISO8601Date Expiration date for Secret Permission (optional).
groupPath ID! Group to which the permissions are added.
principal PrincipalInput! User/MemberRole/Role that is provided access.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.
secretsPermission GroupSecretsPermission Secrets Permission that was created.

groupTransfer#

히스토리

Input type: GroupTransferInput

Arguments#

Name Type Description
id GroupID! Global ID of the group to transfer.
targetId GroupID Global ID of the target parent group. Omit to make group top-level.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group after mutation.

groupUpdate#

Input type: GroupUpdateInput

Arguments#

Name Type Description
aiAuditEventsStorageEnabled Boolean Introduced as an experiment in GitLab 19.2.

Indicates whether AI audit events are stored for the group.
builtInProjectTemplatesEnabled Boolean Introduced as an experiment in GitLab 19.0.

Indicates whether built-in project templates are available for new projects in the group.
duoAutoModeEnabled Boolean Introduced as an experiment in GitLab 19.5.

Indicates whether Duo Agent Platform auto mode is enabled for the group.
duoFeaturesEnabled Boolean Introduced as an experiment in GitLab 16.10.

Indicates whether GitLab Duo features are enabled for the group.
fullPath ID! Full path of the group that will be updated.
lockAiAuditEventsStorageEnabled Boolean Introduced as an experiment in GitLab 19.2.

Indicates whether AI audit events storage is enforced for all subgroups and projects.
lockBuiltInProjectTemplatesEnabled Boolean Introduced as an experiment in GitLab 19.0.

Indicates if the built-in project templates enabled setting is enforced for all subgroups.
lockDuoAutoModeEnabled Boolean Introduced as an experiment in GitLab 19.5.

Indicates if the Duo Agent Platform auto mode setting is enforced for all subgroups.
lockDuoFeaturesEnabled Boolean Introduced as an experiment in GitLab 16.10.

Indicates if the GitLab Duo features enabled setting is enforced for all subgroups.
lockMathRenderingLimitsEnabled Boolean Indicates if math rendering limits are locked for all descendant groups.
lockToolApprovalForSessionEnabled Boolean Introduced as an experiment in GitLab 18.11.

Indicates if the tool approval for session setting is enforced for all subgroups.
mathRenderingLimitsEnabled Boolean Indicates if math rendering limits are used for the group.
name String Name of the group.
path String Path of the namespace.
sharedRunnersSetting SharedRunnersSetting Shared runners availability for the namespace and its descendants.
stepUpAuthRequiredOauthProvider String OAuth provider required for step-up authentication.
toolApprovalForSessionEnabled Boolean Introduced as an experiment in GitLab 18.11.

Indicates whether tool approval for session is enabled for the group.
visibility VisibilityLevelsEnum Visibility of the namespace.
webBasedCommitSigningEnabled Boolean Introduced as an experiment in GitLab 18.2.

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group after update.

httpIntegrationCreate#

Input type: HttpIntegrationCreateInput

Arguments#

Name Type Description Default
active Boolean! Whether the integration is receiving alerts.
name String! Name of the integration.
payloadAttributeMappings [AlertManagementPayloadAlertFieldInput!] Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExample JsonString Example of an alert payload.
projectPath ID! Project to create the integration in.
type AlertManagementIntegrationType Type of integration to create. Cannot be changed after creation. HTTP

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementHttpIntegration Alerting integration.

httpIntegrationDestroy#

Input type: HttpIntegrationDestroyInput

Arguments#

Name Type Description
id AlertManagementHttpIntegrationID! ID of the integration to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementHttpIntegration Alerting integration.

httpIntegrationResetToken#

Input type: HttpIntegrationResetTokenInput

Arguments#

Name Type Description
id AlertManagementHttpIntegrationID! ID of the integration to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementHttpIntegration Alerting integration.

httpIntegrationUpdate#

Input type: HttpIntegrationUpdateInput

Arguments#

Name Type Description
active Boolean Whether the integration is receiving alerts.
id AlertManagementHttpIntegrationID! ID of the integration to mutate.
name String Name of the integration.
payloadAttributeMappings [AlertManagementPayloadAlertFieldInput!] Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExample JsonString Example of an alert payload.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementHttpIntegration Alerting integration.

importSourceUserCancelReassignment#

히스토리

Input type: ImportSourceUserCancelReassignmentInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserKeepAllAsPlaceholder#

히스토리

Input type: ImportSourceUserKeepAllAsPlaceholderInput

Arguments#

Name Type Description
namespaceId NamespaceID! Global ID of the namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
updatedImportSourceUserCount Int Number of successfully updated mappings of users on source instance to their destination users.

importSourceUserKeepAsPlaceholder#

히스토리

Input type: ImportSourceUserKeepAsPlaceholderInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserReassign#

히스토리

Input type: ImportSourceUserReassignInput

Arguments#

Name Type Description
assigneeUserId UserID! Global ID of the assignee user.
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserResendNotification#

히스토리

Input type: ImportSourceUserResendNotificationInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserRetryFailedReassignment#

히스토리

Input type: ImportSourceUserRetryFailedReassignmentInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserRevoke#

히스토리

Input type: ImportSourceUserRevokeInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

importSourceUserUndoKeepAsPlaceholder#

히스토리

Input type: ImportSourceUserUndoKeepAsPlaceholderInput

Arguments#

Name Type Description
id ImportSourceUserID! Global ID of the mapping of a user on source instance to a user on destination instance.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
importSourceUser ImportSourceUser Mapping of a user on source instance to a user on destination instance after mutation.

instanceAuditEventStreamingDestinationsCreate#

히스토리

Input type: InstanceAuditEventStreamingDestinationsCreateInput

Arguments#

Name Type Description
category String! Destination category.
config JSON! Destination config.
name String Destination name.
secretToken String Secret token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination InstanceAuditEventStreamingDestination Destination created.

instanceAuditEventStreamingDestinationsDelete#

히스토리

Input type: InstanceAuditEventStreamingDestinationsDeleteInput

Arguments#

Name Type Description
id AuditEventsInstanceExternalStreamingDestinationID! ID of the audit events external streaming destination to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

instanceAuditEventStreamingDestinationsUpdate#

히스토리

Input type: InstanceAuditEventStreamingDestinationsUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
category String Destination category.
config JSON Destination config.
id AuditEventsInstanceExternalStreamingDestinationID! ID of external audit event destination to update.
name String Destination name.
secretToken String Secret token.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalAuditEventDestination InstanceAuditEventStreamingDestination Updated destination.

instanceExternalAuditEventDestinationCreate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsCreate instead.

Input type: InstanceExternalAuditEventDestinationCreateInput

Arguments#

Name Type Description
destinationUrl String! Destination URL.
name String Destination name.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceExternalAuditEventDestination InstanceExternalAuditEventDestination Destination created.

instanceExternalAuditEventDestinationDestroy#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsDelete instead.

Input type: InstanceExternalAuditEventDestinationDestroyInput

Arguments#

Name Type Description
id AuditEventsInstanceExternalAuditEventDestinationID! ID of the external instance audit event destination to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

instanceExternalAuditEventDestinationUpdate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsUpdate instead.

Input type: InstanceExternalAuditEventDestinationUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
destinationUrl String Destination URL to change.
id AuditEventsInstanceExternalAuditEventDestinationID! ID of the external instance audit event destination to update.
name String Destination name.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceExternalAuditEventDestination InstanceExternalAuditEventDestination Updated destination.

instanceGoogleCloudLoggingConfigurationCreate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsCreate with gcpLogging category instead.

Input type: InstanceGoogleCloudLoggingConfigurationCreateInput

Arguments#

Name Type Description Default
clientEmail String! 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.
googleProjectIdName String! Unique identifier of the Google Cloud project to which the logging configuration belongs.
logIdName String Unique identifier used to distinguish and manage different logs within the same Google Cloud project.(defaults to audit_events). "audit_events"
name String Destination name.
privateKey String! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceGoogleCloudLoggingConfiguration InstanceGoogleCloudLoggingConfigurationType configuration created.

instanceGoogleCloudLoggingConfigurationDestroy#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsDelete instead.

Input type: InstanceGoogleCloudLoggingConfigurationDestroyInput

Arguments#

Name Type Description
id AuditEventsInstanceGoogleCloudLoggingConfigurationID! ID of the Google Cloud logging configuration to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

instanceGoogleCloudLoggingConfigurationUpdate#

Deprecated in GitLab 18.10. Use instanceAuditEventStreamingDestinationsUpdate instead.

Input type: InstanceGoogleCloudLoggingConfigurationUpdateInput

Arguments#

Name Type Description
active Boolean Active status of the destination.
clientEmail String 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.
googleProjectIdName String Unique identifier of the Google Cloud project to which the logging configuration belongs.
id AuditEventsInstanceGoogleCloudLoggingConfigurationID! ID of the instance google Cloud configuration to update.
logIdName String Unique identifier used to distinguish and manage different logs within the same Google Cloud project.
name String Destination name.
privateKey String 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
instanceGoogleCloudLoggingConfiguration InstanceGoogleCloudLoggingConfigurationType configuration updated.

instanceSecretsManagerEnroll#

Input type: InstanceSecretsManagerEnrollInput

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

instanceSecretsManagerUnenroll#

Input type: InstanceSecretsManagerUnenrollInput

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

integrationExclusionCreate#

히스토리

Input type: IntegrationExclusionCreateInput

Arguments#

Name Type Description
groupIds [GroupID!] IDs of groups to exclude up to a maximum of 100.
integrationName IntegrationType! Type of integration to exclude.
projectIds [ProjectID!] IDs of projects to exclude up to a maximum of 100.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
exclusions [IntegrationExclusion!] Integration exclusions created by the mutation.

integrationExclusionDelete#

히스토리

Input type: IntegrationExclusionDeleteInput

Arguments#

Name Type Description
groupIds [GroupID!] IDs of excluded groups.
integrationName IntegrationType! Type of integration.
projectIds [ProjectID!] IDs of excluded projects.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
exclusions [IntegrationExclusion!] Project no longer excluded due to the mutation.

issuableResourceLinkCreate#

Input type: IssuableResourceLinkCreateInput

Arguments#

Name Type Description
id IssueID! Incident id to associate the resource link with.
link String! Link of the resource.
linkText String Link text of the resource.
linkType IssuableResourceLinkType Link type of the resource.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issuableResourceLink IssuableResourceLink Issuable resource link.

issuableResourceLinkDestroy#

Input type: IssuableResourceLinkDestroyInput

Arguments#

Name Type Description
id IncidentManagementIssuableResourceLinkID! Issuable resource link ID to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issuableResourceLink IssuableResourceLink Issuable resource link.

issueLinkAlerts#

Input type: IssueLinkAlertsInput

Arguments#

Name Type Description
alertReferences [String!]! Alerts references to be linked to the incident.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueMove#

Input type: IssueMoveInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
targetProjectPath ID! Project to move the issue to.
targetWorkItemTypeId WorkItemsTypeID Work item type to use in the target project. When omitted, the source work item type is preserved.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueMoveList#

Input type: IssueMoveListInput

Arguments#

Name Type Description
boardId BoardID! Global ID of the board that the issue is in.
epicId EpicID Deprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
fromListId ID ID of the board list that the issue will be moved from.
iid String! IID of the issue to mutate.
moveAfterId ID ID of issue that should be placed after the current issue.
moveBeforeId ID ID of issue that should be placed before the current issue.
positionInList Int Position of issue within the board list. Positions start at 0. Use -1 to move to the end of the list.
projectPath ID! Project the issue to mutate is in.
toListId ID ID of the board list that the issue will be moved to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetAssignees#

Input type: IssueSetAssigneesInput

Arguments#

Name Type Description Default
assigneeUsernames [String!]! Usernames to assign to the resource. Replaces existing assignees by default.
iid String! IID of the issue to mutate.
operationMode MutationOperationMode Operation to perform. Defaults to REPLACE. REPLACE
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetConfidential#

Input type: IssueSetConfidentialInput

Arguments#

Name Type Description
confidential Boolean! Whether or not to set the issue as a confidential.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetCrmContacts#

Input type: IssueSetCrmContactsInput

Arguments#

Name Type Description
contactIds [CustomerRelationsContactID!]! Customer relations contact IDs to set. Replaces existing contacts by default.
iid String! IID of the issue to mutate.
operationMode MutationOperationMode Changes the operation mode. Defaults to REPLACE.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetDueDate#

Input type: IssueSetDueDateInput

Arguments#

Name Type Description
dueDate Time Desired due date for the issue. Due date is removed if null.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetEpic#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: IssueSetEpicInput

Arguments#

Name Type Description
epicId EpicID Deprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetEscalationPolicy#

Input type: IssueSetEscalationPolicyInput

Arguments#

Name Type Description
escalationPolicyId IncidentManagementEscalationPolicyID Global ID of the escalation policy to assign to the issue. Policy will be removed if absent or set to null.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetEscalationStatus#

Input type: IssueSetEscalationStatusInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
status IssueEscalationStatus! Set the escalation status.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetIteration#

Input type: IssueSetIterationInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
iterationId IterationID Iteration to assign to the issue.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetLocked#

Input type: IssueSetLockedInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
locked Boolean! Whether or not to lock discussion on the issue.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetSeverity#

Input type: IssueSetSeverityInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
severity IssuableSeverity! Set the incident severity level.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetSubscription#

Input type: IssueSetSubscriptionInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
subscribedState Boolean! Desired state of the subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueSetWeight#

Input type: IssueSetWeightInput

Arguments#

Name Type Description
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.
weight Int The desired weight for the issue. If set to null, weight is removed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

issueUnlinkAlert#

Input type: IssueUnlinkAlertInput

Arguments#

Name Type Description
alertId AlertManagementAlertID! Global ID of the alert to unlink from the incident.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

iterationCadenceCreate#

Input type: IterationCadenceCreateInput

Arguments#

Name Type Description
active Boolean! Whether the iteration cadence is active.
automatic Boolean! Whether the iteration cadence should automatically generate upcoming iterations.
description String Description of the iteration cadence. Maximum length is 5000 characters.
durationInWeeks Int Duration in weeks of the iterations within the cadence.
groupPath ID! Group where the iteration cadence is created.
iterationsInAdvance Int Number of future iterations to schedule in addition to the current one.
rollOver Boolean Whether the iteration cadence should roll over issues to the next iteration or not.
startDate Time Timestamp of the automation start date.
title String Title of the iteration cadence.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iterationCadence IterationCadence Created iteration cadence.

iterationCadenceDestroy#

Input type: IterationCadenceDestroyInput

Arguments#

Name Type Description
id IterationsCadenceID! Global ID of the iteration cadence.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group! Group the iteration cadence belongs to.

iterationCadenceUpdate#

Input type: IterationCadenceUpdateInput

Arguments#

Name Type Description
active Boolean Whether the iteration cadence is active.
automatic Boolean Whether the iteration cadence should automatically generate upcoming iterations.
description String Description of the iteration cadence. Maximum length is 5000 characters.
durationInWeeks Int Duration in weeks of the iterations within the cadence.
id IterationsCadenceID! Global ID of the iteration cadence.
iterationsInAdvance Int Number of future iterations to schedule in addition to the current one.
rollOver Boolean Whether the iteration cadence should roll over issues to the next iteration or not.
startDate Time Timestamp of the automation start date.
title String Title of the iteration cadence.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iterationCadence IterationCadence Updated iteration cadence.

iterationCreate#

Input type: iterationCreateInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iteration Iteration Created iteration.

iterationDelete#

Input type: IterationDeleteInput

Arguments#

Name Type Description
id IterationID! ID of the iteration.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group! Group the iteration belongs to.

jiraImportStart#

Input type: JiraImportStartInput

Arguments#

Name Type Description
jiraProjectKey String! Project key of the importer Jira project.
jiraProjectName String Deprecated in GitLab 17.4. Argument is not used.
projectPath ID! Project to import the Jira project into.
usersMapping [JiraUsersMappingInputType!] Mapping of Jira to GitLab users.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
jiraImport JiraImport Jira import data after mutation.

jiraImportUsers#

Input type: JiraImportUsersInput

Arguments#

Name Type Description
projectPath ID! Project to import the Jira users into.
startAt Int Index of the record the import should started at, default 0 (50 records returned).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
jiraUsers [JiraUser!] Users returned from Jira, matched by email and name if possible.

jobArtifactsDestroy#

Input type: JobArtifactsDestroyInput

Arguments#

Name Type Description
id CiBuildID! ID of the job to mutate.

Fields#

Name Type Description
destroyedArtifactsCount Int! Number of artifacts deleted.
errors [String!]! Errors encountered during the mutation.
job CiJob Job with artifacts to be deleted.

jobCancel#

Input type: JobCancelInput

Arguments#

Name Type Description
id CiBuildID! ID of the job to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
job CiJob Job after the mutation.

jobPlay#

Input type: JobPlayInput

Arguments#

Name Type Description Default
id CiProcessableID! 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. []

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
job CiJob Job after the mutation.

jobRetry#

Input type: JobRetryInput

Arguments#

Name Type Description Default
id CiProcessableID! 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. []

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
job CiJob Job after the mutation.

jobUnschedule#

Input type: JobUnscheduleInput

Arguments#

Name Type Description
id CiBuildID! ID of the job to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
job CiJob Job after the mutation.

knowledgeGraphExcludedNamespaceCreate#

히스토리

Input type: KnowledgeGraphExcludedNamespaceCreateInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to exclude.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Excluded group.

knowledgeGraphExcludedNamespaceDestroy#

히스토리

Input type: KnowledgeGraphExcludedNamespaceDestroyInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to remove from exclusions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group removed from exclusions.

labelCreate#

Input type: LabelCreateInput

Arguments#

Name Type Description Default
color String The 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"
description String Description of the label.
groupPath ID Full path of the group with which the resource is associated.
projectPath ID Full path of the project with which the resource is associated.
title String! Title of the label.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
label Label Label after mutation.

labelUpdate#

Input type: LabelUpdateInput

Arguments#

Name Type Description
archived Boolean Whether to archive the label. Introduced in GitLab 18.10.
id LabelID! Global ID of the label to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
label Label Label after mutation.

ldapAdminRoleLinkCreate#

히스토리

Creates an instance-level custom admin role LDAP link.

Input type: LdapAdminRoleLinkCreateInput

Arguments#

Name Type Description
adminMemberRoleId MemberRoleID! Global ID of the custom admin role to be assigned to a user.
cn String Common Name (CN) of the LDAP group.
filter String Search filter for the LDAP group.
provider String! LDAP provider for the LDAP link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
ldapAdminRoleLink LdapAdminRoleLink Created instance-level LDAP link.

ldapAdminRoleLinkDestroy#

히스토리

Destroys an instance-level custom admin role LDAP link.

Input type: LdapAdminRoleLinkDestroyInput

Arguments#

Name Type Description
id AuthzLdapAdminRoleLinkID! Global ID of the instance-level LDAP link to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
ldapAdminRoleLink LdapAdminRoleLink Deleted instance-level LDAP link.

lifecycleAttachWorkItemType#

히스토리

Input type: LifecycleAttachWorkItemTypeInput

Arguments#

Name Type Description
lifecycleId WorkItemsStatusesLifecycleID! Global ID of the lifecycle to attach the work item type to.
namespacePath ID! Namespace path where the lifecycle exists.
statusMappings [StatusMappingInput!] Status mappings from the old lifecycle to the new lifecycle.
workItemTypeId WorkItemsTypeID! Global ID of the work item type to attach to the lifecycle.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
lifecycle WorkItemLifecycle Lifecycle after attaching the work item type.

lifecycleCreate#

히스토리

Input type: LifecycleCreateInput

Arguments#

Name Type Description
defaultClosedStatusIndex Int! Index of the default closed status in the statuses array.
defaultDuplicateStatusIndex Int! Index of the default duplicated status in the statuses array.
defaultOpenStatusIndex Int! Index of the default open status in the statuses array.
name String! Name of the lifecycle.
namespacePath ID! Namespace path where the lifecycle will be created.
statuses [WorkItemStatusInput!]! Statuses of the lifecycle. Can be existing (with id) or new (without id).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
lifecycle WorkItemLifecycle Lifecycle created.

lifecycleDelete#

히스토리

Input type: LifecycleDeleteInput

Arguments#

Name Type Description
id WorkItemsStatusesLifecycleID! Global ID of the lifecycle to delete.
namespacePath ID! Namespace path where the lifecycle exists.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
lifecycle WorkItemLifecycle Deleted lifecycle.

lifecycleUpdate#

히스토리

Input type: LifecycleUpdateInput

Arguments#

Name Type Description
defaultClosedStatusIndex Int Index of the default closed status in the statuses array.
defaultDuplicateStatusIndex Int Index of the default duplicated status in the statuses array.
defaultOpenStatusIndex Int Index of the default open status in the statuses array.
id WorkItemsStatusesLifecycleID! Global ID of the lifecycle to be updated.
name String Name of the lifecycle.
namespacePath ID! 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).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
lifecycle WorkItemLifecycle Lifecycle updated.

linkProjectComplianceViolationIssue#

히스토리

Input type: LinkProjectComplianceViolationIssueInput

Arguments#

Name Type Description
issueIid String! IID of the issue to be linked.
projectPath ID! Full path of the project the issue belongs to.
violationId ComplianceManagementProjectsComplianceViolationID! Global ID of the project compliance violation.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
violation ProjectComplianceViolation Updated project compliance violation.

markAsSpamSnippet#

Input type: MarkAsSpamSnippetInput

Arguments#

Name Type Description
id SnippetID! Global ID of the snippet to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
snippet Snippet Snippet after mutation.

mavenCacheEntryDelete#

히스토리

Input type: MavenCacheEntryDeleteInput

Arguments#

Name Type Description
id String! ID of the cache entry.

Fields#

Name Type Description
cacheEntry MavenUpstreamCacheEntry Maven cache entry.
errors [String!]! Errors encountered during the mutation.

mavenUpstreamCacheDelete#

히스토리

Input type: MavenUpstreamCacheDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenUpstreamID! ID of the Maven virtual registry upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream MavenUpstreamDetails Maven virtual registry upstream.

mavenUpstreamCreate#

히스토리

Input type: MavenUpstreamCreateInput

Arguments#

Name Type Description Default
cacheValidityHours Int Cache validity period. Defaults to 24 hours. 24
description String Description of the upstream registry.
id VirtualRegistriesPackagesMavenRegistryID! ID of the upstream registry.
metadataCacheValidityHours Int Metadata cache validity period. Defaults to 24 hours. 24
name String! Name of upstream registry.
password String Password of the upstream registry.
url String! URL of the upstream registry.
username String Username of the upstream registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream MavenUpstreamDetails Maven upstream after the mutation.

mavenUpstreamDelete#

히스토리

Input type: MavenUpstreamDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenUpstreamID! ID of the upstream to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream MavenUpstreamDetails Destroyed upstream.

mavenUpstreamUpdate#

히스토리

Input type: MavenUpstreamUpdateInput

Arguments#

Name Type Description
cacheValidityHours Int Cache validity period.
description String Description of the upstream registry.
id VirtualRegistriesPackagesMavenUpstreamID! ID of the upstream registry.
metadataCacheValidityHours Int Metadata cache validity period.
name String Name of upstream registry.
password String Password of the upstream registry.
url String URL of the upstream registry.
username String Username of the upstream registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upstream MavenUpstreamDetails Maven upstream after the mutation.

mavenVirtualRegistryCacheDelete#

히스토리

Input type: MavenVirtualRegistryCacheDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenRegistryID! ID of the Maven virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry MavenRegistry Maven virtual registry.

mavenVirtualRegistryCreate#

히스토리

Input type: MavenVirtualRegistryCreateInput

Arguments#

Name Type Description
description String Description of the virtual registry.
groupPath ID Full path of the group with which the resource is associated.
name String! Name of virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry MavenRegistry Maven virtual registry after the mutation.

mavenVirtualRegistryDelete#

히스토리

Input type: MavenVirtualRegistryDeleteInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenRegistryID! ID of the Maven virtual registry to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry MavenRegistry Deleted Maven virtual registry.

mavenVirtualRegistryUpdate#

히스토리

Input type: MavenVirtualRegistryUpdateInput

Arguments#

Name Type Description
description String Description of the virtual registry.
id VirtualRegistriesPackagesMavenRegistryID! ID of the Maven virtual registry to be updated.
name String Name of virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registry MavenRegistry Maven virtual registry after the mutation.

mavenVirtualRegistryUpstreamDelete#

히스토리

Input type: MavenVirtualRegistryUpstreamDeleteInput

Arguments#

Name Type Description
upstreamId VirtualRegistriesPackagesMavenRegistryUpstreamID! ID of the Maven virtual registry upstream.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream MavenRegistryUpstreamWithRegistry Deleted maven registry upstream.

mavenVirtualRegistryUpstreamUpdate#

히스토리

Input type: MavenVirtualRegistryUpstreamUpdateInput

Arguments#

Name Type Description
id VirtualRegistriesPackagesMavenRegistryUpstreamID! ID of the Maven virtual registry upstream.
position Int! Priority order of an upstream within a virtual registry.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
registryUpstream MavenRegistryUpstreamWithRegistry Maven registry upstream after update.

memberRoleAdminCreate#

히스토리

Input type: MemberRoleAdminCreateInput

Arguments#

Name Type Description
description String Description of the member role.
name String Name of the member role.
permissions [MemberRoleAdminPermission!] List of all customizable admin permissions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole AdminMemberRole Member role.

memberRoleAdminDelete#

히스토리

Input type: MemberRoleAdminDeleteInput

Arguments#

Name Type Description
id MemberRoleID! ID of the admin member role to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole MemberRole Deleted admin member role.

memberRoleAdminUpdate#

히스토리

Input type: MemberRoleAdminUpdateInput

Arguments#

Name Type Description
description String Description of the member role.
id MemberRoleID! ID of the member role to mutate.
name String Name of the member role.
permissions [MemberRoleAdminPermission!] List of all customizable admin permissions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole AdminMemberRole Member role.

memberRoleCreate#

히스토리

Input type: MemberRoleCreateInput

Arguments#

Name Type Description
baseAccessLevel MemberRolesAccessLevel! Base access level for the custom role.
description String Description of the member role.
groupPath ID Group the member role to mutate is in. Required for SaaS.
name String Name of the member role.
permissions [MemberRolePermission!] List of all customizable permissions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole MemberRole Member role.

memberRoleDelete#

히스토리

Input type: MemberRoleDeleteInput

Arguments#

Name Type Description
id MemberRoleID! ID of the member role to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole MemberRole Deleted member role.

memberRoleToUserAssign#

히스토리

Input type: MemberRoleToUserAssignInput

Arguments#

Name Type Description
memberRoleId MemberRoleID Global 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.
userId UserID! Global ID of the user to be assigned to a custom role.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userMemberRole UserMemberRole Created user member role or nil if the relation was deleted.

memberRoleUpdate#

Input type: MemberRoleUpdateInput

Arguments#

Name Type Description
description String Description of the member role.
id MemberRoleID! ID of the member role to mutate.
name String Name of the member role.
permissions [MemberRolePermission!] List of all customizable permissions.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
memberRole MemberRole Member role.

mergeRequestAccept#

Accepts a merge request. When accepted, the source branch will be scheduled to merge into the target branch, either immediately if possible, or using one of the automatic merge strategies.

In GitLab 16.5, the merging happens asynchronously. This results in mergeRequest and state not updating after a mutation request, because the merging may not have happened yet.

Input type: MergeRequestAcceptInput

Arguments#

Name Type Description Default
commitMessage String Custom merge commit message.
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
sha String! HEAD SHA at the time when the merge was requested.
shouldRemoveSourceBranch Boolean Should the source branch be removed.
squash Boolean Squash commits on the source branch before merge. false
squashCommitMessage String Custom squash commit message (if squash is true).
strategy MergeStrategyEnum How to merge the merge request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestBypassSecurityPolicy#

히스토리

Bypasses security policies for a merge request.

Input type: MergeRequestBypassSecurityPolicyInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
reason String! Reason for bypassing the security policy.
securityPolicyIds [ID!]! ID of the security policy to bypass.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestCreate#

Input type: MergeRequestCreateInput

Arguments#

Name Type Description
description String Description of the merge request (Markdown rendered as HTML for caching).
labels [String!] Labels of the merge request.
mergeAfter Time Date after which the merge request can be merged.
projectPath ID! Project full path the merge request is associated with.
removeSourceBranch Boolean Indicates if the source branch of the merge request will be deleted after merge.
sourceBranch String! Source branch of the merge request.
targetBranch String! Target branch of the merge request.
title String! Title of the merge request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestCreateWorkItemRelations#

Links work items to a merge request.

Input type: MergeRequestCreateWorkItemRelationsInput

Arguments#

Name Type Description Default
iid String! IID of the merge request to mutate.
linkType MergeRequestWorkItemLinkType Type of relationship to create. Defaults to RELATED. MENTIONED relations are managed automatically and cannot be created. RELATED
projectPath ID! Project the merge request to mutate is in.
workItemIds [WorkItemID!]! Global IDs of the work items to link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.
workItemRelations [MergeRequestWorkItemRelation!] Created merge request to work item relations.

mergeRequestDestroyRequestedChanges#

Input type: MergeRequestDestroyRequestedChangesInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestDestroyWorkItemRelations#

Removes relations between a merge request and work items.

Input type: MergeRequestDestroyWorkItemRelationsInput

Arguments#

Name Type Description
ids [MergeRequestIssueID!]! Global IDs of the relations to remove.
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.
removedRelationIds [MergeRequestIssueID!] Global IDs of the removed relations.

mergeRequestRequestChanges#

Input type: MergeRequestRequestChangesInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestResyncSecurityPolicies#

히스토리

Triggers a re-evaluation of the security approval policies applicable to the merge request.

Input type: MergeRequestResyncSecurityPoliciesInput

Arguments#

Name Type Description
iid String! IID of the merge request to re-evaluate.
projectPath ID! Project the merge request belongs to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after the re-evaluation was scheduled.

mergeRequestReviewerRereview#

Input type: MergeRequestReviewerRereviewInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
userId UserID! User ID for the user that has been requested for a new review.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSavedViewCreate#

히스토리

Creates a saved view on the merge request dashboard. Available only when the mr_dashboard_saved_views feature flag is enabled.

Input type: MergeRequestSavedViewCreateInput

Arguments#

Name Type Description
filters MergeRequestSavedViewFilterInput Merge request filters stored in the saved view.
name String! Name of the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView MergeRequestSavedView Saved view after the mutation.

mergeRequestSavedViewDelete#

히스토리

Deletes a saved view from the merge request dashboard. Available only when the mr_dashboard_saved_views feature flag is enabled.

Input type: MergeRequestSavedViewDeleteInput

Arguments#

Name Type Description
id MergeRequestsSavedViewID! Global ID of the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView MergeRequestSavedView Saved view after the mutation.

mergeRequestSavedViewUpdate#

히스토리

Updates a saved view on the merge request dashboard. Available only when the mr_dashboard_saved_views feature flag is enabled.

Input type: MergeRequestSavedViewUpdateInput

Arguments#

Name Type Description
filters MergeRequestSavedViewFilterInput Merge request filters stored in the saved view.
id MergeRequestsSavedViewID! Global ID of the saved view.
name String Name of the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView MergeRequestSavedView Saved view after the mutation.

mergeRequestSetAssignees#

Input type: MergeRequestSetAssigneesInput

Arguments#

Name Type Description Default
assigneeUsernames [String!]! Usernames to assign to the resource. Replaces existing assignees by default.
iid String! IID of the merge request to mutate.
operationMode MutationOperationMode Operation to perform. Defaults to REPLACE. REPLACE
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetBlockingMergeRequests#

Input type: MergeRequestSetBlockingMergeRequestsInput

Arguments#

Name Type Description
blockingMergeRequestReferences [String!]! Array of blocking merge request references (e.g., "!123", "project!456").
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetDraft#

Input type: MergeRequestSetDraftInput

Arguments#

Name Type Description
draft Boolean! Whether or not to set the merge request as a draft.
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetLabels#

Input type: MergeRequestSetLabelsInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
labelIds [LabelID!]! Label IDs to set. Replaces existing labels by default.
operationMode MutationOperationMode Changes the operation mode. Defaults to REPLACE.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetLocked#

Input type: MergeRequestSetLockedInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
locked Boolean! Whether or not to lock the merge request.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetMilestone#

Input type: MergeRequestSetMilestoneInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
milestoneId MilestoneID Milestone to assign to the merge request.
projectPath ID! Project the merge request to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetReviewers#

Input type: MergeRequestSetReviewersInput

Arguments#

Name Type Description Default
iid String! IID of the merge request to mutate.
operationMode MutationOperationMode Operation to perform. Defaults to REPLACE. REPLACE
projectPath ID! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestSetSubscription#

Input type: MergeRequestSetSubscriptionInput

Arguments#

Name Type Description
iid String! IID of the merge request to mutate.
projectPath ID! Project the merge request to mutate is in.
subscribedState Boolean! Desired state of the subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestUpdate#

Update attributes of a merge request.

Input type: MergeRequestUpdateInput

Arguments#

Name Type Description
description String Description of the merge request (Markdown rendered as HTML for caching).
iid String! IID of the merge request to mutate.
mergeAfter Time Date after which the merge request can be merged.
overrideRequestedChanges Boolean Override all requested changes. Can only be set by users who have permissionto merge this merge request.
projectPath ID! Project the merge request to mutate is in.
removeSourceBranch Boolean Indicates if the source branch of the merge request will be deleted after merge.
state MergeRequestNewState Action to perform to change the state.
targetBranch String Target branch of the merge request.
timeEstimate String Estimated time to complete the merge request. Use null or 0 to remove the current estimate.
title String Title of the merge request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeRequestUpdateApprovalRule#

Input type: MergeRequestUpdateApprovalRuleInput

Arguments#

Name Type Description Default
approvalRuleId Int! ID of an approval rule.
approvalsRequired Int! Number of required approvals for a given rule.
groupIds [String!] IDs of groups as approvers. []
iid String! IID of the merge request to mutate.
name String! Name of the approval rule.
projectPath ID! Project the merge request to mutate is in.
removeHiddenGroups Boolean Whether hidden groups should be removed. false
userIds [String!] IDs of users as approvers. []

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge request after mutation.

mergeTrainsDeleteCar#

히스토리

Input type: MergeTrainsDeleteCarInput

Arguments#

Name Type Description
carId MergeTrainsCarID! Global ID of the car.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

mlModelCreate#

히스토리

Input type: MlModelCreateInput

Arguments#

Name Type Description
description String Description of the model.
name String! Name of the model.
projectPath ID! Project the model to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
model MlModel Model after mutation.

mlModelDelete#

히스토리

Input type: MlModelDeleteInput

Arguments#

Name Type Description
id MlModelID! Global ID of the model to be deleted.
projectPath ID! Project the model to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
model MlModel Model after mutation.

mlModelDestroy#

히스토리

Input type: MlModelDestroyInput

Arguments#

Name Type Description
id MlModelID! Global ID of the model to be deleted.
projectPath ID! Project the model to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Model deletion result message.
model MlModel Model after mutation.

mlModelEdit#

히스토리

Input type: MlModelEditInput

Arguments#

Name Type Description
description String Description of the model.
modelId Int Id of the model.
name String! Name of the model.
projectPath ID! Project the model to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
model MlModel Model after mutation.

mlModelVersionCreate#

히스토리

Input type: MlModelVersionCreateInput

Arguments#

Name Type Description
candidateId MlCandidateID Global ID of a candidate to promote optionally.
description String Description of the model version.
modelId MlModelID! Global ID of the model the version belongs to.
projectPath ID! Project the model to mutate is in.
version String Model version.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
modelVersion MlModelVersion Model after mutation.

mlModelVersionDelete#

히스토리

Input type: MlModelVersionDeleteInput

Arguments#

Name Type Description
id MlModelVersionID! Global ID of the model version to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
modelVersion MlModelVersion Deleted model version.

mlModelVersionEdit#

히스토리

Input type: MlModelVersionEditInput

Arguments#

Name Type Description
description String! Description of the model version.
modelId MlModelID! Global ID of the model the version belongs to.
projectPath ID! Project the model to mutate is in.
version String! Model version.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
modelVersion MlModelVersion Model after mutation.

namespaceBanDestroy#

Input type: NamespaceBanDestroyInput

Arguments#

Name Type Description
id NamespacesNamespaceBanID! Global ID of the namespace ban to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceBan NamespaceBan Namespace Ban.

namespaceCiCdSettingsUpdate#

Input type: NamespaceCiCdSettingsUpdateInput

Arguments#

Name Type Description
allowStaleRunnerPruning Boolean Indicates if stale runners directly belonging to the namespace should be periodically pruned.
fullPath ID! Full path of the namespace the settings belong to.

Fields#

Name Type Description
ciCdSettings NamespaceCiCdSetting! CI/CD settings after mutation.
errors [String!]! Errors encountered during the mutation.

namespaceCreateRemoteDevelopmentClusterAgentMapping#

Input type: NamespaceCreateRemoteDevelopmentClusterAgentMappingInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! GlobalID of the cluster agent to be associated with the namespace.
namespaceId GroupID! GlobalID of the group to be associated with the cluster agent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceClusterAgentMapping NamespaceClusterAgentMapping Introduced as an experiment in GitLab 17.10.

Created namespace cluster agent mapping.

namespaceDeleteRemoteDevelopmentClusterAgentMapping#

Input type: NamespaceDeleteRemoteDevelopmentClusterAgentMappingInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! GlobalID of the cluster agent to be un-associated from the namespace.
namespaceId GroupID! GlobalID of the group to be un-associated from the cluster agent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceClusterAgentMapping NamespaceClusterAgentMapping Introduced as an experiment in GitLab 17.11.

Created namespace cluster agent mapping.

namespaceSecretsManagerEnroll#

Input type: NamespaceSecretsManagerEnrollInput

Arguments#

Name Type Description
namespacePath ID! Full path of the namespace to enroll.

Fields#

Name Type Description
enrollment SecretsManagerEnrollment Enrollment record.
errors [String!]! Errors encountered during the mutation.

namespaceSecretsManagerUnenroll#

Input type: NamespaceSecretsManagerUnenrollInput

Arguments#

Name Type Description
namespacePath ID! Full path of the namespace to unenroll.

Fields#

Name Type Description
enrollment SecretsManagerEnrollment Enrollment record.
errors [String!]! Errors encountered during the mutation.

namespaceSettingsUpdate#

히스토리

Input type: NamespaceSettingsUpdateInput

Arguments#

Name Type Description
fullPath ID! Full path of the namespace the settings belong to.
pipelineVariablesDefaultRole PipelineVariablesDefaultRoleType Indicates the default minimum role required to override pipeline variables in the namespace.

Fields#

Name Type Description
ciCdSettings CiCdSettings! Namespace CI/CD settings after mutation.
errors [String!]! Errors encountered during the mutation.

namespacesRegenerateNewWorkItemEmailAddress#

히스토리

Input type: NamespacesRegenerateNewWorkItemEmailAddressInput

Arguments#

Name Type Description
fullPath ID! Full path of the namespace to regenerate the new work item email address for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespace Namespace Namespace after regenerating the new work item email address.

noteConvertToThread#

Convert a standard comment to a resolvable thread.

Input type: NoteConvertToThreadInput

Arguments#

Name Type Description
id NoteID! Global ID of the Note to convert.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

oncallRotationCreate#

Input type: OncallRotationCreateInput

Arguments#

Name Type Description
activePeriod OncallRotationActivePeriodInputType Active period of time that the on-call rotation should take place.
endsAt OncallRotationDateInputType End date and time of the on-call rotation, in the timezone of the on-call schedule.
name String! Name of the on-call rotation.
participants [OncallUserInputType!]! Usernames of users participating in the on-call rotation. A maximum limit of 100 participants applies.
projectPath ID! Project to create the on-call schedule in.
rotationLength OncallRotationLengthInputType! Rotation length of the on-call rotation.
scheduleIid String! IID of the on-call schedule to create the on-call rotation in.
startsAt OncallRotationDateInputType! Start date and time of the on-call rotation, in the timezone of the on-call schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallRotation IncidentManagementOncallRotation On-call rotation.

oncallRotationDestroy#

Input type: OncallRotationDestroyInput

Arguments#

Name Type Description
id IncidentManagementOncallRotationID! ID of the on-call rotation to remove.
projectPath ID! Project to remove the on-call schedule from.
scheduleIid String! IID of the on-call schedule to the on-call rotation belongs to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallRotation IncidentManagementOncallRotation On-call rotation.

oncallRotationUpdate#

Input type: OncallRotationUpdateInput

Arguments#

Name Type Description
activePeriod OncallRotationActivePeriodInputType Active period of time that the on-call rotation should take place.
endsAt OncallRotationDateInputType End date and time of the on-call rotation, in the timezone of the on-call schedule.
id IncidentManagementOncallRotationID! ID of the on-call schedule to create the on-call rotation in.
name String Name of the on-call rotation.
participants [OncallUserInputType!] Usernames of users participating in the on-call rotation. A maximum limit of 100 participants applies.
rotationLength OncallRotationLengthInputType Rotation length of the on-call rotation.
startsAt OncallRotationDateInputType Start date and time of the on-call rotation, in the timezone of the on-call schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallRotation IncidentManagementOncallRotation On-call rotation.

oncallScheduleCreate#

Input type: OncallScheduleCreateInput

Arguments#

Name Type Description
description String Description of the on-call schedule.
name String! Name of the on-call schedule.
projectPath ID! Project to create the on-call schedule in.
timezone String! Timezone of the on-call schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallSchedule IncidentManagementOncallSchedule On-call schedule.

oncallScheduleDestroy#

Input type: OncallScheduleDestroyInput

Arguments#

Name Type Description
iid String! On-call schedule internal ID to remove.
projectPath ID! Project to remove the on-call schedule from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallSchedule IncidentManagementOncallSchedule On-call schedule.

oncallScheduleUpdate#

Input type: OncallScheduleUpdateInput

Arguments#

Name Type Description
description String Description of the on-call schedule.
iid String! On-call schedule internal ID to update.
name String Name of the on-call schedule.
projectPath ID! Project to update the on-call schedule in.
timezone String Timezone of the on-call schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
oncallSchedule IncidentManagementOncallSchedule On-call schedule.

orbitStartTrial#

히스토리

Input type: OrbitStartTrialInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group the trial was requested for, also returned on error. Read knowledgeGraphEnabled and orbitTrial from it.

orbitUpdate#

히스토리

Input type: OrbitUpdateInput

Arguments#

Name Type Description
enabled Boolean! Whether to enable or disable the Knowledge Graph for the group.
groupPath ID! Full path of the group to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
group Group Group after mutation.

organizationConfirm#

히스토리

Input type: OrganizationConfirmInput

Arguments#

Name Type Description
groups [GroupID!] Global IDs of top-level groups to transfer to the organization.
id OrganizationsOrganizationID! Global ID of the organization to confirm.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Organization after mutation.

organizationCreate#

히스토리

Input type: OrganizationCreateInput

Arguments#

Name Type Description
avatar Upload Avatar for the organization.
description String Description of the organization.
name String! Name for the organization.
path String! Path for the organization.
visibility OrganizationVisibility Visibility for the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Organization after mutation.

organizationCreateClusterAgentMapping#

히스토리

Input type: OrganizationCreateClusterAgentMappingInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! GlobalID of the cluster agent to be associated with the organization.
organizationId OrganizationsOrganizationID! GlobalID of the organization to be associated with the cluster agent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

organizationDelete#

히스토리

Input type: OrganizationDeleteInput

Arguments#

Name Type Description
avatar Upload Avatar for the organization.
description String Description of the organization.
id OrganizationsOrganizationID! ID of the organization to soft-delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Soft-deleted organization.

organizationDeleteClusterAgentMapping#

히스토리

Input type: OrganizationDeleteClusterAgentMappingInput

Arguments#

Name Type Description
clusterAgentId ClustersAgentID! GlobalID of the cluster agent to be dissociated with the organization.
organizationId OrganizationsOrganizationID! GlobalID of the organization to be dissociated with the cluster agent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

organizationRestore#

히스토리

Input type: OrganizationRestoreInput

Arguments#

Name Type Description
id OrganizationsOrganizationID! ID of the organization to restore.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Restored organization.

organizationUpdate#

히스토리

Input type: OrganizationUpdateInput

Arguments#

Name Type Description
avatar Upload Avatar for the organization.
description String Description of the organization.
id OrganizationsOrganizationID! ID of the organization to mutate.
name String Name for the organization.
path String Path for the organization.
policyStoreExperimentEnabled Boolean Introduced as an experiment 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.
visibility OrganizationVisibility Visibility for the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organization Organization Organization after mutation.

organizationUserCreate#

히스토리

Input type: OrganizationUserCreateInput

Arguments#

Name Type Description
organizationId OrganizationsOrganizationID! ID of the organization to add the user to.
userType OrganizationUserType! Type to add the organization user with.
username String! Username of the user to add to the organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organizationUser OrganizationUser Introduced as an experiment in GitLab 19.3.

Organization user added by the mutation.

organizationUserDelete#

히스토리

Input type: OrganizationUserDeleteInput

Arguments#

Name Type Description
id OrganizationsOrganizationUserID! ID of the organization user to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organizationUser OrganizationUser Introduced as an experiment in GitLab 19.3.

Organization user that was deleted.

organizationUserUpdate#

히스토리

Input type: OrganizationUserUpdateInput

Arguments#

Name Type Description
accessLevel OrganizationUserAccessLevel! Access level to update the organization user to.
id OrganizationsOrganizationUserID! ID of the organization user to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
organizationUser OrganizationUser Introduced as an experiment in GitLab 17.5.

Organization user after mutation.

pagesMarkOnboardingComplete#

Input type: PagesMarkOnboardingCompleteInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
onboardingComplete Boolean! Indicates the new onboarding_complete state of the project's Pages metadata.

personalAccessTokenCreate#

히스토리

Creates a personal access token for the current user.

Input type: PersonalAccessTokenCreateInput

Arguments#

Name Type Description Default
description String Description of the token.
expiresAt ISO8601Date Expiration date of the token.
granularScopes [GranularScopeInput!]! List of granular scopes to assign to the token.
name String! Name of the token.
sudo Boolean Whether the token can impersonate other users with sudo. Requires the token owner to be an administrator. false

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
token String Created personal access token.

personalAccessTokenRevoke#

히스토리

Revokes a specified personal access token.

Input type: PersonalAccessTokenRevokeInput

Arguments#

Name Type Description
id PersonalAccessTokenID! Global ID of the personal access token that will be revoked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

personalAccessTokenRotate#

히스토리

Rotate a specified personal access token.

Input type: PersonalAccessTokenRotateInput

Arguments#

Name Type Description
expiresAt ISO8601Date Expiration date of the token.
id PersonalAccessTokenID! Global ID of the personal access token that will be rotated.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
token String Created personal access token.

pipelineCancel#

Input type: PipelineCancelInput

Arguments#

Name Type Description
id CiPipelineID! ID of the pipeline to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipeline Pipeline Pipeline after mutation.

pipelineCreate#

Input type: PipelineCreateInput

Arguments#

Name Type Description
async Boolean Introduced as an experiment 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.
inputs [CiInputsInput!] Introduced as an experiment in GitLab 17.10.

Inputs for the pipeline.
mergeRequestIid String IID of the merge request to create pipeline for.
projectPath ID! Full path of the project that is triggering the pipeline.
ref String! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipeline Pipeline Pipeline created after mutation. Null if async: true.
requestId String Introduced as an experiment in GitLab 17.8.

ID for checking the pipeline creation status. Null if async: false.

pipelineDestroy#

Input type: PipelineDestroyInput

Arguments#

Name Type Description
id CiPipelineID! ID of the pipeline to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

pipelineExecutionSchedulePolicyTestRun#

히스토리

Triggers a test-run for a Scheduled Pipeline Execution Policy on a specific project.

Input type: PipelineExecutionSchedulePolicyTestRunInput

Arguments#

Name Type Description
policyId SecurityPolicyID! Global ID of the pipeline execution schedule policy to test.
projectPath ID! Full path of the project to run the test on.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
testRun PolicyScheduleTestRun Test-run record created.

pipelineRetry#

Input type: PipelineRetryInput

Arguments#

Name Type Description
id CiPipelineID! ID of the pipeline to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipeline Pipeline Pipeline after mutation.

pipelineScheduleCreate#

Input type: PipelineScheduleCreateInput

Arguments#

Name Type Description
active Boolean Indicates if the pipeline schedule should be active or not.
cron String! Cron expression of the pipeline schedule.
cronTimezone String Cron time zone supported by ActiveSupport::TimeZone. For example: Pacific Time (US & Canada) (default: UTC).
description String! Description of the pipeline schedule.
inputs [CiInputsInput!] Introduced as an experiment in GitLab 17.10.

Inputs for the pipeline schedule.
projectPath ID! Full path of the project the pipeline schedule is associated with.
ref String! Ref of the pipeline schedule.
variables [PipelineScheduleVariableInput!] Variables for the pipeline schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineSchedule PipelineSchedule Created pipeline schedule.

pipelineScheduleDelete#

Input type: PipelineScheduleDeleteInput

Arguments#

Name Type Description
id CiPipelineScheduleID! ID of the pipeline schedule to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

pipelineSchedulePlay#

Input type: PipelineSchedulePlayInput

Arguments#

Name Type Description
id CiPipelineScheduleID! ID of the pipeline schedule to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineSchedule PipelineSchedule Pipeline schedule after mutation.

pipelineScheduleTakeOwnership#

Input type: PipelineScheduleTakeOwnershipInput

Arguments#

Name Type Description
id CiPipelineScheduleID! ID of the pipeline schedule to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineSchedule PipelineSchedule Updated pipeline schedule ownership.

pipelineScheduleUpdate#

Input type: PipelineScheduleUpdateInput

Arguments#

Name Type Description
active Boolean Indicates if the pipeline schedule should be active or not.
cron String Cron expression of the pipeline schedule.
cronTimezone String Cron time zone supported by ActiveSupport::TimeZone. For example: Pacific Time (US & Canada) (default: UTC).
description String Description of the pipeline schedule.
id CiPipelineScheduleID! ID of the pipeline schedule to mutate.
inputs [CiInputsInput!] Introduced as an experiment in GitLab 17.11.

Inputs for the pipeline schedule.
ref String Ref of the pipeline schedule.
variables [PipelineScheduleVariableInput!] Variables for the pipeline schedule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineSchedule PipelineSchedule Updated pipeline schedule.

pipelineTriggerCreate#

히스토리

Input type: PipelineTriggerCreateInput

Arguments#

Name Type Description
description String! Description of the pipeline trigger token.
expiresAt Time Timestamp of when the pipeline trigger token expires.
projectPath ID! Full path of the project that the pipeline trigger token to mutate is in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineTrigger PipelineTrigger Mutated pipeline trigger token.

pipelineTriggerDelete#

히스토리

Input type: PipelineTriggerDeleteInput

Arguments#

Name Type Description
id CiTriggerID! ID of the pipeline trigger token to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

pipelineTriggerUpdate#

히스토리

Input type: PipelineTriggerUpdateInput

Arguments#

Name Type Description
description String! Description of the pipeline trigger token.
id CiTriggerID! ID of the pipeline trigger token to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pipelineTrigger PipelineTrigger Mutated pipeline trigger token.

processUserBillablePromotionRequest#

히스토리

Input type: ProcessUserBillablePromotionRequestInput

Arguments#

Name Type Description
status MemberApprovalStatusType! Status for the member approval request (approved, denied, pending).
userId UserID! Global ID of user to be promoted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
result UserPromotionStatusType Status of the user promotion process (success, partial_success, failed).

projectBlobsRemove#

히스토리

Input type: projectBlobsRemoveInput

Arguments#

Name Type Description
blobOids [String!]! List of blob oids.
projectPath ID! Full path of the project to replace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

projectCiCdSettingsUpdate#

Input type: ProjectCiCdSettingsUpdateInput

Arguments#

Name Type Description
crossProjectPushForJobTokenAllowed Boolean Indicates the ability to push to this repository using a job token from an allowlisted project.
displayPipelineVariables Boolean Indicates whether pipeline variables can be displayed in the UI.
fullPath ID! Full Path of the project the settings belong to.
groupRunnersEnabled Boolean Indicates whether group runners are enabled for the project.
inboundJobTokenScopeEnabled Boolean Indicates whether CI/CD job tokens generated in other projects have restricted access to this project.
jobTokenScopeEnabled Boolean Deprecated in GitLab 16.0. Outbound job token scope is being removed. This field can now only be set to false.
keepLatestArtifact Boolean Indicates whether the latest artifact should be kept for the project.
maxPipelinesPerMergeTrain Int Maximum number of parallel pipelines per merge train.
mergePipelinesEnabled Boolean Indicates if merged results pipelines are enabled for the project.
mergeTrainEnforcement MergeTrainEnforcement Merge train enforcement level for the project.
mergeTrainsEnabled Boolean Indicates if merge trains are enabled for the project.
mergeTrainsSkipTrainAllowed Boolean Indicates whether an option is allowed to merge without refreshing the merge train. Ignored unless the merge_trains_skip_train feature flag is also enabled.
pipelineVariablesMinimumOverrideRole String Minimum role required to set variables when creating a pipeline or running a job.
pushRepositoryForJobTokenAllowed Boolean Indicates the ability to push to the original project repository using a job token.
resourceGroupDefaultProcessMode ResourceGroupsProcessMode Default process mode for resource groups in the project.
skipBranchPipelinesForMrs Boolean Indicates whether branch pipelines are skipped if a merge request is open.

Fields#

Name Type Description
ciCdSettings ProjectCiCdSetting! CI/CD settings after mutation.
errors [String!]! Errors encountered during the mutation.

projectCustomAttributeSet#

히스토리

Sets (creates or updates) a custom attribute on a project. Only available to admins.

Input type: ProjectCustomAttributeSetInput

Arguments#

Name Type Description
key String! Key of the custom attribute.
projectPath ID! Full path of the project.
value String! Value of the custom attribute.

Fields#

Name Type Description
customAttribute CustomAttribute Custom attribute after mutation.
errors [String!]! Errors encountered during the mutation.

projectMemberBulkUpdate#

Updates multiple members of a project. To use this mutation, you must have at least the Maintainer role.

Input type: ProjectMemberBulkUpdateInput

Arguments#

Name Type Description
accessLevel MemberAccessLevel! Access level to update the members to.
expiresAt Time Date and time the membership expires.
projectId ProjectID! Global ID of the project.
userIds [UserID!]! Global IDs of the members.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectMembers [ProjectMember!] Project members after mutation.
queuedMemberApprovals MemberApprovalConnection List of queued pending members approvals. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.

projectSavedReplyCreate#

히스토리

Input type: ProjectSavedReplyCreateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
name String! Name of the saved reply.
projectId ProjectID! Project for the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply ProjectSavedReply Saved reply after mutation.

projectSavedReplyDestroy#

히스토리

Input type: ProjectSavedReplyDestroyInput

Arguments#

Name Type Description
id ProjectsSavedReplyID! Global ID of the project-level saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply ProjectSavedReply Saved reply after mutation.

projectSavedReplyUpdate#

히스토리

Input type: ProjectSavedReplyUpdateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
id ProjectsSavedReplyID! Global ID of the project-level saved reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply ProjectSavedReply Saved reply after mutation.

projectSecretCreate#

Input type: ProjectSecretCreateInput

Arguments#

Name Type Description
branch String! Branches that can access the secret.
description String Description of the project secret.
environment String! Environments that can access the secret.
name String! Name of the project secret.
projectPath ID! Project of the secret.
rotationIntervalDays Int Number of days between rotation reminders for the secret.
secret String! Value of the project secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecret ProjectSecret Project secret.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

projectSecretDelete#

Input type: ProjectSecretDeleteInput

Arguments#

Name Type Description
name String! Name of the project secret.
projectPath ID! Project of the secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecret ProjectSecret Deleted project secret.

projectSecretUpdate#

Input type: ProjectSecretUpdateInput

Arguments#

Name Type Description
branch String New branches that can access the secret.
description String New description of the project secret.
environment String New environments that can access the secret.
metadataCas Int! This should match the current metadata version of the project secret being updated.
name String! Name of the project secret to update.
projectPath ID! Project of the secret.
rotationIntervalDays Int Number of days between rotation reminders for the secret.
secret String New value of the project secret.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecret ProjectSecret Updated project secret.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

projectSecretsManagerDeprovision#

Input type: ProjectSecretsManagerDeprovisionInput

Arguments#

Name Type Description
projectPath ID! Project of the secrets manager.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecretsManager ProjectSecretsManager Project secrets manager.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

projectSecretsManagerInitialize#

Input type: ProjectSecretsManagerInitializeInput

Arguments#

Name Type Description
projectPath ID! Project of the secrets manager.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSecretsManager ProjectSecretsManager Project secrets manager.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.

projectSecretsPermissionDelete#

Input type: ProjectSecretsPermissionDeleteInput

Arguments#

Name Type Description
principal PrincipalInput! User/MemberRole/Role whose access is being removed.
projectPath ID! Project from which the permissions are removed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.
secretsPermission ProjectSecretsPermission Secrets Permission that was deleted.

projectSecretsPermissionUpdate#

Input type: ProjectSecretsPermissionUpdateInput

Arguments#

Name Type Description
actions [SecretsManagementAction!]! Actions that can be performed on secrets.
expiredAt ISO8601Date Expiration date for Secret Permission (optional).
principal PrincipalInput! User/MemberRole/Role that is provided access.
projectPath ID! Project to which the permissions are added.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
reason SecretsManagerWriteDenialReason Introduced as an experiment in GitLab 19.2.

Reason the write was denied due to entitlement; null when not denied for that reason.
secretsPermission ProjectSecretsPermission Secrets Permission that was created.

projectSecurityExclusionCreate#

Input type: ProjectSecurityExclusionCreateInput

Arguments#

Name Type Description
active Boolean! Whether the exclusion is active.
description String Optional description for the exclusion.
projectPath ID! Full path of the project the exclusion will be associated with.
scanner ExclusionScannerEnum! Scanner to ignore values for based on the exclusion.
type ExclusionTypeEnum! Type of the exclusion.
value String! Value of the exclusion.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityExclusion ProjectSecurityExclusion Project security exclusion created.

projectSecurityExclusionDelete#

Input type: ProjectSecurityExclusionDeleteInput

Arguments#

Name Type Description
id SecurityProjectSecurityExclusionID! Global ID of the exclusion to be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

projectSecurityExclusionUpdate#

Input type: ProjectSecurityExclusionUpdateInput

Arguments#

Name Type Description
active Boolean Whether the exclusion is active.
description String Optional description for the exclusion.
id SecurityProjectSecurityExclusionID! Global ID of the exclusion to be updated.
scanner ExclusionScannerEnum Scanner to ignore values for based on the exclusion.
type ExclusionTypeEnum Type of the exclusion.
value String Value of the exclusion.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityExclusion ProjectSecurityExclusion Project security exclusion updated.

projectSetComplianceFramework#

Deprecated in GitLab 17.11. Use mutation ProjectUpdateComplianceFrameworks instead of this.

Input type: ProjectSetComplianceFrameworkInput

Arguments#

Name Type Description
complianceFrameworkId ComplianceManagementFrameworkID ID of the compliance framework to assign to the project. Set to null to unset.
projectId ProjectID! ID of the project to change the compliance framework of.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

projectSetContinuousVulnerabilityScanning#

Deprecated in GitLab 17.3. CVS has been enabled permanently. See this epic for more information.

Input type: ProjectSetContinuousVulnerabilityScanningInput

Arguments#

Name Type Description
enable Boolean! Desired status for continuous vulnerability scanning feature.
projectPath ID! Full path of the project.

Fields#

Name Type Description
continuousVulnerabilityScanningEnabled Boolean! Whether feature is enabled.
errors [String!]! Errors encountered during the mutation.

projectSetLocked#

Input type: ProjectSetLockedInput

Arguments#

Name Type Description
filePath String! Full path to the file.
lock Boolean! Whether or not to lock the file path.
projectPath ID! Full path of the project to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

projectSettingsUpdate#

히스토리

Input type: ProjectSettingsUpdateInput

Arguments#

Name Type Description
aiAuditEventsStorageEnabled Boolean Introduced as an experiment in GitLab 19.2.

Indicates whether AI audit events are stored for the project.
duoAutoModeEnabled Boolean Indicates whether Duo Agent Platform auto mode is enabled for the project.
duoContextExclusionSettings DuoContextExclusionSettingsInput Settings for excluding files from Duo context.
duoFeaturesEnabled Boolean Indicates whether GitLab Duo features are enabled for the project.
duoSastFpDetectionEnabled Boolean Indicates whether SAST False Positive Detection is enabled for the project.
duoSastVrWorkflowEnabled Boolean Indicates whether SAST Vulnerability Resolution workflow is enabled for the project.
duoSecretDetectionFpEnabled Boolean Indicates whether Secret Detection False Positive Detection is enabled for the project.
fullPath ID! Full Path of the project the settings belong to.
toolApprovalForSessionEnabled Boolean Indicates whether tool approval for Duo Workflow sessions is enabled for the project.
webBasedCommitSigningEnabled Boolean Introduced as an experiment in GitLab 18.2.

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projectSettings ProjectSetting! Project settings after mutation.

projectSubscriptionCreate#

Input type: ProjectSubscriptionCreateInput

Arguments#

Name Type Description
projectPath String! Full path of the downstream project of the Project Subscription.
upstreamPath String! Full path of the upstream project of the Project Subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
subscription CiSubscriptionsProject Project Subscription created by the mutation.

projectSubscriptionDelete#

Input type: ProjectSubscriptionDeleteInput

Arguments#

Name Type Description
subscriptionId CiSubscriptionsProjectID! ID of the subscription to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

projectSyncFork#

히스토리

Input type: ProjectSyncForkInput

Arguments#

Name Type Description
projectPath ID! Full path of the project to initialize.
targetBranch String! Ref of the fork to fetch into.

Fields#

Name Type Description
details ForkDetails Updated fork details.
errors [String!]! Errors encountered during the mutation.

projectTargetBranchRuleCreate#

Input type: ProjectTargetBranchRuleCreateInput

Arguments#

Name Type Description
name String! Name for the target branch rule.
projectId ProjectID! Project ID for the target branch rule.
targetBranch String! Target branch for the target branch rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
targetBranchRule ProjectTargetBranchRule Target branch rule after mutation.

projectTargetBranchRuleDestroy#

Input type: ProjectTargetBranchRuleDestroyInput

Arguments#

Name Type Description
id ProjectsTargetBranchRuleID! ID for the target branch rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

projectTextReplace#

히스토리

Input type: projectTextReplaceInput

Arguments#

Name Type Description
projectPath ID! Full path of the project to replace.
replacements [String!]! List of text patterns to replace project-wide.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

projectTransfer#

히스토리

Input type: ProjectTransferInput

Arguments#

Name Type Description
id ProjectID! Global ID of the project to transfer.
namespaceId NamespaceID! Global ID of the target namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

projectUpdateComplianceFrameworks#

Update compliance frameworks for a project.

Input type: ProjectUpdateComplianceFrameworksInput

Arguments#

Name Type Description
complianceFrameworkIds [ComplianceManagementFrameworkID!]! IDs of the compliance framework to update for the project.
projectId ProjectID! ID of the project to change the compliance framework of.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project after mutation.

prometheusIntegrationCreate#

Deprecated in GitLab 18.2. Use HttpIntegrationCreate.

Input type: PrometheusIntegrationCreateInput

Arguments#

Name Type Description Default
active Boolean! Whether the integration is receiving alerts.
apiUrl String Deprecated in GitLab 18.2. Feature removed in 16.0.
name String Name of the integration. "Prometheus"
payloadAttributeMappings [AlertManagementPayloadAlertFieldInput!] Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExample JsonString Example of an alert payload.
projectPath ID! Project to create the integration in.
type AlertManagementIntegrationType Type of integration to create. Cannot be changed after creation. HTTP

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementPrometheusIntegration Newly created integration.

prometheusIntegrationResetToken#

Deprecated in GitLab 18.2. Use HttpIntegrationResetToken.

Input type: PrometheusIntegrationResetTokenInput

Arguments#

Name Type Description
id IntegrationsPrometheusID! ID of the integration to mutate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementPrometheusIntegration Updated integration.

prometheusIntegrationUpdate#

Deprecated in GitLab 18.2. Use HttpIntegrationUpdate.

Input type: PrometheusIntegrationUpdateInput

Arguments#

Name Type Description
active Boolean Whether the integration is receiving alerts.
apiUrl String Deprecated in GitLab 18.2. Feature removed in 16.0.
id IntegrationsPrometheusID! ID of the integration to mutate.
name String Name of the integration.
payloadAttributeMappings [AlertManagementPayloadAlertFieldInput!] Custom mapping of GitLab alert attributes to fields from the payload example.
payloadExample JsonString Example of an alert payload.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
integration AlertManagementPrometheusIntegration Updated integration.

promoteToEpic#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: PromoteToEpicInput

Arguments#

Name Type Description
groupPath ID Group the promoted epic will belong to.
iid String! IID of the issue to mutate.
projectPath ID! Project the issue to mutate is in.

Fields#

Name Type Description
epic Epic Epic after issue promotion.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

refreshFindingTokenStatus#

Input type: RefreshFindingTokenStatusInput

Arguments#

Name Type Description
vulnerabilityId VulnerabilityID! Global ID of the Vulnerability whose token status should be refreshed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
findingTokenStatus VulnerabilityFindingTokenStatus Updated token status record for the given finding.

refreshSecurityFindingTokenStatus#

Input type: RefreshSecurityFindingTokenStatusInput

Arguments#

Name Type Description
securityFindingUuid String! UUID of the Security::Finding whose token status should be refreshed (MR context).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
findingTokenStatus SecurityFindingTokenStatus Updated token status record for the given Security::Finding.

refreshStandardsAdherenceChecks#

Input type: RefreshStandardsAdherenceChecksInput

Arguments#

Name Type Description
groupPath ID! Group path.

Fields#

Name Type Description
adherenceChecksStatus StandardsAdherenceChecksStatus Progress of standards adherence checks.
errors [String!]! Errors encountered during the mutation.

refreshVulnerabilityFindingTokenStatus#

Input type: RefreshVulnerabilityFindingTokenStatusInput

Arguments#

Name Type Description
vulnerabilityId VulnerabilityID! Global ID of the Vulnerability whose token status should be refreshed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
findingTokenStatus VulnerabilityFindingTokenStatus Updated token status record for the given Vulnerabilities::Finding.

releaseAssetLinkCreate#

Input type: ReleaseAssetLinkCreateInput

Arguments#

Name Type Description Default
directAssetPath String Relative path for a direct asset link.
linkType ReleaseAssetLinkType Type of the asset link. OTHER
name String! Name of the asset link.
projectPath ID! Full path of the project the asset link is associated with.
tagName String! Name of the associated release's tag.
url String! URL of the asset link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
link ReleaseAssetLink Asset link after mutation.

releaseAssetLinkDelete#

Input type: ReleaseAssetLinkDeleteInput

Arguments#

Name Type Description
id ReleasesLinkID! ID of the release asset link to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
link ReleaseAssetLink Deleted release asset link.

releaseAssetLinkUpdate#

Input type: ReleaseAssetLinkUpdateInput

Arguments#

Name Type Description
directAssetPath String Relative path for a direct asset link.
id ReleasesLinkID! ID of the release asset link to update.
linkType ReleaseAssetLinkType Type of the asset link.
name String Name of the asset link.
url String URL of the asset link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
link ReleaseAssetLink Asset link after mutation.

releaseCreate#

Input type: ReleaseCreateInput

Arguments#

Name Type Description
assets ReleaseAssetsInput Assets associated to the release.
description String Description (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.
name String Name of the release.
projectPath ID! Full path of the project the release is associated with.
ref String Commit SHA or branch name to use if creating a new tag.
releasedAt Time Date 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.
tagMessage String Message to use if creating a new annotated tag.
tagName String! Name of the tag to associate with the release.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
release Release Release after mutation.

releaseDelete#

Input type: ReleaseDeleteInput

Arguments#

Name Type Description
projectPath ID! Full path of the project the release is associated with.
tagName String! Name of the tag associated with the release to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
release Release Deleted release.

releaseUpdate#

Input type: ReleaseUpdateInput

Arguments#

Name Type Description
description String Description (release notes) of the release.
milestones [String!] Title of each milestone the release is associated with. GitLab Premium customers can specify group milestones.
name String Name of the release.
projectPath ID! Full path of the project the release is associated with.
releasedAt Time Release date.
tagName String! Name of the tag associated with the release.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
release Release Release after mutation.

removeProjectFromSecurityDashboard#

Input type: RemoveProjectFromSecurityDashboardInput

Arguments#

Name Type Description
id ProjectID! ID of the project to remove from the Instance Security Dashboard.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

repositionImageDiffNote#

Repositions a DiffNote on an image (a Note where the position.positionType is "image").

Input type: RepositionImageDiffNoteInput

Arguments#

Name Type Description
id DiffNoteID! Global ID of the DiffNote to update.
position UpdateDiffImagePositionInput! Position of the note on a diff.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

restorePagesDeployment#

히스토리

Restores a Pages deployment that has been scheduled for deletion.

Input type: RestorePagesDeploymentInput

Arguments#

Name Type Description
id PagesDeploymentID! ID of the Pages Deployment.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
pagesDeployment PagesDeployment! Restored Pages Deployment.

resyncSecurityPolicies#

히스토리

Triggers a resynchronization of security policies linked to the given project or group (full_path).

Input type: ResyncSecurityPoliciesInput

Arguments#

Name Type Description Default
fullPath String! Full path of the project or group.
relationship RelationshipType Relationship of the policies to resync. DIRECT

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerAssignToProject#

히스토리

Input type: RunnerAssignToProjectInput

Arguments#

Name Type Description
projectPath ID! Full path of the project to which the runner will be assigned.
runnerId CiRunnerID! ID of the runner to assign to the project .

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerBulkPause#

히스토리

Input type: RunnerBulkPauseInput

Arguments#

Name Type Description
ids [CiRunnerID!]! IDs of the runners to pause or unpause.
paused Boolean! Indicates the runner is not allowed to receive jobs.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
updatedCount Int Number of records effectively updated. Only present if operation was performed synchronously.
updatedRunners [CiRunner!] Runners after mutation.

runnerCacheClear#

Input type: RunnerCacheClearInput

Arguments#

Name Type Description
projectId ProjectID! Global ID of the project that will have its runner cache cleared.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerCreate#

히스토리

Input type: RunnerCreateInput

Arguments#

Name Type Description
accessLevel CiRunnerAccessLevel Access level of the runner.
description String Description of the runner.
groupId GroupID Global ID of the group that the runner is created in (valid only for group runner).
locked Boolean Indicates the runner is locked.
maintenanceNote String Runner's maintenance notes.
maximumTimeout Int Maximum timeout (in seconds) for jobs processed by the runner.
paused Boolean Indicates the runner is not allowed to receive jobs.
privateProjectsMinutesCostFactor Float Introduced as an experiment in GitLab 17.7.

Private projects' "compute cost factor" associated with the runner (GitLab.com only).
projectId ProjectID Global ID of the project that the runner is created in (valid only for project runner).
publicProjectsMinutesCostFactor Float Introduced as an experiment in GitLab 17.7.

Public projects' "compute cost factor" associated with the runner (GitLab.com only).
runUntagged Boolean Indicates the runner is able to run untagged jobs.
runnerType CiRunnerType! Type of the runner to create.
tagList [String!] Tags associated with the runner.
tokenExpiresAt Time Token expiration time (ISO 8601 format). Must be between 5 minutes and 21 days in the future, and cannot exceed instance/group/project limits.
tokenRotationDeadline Time Introduced as an experiment 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
runner CiRunner Runner after mutation.

runnerDelete#

Input type: RunnerDeleteInput

Arguments#

Name Type Description
id CiRunnerID! ID of the runner to delete.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerUnassignFromProject#

히스토리

Input type: RunnerUnassignFromProjectInput

Arguments#

Name Type Description
projectPath ID! Full path of the project from which the runner will be unassigned.
runnerId CiRunnerID! ID of the runner to unassign from the project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnerUpdate#

Input type: RunnerUpdateInput

Arguments#

Name Type Description
accessLevel CiRunnerAccessLevel Access level of the runner.
active Boolean Deprecated in GitLab 14.8. Renamed. Use paused instead.
associatedProjects [ProjectID!] Projects associated with the runner. Available only for project runners.
description String Description of the runner.
id CiRunnerID! ID of the runner to update.
locked Boolean Indicates the runner is locked.
maintenanceNote String Runner's maintenance notes.
maximumTimeout Int Maximum timeout (in seconds) for jobs processed by the runner.
paused Boolean Indicates the runner is not allowed to receive jobs.
privateProjectsMinutesCostFactor Float Introduced as an experiment in GitLab 17.7.

Private projects' "compute cost factor" associated with the runner (GitLab.com only).
publicProjectsMinutesCostFactor Float Introduced as an experiment in GitLab 17.7.

Public projects' "compute cost factor" associated with the runner (GitLab.com only).
runUntagged Boolean Indicates the runner is able to run untagged jobs.
tagList [String!] Tags associated with the runner.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
runner CiRunner Runner after mutation.

runnersExportUsage#

Input type: RunnersExportUsageInput

Arguments#

Name Type Description Default
fromDate ISO8601Date UTC start date of the period to report on. Defaults to the start of last full month.
fullPath ID Filter 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.
maxProjectCount Int Maximum number of projects to return. All other runner usage will be attributed to an entry. Defaults to 1000 projects. 1000
runnerType CiRunnerType Scope of the runners to include in the report.
toDate ISO8601Date UTC end date of the period to report on. " \ "Defaults to the end of the month specified by fromDate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

runnersRegistrationTokenReset#

Deprecated in GitLab 17.7. Underlying feature was deprecated in 15.6 and will be removed in 18.0.

Input type: RunnersRegistrationTokenResetInput

Arguments#

Name Type Description
id ID ID of the project or group to reset the token for. Omit if resetting instance runner token.
type CiRunnerType! Scope of the object to reset the token for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
token String Runner token after mutation.

safeDisablePipelineVariables#

Input type: SafeDisablePipelineVariablesInput

Arguments#

Name Type Description
fullPath ID! Full path of the group to disable pipeline variables for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
success Boolean! Indicates whether the migration was successfully enqueued.

savedReplyCreate#

Input type: SavedReplyCreateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply SavedReply Saved reply after mutation.

savedReplyDestroy#

Input type: SavedReplyDestroyInput

Arguments#

Name Type Description
id UsersSavedReplyID! Global ID of the user saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply SavedReply Saved reply after mutation.

savedReplyUpdate#

Input type: SavedReplyUpdateInput

Arguments#

Name Type Description
content String! Content of the saved reply.
id UsersSavedReplyID! Global ID of the user saved reply.
name String! Name of the saved reply.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedReply SavedReply Saved reply after mutation.

scanExecutionPolicyCommit#

Commits the policy_yaml content to the assigned security policy project for the given project (full_path).

Input type: ScanExecutionPolicyCommitInput

Arguments#

Name Type Description
fullPath String Full path of the project.
name String! Name of the policy. If the name is null, the name field from policy_yaml is used.
operationMode MutationOperationMode! Changes the operation mode.
policyYaml String! YAML snippet of the policy.
projectPath ID Deprecated in GitLab 14.10. Use fullPath.

Fields#

Name Type Description
branch String Name of the branch to which the policy changes are committed.
errors [String!]! Errors encountered during the mutation.
validationErrors [SecurityPolicyValidationError!] Validation errors encountered during execution of the mutation.

secretsManagerEnableAddOn#

히스토리

Input type: SecretsManagerEnableAddOnInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to enable the Secrets Manager add-on for.

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Secrets Manager entitlement state after enabling the add-on. Null when enabling failed; see errors for the reason.
errors [String!]! Errors encountered during the mutation.

secretsManagerInstanceEnableAddOn#

히스토리

Input type: SecretsManagerInstanceEnableAddOnInput

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Instance-level Secrets Manager entitlement state after enabling the add-on. Null when enabling failed; see errors for the reason.
errors [String!]! Errors encountered during the mutation.

secretsManagerInstanceRefreshEntitlement#

히스토리

Input type: SecretsManagerInstanceRefreshEntitlementInput

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Instance-wide Secrets Manager entitlement state as the subscription service reports it now. Null when refreshing failed; see errors for the reason.
errors [String!]! Errors encountered during the mutation.

secretsManagerInstanceStartTrial#

히스토리

Input type: SecretsManagerInstanceStartTrialInput

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Instance-wide Secrets Manager entitlement state after starting the trial. Null when the post-trial state cannot be resolved; query secretsManagerInstanceEntitlement instead.
errors [String!]! Errors encountered during the mutation.

secretsManagerRefreshEntitlement#

히스토리

Input type: SecretsManagerRefreshEntitlementInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to refresh the Secrets Manager entitlement for.

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Secrets Manager entitlement state as the subscription service reports it now. Null when the subscription service could not be reached; see errors.
errors [String!]! Errors encountered during the mutation.

secretsManagerStartTrial#

히스토리

Input type: SecretsManagerStartTrialInput

Arguments#

Name Type Description
groupPath ID! Full path of the top-level group to start a Secrets Manager trial for.

Fields#

Name Type Description
entitlement SecretsManagerEntitlement Secrets Manager entitlement state after starting the trial. Null when the post-trial state cannot be resolved; query the group entitlement directly instead.
errors [String!]! Errors encountered during the mutation.

securityAttributeCreate#

Input type: SecurityAttributeCreateInput

Arguments#

Name Type Description
attributes [SecurityAttributeInput!]! Attributes to create.
categoryId SecurityCategoryID! Global ID of the security category.
namespaceId NamespaceID! Global ID of the namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityAttributes [SecurityAttribute!] Created security attributes.

securityAttributeDestroy#

Input type: SecurityAttributeDestroyInput

Arguments#

Name Type Description
id SecurityAttributeID! Global ID of the security attribute to destroy.

Fields#

Name Type Description
deletedAttributeGid SecurityAttributeID Global ID of the destroyed security attribute.
errors [String!]! Errors encountered during the mutation.

securityAttributeProjectUpdate#

Input type: SecurityAttributeProjectUpdateInput

Arguments#

Name Type Description
addAttributeIds [SecurityAttributeID!] Global IDs of the security attributes to add to the project.
projectId ProjectID! Global ID of the project.
removeAttributeIds [SecurityAttributeID!] Global IDs of the security attributes to remove from the project.

Fields#

Name Type Description
addedCount Int Number of attributes added.
errors [String!]! Errors encountered during the mutation.
project Project Updated project.
removedCount Int Number of attributes removed.

securityAttributeUpdate#

Input type: SecurityAttributeUpdateInput

Arguments#

Name Type Description
color Color Color of the security attribute.
description String Description of the security attribute.
id SecurityAttributeID! Global ID of the security attribute.
name String Name of the security attribute.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityAttribute SecurityAttribute Updated security attribute.

securityCategoryCreate#

Input type: SecurityCategoryCreateInput

Arguments#

Name Type Description
description String Description of the security category.
multipleSelection Boolean Whether multiple attributes can be selected.
name String! Name of the security category.
namespaceId NamespaceID! Global ID of the category namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityCategory SecurityCategory Created security category.

securityCategoryDestroy#

Input type: SecurityCategoryDestroyInput

Arguments#

Name Type Description
id SecurityCategoryID! Global ID of the security category to destroy.

Fields#

Name Type Description
deletedAttributesGid [SecurityAttributeID!] Global IDs of the deleted security attributes.
deletedCategoryGid SecurityCategoryID Global ID of the deleted security category.
errors [String!]! Errors encountered during the mutation.

securityCategoryUpdate#

Input type: SecurityCategoryUpdateInput

Arguments#

Name Type Description
description String Description of the security category.
id SecurityCategoryID! Global ID of the security category.
name String Name of the security category.
namespaceId NamespaceID! Global ID of the category namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityCategory SecurityCategory Updated security category.

securityFindingCreateIssue#

Input type: SecurityFindingCreateIssueInput

Arguments#

Name Type Description
project ProjectID! ID of the project to attach the issue to.
uuid String! UUID of the security finding to be used to create an issue.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.

securityFindingCreateMergeRequest#

Input type: SecurityFindingCreateMergeRequestInput

Arguments#

Name Type Description
uuid String! UUID of the security finding to be used to create a merge request.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
mergeRequest MergeRequest Merge Request created after mutation.

securityFindingCreateVulnerability#

히스토리

Input type: SecurityFindingCreateVulnerabilityInput

Arguments#

Name Type Description
uuid String! UUID of the security finding to be used to create a vulnerability.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability created after mutation.

securityFindingDismiss#

Input type: SecurityFindingDismissInput

Arguments#

Name Type Description
comment String Comment why finding should be dismissed.
dismissalReason VulnerabilityDismissalReason Reason why finding should be dismissed.
uuid String! UUID of the finding to be dismissed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityFinding PipelineSecurityReportFinding Dismissed finding.
uuid String UUID of dismissed finding.

securityFindingExternalIssueLinkCreate#

Input type: SecurityFindingExternalIssueLinkCreateInput

Arguments#

Name Type Description
externalTracker VulnerabilityExternalIssueLinkExternalTracker! External tracker type of the external issue link.
linkType VulnerabilityExternalIssueLinkType! Type of the external issue link.
project ProjectID! ID of the project to attach the issue to.
uuid String! UUID of the security finding to be used to create an issue.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalIssueLink VulnerabilityExternalIssueLink Created external issue link.

securityFindingJiraIssueFormUrlCreate#

히스토리

Input type: SecurityFindingJiraIssueFormUrlCreateInput

Arguments#

Name Type Description
project ProjectID! ID of the project to attach the issue to.
uuid String! UUID of the security finding to be used to create an issue.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
jiraIssueFormUrl String URL to Jira issue creation form with pre-filled vulnerability data.

securityFindingRevertToDetected#

Input type: SecurityFindingRevertToDetectedInput

Arguments#

Name Type Description
comment String Comment that explains why finding was reverted to detected status.
uuid String! UUID of the finding to be dismissed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityFinding PipelineSecurityReportFinding Finding reverted to detected.

securityFindingSeverityOverride#

Input type: SecurityFindingSeverityOverrideInput

Arguments#

Name Type Description
severity VulnerabilitySeverity! New severity value for the finding.
uuid String! UUID of the finding to modify.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
securityFinding PipelineSecurityReportFinding Finding of which the severity was modified.

securityPolicyProjectAssign#

Assigns the specified project(security_policy_project_id) as security policy project for the given project(full_path). If the project already has a security policy project, this reassigns the project's security policy project with the given security_policy_project_id.

Input type: SecurityPolicyProjectAssignInput

Arguments#

Name Type Description
fullPath String Full path of the project or group.
projectPath ID Deprecated in GitLab 14.10. Use fullPath.
securityPolicyProjectId ProjectID! ID of the security policy project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityPolicyProjectCreate#

Creates and assigns a security policy project for the given project or group (full_path).

Input type: SecurityPolicyProjectCreateInput

Arguments#

Name Type Description
fullPath String Full path of the project or group.
projectPath ID Deprecated in GitLab 14.10. Use fullPath.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Security Policy Project that was created.

securityPolicyProjectCreateAsync#

히스토리

Creates and assigns a security policy project for the given project or group (full_path) async.

Input type: SecurityPolicyProjectCreateAsyncInput

Arguments#

Name Type Description
fullPath String! Full path of the project or group.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityPolicyProjectUnassign#

Unassigns the security policy project for the given project (full_path).

Input type: SecurityPolicyProjectUnassignInput

Arguments#

Name Type Description
fullPath String Full path of the project or group.
projectPath ID Deprecated in GitLab 14.10. Use fullPath.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityRefsTrack#

히스토리

Input type: SecurityRefsTrackInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.
refs [SecurityRefInput!]! Array of refs to be tracked.

Fields#

Name Type Description
errors [String!]! Errors encountered during the operation.
trackedRefs [SecurityTrackedRef!] Refs that were successfully tracked.

securityRefsUntrack#

히스토리

Input type: SecurityRefsUntrackInput

Arguments#

Name Type Description
refIds [SecurityProjectTrackedContextID!]! Global IDs of the tracked refs to stop tracking.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
untrackedRefIds [ID!] Global IDs of refs that were successfully untracked.

securityScanProfileAttach#

히스토리

Input type: SecurityScanProfileAttachInput

Arguments#

Name Type Description Default
groupIds [GroupID!] Group IDs to attach the profile to. []
projectIds [ProjectID!] Project IDs to attach the profile to. []
securityScanProfileId SecurityScanProfileID! Security scan profile ID to attach.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityScanProfileCreate#

히스토리

Input type: SecurityScanProfileCreateInput

Arguments#

Name Type Description Default
description String! Description of the scan profile.
name String! Name of the scan profile.
namespaceId NamespaceID! Global ID of the top level namespace to create the scan profile for.
scanType SecurityScanProfileType! Type of the scan profile.
stripDefaults Boolean When 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
scanProfile ScanProfileType Created scan profile.

securityScanProfileDelete#

히스토리

Input type: SecurityScanProfileDeleteInput

Arguments#

Name Type Description
id SecurityScanProfileID! Global ID of the scan profile to delete.

Fields#

Name Type Description
deletedScanProfileId SecurityScanProfileID Global ID of the deleted scan profile.
errors [String!]! Errors encountered during the mutation.

securityScanProfileDetach#

히스토리

Input type: SecurityScanProfileDetachInput

Arguments#

Name Type Description Default
groupIds [GroupID!] Group IDs to detach the profile from. []
projectIds [ProjectID!] Project IDs to detach the profile from. []
securityScanProfileId SecurityScanProfileID! Security scan profile ID to detach.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

securityScanProfileUpdate#

히스토리

Input type: SecurityScanProfileUpdateInput

Arguments#

Name Type Description Default
description String Description of the scan profile.
id SecurityScanProfileID! Global ID of the scan profile to update.
name String Name of the scan profile.
stripDefaults Boolean When 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
scanProfile ScanProfileType Updated scan profile.

securityTrainingUpdate#

Input type: SecurityTrainingUpdateInput

Arguments#

Name Type Description
isEnabled Boolean! Sets the training provider as enabled for the project.
isPrimary Boolean Sets the training provider as primary for the project.
projectPath ID! Full path of the project.
providerId SecurityTrainingProviderID! ID of the provider.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
training ProjectSecurityTraining Represents the training entity subject to mutation.

setContainerScanningForRegistry#

Enable/disable container scanning for registry for the given project.

Input type: SetContainerScanningForRegistryInput

Arguments#

Name Type Description
enable Boolean! Desired status for container scanning for registry feature.
namespacePath ID! Full path of the namespace (project).

Fields#

Name Type Description
containerScanningForRegistryEnabled Boolean Whether the feature is enabled.
errors [String!]! Errors encountered during the mutation.

setCvsForContainerScanning#

히스토리

Enable or disable continuous vulnerability scanning for container scanning for the given project.

Input type: SetCvsForContainerScanningInput

Arguments#

Name Type Description
enable Boolean! Desired status for CVS for container scanning.
projectPath ID! Full path of the project.

Fields#

Name Type Description
cvsForContainerScanningEnabled Boolean Whether CVS for container scanning is enabled.
errors [String!]! Errors encountered during the mutation.

setCvsForDependencyScanning#

히스토리

Enable or disable continuous vulnerability scanning for dependency scanning for the given project.

Input type: SetCvsForDependencyScanningInput

Arguments#

Name Type Description
enable Boolean! Desired status for CVS for dependency scanning.
projectPath ID! Full path of the project.

Fields#

Name Type Description
cvsForDependencyScanningEnabled Boolean Whether CVS for dependency scanning is enabled.
errors [String!]! Errors encountered during the mutation.

setGroupCustomAttribute#

히스토리

Creates or updates a custom attribute on a group. Only available to admins.

Input type: SetGroupCustomAttributeInput

Arguments#

Name Type Description
groupPath ID! Full path of the group.
key String! Key of the custom attribute.
value String! Value of the custom attribute.

Fields#

Name Type Description
customAttribute CustomAttribute Custom attribute after mutation.
errors [String!]! Errors encountered during the mutation.

setGroupSecretPushProtection#

Enable or disable secret push protection for a group.

Input type: SetGroupSecretPushProtectionInput

Arguments#

Name Type Description
namespacePath ID! Full path of the group.
projectsToExclude [Int!] IDs of projects to exclude from the feature.
secretPushProtectionEnabled Boolean! Whether to enable the feature.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

setGroupValidityChecks#

Enable or disable Validity Checks for a group.

Input type: SetGroupValidityChecksInput

Arguments#

Name Type Description
namespacePath ID! Full path of the group.
projectsToExclude [Int!] IDs of projects to exclude from validity checks configuration.
validityChecksEnabled Boolean! Whether to enable validity checks for all projects in the group.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
validityChecksEnabled Boolean! Indicates whether validity checks have been enabled for the group.

setLicenseConfigurationSource#

Set the license information source for a given project.

Input type: SetLicenseConfigurationSourceInput

Arguments#

Name Type Description
projectPath ID! Full path of the project.
source SecurityPreferredLicenseSourceConfiguration! Preferred source of license information for dependencies.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
licenseConfigurationSource SecurityPreferredLicenseSourceConfiguration Preferred source of license information for dependencies.

setLicenseScanningForCyclonedx#

Enable/disable license scanning for CycloneDX SBOM files for the given project.

Input type: SetLicenseScanningForCyclonedxInput

Arguments#

Name Type Description
enable Boolean! Desired status for license scanning for CycloneDX files.
projectPath ID! Full path of the project.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
licenseScanningForCyclonedxEnabled Boolean Whether license scanning for CycloneDX files is enabled.

setPagesForceHttps#

Input type: SetPagesForceHttpsInput

Arguments#

Name Type Description
projectPath ID! Path of the project to set the pages force HTTPS.
value Boolean! Indicates user wants to enforce HTTPS on their pages.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project that was updated.

setPagesUseUniqueDomain#

Input type: SetPagesUseUniqueDomainInput

Arguments#

Name Type Description
projectPath ID! Path of the project to set the pages to use unique domains.
value Boolean! Indicates user wants to use unique subdomains for their pages.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
project Project Project that was updated.

setPreReceiveSecretDetection#

Enable/disable secret push protection for the given project.

Input type: SetPreReceiveSecretDetectionInput

Arguments#

Name Type Description
enable Boolean! Desired status for secret push protection feature.
namespacePath ID! Full path of the namespace (project).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
preReceiveSecretDetectionEnabled Boolean Whether the feature is enabled.
secretPushProtectionEnabled Boolean Whether the feature is enabled.

setSecretPushProtection#

Enable/disable secret push protection for the given project.

Input type: SetSecretPushProtectionInput

Arguments#

Name Type Description
enable Boolean! Desired status for secret push protection feature.
namespacePath ID! Full path of the namespace (project).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
preReceiveSecretDetectionEnabled Boolean Whether the feature is enabled.
secretPushProtectionEnabled Boolean Whether the feature is enabled.

setValidityChecks#

Enable/disable secret detection validity checks for the given project.

Input type: SetValidityChecksInput

Arguments#

Name Type Description
enable Boolean! Desired status for validity checks feature.
namespacePath ID! Full path of the namespace (project).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
validityChecksEnabled Boolean Whether the feature is enabled.

starProject#

히스토리

Input type: StarProjectInput

Arguments#

Name Type Description
projectId ProjectID! Full path of the project to star or unstar.
starred Boolean! Indicates whether to star or unstar the project.

Fields#

Name Type Description
count String! Number of stars for the project.
errors [String!]! Errors encountered during the mutation.

startVulnerabilityWorkflow#

히스토리

Creates and starts a vulnerability workflow execution.

Input type: StartVulnerabilityWorkflowInput

Arguments#

Name Type Description
findingUuids [String!] Finding UUIDs to process, up to 1000. If omitted, all project findings are processed.
projectId ProjectID! Global ID of the project.
severities [VulnerabilitySeverity!] Severities to process. If omitted, all severities are processed.
workflow VulnerabilityDuoWorkflow! Workflow to execute.

Fields#

Name Type Description
errorReason VulnerabilityWorkflowErrorReason Machine-readable reason for the mutation error.
errors [String!]! Errors encountered during the mutation.
execution VulnerabilityWorkflowExecution Workflow execution.

tagCreate#

Creates a tag in a project repository. Rate limited per project by the tags_create_limit application setting.

Input type: TagCreateInput

Arguments#

Name Type Description Default
message String Tagging message. ""
name String! Name of the tag.
projectPath ID! Project full path the branch is associated with.
ref String! Tag name or commit SHA to create tag from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
tag Tag Tag after mutation.

tagDelete#

Input type: TagDeleteInput

Arguments#

Name Type Description
name String! Name of the tag.
projectPath ID! Project full path the branch is associated with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
tag Tag Tag after mutation.

terraformStateDelete#

Input type: TerraformStateDeleteInput

Arguments#

Name Type Description
id TerraformStateID! Global ID of the Terraform state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

terraformStateLock#

Input type: TerraformStateLockInput

Arguments#

Name Type Description
id TerraformStateID! Global ID of the Terraform state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

terraformStateUnlock#

Input type: TerraformStateUnlockInput

Arguments#

Name Type Description
id TerraformStateID! Global ID of the Terraform state.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

timelineEventCreate#

히스토리

Input type: TimelineEventCreateInput

Arguments#

Name Type Description
incidentId IssueID! Incident ID of the timeline event.
note String! Text note of the timeline event.
occurredAt Time! Timestamp of when the event occurred.
timelineEventTagNames [String!] Tags for the incident timeline event.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEvent TimelineEventType Timeline event.

timelineEventDestroy#

Input type: TimelineEventDestroyInput

Arguments#

Name Type Description
id IncidentManagementTimelineEventID! Timeline event ID to remove.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEvent TimelineEventType Timeline event.

timelineEventPromoteFromNote#

Input type: TimelineEventPromoteFromNoteInput

Arguments#

Name Type Description
noteId NoteID! Note ID from which the timeline event promoted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEvent TimelineEventType Timeline event.

timelineEventTagCreate#

Input type: TimelineEventTagCreateInput

Arguments#

Name Type Description
name String! Name of the tag.
projectPath ID! Project to create the timeline event tag in.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEventTag TimelineEventTagType Timeline event tag.

timelineEventUpdate#

Input type: TimelineEventUpdateInput

Arguments#

Name Type Description
id IncidentManagementTimelineEventID! ID of the timeline event to update.
note String Text note of the timeline event.
occurredAt Time Timestamp when the event occurred.
timelineEventTagNames [String!] Tags for the incident timeline event.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelineEvent TimelineEventType Timeline event.

timelogCreate#

Input type: TimelogCreateInput

Arguments#

Name Type Description
issuableId IssuableID! Global ID of the issuable (Issue, WorkItem or MergeRequest).
spentAt Time Timestamp of when the time was spent. If empty, defaults to current time.
summary String! Summary of time spent.
timeSpent String! Amount of time spent.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelog Timelog Timelog.

timelogDelete#

Input type: TimelogDeleteInput

Arguments#

Name Type Description
id TimelogID! Global ID of the timelog.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
timelog Timelog Timelog.

todoCreate#

Input type: TodoCreateInput

Arguments#

Name Type Description
targetId TodoableID! Global ID of the to-do item's parent. Issues, merge requests, designs, and epics are supported.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo To-do item created.

todoDeleteAllDone#

히스토리

Input type: TodoDeleteAllDoneInput

Arguments#

Name Type Description
updatedBefore Time To-do items marked as done before the timestamp will be deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

todoDeleteMany#

히스토리

Input type: TodoDeleteManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

todoMarkDone#

Input type: TodoMarkDoneInput

Arguments#

Name Type Description
id TodoID! Global ID of the to-do item to mark as done.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo! Requested to-do item.

todoResolveMany#

히스토리

Input type: TodoResolveManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Resolved to-do items.

todoRestore#

Input type: TodoRestoreInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo! Requested to-do item.

todoRestoreMany#

Input type: TodoRestoreManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Restored to-do items.

todoSnooze#

히스토리

Input type: TodoSnoozeInput

Arguments#

Name Type Description
id TodoID! Global ID of the to-do item to be snoozed.
snoozeUntil Time! Time until which the todo should be snoozed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo! Requested to-do item.

todoSnoozeMany#

히스토리

Input type: TodoSnoozeManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).
snoozeUntil Time! Time until which the todos should be snoozed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Snoozed to-do items.

todoUnSnooze#

히스토리

Input type: TodoUnSnoozeInput

Arguments#

Name Type Description
id TodoID! Global ID of the to-do item to be snoozed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todo Todo! Requested to-do item.

todoUnsnoozeMany#

히스토리

Input type: TodoUnsnoozeManyInput

Arguments#

Name Type Description
ids [TodoID!]! Global IDs of the to-do items to process (a maximum of 100 is supported at once).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Unsnoozed to-do items.

todosMarkAllDone#

Input type: TodosMarkAllDoneInput

Arguments#

Name Type Description
action [TodoActionEnum!] Action to be filtered.
authorId [ID!] ID of an author.
groupId [ID!] ID of a group.
projectId [ID!] ID of a project.
targetId TodoableID Global 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
todos [Todo!]! Updated to-do items.

unlinkProjectComplianceViolationIssue#

히스토리

Input type: UnlinkProjectComplianceViolationIssueInput

Arguments#

Name Type Description
issueIid String! IID of the issue to be unlinked.
projectPath ID! Full path of the project the issue belongs to.
violationId ComplianceManagementProjectsComplianceViolationID! Global ID of the project compliance violation.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
violation ProjectComplianceViolation Updated project compliance violation.

updateAiToolRule#

히스토리

Updates the permission settings for an AI tool rule.

Input type: UpdateAiToolRuleInput

Arguments#

Name Type Description
backgroundAccess AiBackgroundToolPermission Introduced as an experiment in GitLab 19.3.

Permission mode for the background-flow surface.
fullPath ID! Full path of the root namespace to update the tool rule for.
localAccess AiToolPermission Permission mode for local or IDE surface.
projectPath ID Full 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.
toolId String! Tool name string identifying the tool to update. For example, "create_issue".
unsetAccessTypes [AiToolAccessType!] Introduced as an experiment in GitLab 19.5.

Access types to clear so they fall back to their defaults. The rule is deleted when every access type is unset.
webAccess AiToolPermission Permission mode for web surface.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
toolRule AiToolRule Updated tool rule after mutation.

updateAlertStatus#

Input type: UpdateAlertStatusInput

Arguments#

Name Type Description
iid String! IID of the alert to mutate.
projectPath ID! Project the alert to mutate is in.
status AlertManagementStatus! Status to set the alert.

Fields#

Name Type Description
alert AlertManagementAlert Alert after mutation.
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.
todo Todo To-do item after mutation.

updateBoard#

Input type: UpdateBoardInput

Arguments#

Name Type Description
assigneeId UserID ID of user to be assigned to the board.
hideBacklogList Boolean Whether or not backlog list is hidden.
hideClosedList Boolean Whether or not closed list is hidden.
id BoardID! Board global ID.
iterationCadenceId IterationsCadenceID ID of iteration cadence to be assigned to the board.
iterationId IterationID ID of iteration to be assigned to the board.
labelIds [LabelID!] IDs of labels to be added to the board.
labels [String!] Labels of the issue.
milestoneId MilestoneID ID of milestone to be assigned to the board.
name String Board name.
weight Int Weight value to be assigned to the board.

Fields#

Name Type Description
board Board Board after mutation.
errors [String!]! Errors encountered during the mutation.

updateBoardEpicUserPreferences#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: UpdateBoardEpicUserPreferencesInput

Arguments#

Name Type Description
boardId BoardID! Board global ID.
collapsed Boolean! Whether the epic should be collapsed in the board.
epicId EpicID! ID of an epic to set preferences for.

Fields#

Name Type Description
epicUserPreferences BoardEpicUserPreferences User preferences for the epic in the board after mutation.
errors [String!]! Errors encountered during the mutation.

updateBoardList#

Input type: UpdateBoardListInput

Arguments#

Name Type Description
collapsed Boolean Indicates if the list is collapsed for the user.
listId ListID! Global ID of the list.
position Int Position of list within the board.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list BoardList Mutated list.

updateComplianceFramework#

Input type: UpdateComplianceFrameworkInput

Arguments#

Name Type Description
id ComplianceManagementFrameworkID! Global ID of the compliance framework to update.
params ComplianceFrameworkInput! Parameters to update the compliance framework with.

Fields#

Name Type Description
complianceFramework ComplianceFramework Compliance framework after mutation.
errors [String!]! Errors encountered during the mutation.

updateComplianceRequirement#

히스토리

Input type: UpdateComplianceRequirementInput

Arguments#

Name Type Description
controls [ComplianceRequirementsControlInput!] Controls to add or update to the compliance requirement.
id ComplianceManagementComplianceFrameworkComplianceRequirementID! Global ID of the compliance requirement to update.
params ComplianceRequirementInput! Parameters to update the compliance requirement with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirement ComplianceRequirement Compliance requirement after updation.

updateComplianceRequirementsControl#

히스토리

Input type: UpdateComplianceRequirementsControlInput

Arguments#

Name Type Description
id ComplianceManagementComplianceFrameworkComplianceRequirementsControlID! Global ID of the compliance requirement control to update.
params ComplianceRequirementsControlInput! Parameters to update the compliance requirement control with.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirementsControl ComplianceRequirementsControl Compliance requirement control after updation.

updateContainerExpirationPolicy#

Input type: UpdateContainerExpirationPolicyInput

Arguments#

Name Type Description
cadence ContainerExpirationPolicyCadenceEnum Schedule of the container expiration policy.
enabled Boolean Indicates whether the container expiration policy is enabled.
keepN ContainerExpirationPolicyKeepEnum Number of tags to retain.
nameRegex UntrustedRegexp Tags with names matching the regex pattern will expire.
nameRegexKeep UntrustedRegexp Tags with names matching the regex pattern will be preserved.
olderThan ContainerExpirationPolicyOlderThanEnum Tags older than the given age will expire.
projectPath ID! Project path where the container expiration policy is located.

Fields#

Name Type Description
containerExpirationPolicy ContainerExpirationPolicy Deprecated in GitLab 17.5. Use container_tags_expiration_policy.
containerTagsExpirationPolicy ContainerTagsExpirationPolicy Container tags expiration policy after mutation.
errors [String!]! Errors encountered during the mutation.

updateContainerProtectionRepositoryRule#

Updates a container repository protection rule that controls who can modify container images based on user roles.

Input type: UpdateContainerProtectionRepositoryRuleInput

Arguments#

Name Type Description
id ContainerRegistryProtectionRuleID! Global ID of the container repository protection rule to be updated.
minimumAccessLevelForDelete ContainerProtectionRepositoryRuleAccessLevel Introduced as an experiment 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.
minimumAccessLevelForPush ContainerProtectionRepositoryRuleAccessLevel Minimum 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.
repositoryPathPattern String 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.

Fields#

Name Type Description
containerProtectionRepositoryRule ContainerProtectionRepositoryRule Container repository protection rule after mutation.
errors [String!]! Errors encountered during the mutation.

updateContainerProtectionTagRule#

히스토리

Updates a protection rule that controls which user roles can modify container image tags matching a specified pattern.

Input type: UpdateContainerProtectionTagRuleInput

Arguments#

Name Type Description
id ContainerRegistryProtectionTagRuleID! Global ID of the tag protection rule to update.
minimumAccessLevelForDelete ContainerProtectionTagRuleAccessLevel Minimum 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.
minimumAccessLevelForPush ContainerProtectionTagRuleAccessLevel Minimum 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.
tagNamePattern String The pattern that matches container image tags to protect. For example, v1.*. Wildcard character * allowed.

Fields#

Name Type Description
containerProtectionTagRule ContainerProtectionTagRule Protection rule for container image tags after creation.
errors [String!]! Errors encountered during the mutation.

updateCustomDashboard#

히스토리

Updates a custom dashboard.

Input type: UpdateCustomDashboardInput

Arguments#

Name Type Description
config CustomDashboardConfigInput Dashboard layout/config.
description String Dashboard description.
id AnalyticsCustomDashboardsDashboardID! Global ID of the dashboard to update.
name String Dashboard name.

Fields#

Name Type Description
dashboard CustomDashboard Updated dashboard.
errors [String!]! Errors encountered during update.

updateDependencyProxyImageTtlGroupPolicy#

These settings can be adjusted only by the group Owner.

Input type: UpdateDependencyProxyImageTtlGroupPolicyInput

Arguments#

Name Type Description
enabled Boolean Indicates whether the policy is enabled or disabled.
groupPath ID! Group path for the group dependency proxy image TTL policy.
ttl Int Number of days to retain a cached image file.

Fields#

Name Type Description
dependencyProxyImageTtlPolicy DependencyProxyImageTtlGroupPolicy Group image TTL policy after mutation.
errors [String!]! Errors encountered during the mutation.

updateDependencyProxyPackagesSettings#

Updates or creates dependency proxy for packages settings. Requires the packages and dependency proxy to be enabled in the config. Requires the packages feature to be enabled at the project level.

Input type: UpdateDependencyProxyPackagesSettingsInput

Arguments#

Name Type Description
enabled Boolean Indicates whether the dependency proxy for packages is enabled for the project.
mavenExternalRegistryPassword String Password for the external Maven packages registry. Introduced in 16.5: This feature is an Experiment. It can be changed or removed at any time.
mavenExternalRegistryUrl String URL for the external Maven packages registry.
mavenExternalRegistryUsername String Username for the external Maven packages registry.
projectPath ID! Project path for the dependency proxy for packages settings.

Fields#

Name Type Description
dependencyProxyPackagesSetting DependencyProxyPackagesSetting Dependency proxy for packages settings after mutation.
errors [String!]! Errors encountered during the mutation.

updateDependencyProxySettings#

These settings can be adjusted only by the group Owner.

Input type: UpdateDependencyProxySettingsInput

Arguments#

Name Type Description
enabled Boolean Indicates whether the policy is enabled or disabled.
groupPath ID! Group path for the group dependency proxy.
identity String Identity 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)).
secret String Secret credential used to authenticate with Docker Hub when pulling images. Can be a password, personal access token (PAT), or organization access token (OAT).

Fields#

Name Type Description
dependencyProxySetting DependencyProxySetting Group dependency proxy settings after mutation.
errors [String!]! Errors encountered during the mutation.

updateDuoWorkflowAgentPrivileges#

히스토리

Input type: UpdateDuoWorkflowAgentPrivilegesInput

Arguments#

Name Type Description
agentPrivileges [Int!] Replaces the set of actions the agent is allowed to perform.
preApprovedAgentPrivileges [Int!] Replaces the set of actions the agent can perform without asking for approval.
workflowId AiDuoWorkflowsWorkflowID! Global ID of the workflow to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during update.
workflow DuoWorkflow Updated workflow.

updateDuoWorkflowToolCallApprovals#

히스토리

Input type: UpdateDuoWorkflowToolCallApprovalsInput

Arguments#

Name Type Description
approvalSource DuoWorkflowToolCallApprovalSource Introduced as an experiment in GitLab 19.3.

Source of the approval decision, for audit purposes.
pattern String Glob pattern to approve for matching tool call arguments.
toolCallArgs JSON Arguments for the tool call.
toolName String! Name of the tool to approve.
workflowId AiDuoWorkflowsWorkflowID! Global ID of the workflow to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during update.
workflow DuoWorkflow Updated workflow with new tool approvals.

updateDuoWorkflowWebSearch#

히스토리

Input type: UpdateDuoWorkflowWebSearchInput

Arguments#

Name Type Description
webSearchEnabled Boolean! Whether web search should be enabled for the session.
workflowId AiDuoWorkflowsWorkflowID! Global ID of the workflow to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during update.
workflow DuoWorkflow Updated workflow.

updateEpic#

Deprecated in GitLab 17.5. Replaced by WorkItem type. For more information, see migration guide.

Input type: UpdateEpicInput

Arguments#

Name Type Description
addLabelIds [ID!] IDs of labels to be added to the epic.
addLabels [String!] Array of labels to be added to the epic.
color Color Color of the epic.
confidential Boolean Indicates if the epic is confidential.
description String Description of the epic.
dueDateFixed String End date of the epic.
dueDateIsFixed Boolean Indicates end date should be sourced from due_date_fixed field not the issue milestones.
groupPath ID! Group the epic to mutate is in.
iid ID! 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.
startDateFixed String Start date of the epic.
startDateIsFixed Boolean Indicates start date should be sourced from start_date_fixed field not the issue milestones.
stateEvent EpicStateEvent State event for the epic.
title String Title of the epic.

Fields#

Name Type Description
epic Epic Epic after mutation.
errors [String!]! Errors encountered during the mutation.

updateEpicBoardList#

Deprecated in GitLab 17.5. Replaced by WorkItem type.

Input type: UpdateEpicBoardListInput

Arguments#

Name Type Description
collapsed Boolean Indicates if the list is collapsed for the user.
listId BoardsEpicListID! Global ID of the epic list.
position Int Position of list within the board.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
list EpicList Mutated epic list.

updateImageDiffNote#

Updates a DiffNote on an image (a Note where the position.positionType is "image"). If the body of the Note contains only quick actions, the Note will be destroyed during an update, and no Note will be returned.

Input type: UpdateImageDiffNoteInput

Arguments#

Name Type Description
body String Content of the note.
id NoteID! Global ID of the note to update.
position UpdateDiffImagePositionInput Position of the note on a diff.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

updateIssue#

Input type: UpdateIssueInput

Arguments#

Name Type Description
addLabelIds [ID!] IDs of labels to be added to the issue.
confidential Boolean Indicates the issue is confidential.
description String Description of the issue.
dueDate ISO8601Date Due date of the issue.
epicId EpicID Deprecated in GitLab 17.5. This will be replaced by WorkItem hierarchyWidget.
healthStatus HealthStatus Desired health status.
iid String! IID of the issue to mutate.
labelIds [ID!] IDs of labels to be set. Replaces existing issue labels.
locked Boolean Indicates discussion is locked on the issue.
milestoneId ID ID 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.
projectPath ID! Project the issue to mutate is in.
removeLabelIds [ID!] IDs of labels to be removed from the issue.
stateEvent IssueStateEvent Close or reopen an issue.
timeEstimate String Estimated time to complete the issue. Use null or 0 to remove the current estimate.
title String Title of the issue.
type IssueType Type of the issue.
weight Int Weight of the issue.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue after mutation.

updateIteration#

Input type: UpdateIterationInput

Arguments#

Name Type Description
description String Description of the iteration.
dueDate String End date of the iteration.
groupPath ID! Group of the iteration.
id ID! Global ID of the iteration.
startDate String Start date of the iteration.
title String Title of the iteration.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
iteration Iteration Updated iteration.

updateNamespacePackageSettings#

These settings can be adjusted only by the group Owner.

Input type: UpdateNamespacePackageSettingsInput

Arguments#

Name Type Description
auditEventsEnabled Boolean Indicates whether audit events are created when publishing or deleting a package in the namespace (Premium and Ultimate only).
genericDuplicateExceptionRegex UntrustedRegexp When 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.
genericDuplicatesAllowed Boolean Indicates whether duplicate generic packages are allowed for the namespace.
lockMavenPackageRequestsForwarding Boolean Indicates whether Maven package forwarding is locked for all descendent namespaces.
lockNpmPackageRequestsForwarding Boolean Indicates whether npm package forwarding is locked for all descendent namespaces.
lockPypiPackageRequestsForwarding Boolean Indicates whether PyPI package forwarding is locked for all descendent namespaces.
lockRubygemsPackageRequestsForwarding Boolean Indicates whether RubyGems package forwarding is locked for all descendent namespaces.
mavenDuplicateExceptionRegex UntrustedRegexp When 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.
mavenDuplicatesAllowed Boolean Indicates whether duplicate Maven packages are allowed for the namespace.
mavenPackageRequestsForwarding Boolean Indicates whether Maven package forwarding is allowed for the namespace.
namespacePath ID! Namespace path where the namespace package setting is located.
npmPackageRequestsForwarding Boolean Indicates whether npm package forwarding is allowed for the namespace.
nugetDuplicateExceptionRegex UntrustedRegexp When 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.
nugetDuplicatesAllowed Boolean Indicates whether duplicate NuGet packages are allowed for the namespace.
nugetSymbolServerEnabled Boolean Indicates whether the NuGet symbol server is enabled for the namespace.
pypiPackageRequestsForwarding Boolean Indicates whether PyPI package forwarding is allowed for the namespace.
rubygemsPackageRequestsForwarding Boolean Indicates whether RubyGems package forwarding is allowed for the namespace.
terraformModuleDuplicateExceptionRegex UntrustedRegexp When 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.
terraformModuleDuplicatesAllowed Boolean Indicates whether duplicate Terraform packages are allowed for the namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packageSettings PackageSettings Namespace package setting after mutation.

updateNote#

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

Input type: UpdateNoteInput

Arguments#

Name Type Description
body String Content of the note.
id NoteID! Global ID of the note to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
note Note Note after mutation.
quickActionsStatus QuickActionsStatus Status of quick actions after mutation.

updatePackagesCleanupPolicy#

Input type: UpdatePackagesCleanupPolicyInput

Arguments#

Name Type Description
keepNDuplicatedPackageFiles PackagesCleanupKeepDuplicatedPackageFilesEnum Number of duplicated package files to retain.
projectPath ID! Project path where the packages cleanup policy is located.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packagesCleanupPolicy PackagesCleanupPolicy Packages cleanup policy after mutation.

updatePackagesProtectionRule#

Updates a package protection rule to restrict access to project packages. You can prevent users without certain permissions from altering packages.

Input type: UpdatePackagesProtectionRuleInput

Arguments#

Name Type Description
id PackagesProtectionRuleID! Global ID of the package protection rule to be updated.
minimumAccessLevelForDelete PackagesProtectionRuleAccessLevelForDelete Introduced as an experiment 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.
minimumAccessLevelForPush PackagesProtectionRuleAccessLevel Minimum 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.
packageNamePattern String Package name protected by the protection rule. For example, @my-scope/my-package-*. Wildcard character * allowed.
packageType PackagesProtectionRulePackageType Package type protected by the protection rule. For example, NPM, PYPI.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
packageProtectionRule PackagesProtectionRule Packages protection rule after mutation.

updateProjectComplianceViolation#

히스토리

Input type: UpdateProjectComplianceViolationInput

Arguments#

Name Type Description
id ComplianceManagementProjectsComplianceViolationID! Global ID of the project compliance violation to update.
status ComplianceViolationStatus! New status for the project compliance violation.

Fields#

Name Type Description
complianceViolation ProjectComplianceViolation Compliance violation after status update.
errors [String!]! Errors encountered during the mutation.

updateRequirement#

Input type: UpdateRequirementInput

Arguments#

Name Type Description
description String Description of the requirement.
iid String Deprecated in GitLab 15.8. Use work_item_iid instead.
lastTestReportState TestReportState Creates a test report for the requirement with the given state.
projectPath ID! Full project path the requirement is associated with.
state RequirementState State of the requirement.
title String Title of the requirement.
workItemIid String IID of the requirement work item to update.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
requirement Requirement Requirement after mutation.

updateSnippet#

Input type: UpdateSnippetInput

Arguments#

Name Type Description
blobActions [SnippetBlobActionInputType!] Actions to perform over the snippet repository and blobs.
description String Description of the snippet.
id SnippetID! Global ID of the snippet to update.
title String Title of the snippet.
visibilityLevel VisibilityLevelsEnum Visibility level of the snippet.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
snippet Snippet Snippet after mutation.

updateTerraformStateProtectionRule#

히스토리

Updates a protection rule for a Terraform state backend.

Input type: UpdateTerraformStateProtectionRuleInput

Arguments#

Name Type Description
allowedFrom TerraformStateProtectionRuleAllowedFrom Introduced as an experiment 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.
id TerraformStateProtectionRuleID! Global ID of the Terraform state protection rule to update.
minimumAccessLevelForWrite TerraformStateProtectionRuleAccessLevel Introduced as an experiment 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.
stateName String Introduced as an experiment in GitLab 18.11.

Terraform state name protected by the rule.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
terraformStateProtectionRule TerraformStateProtectionRule Introduced as an experiment in GitLab 18.11.

Terraform state protection rule after mutation.

updateVirtualRegistriesSetting#

히스토리

Updates or creates virtual registries settings for a root group.

Input type: UpdateVirtualRegistriesSettingInput

Arguments#

Name Type Description
enabled Boolean Enable or disable the virtual registries.
fullPath ID! Group path for the group virtual registries.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
virtualRegistriesSetting VirtualRegistriesSetting Virtual registries settings after mutation.

uploadCreate#

히스토리

Creates an upload (uploads a file to a project or group for use in Markdown).

Input type: UploadCreateInput

Arguments#

Name Type Description
file Upload! File to upload.
groupPath ID Full path of the group with which the resource is associated.
projectPath ID Full path of the project with which the resource is associated.

Fields#

Name Type Description
alt String Alt text for the uploaded file. Usually the name of the file.
errors [String!]! Errors encountered during the mutation.
fullPath String Full path to the file.
markdown String Markdown-formatted link to the file.
upload FileUpload Uploaded file.
url String URL to access the file.

uploadDelete#

Deletes an upload.

Input type: UploadDeleteInput

Arguments#

Name Type Description
filename String! Upload filename.
groupPath ID Full path of the group with which the resource is associated.
projectPath ID Full path of the project with which the resource is associated.
secret String! Secret part of upload path.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
upload FileUpload Deleted upload.

upsertFlatUserCap#

Update the flat per-user budget cap for a subscription.

Input type: UpsertFlatUserCapInput

Arguments#

Name Type Description
flatUserCap Float! Default per-user budget cap applied to all users.
flatUserCapEnabled Boolean! Whether the flat per-user budget cap is enabled.
namespacePath String Path of the top-level group namespace. Omit for self-managed instance scope.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
flatUserCap Float Updated flat per-user budget cap.
flatUserCapEnabled Boolean Whether the flat per-user budget cap is enabled.

upsertUserBudgetCapOverrides#

Bulk upsert per-user budget cap overrides.

Input type: UpsertUserBudgetCapOverridesInput

Arguments#

Name Type Description
namespacePath String Path of the top-level group namespace. Omit for self-managed instance scope.
overrides [BudgetCapUserOverrideInput!]! List of per-user budget cap overrides to upsert.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userOverrides [GitlabSubscriptionBudgetCapUserOverride!] Updated user budget cap overrides.

userAchievementPrioritiesUpdate#

Input type: UserAchievementPrioritiesUpdateInput

Arguments#

Name Type Description
userAchievementIds [AchievementsUserAchievementID!]! Global IDs of the user achievements being prioritized, ordered from highest to lowest priority.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievements [UserAchievement!]! Updated user achievements.

userAchievementsDelete#

Input type: UserAchievementsDeleteInput

Arguments#

Name Type Description
userAchievementId AchievementsUserAchievementID! Global ID of the user achievement being deleted.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievement UserAchievement Deleted user achievement.

userAchievementsUpdate#

Input type: UserAchievementsUpdateInput

Arguments#

Name Type Description
awardMessage String Message to associate with the awarded achievement.
showOnProfile Boolean Indicates whether or not the user achievement is visible on the profile.
userAchievementId AchievementsUserAchievementID! Global ID of the user achievement being updated.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userAchievement UserAchievement Achievement award.

userAddOnAssignmentBulkCreate#

Input type: UserAddOnAssignmentBulkCreateInput

Arguments#

Name Type Description
addOnPurchaseId GitlabSubscriptionsAddOnPurchaseID! Global ID of AddOnPurchase to be assigned to.
userIds [UserID!]! Global IDs of user to be assigned.

Fields#

Name Type Description
addOnPurchase AddOnPurchase AddOnPurchase state after mutation.
errors [String!]! Errors encountered during the mutation.
users AddOnUserConnection Users who the add-on purchase was assigned to. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.

userAddOnAssignmentBulkRemove#

Input type: UserAddOnAssignmentBulkRemoveInput

Arguments#

Name Type Description
addOnPurchaseId GitlabSubscriptionsAddOnPurchaseID! Global ID of AddOnPurchase to be unassigned from.
userIds [UserID!]! Global IDs of user to be unassigned.

Fields#

Name Type Description
addOnPurchase AddOnPurchase AddOnPurchase state after mutation.
errors [String!]! Errors encountered during the mutation.
users AddOnUserConnection Users who was unassigned from the add-on purchase. This field is a connection and accepts the four standard pagination arguments: before, after, first, last.

userAddOnAssignmentCreate#

Input type: UserAddOnAssignmentCreateInput

Arguments#

Name Type Description
addOnPurchaseId GitlabSubscriptionsAddOnPurchaseID! Global ID of AddOnPurchase to be assigned to.
userId UserID! Global ID of user to be assigned.

Fields#

Name Type Description
addOnPurchase AddOnPurchase AddOnPurchase state after mutation.
errors [String!]! Errors encountered during the mutation.
user AddOnUser User who the add-on purchase was assigned to.

userAddOnAssignmentRemove#

Input type: UserAddOnAssignmentRemoveInput

Arguments#

Name Type Description
addOnPurchaseId GitlabSubscriptionsAddOnPurchaseID! Global ID of AddOnPurchase assignment belongs to.
userId UserID! Global ID of user whose assignment will be removed.

Fields#

Name Type Description
addOnPurchase AddOnPurchase AddOnPurchase state after mutation.
errors [String!]! Errors encountered during the mutation.
user AddOnUser User that the add-on was removed from.

userCalloutCreate#

Input type: UserCalloutCreateInput

Arguments#

Name Type Description
featureName String! Feature name you want to dismiss the callout for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userCallout UserCallout! User callout dismissed.

userCustomAttributeSet#

히스토리

Creates or updates a custom attribute on a user. Only available to admins.

Input type: UserCustomAttributeSetInput

Arguments#

Name Type Description
key String! Key of the custom attribute.
userId UserID! Global ID of the user.
value String! Value of the custom attribute.

Fields#

Name Type Description
customAttribute CustomAttribute Custom attribute after mutation.
errors [String!]! Errors encountered during the mutation.

userGroupCalloutCreate#

Input type: UserGroupCalloutCreateInput

Arguments#

Name Type Description
featureName String! Feature name you want to dismiss the callout for.
groupId GroupID! Group for the callout.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userGroupCallout UserGroupCallout! User group callout dismissed.

userPreferencesUpdate#

Input type: UserPreferencesUpdateInput

Arguments#

Name Type Description
duoDefaultNamespaceId Int Default namespace context for Duo features when namespace can not be inferred.
extensionsMarketplaceOptInStatus ExtensionsMarketplaceOptInStatus Status of the Web IDE Extension Marketplace opt-in for the user.
issuesSort IssueSort Sort order for issue lists.
knowledgeGraphGoverningNamespaceId Int Governing and billing namespace for Orbit.
mergeRequestDashboardListType MergeRequestsDashboardListType Merge request dashboard list rendering type.
mergeRequestDashboardShowDrafts Boolean Show draft merge requests on the merge request dashboard.
mergeRequestsSort MergeRequestSort Sort order for issue lists.
orbitSettings JSON Introduced as an experiment in GitLab 19.0.

Orbit agent settings, e.g.: "{ enabled: false }".
organizationGroupsProjectsDisplay OrganizationGroupProjectDisplay Introduced as an experiment in GitLab 17.2.

Default list view for organization groups and projects.
organizationGroupsProjectsSort OrganizationGroupProjectSort Introduced as an experiment in GitLab 17.2.

Sort order for organization groups and projects.
projectsSort ProjectSort Sort order for projects.
useWorkItemsView Boolean Deprecated in GitLab 19.5. Work item view is always used.
visibilityPipelineIdType VisibilityPipelineIdType Determines whether the pipeline list shows ID or IID.
wikiUseAutoCommitMessage Boolean Introduced as an experiment 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.
workItemsDisplaySettings JSON Introduced as an experiment in GitLab 18.1.

Display settings for the work item lists, e.g.: "{ shouldOpenItemsInSidePanel: false }".

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userPreferences UserPreferences User preferences after mutation.

userSetNamespaceCommitEmail#

Input type: UserSetNamespaceCommitEmailInput

Arguments#

Name Type Description
emailId EmailID ID of the email to set.
namespaceId NamespaceID! ID of the namespace to set the namespace commit email for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespaceCommitEmail NamespaceCommitEmail User namespace commit email after mutation.

valueStreamCreate#

히스토리

Creates a value stream.

Input type: ValueStreamCreateInput

Arguments#

Name Type Description
name String! Value stream name.
namespacePath ID! Full path of the namespace(project or group) the value stream is created in.
setting ValueStreamSettingInput Value stream configuration.
stages [CreateValueStreamStageInput!] Value stream stages.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
valueStream ValueStream Created value stream.

valueStreamDestroy#

히스토리

Destroy a value stream.

Input type: ValueStreamDestroyInput

Arguments#

Name Type Description
id AnalyticsCycleAnalyticsValueStreamID! Global ID of the value stream to destroy.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
valueStream ValueStream Value stream deleted after mutation.

valueStreamUpdate#

히스토리

Updates a value stream.

Input type: ValueStreamUpdateInput

Arguments#

Name Type Description
id AnalyticsCycleAnalyticsValueStreamID! Global ID of the value stream to update.
name String Value stream name.
setting ValueStreamSettingInput Value stream configuration.
stages [UpdateValueStreamStageInput!] Value stream stages.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
valueStream ValueStream Updated value stream.

verifiedNamespaceCreate#

Create a verified namespace and mark all child catalog resources with the passed verification level info.

Input type: VerifiedNamespaceCreateInput

Arguments#

Name Type Description
namespacePath ID! Root namespace path.
verificationLevel CiCatalogResourceVerificationLevel! Verification level for a root namespace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

virtualRegistriesCleanupPolicyUpsert#

히스토리

Create or update virtual registries cleanup policy for a root group.

Input type: VirtualRegistriesCleanupPolicyUpsertInput

Arguments#

Name Type Description
cadence Int Job cadence for the cleanup process. Allowed values are 1, 7, 14, 30, 90. Default is 7.
enabled Boolean Enable or disable the virtual registries cleanup policy. Default is false.
fullPath ID! Group path for the group virtual registries.
keepNDaysAfterDownload Int Keep packages for the period after download. Range is 1-365. Default is 30.
notifyOnFailure Boolean Whether to notify group owners when cleanup runs fail. Default is false.
notifyOnSuccess Boolean Whether to notify group owners when cleanup runs succeed. Default is false.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
virtualRegistriesCleanupPolicy VirtualRegistryCleanupPolicy Virtual registries cleanup policy after mutation.

vulnerabilitiesArchive#

히스토리

Input type: VulnerabilitiesArchiveInput

Arguments#

Name Type Description
date Date! Last update date of vulnerabilities being archived.
projectId ProjectID! ID of the project to attach the vulnerability to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
status String! Status of the action.

vulnerabilitiesCreateIssue#

히스토리

Input type: VulnerabilitiesCreateIssueInput

Arguments#

Name Type Description
project ProjectID! 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.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issue Issue Issue created after mutation.

vulnerabilitiesDismiss#

Input type: VulnerabilitiesDismissInput

Arguments#

Name Type Description
comment String Comment why vulnerability was dismissed (maximum 50,000 characters).
dismissalReason VulnerabilityDismissalReason Reason why vulnerability should be dismissed.
vulnerabilityIds [VulnerabilityID!]! IDs of the vulnerabilities to be dismissed (maximum 100 entries).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerabilities [Vulnerability!]! Vulnerabilities after state change.

vulnerabilitiesRemoveAllFromProject#

Remove all Vulnerabilities and related information from a given project. Introduced in GitLab 16.7.

Input type: VulnerabilitiesRemoveAllFromProjectInput

Arguments#

Name Type Description
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.
resolvedOnDefaultBranch Boolean When set as true, deletes only the vulnerabilities no longer detected. When set as false, deletes only the vulnerabilities still detected.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
projects [Project!]! Projects for which the deletion was scheduled.

vulnerabilitiesSeverityOverride#

Input type: vulnerabilitiesSeverityOverrideInput

Arguments#

Name Type Description
comment String! Comment why vulnerability severity was changed (maximum 50,000 characters).
severity VulnerabilitySeverity! New severity value for the severities.
vulnerabilityIds [VulnerabilityID!]! IDs of the vulnerabilities for which severity needs to be changed (maximum 100 entries).

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerabilities [Vulnerability!]! Vulnerabilities after severity change.

vulnerabilityAutoRemediation#

히스토리

Triggers automated remediation for a single vulnerability. Currently supports dependency (SCA) vulnerabilities, where a remediation merge request is created asynchronously when a fix is available; other report types return UNSUPPORTED.

Input type: VulnerabilityAutoRemediationInput

Arguments#

Name Type Description
vulnerabilityId VulnerabilityID! ID of the vulnerability to remediate.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
status VulnerabilityAutoRemediationStatus Outcome of triggering auto-remediation.

vulnerabilityConfirm#

Input type: VulnerabilityConfirmInput

Arguments#

Name Type Description
comment String Comment why vulnerability was confirmed (maximum 50,000 characters).
id VulnerabilityID! ID of the vulnerability to be confirmed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after state change.

vulnerabilityCreate#

Input type: VulnerabilityCreateInput

Arguments#

Name Type Description Default
confirmedAt Time Timestamp of when the vulnerability state changed to confirmed (defaults to creation time if status is confirmed).
description String! Long text section that describes the vulnerability in more detail.
detectedAt Time Timestamp of when the vulnerability was first detected (defaults to creation time).
dismissedAt Time Timestamp 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.
name String! Name of the vulnerability.
project ProjectID! ID of the project to attach the vulnerability to.
projectTrackedContext ProjectTrackedContextInput Tracked context to associate with the vulnerability.
resolvedAt Time Timestamp of when the vulnerability state changed to resolved (defaults to creation time if status is resolved).
scanner VulnerabilityScannerInput! Information about the scanner used to discover the vulnerability.
severity VulnerabilitySeverity Severity of the vulnerability (defaults to unknown). UNKNOWN
solution String Instructions for how to fix the vulnerability.
state VulnerabilityState State of the vulnerability (defaults to detected). DETECTED

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability created.

vulnerabilityDismiss#

Input type: VulnerabilityDismissInput

Arguments#

Name Type Description
comment String Comment why vulnerability was dismissed (maximum 50,000 characters).
dismissalReason VulnerabilityDismissalReason Reason why vulnerability should be dismissed.
id VulnerabilityID! ID of the vulnerability to be dismissed.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after state change.

vulnerabilityDismissFalsePositiveFlag#

히스토리

Dismiss a vulnerability false positive flag.

Input type: VulnerabilityDismissFalsePositiveFlagInput

Arguments#

Name Type Description
id VulnerabilityID! ID of the vulnerability to dismiss false positive flag for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after dismissing false positive flag.

vulnerabilityExternalIssueLinkCreate#

Input type: VulnerabilityExternalIssueLinkCreateInput

Arguments#

Name Type Description
externalTracker VulnerabilityExternalIssueLinkExternalTracker! External tracker type of the external issue link.
id VulnerabilityID! ID of the vulnerability.
linkType VulnerabilityExternalIssueLinkType! Type of the external issue link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
externalIssueLink VulnerabilityExternalIssueLink Created external issue link.

vulnerabilityExternalIssueLinkDestroy#

Input type: VulnerabilityExternalIssueLinkDestroyInput

Arguments#

Name Type Description
id VulnerabilitiesExternalIssueLinkID! Global ID of the vulnerability external issue link.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.

vulnerabilityIssueLinkCreate#

Input type: VulnerabilityIssueLinkCreateInput

Arguments#

Name Type Description
issueId IssueID! ID of the issue to link to.
vulnerabilityIds [VulnerabilityID!]! IDs of vulnerabilities to link to the given issue. Up to 100 can be provided.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
issueLinks [VulnerabilityIssueLink!] Created issue links.

vulnerabilityLinkMergeRequest#

히스토리

Link a merge request to a vulnerability.

Input type: VulnerabilityLinkMergeRequestInput

Arguments#

Name Type Description
mergeRequestId MergeRequestID! ID of the merge request.
readinessScore Float Confidence 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.
vulnerabilityId VulnerabilityID! ID of the vulnerability.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Updated vulnerability.

vulnerabilityResolve#

Input type: VulnerabilityResolveInput

Arguments#

Name Type Description
comment String Comment why vulnerability was resolved (maximum 50,000 characters).
id VulnerabilityID! ID of the vulnerability to be resolved.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after state change.

vulnerabilityRevertToDetected#

Input type: VulnerabilityRevertToDetectedInput

Arguments#

Name Type Description
comment String Comment why vulnerability was reverted to detected (maximum 50,000 characters).
id VulnerabilityID! ID of the vulnerability to be reverted to detected.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Vulnerability after state change.

vulnerabilityUnlinkMergeRequest#

히스토리

Unlink a merge request from a vulnerability.

Input type: VulnerabilityUnlinkMergeRequestInput

Arguments#

Name Type Description
mergeRequestId MergeRequestID! ID of the merge request.
vulnerabilityId VulnerabilityID! ID of the vulnerability.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
vulnerability Vulnerability Updated vulnerability.

wikiPageSubscribe#

히스토리

Input type: WikiPageSubscribeInput

Arguments#

Name Type Description
id WikiPageMetaID! Global ID of the wiki page meta record.
subscribed Boolean! Desired state of the subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
wikiPage WikiPage Wiki page after mutation.

workItemAddClosingMergeRequest#

히스토리

Adds a closing merge request to a work item.

Input type: WorkItemAddClosingMergeRequestInput

Arguments#

Name Type Description
contextNamespacePath ID Full 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.
id WorkItemID! Global ID of the work item.
mergeRequestReference String! Merge request reference (short, full or URL). Example: !1, project_full_path!1 or https://gitlab.com/gitlab-org/gitlab/-/merge_requests/1.

Fields#

Name Type Description
closingMergeRequest WorkItemClosingMergeRequest Closing merge request added to the work item.
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Work item with new closing merge requests.

workItemAddLinkedItems#

히스토리

Add linked items to the work item.

Input type: WorkItemAddLinkedItemsInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
linkType WorkItemRelatedLinkType Type of link. Defaults to RELATED.
workItemsIds [WorkItemID!]! Global IDs of the items to link. Maximum number of IDs you can provide: 10.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Linked items update result message.
workItem WorkItem Updated work item.

workItemAvailabilityToggle#

히스토리

Enables or disables a work item type for a namespace.

Input type: WorkItemAvailabilityToggleInput

Arguments#

Name Type Description
action WorkItemAvailabilityAction! Whether to enable or disable the work item type.
fullPath ID! Full path of the group or project.
scope WorkItemAvailabilityScope! Whether to apply to the namespace or propagate to all existing children.
workItemTypeId WorkItemsTypeID! Global ID of the work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItemType WorkItemType Work item type after the availability change.

workItemBulkMove#

히스토리

Moves work items between projects or groups.

Input type: WorkItemBulkMoveInput

Arguments#

Name Type Description
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.
sourceFullPath String! Full path of the source namespace. For example, gitlab-org/gitlab-foss.
targetFullPath String! Full path of the target namespace. For example, gitlab-org/gitlab-foss. User paths are not supported.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
movedWorkItemCount Int Number of work items that were successfully moved.

workItemBulkUpdate#

히스토리

Allows updating several properties for a set of work items.

Input type: WorkItemBulkUpdateInput

Arguments#

Name Type Description
assigneesWidget WorkItemWidgetAssigneesInput Introduced as an experiment in GitLab 18.2.

Input for assignees widget.
confidential Boolean Introduced as an experiment in GitLab 18.2.

Sets the work item confidentiality.
fullPath ID! Full path of the project or group containing the work items that will be updated. User paths are not supported.
healthStatusWidget WorkItemWidgetHealthStatusInput Introduced as an experiment in GitLab 18.2.

Input for health status widget.
hierarchyWidget WorkItemWidgetHierarchyCreateInput Introduced as an experiment 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.
iterationWidget WorkItemWidgetIterationInput Introduced as an experiment in GitLab 18.2.

Input for iteration widget.
labelsWidget WorkItemWidgetLabelsUpdateInput Input for labels widget.
milestoneWidget WorkItemWidgetMilestoneInput Introduced as an experiment in GitLab 18.2.

Input for milestone widget.
stateEvent WorkItemStateEvent Introduced as an experiment in GitLab 18.2.

Close or reopen multiple work items at once.
statusWidget WorkItemWidgetStatusInput Introduced as an experiment in GitLab 18.3.

Input for status widget.
subscriptionEvent WorkItemSubscriptionEvent Introduced as an experiment in GitLab 18.2.

Subscribe or unsubscribe from the work items.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
updatedWorkItemCount Int Number of work items that were successfully updated.

workItemConvert#

히스토리

Converts the work item to a new type.

Input type: WorkItemConvertInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
workItemTypeId WorkItemsTypeID! Global ID of the new work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Updated work item.

workItemCreate#

히스토리

Creates a work item.

Input type: WorkItemCreateInput

Arguments#

Name Type Description
agentPlanWidget WorkItemWidgetAgentPlanInput Introduced as an experiment in GitLab 19.0.

Input for agent plan widget.
assigneesWidget WorkItemWidgetAssigneesInput Input for assignees widget.
colorWidget WorkItemWidgetColorInput Input for color widget.
confidential Boolean Sets the work item confidentiality.
createSource String Source which triggered the creation of the work item. Used only for tracking purposes.
createdAt Time Timestamp when the work item was created. Available only for admins and project owners.
crmContactsWidget WorkItemWidgetCrmContactsCreateInput Input for CRM contacts widget.
customFieldsWidget [WorkItemWidgetCustomFieldValueInputType!] Introduced as an experiment in GitLab 17.10.

Input for custom fields widget.
description String Deprecated in GitLab 16.9. use description widget instead.
descriptionWidget WorkItemWidgetDescriptionInput Input for description widget.
developmentWidget WorkItemWidgetDevelopmentCreateInput Input for development widget.
discussionsToResolve WorkItemResolveDiscussionsInput Information required to resolve discussions in a noteable, when the work item is created.
healthStatusWidget WorkItemWidgetHealthStatusInput Input for health status widget.
hierarchyWidget WorkItemWidgetHierarchyCreateInput Input for hierarchy widget.
iterationWidget WorkItemWidgetIterationInput Iteration widget of the work item.
labelsWidget WorkItemWidgetLabelsCreateInput Input for labels widget.
linkedItemsWidget WorkItemWidgetLinkedItemsCreateInput Input for linked items widget.
milestoneWidget WorkItemWidgetMilestoneInput Input for milestone widget.
namespacePath ID Full path of the namespace(project or group) the work item is created in.
projectPath ID Deprecated in GitLab 15.10. Please use namespacePath instead. That will cover for both projects and groups.
startAndDueDateWidget WorkItemWidgetStartAndDueDateUpdateInput Input for start and due date widget.
statusWidget WorkItemWidgetStatusInput Introduced as an experiment in GitLab 17.11.

Input for status widget.
title String! Title of the work item.
vulnerabilityId VulnerabilityID Introduced as an experiment in GitLab 17.9.

Input for linking an existing vulnerability to created work item.
weightWidget WorkItemWidgetWeightInput Input for weight widget.
workItemTypeId WorkItemsTypeID! Global ID of a work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Created work item.

workItemCreateFromTask#

히스토리

Creates a work item from a task in another work item's description.

Input type: WorkItemCreateFromTaskInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
workItemData WorkItemConvertTaskInput! Arguments necessary to convert a task into a work item.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
newWorkItem WorkItem New work item created from task.
workItem WorkItem Updated work item.

workItemDecisionArchive#

히스토리

Archives a resolved decision in the decision log of a work item. The decision is kept but marked as archived. Open decisions cannot be archived, and archiving cannot be undone.

Input type: WorkItemDecisionArchiveInput

Arguments#

Name Type Description
id WorkItemsDecisionID! Global ID of the decision.

Fields#

Name Type Description
decision WorkItemDecision Decision after mutation.
errors [String!]! Errors encountered during the mutation.

workItemDecisionCreate#

히스토리

Records a decision in the decision log of a work item.

Input type: WorkItemDecisionCreateInput

Arguments#

Name Type Description
description String Context of the decision.
discussionId DiscussionID Global ID of the originating discussion thread.
options [WorkItemDecisionOptionInput!] Candidate options of the decision. Maximum of 5 options. Incompatible with resolution.
resolution WorkItemDecisionResolutionInput When present, records the decision as resolved at creation. Incompatible with options.
sourceLink String URL of the comment, discussion, or external resource that prompted the decision.
title String Question being decided. Required unless resolution is provided.
workItemId WorkItemID! Global ID of the work item.

Fields#

Name Type Description
decision WorkItemDecision Decision after mutation.
errors [String!]! Errors encountered during the mutation.

workItemDecisionDelete#

히스토리

Deletes an open decision from the decision log of a work item. Resolved or archived decisions cannot be deleted; archive resolved decisions instead.

Input type: WorkItemDecisionDeleteInput

Arguments#

Name Type Description
id WorkItemsDecisionID! Global ID of the decision.

Fields#

Name Type Description
decision WorkItemDecision Deleted decision.
errors [String!]! Errors encountered during the mutation.

workItemDecisionResolve#

히스토리

Resolves a decision in the decision log of a work item.

Input type: WorkItemDecisionResolveInput

Arguments#

Name Type Description
id WorkItemsDecisionID! Global ID of the decision.
resolutionRationale String Reasoning for the resolution.
resolvingNoteId NoteID Global ID of the comment that resolved the decision.
selectedOptionContent String Content of a custom option, added as the only selected option of the decision while every existing option is deselected. Incompatible with selectedOptionIds.
selectedOptionIds [WorkItemsDecisionOptionID!] Global IDs of the selected options. Maximum of 5 options.

Fields#

Name Type Description
decision WorkItemDecision Decision after mutation.
errors [String!]! Errors encountered during the mutation.

workItemDecisionUpdate#

히스토리

Updates a decision in the decision log of a work item.

Input type: WorkItemDecisionUpdateInput

Arguments#

Name Type Description
description String Context of the decision.
discussionId DiscussionID Global ID of the originating discussion thread.
id WorkItemsDecisionID! Global ID of the decision.
options [WorkItemDecisionOptionUpdateInput!] Existing options of the decision to update. Maximum of 6 options.
resolutionRationale String Reasoning for the resolution. Can only be updated on resolved decisions.
resolvedById UserID Global ID of the user who resolved the decision. Can only be updated on resolved decisions.
resolvingNoteId NoteID Global ID of the comment that resolved the decision. Can only be updated on resolved decisions.
selectedOptionContent String Content of the selected option. Unless exactly one option is selected, a new selected option with this content is added and any selected options are deselected. Can only be updated on resolved decisions.
sourceLink String URL of the comment, discussion, or external resource that prompted the decision.
title String Question being decided.

Fields#

Name Type Description
decision WorkItemDecision Decision after mutation.
errors [String!]! Errors encountered during the mutation.

workItemDelete#

히스토리

Deletes a work item.

Input type: WorkItemDeleteInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
namespace Namespace Namespace the deleted work item belonged to.
project Project Deprecated in GitLab 16.9. Use namespace.

workItemEnableAiPlanning#

히스토리

Enables AI planning for a work item. Once enabled, AI planning cannot be disabled.

Input type: WorkItemEnableAiPlanningInput

Arguments#

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

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Work item after mutation.

workItemExport#

Deprecated in GitLab 18.0. Use WorkItemsCsvExport.

Input type: WorkItemExportInput

Arguments#

Name Type Description
assigneeUsernames [String!] Usernames of users assigned to the work item (maximum is 100 usernames).
assigneeWildcardId AssigneeWildcardId Filter by assignee wildcard. Incompatible with assigneeUsernames.
authorUsername String Filter work items by author username.
closedAfter Time Work items closed after the date.
closedBefore Time Work items closed before the date.
confidential Boolean Filter for confidential work items. If false, excludes confidential work items. If true, returns only confidential work items.
createdAfter Time Work items created after the timestamp.
createdBefore Time Work items created before the timestamp.
crmContactId String Filter by ID of CRM contact.
crmOrganizationId String Filter by ID of CRM contact organization.
dueAfter Time Work items due after the timestamp.
dueBefore Time Work items due before the timestamp.
healthStatusFilter HealthStatusFilter Introduced as an experiment in GitLab 18.2.

Health status of the work items, "none" and "any" values are supported.
hierarchyFilters HierarchyFilterInput Introduced as an experiment 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.'.
includeDescendantWorkItems Boolean Introduced as an experiment in GitLab 18.3.

Whether to include work items of descendant parents when filtering by parent_ids.
iterationCadenceId [IterationsCadenceID!] Introduced as an experiment in GitLab 18.2.

Filter by a list of iteration cadence IDs.
iterationId [ID] Introduced as an experiment in GitLab 18.2.

List of iteration Global IDs applied to the work items.
iterationWildcardId IterationWildcardId Introduced as an experiment 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).
milestoneWildcardId MilestoneWildcardId Filter by milestone ID wildcard. Incompatible with milestoneTitle.
myReactionEmoji String Filter by reaction emoji applied by the current user. Wildcard values NONE and ANY are supported.
not NegatedWorkItemFilterInput Negated work item arguments.
or UnionedWorkItemFilterInput List of arguments with inclusive OR.
parentIds [WorkItemID!] Filter work items by global IDs of their parent items (maximum is 100 IDs).
parentWildcardId WorkItemParentWildcardId Introduced as an experiment in GitLab 18.5.

Filter by parent ID wildcard. Incompatible with parentIds.
projectPath ID! Full project path.
releaseTag [String!] Release tag associated with the work item's milestone (maximum is 100 tags). Ignored when parent is a group.
releaseTagWildcardId ReleaseTagWildcardId Filter by release tag wildcard.
search String Search query for title or description.
selectedFields [AvailableExportFields!] List of selected fields to be exported. Omit to export all available fields.
state IssuableState Current state of the work item.
status WorkItemWidgetStatusFilterInput Introduced as an experiment in GitLab 18.7.

Filter by status.
subscribed SubscriptionStatus Work items the current user is subscribed to.
types [IssueType!] Filter work items by the given work item types.
updatedAfter Time Work items updated after the timestamp.
updatedBefore Time Work items updated before the timestamp.
weight String Introduced as an experiment in GitLab 18.2.

Weight applied to the work item, "none" and "any" values are supported.
weightWildcardId WeightWildcardId Introduced as an experiment in GitLab 18.2.

Filter by weight ID wildcard. Incompatible with weight.
workItemTypeIds [WorkItemsTypeID!] Filter work items by work item type global IDs.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Export request result message.

workItemGenerateReadinessScore#

히스토리

Scores the readiness of a work item asynchronously through a Duo Agent Platform flow, instead of Duo Chat. Available only when the workplan_score feature flag is enabled; returns an error otherwise.

Input type: WorkItemGenerateReadinessScoreInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item to score readiness for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workflow DuoWorkflow Duo Agent Platform workflow started to score the readiness.

workItemGenerateWorkplan#

히스토리

Generates a workplan for a work item asynchronously through a Duo Agent Platform flow, instead of Duo Chat. Available only when the duo_workplan_async_flow feature flag is enabled; returns an error otherwise.

Input type: WorkItemGenerateWorkplanInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item to generate a workplan for.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workflow DuoWorkflow Duo Agent Platform workflow started to generate the workplan.

workItemHierarchyAddChildrenItems#

히스토리

Adds children to a given work item's hierarchy by Global ID.

Input type: WorkItemHierarchyAddChildrenItemsInput

Arguments#

Name Type Description
childrenIds [WorkItemID!]! Global IDs of children work items.
id WorkItemID! Global ID of the work item.

Fields#

Name Type Description
addedChildren [WorkItem!]! Work items that were added as children.
errors [String!]! Errors encountered during the mutation.

workItemRemoveLinkedItems#

히스토리

Remove items linked to the work item.

Input type: WorkItemRemoveLinkedItemsInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
workItemsIds [WorkItemID!]! Global IDs of the items to unlink. Maximum number of IDs you can provide: 10.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Linked items update result message.
workItem WorkItem Updated work item.

workItemResumeWorkplan#

히스토리

Resumes a paused workplan generation flow that is awaiting input, sending the replies left on the questions the flow asked. Available only when the duo_workplan_async_flow feature flag is enabled; returns an error otherwise.

Input type: WorkItemResumeWorkplanInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item whose workplan generation to resume.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workflow DuoWorkflow Duo Agent Platform workflow that was resumed.

workItemSavedViewCreate#

히스토리

Creates a saved view.

Input type: WorkItemSavedViewCreateInput

Arguments#

Name Type Description
description String Description of the saved view.
displaySettings JSON! Display settings associated with the saved view.
filters WorkItemSavedViewFilterInput! Filters associated with the saved view.
isPrivate Boolean Whether the saved view is private. Default is true.
name String! Name of the saved view.
namespacePath ID! Full path of the namespace to create the saved view in.
private Boolean Deprecated in GitLab 18.10. Replaced by isPrivate argument.
sort WorkItemSort! Sort option associated with the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Created saved view.

workItemSavedViewDelete#

히스토리

Deletes a saved view.

Input type: WorkItemSavedViewDeleteInput

Arguments#

Name Type Description
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Deleted saved view.

workItemSavedViewReorder#

히스토리

Reorders a saved view for the current user.

Input type: WorkItemSavedViewReorderInput

Arguments#

Name Type Description
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view to be reordered.
moveAfterId WorkItemsSavedViewsSavedViewID Global ID of a saved view that the reordered view should be placed after.
moveBeforeId WorkItemsSavedViewsSavedViewID Global ID of a saved view that the reordered view should be placed before.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Reordered saved view.

workItemSavedViewSubscribe#

히스토리

Subscribes the current user to a saved view.

Input type: WorkItemSavedViewSubscribeInput

Arguments#

Name Type Description
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view to subscribe to.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Subscribed saved view.

workItemSavedViewUnsubscribe#

히스토리

Unsubscribes the current user from a saved view.

Input type: WorkItemSavedViewUnsubscribeInput

Arguments#

Name Type Description
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view to unsubscribe from.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Unsubscribed saved view.

workItemSavedViewUpdate#

히스토리

Updates a saved view.

Input type: WorkItemSavedViewUpdateInput

Arguments#

Name Type Description
description String Description of the saved view.
displaySettings JSON Display settings associated with the saved view.
filters WorkItemSavedViewFilterInput Filters associated with the saved view.
id WorkItemsSavedViewsSavedViewID! Global ID of the saved view.
isPrivate Boolean Whether the saved view is private.
name String Name of the saved view.
private Boolean Deprecated in GitLab 18.10. Replaced by isPrivate argument.
sort WorkItemSort Sorting option associated with the saved view.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
savedView WorkItemSavedViewType Updated saved view.

workItemSettingsUpdate#

히스토리

Updates work item settings for a root group or organization. Omit fullPath to update settings for the current organization.

Input type: WorkItemSettingsUpdateInput

Arguments#

Name Type Description
customizableTypeVisibility Boolean Whether namespace admins can configure per-type work item visibility.
fullPath ID Full path of the root group. Omit to use the current organization.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItemSettings WorkItemSettings Work item settings after mutation.

workItemSubscribe#

히스토리

Input type: WorkItemSubscribeInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item.
subscribed Boolean! Desired state of the subscription.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Work item after mutation.

workItemTypeCreate#

히스토리

Input type: WorkItemTypeCreateInput

Arguments#

Name Type Description
enabledByDefaultForNewNamespaces Boolean Indicates the type is enabled by default for new child namespaces.
fullPath String Full path of the root group.
iconName String! Icon name for the work item type. Use the workItemTypeIconDefinitions query to retrieve the list of available icon names.
name String! Name for the work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItemType WorkItemType Work item type that was created.

workItemTypeUpdate#

히스토리

Input type: WorkItemTypeUpdateInput

Arguments#

Name Type Description
archive Boolean Whether to archive the work item type.
enabledByDefaultForNewNamespaces Boolean Indicates the type is enabled by default for new child namespaces.
fullPath String Full path of the root group.
iconName String Icon name for the work item type. Use the workItemTypeIconDefinitions query to retrieve the list of available icon names.
id WorkItemsTypeID! Global ID of the work item type to update.
name String New name for the work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItemType WorkItemType Work item type that was updated.

workItemUpdate#

히스토리

Updates a work item by Global ID.

Input type: WorkItemUpdateInput

Arguments#

Name Type Description
agentPlanWidget WorkItemWidgetAgentPlanInput Introduced as an experiment in GitLab 19.0.

Input for agent plan widget.
assigneesWidget WorkItemWidgetAssigneesInput Input for assignees widget.
awardEmojiWidget WorkItemWidgetAwardEmojiUpdateInput Input for emoji reactions widget.
colorWidget WorkItemWidgetColorInput Input for color widget.
confidential Boolean Sets the work item confidentiality.
crmContactsWidget WorkItemWidgetCrmContactsUpdateInput Input for CRM contacts widget.
currentUserTodosWidget WorkItemWidgetCurrentUserTodosInput Input for to-dos widget.
customFieldsWidget [WorkItemWidgetCustomFieldValueInputType!] Introduced as an experiment in GitLab 17.10.

Input for custom fields widget.
descriptionWidget WorkItemWidgetDescriptionInput Input for description widget.
healthStatusWidget WorkItemWidgetHealthStatusInput Input for health status widget.
hierarchyWidget WorkItemWidgetHierarchyUpdateInput Input for hierarchy widget.
id WorkItemID! Global ID of the work item.
iterationWidget WorkItemWidgetIterationInput Input for iteration widget.
labelsWidget WorkItemWidgetLabelsUpdateInput Input for labels widget.
milestoneWidget WorkItemWidgetMilestoneInput Input for milestone widget.
moveAfterId WorkItemID Introduced as an experiment in GitLab 19.2.

Global ID of a work item that should be placed after the work item.
moveBeforeId WorkItemID Introduced as an experiment in GitLab 19.2.

Global ID of a work item that should be placed before the work item.
notesWidget WorkItemWidgetNotesInput Input for notes widget.
notificationsWidget WorkItemWidgetNotificationsUpdateInput Input for notifications widget.
progressWidget WorkItemWidgetProgressInput Input for progress widget.
startAndDueDateWidget WorkItemWidgetStartAndDueDateUpdateInput Input for start and due date widget.
stateEvent WorkItemStateEvent Close or reopen a work item.
statusWidget WorkItemWidgetStatusInput Introduced as an experiment in GitLab 17.11.

Input for status widget.
timeTrackingWidget WorkItemWidgetTimeTrackingInput Input for time tracking widget.
title String Title of the work item.
verificationStatusWidget VerificationStatusInput Input for verification status widget.
weightWidget WorkItemWidgetWeightInput Input for weight widget.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Updated work item.

workItemUserPreferenceUpdate#

히스토리

Create or Update user preferences for a work item type and namespace.

Input type: WorkItemUserPreferenceUpdateInput

Arguments#

Name Type Description Default
displaySettings JSON Display settings for the work item lists.
namespacePath ID! Full path of the namespace on which the preference is set.
sort WorkItemSort Sort order for work item lists. CREATED_ASC
workItemTypeId WorkItemsTypeID Global ID of a work item type.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
userPreferences WorkItemTypesUserPreference User preferences.

workItemsCsvExport#

히스토리

Input type: WorkItemsCsvExportInput

Arguments#

Name Type Description
assigneeUsernames [String!] Usernames of users assigned to the work item (maximum is 100 usernames).
assigneeWildcardId AssigneeWildcardId Filter by assignee wildcard. Incompatible with assigneeUsernames.
authorUsername String Filter work items by author username.
closedAfter Time Work items closed after the date.
closedBefore Time Work items closed before the date.
confidential Boolean Filter for confidential work items. If false, excludes confidential work items. If true, returns only confidential work items.
createdAfter Time Work items created after the timestamp.
createdBefore Time Work items created before the timestamp.
crmContactId String Filter by ID of CRM contact.
crmOrganizationId String Filter by ID of CRM contact organization.
dueAfter Time Work items due after the timestamp.
dueBefore Time Work items due before the timestamp.
healthStatusFilter HealthStatusFilter Introduced as an experiment in GitLab 18.2.

Health status of the work items, "none" and "any" values are supported.
hierarchyFilters HierarchyFilterInput Introduced as an experiment 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.'.
includeDescendantWorkItems Boolean Introduced as an experiment in GitLab 18.3.

Whether to include work items of descendant parents when filtering by parent_ids.
iterationCadenceId [IterationsCadenceID!] Introduced as an experiment in GitLab 18.2.

Filter by a list of iteration cadence IDs.
iterationId [ID] Introduced as an experiment in GitLab 18.2.

List of iteration Global IDs applied to the work items.
iterationWildcardId IterationWildcardId Introduced as an experiment 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).
milestoneWildcardId MilestoneWildcardId Filter by milestone ID wildcard. Incompatible with milestoneTitle.
myReactionEmoji String Filter by reaction emoji applied by the current user. Wildcard values NONE and ANY are supported.
not NegatedWorkItemFilterInput Negated work item arguments.
or UnionedWorkItemFilterInput List of arguments with inclusive OR.
parentIds [WorkItemID!] Filter work items by global IDs of their parent items (maximum is 100 IDs).
parentWildcardId WorkItemParentWildcardId Introduced as an experiment in GitLab 18.5.

Filter by parent ID wildcard. Incompatible with parentIds.
projectPath ID! Full project path.
releaseTag [String!] Release tag associated with the work item's milestone (maximum is 100 tags). Ignored when parent is a group.
releaseTagWildcardId ReleaseTagWildcardId Filter by release tag wildcard.
search String Search query for title or description.
selectedFields [AvailableExportFields!] List of selected fields to be exported. Omit to export all available fields.
state IssuableState Current state of the work item.
status WorkItemWidgetStatusFilterInput Introduced as an experiment in GitLab 18.7.

Filter by status.
subscribed SubscriptionStatus Work items the current user is subscribed to.
types [IssueType!] Filter work items by the given work item types.
updatedAfter Time Work items updated after the timestamp.
updatedBefore Time Work items updated before the timestamp.
weight String Introduced as an experiment in GitLab 18.2.

Weight applied to the work item, "none" and "any" values are supported.
weightWildcardId WeightWildcardId Introduced as an experiment in GitLab 18.2.

Filter by weight ID wildcard. Incompatible with weight.
workItemTypeIds [WorkItemsTypeID!] Filter work items by work item type global IDs.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Export request result message.

workItemsCsvImport#

히스토리

Input type: WorkItemsCsvImportInput

Arguments#

Name Type Description
file Upload! CSV file to import work items from.
projectPath ID! Full project path.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
message String Import request result message.

workItemsHierarchyReorder#

히스토리

Reorder a work item in the hierarchy tree.

Input type: workItemsHierarchyReorderInput

Arguments#

Name Type Description
adjacentWorkItemId WorkItemID ID of the work item to move next to. For example, the item above or below.
id WorkItemID! Global ID of the work item to be reordered.
parentId WorkItemID Global ID of the new parent work item.
relativePosition RelativePositionType Position relative to the adjacent work item. Valid values are BEFORE or AFTER.

Fields#

Name Type Description
adjacentWorkItem WorkItem Adjacent work item after mutation.
errors [String!]! Errors encountered during the mutation.
parentWorkItem WorkItem Work item's parent after mutation.
workItem WorkItem Work item after mutation.

workItemsReorder#

히스토리

Reorders a work item.

Input type: workItemsReorderInput

Arguments#

Name Type Description
id WorkItemID! Global ID of the work item to be reordered.
moveAfterId WorkItemID Global ID of a work item that should be placed after the work item.
moveBeforeId WorkItemID Global ID of a work item that should be placed before the work item.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workItem WorkItem Work item after mutation.

workspaceCreate#

Input type: WorkspaceCreateInput

Arguments#

Name Type Description Default
clusterAgentId ClustersAgentID! GlobalID of the cluster agent the created workspace will be associated with.
desiredState String! Desired state of the created workspace.
devfilePath String Project path containing the devfile used to configure the workspace. If not provided, the GitLab default devfile is used. null
devfileRef String Deprecated in GitLab 17.8. Argument is renamed to project_ref.
editor String Deprecated in GitLab 17.5. Argument is not used.
maxHoursBeforeTermination Int Deprecated in GitLab 17.9. Field is not used.
projectId ProjectID! ID of the project that will provide the Devfile for the created workspace.
projectRef String Project repo git ref.
variables [WorkspaceVariableInput!] Deprecated in GitLab 18.0. Argument is renamed to workspace_variables. []
workspaceVariables [WorkspaceVariableInput!] Introduced as an experiment in GitLab 18.0.

Variables to inject into the workspace.		 []

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workspace Workspace Created workspace.

workspaceUpdate#

Input type: WorkspaceUpdateInput

Arguments#

Name Type Description
desiredState String! Desired state of the created workspace.
id RemoteDevelopmentWorkspaceID! Global ID of the workspace.

Fields#

Name Type Description
errors [String!]! Errors encountered during the mutation.
workspace Workspace Created workspace.