Fine-grained permissions for GraphQL API

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

A fine-grained personal access token can access only the resources and permissions you grant it. To use one with the GraphQL API, create a token and define its scope. For more information, see fine-grained personal access tokens.

Available fine-grained permissions

Fine-grained personal access tokens can access the following GraphQL types, mutations, and fields:

Application Security resources

Ascp

Grants the ability to create ascps.

ActionAccessKindName
CreateProjectMutationAscpComponentCreate
CreateProjectMutationAscpScanCreate
CreateProjectMutationAscpSecurityContextCreate

Coverage Fuzzing Corpus

Grants the ability to create coverage fuzzing corpus.

ActionAccessKindName
CreateProjectMutationCorpusCreate

Dependency

Grants the ability to read dependencies.

ActionAccessKindName
ReadProjectTypeDependencyLocation
ReadProjectTypeDependencyTrackedRef

Finding Token Status

Grants the ability to update finding token statuses.

ActionAccessKindName
UpdateProjectMutationRefreshFindingTokenStatus
UpdateProjectMutationRefreshVulnerabilityFindingTokenStatus

On-Demand DAST Scan

Grants the ability to create, delete, and update on-demand DAST scans, including their site profiles, scanner profiles, site tokens, and site validations.

ActionAccessKindName
CreateProjectMutationDastOnDemandScanCreate
CreateProjectMutationDastProfileCreate
CreateProjectMutationDastProfileRun
CreateProjectMutationDastScannerProfileCreate
CreateProjectMutationDastSiteProfileCreate
CreateProjectMutationDastSiteTokenCreate
CreateProjectMutationDastSiteValidationCreate
DeleteProjectMutationDastProfileDelete
DeleteProjectMutationDastScannerProfileDelete
DeleteProjectMutationDastSiteProfileDelete
DeleteProjectMutationDastSiteValidationRevoke
UpdateProjectMutationDastProfileUpdate
UpdateProjectMutationDastScannerProfileUpdate
UpdateProjectMutationDastSiteProfileUpdate

Pipeline Execution Project Schedule

Grants the ability to read pipeline execution project schedules.

ActionAccessKindName
ReadProjectTypePipelineExecutionProjectSchedule

Policy Store Policy

Grants the ability to create, delete, read, and update policies in the policy store.

ActionAccessKindName
Create 1GroupMutationGovernPolicyCreate
Create 1InstanceMutationGovernPolicyCreate
DeleteGroupMutationGovernPolicyDelete
DeleteInstanceMutationGovernPolicyDelete
ReadGroupFieldPolicyStore.policies
ReadGroupFieldPolicyStore.policyEvaluations
ReadInstanceFieldPolicyStore.policies
ReadInstanceFieldPolicyStore.policyEvaluations
Update 1GroupMutationGovernPolicyUpdate
Update 1InstanceMutationGovernPolicyUpdate

1 Also requires the Read Policy Store Policy permission.

Secret

Grants the ability to create, delete, and update secrets.

ActionAccessKindName
CreateProjectMutationProjectSecretCreate
CreateGroupMutationGroupSecretCreate
DeleteProjectMutationProjectSecretDelete
DeleteGroupMutationGroupSecretDelete
UpdateProjectMutationProjectSecretUpdate
UpdateGroupMutationGroupSecretUpdate

Secrets Manager

Grants the ability to deprovision, provision, and read secrets managers.

ActionAccessKindName
DeprovisionProjectMutationProjectSecretsManagerDeprovision
DeprovisionGroupMutationGroupSecretsManagerDeprovision
DeprovisionGroupMutationNamespaceSecretsManagerUnenroll
DeprovisionInstanceMutationInstanceSecretsManagerUnenroll
ProvisionProjectMutationProjectSecretsManagerInitialize
ProvisionGroupMutationGroupSecretsManagerInitialize
ProvisionGroupMutationNamespaceSecretsManagerEnroll
ProvisionInstanceMutationInstanceSecretsManagerEnroll
ReadProjectTypeProjectSecretsManager
ReadGroupTypeGroupSecretsManager
ReadGroupTypeSecretsManagerEntitlement
ReadInstanceTypeSecretsManagerEntitlement

Secrets Permission

Grants the ability to delete and update secrets permissions.

ActionAccessKindName
DeleteProjectMutationProjectSecretsPermissionDelete
DeleteGroupMutationGroupSecretsPermissionDelete
UpdateProjectMutationProjectSecretsPermissionUpdate
UpdateGroupMutationGroupSecretsPermissionUpdate

Security Attribute

Grants the ability to create, delete, and update security attributes.

ActionAccessKindName
CreateGroupMutationSecurityAttributeCreate
CreateGroupMutationSecurityCategoryCreate
DeleteGroupMutationSecurityAttributeDestroy
DeleteGroupMutationSecurityCategoryDestroy
UpdateProjectMutationSecurityAttributeProjectUpdate
UpdateGroupMutationSecurityAttributeUpdate
UpdateGroupMutationSecurityCategoryUpdate

Security Dashboard

Grants the ability to update security dashboards.

ActionAccessKindName
UpdateProjectMutationAddProjectToSecurityDashboard
UpdateProjectMutationRemoveProjectFromSecurityDashboard

Security Policy

Grants the ability to update security policies.

ActionAccessKindName
UpdateProjectMutationPipelineExecutionSchedulePolicyTestRun
UpdateProjectMutationResyncSecurityPolicies
UpdateProjectMutationScanExecutionPolicyCommit
UpdateProjectMutationSecurityPolicyProjectAssign
UpdateProjectMutationSecurityPolicyProjectCreate
UpdateProjectMutationSecurityPolicyProjectCreateAsync
UpdateProjectMutationSecurityPolicyProjectUnassign
UpdateGroupMutationResyncSecurityPolicies
UpdateGroupMutationScanExecutionPolicyCommit
UpdateGroupMutationSecurityPolicyProjectAssign
UpdateGroupMutationSecurityPolicyProjectCreate
UpdateGroupMutationSecurityPolicyProjectCreateAsync
UpdateGroupMutationSecurityPolicyProjectUnassign

Security Project Tracked Ref

Grants the ability to create security project tracked refs.

ActionAccessKindName
CreateProjectMutationSecurityRefsTrack

Security Scan Profiles

Grants the ability to create, delete, read, and update security scan profiles.

ActionAccessKindName
CreateGroupMutationSecurityScanProfileCreate
DeleteGroupMutationSecurityScanProfileDelete
ReadProjectTypeTriageAndRemediationCoverage
ReadGroupTypeTriageAndRemediationCoverageCounters
UpdateGroupMutationSecurityScanProfileUpdate

Security Setting

Grants the ability to read and update security settings.

ActionAccessKindName
UpdateProjectMutationProjectSecurityExclusionCreate
UpdateProjectMutationProjectSecurityExclusionDelete
UpdateProjectMutationProjectSecurityExclusionUpdate
UpdateProjectMutationProjectSetContinuousVulnerabilityScanning
UpdateProjectMutationSecurityTrainingUpdate
UpdateProjectMutationSetContainerScanningForRegistry
UpdateProjectMutationSetCvsForContainerScanning
UpdateProjectMutationSetCvsForDependencyScanning
UpdateProjectMutationSetLicenseConfigurationSource
UpdateProjectMutationSetLicenseScanningForCyclonedx
UpdateProjectMutationSetPreReceiveSecretDetection
UpdateProjectMutationSetSecretPushProtection
UpdateProjectMutationSetValidityChecks
UpdateGroupMutationSetGroupSecretPushProtection
UpdateGroupMutationSetGroupValidityChecks

Vulnerability

Grants the ability to archive, create, read, and update vulnerabilities.

ActionAccessKindName
ArchiveProjectMutationVulnerabilitiesArchive
CreateProjectMutationVulnerabilityCreate
ReadProjectTypeCountableVulnerability
ReadProjectTypeVulnerability
ReadProjectTypeVulnerabilityScanner
ReadProjectFieldMergeRequest.findingReportsComparer
ReadProjectFieldProject.vulnerabilityWorkflowExecution
UpdateProjectMutationBulkSetVulnerabilityFindingsDueDates
UpdateProjectMutationVulnerabilityAutoRemediation
UpdateProjectMutationVulnerabilityConfirm
UpdateProjectMutationVulnerabilityDismiss
UpdateProjectMutationVulnerabilityResolve
UpdateProjectMutationVulnerabilityRevertToDetected

Vulnerability Duo Workflow

Grants the ability to execute vulnerability duo workflows.

ActionAccessKindName
ExecuteProjectMutationCancelVulnerabilityWorkflow
ExecuteProjectMutationStartVulnerabilityWorkflow

Vulnerability Flag

Grants the ability to update vulnerability flags.

ActionAccessKindName
UpdateProjectMutationVulnerabilityDismissFalsePositiveFlag

Grants the ability to create, delete, and read vulnerability issue links.

ActionAccessKindName
CreateProjectMutationSecurityFindingCreateIssue
CreateProjectMutationSecurityFindingExternalIssueLinkCreate
CreateProjectMutationSecurityFindingJiraIssueFormUrlCreate
CreateProjectMutationVulnerabilitiesCreateIssue
CreateProjectMutationVulnerabilityExternalIssueLinkCreate
CreateProjectMutationVulnerabilityIssueLinkCreate
DeleteProjectMutationVulnerabilityExternalIssueLinkDestroy

Grants the ability to create and delete vulnerability merge request links.

ActionAccessKindName
CreateProjectMutationVulnerabilityLinkMergeRequest
DeleteProjectMutationVulnerabilityUnlinkMergeRequest

CI/CD resources

Catalog Bundled Resource

Grants the ability to read bundled CI catalog resources.

ActionAccessKindName
ReadInstanceTypeCiCatalogBundledResource

Catalog Resource

Grants the ability to create and delete CI catalog resources.

ActionAccessKindName
CreateProjectMutationCatalogResourcesCreate
DeleteProjectMutationCatalogResourcesDestroy

CD Application

Grants the ability to create, read, and update continuous deployment applications.

ActionAccessKindName
CreateInstanceMutationCdApplicationCreate
ReadInstanceTypeCdApplication
UpdateInstanceMutationCdApplicationUpdate

CD Application Flow Definition

Grants the ability to create and read continuous deployment application flow definitions.

ActionAccessKindName
CreateInstanceMutationCdApplicationFlowDefinitionCreate
ReadInstanceTypeCdApplicationFlowDefinition
ReadInstanceTypeCdDefinitionStep

Grants the ability to create, delete, read, and update continuous deployment application links.

ActionAccessKindName
CreateInstanceMutationCdApplicationLinkCreate
DeleteInstanceMutationCdApplicationLinkDelete
ReadInstanceTypeCdApplicationLink
UpdateInstanceMutationCdApplicationLinkUpdate

CD Artifact Source

Grants the ability to create and read continuous deployment artifact sources.

ActionAccessKindName
CreateInstanceMutationCdArtifactSourceCreate
CreateInstanceMutationCdVersionCreate
ReadInstanceTypeCdArtifactSource
ReadInstanceTypeCdVersion

CD Environment

Grants the ability to create, read, and update continuous deployment environments.

ActionAccessKindName
CreateInstanceMutationCdEnvironmentCreate
ReadInstanceTypeCdEnvironment
ReadInstanceTypeCdEnvironmentApplication
ReadInstanceTypeCdEnvironmentDriverBinding
UpdateInstanceMutationCdEnvironmentDriverBindingCreate
UpdateInstanceMutationCdEnvironmentUpdate

CD Rollout

Grants the ability to create and read CD rollouts.

ActionAccessKindName
CreateInstanceMutationCdRolloutCreate
ReadInstanceTypeCdDeployment
ReadInstanceTypeCdDeploymentTransition
ReadInstanceTypeCdRollout
ReadInstanceTypeCdRolloutEnvironment
ReadInstanceTypeCdRolloutGate
ReadInstanceTypeCdRolloutStep
ReadInstanceTypeCdRolloutTransition

CD Rollout Gate

Grants the ability to resolve CD rollout gates.

ActionAccessKindName
ResolveInstanceMutationCdRolloutGateResolve

CD Service

Grants the ability to create, read, and update continuous deployment services.

ActionAccessKindName
CreateInstanceMutationCdServiceCreate
ReadInstanceTypeCdService
ReadInstanceTypeCdServiceEnvironmentHealth
UpdateInstanceMutationCdServiceUpdate

CD Version Set

Grants the ability to create and read continuous deployment version sets.

ActionAccessKindName
CreateInstanceMutationCdVersionSetCreate
ReadInstanceTypeCdVersionSet
ReadInstanceTypeCdVersionSetEntry

CI Config

Grants the ability to read and validate CI/CD configuration.

ActionAccessKindName
ValidateProjectMutationCiLint

CI Namespace Settings

Grants the ability to update CI namespace settings.

ActionAccessKindName
UpdateGroupMutationNamespaceCiCdSettingsUpdate
UpdateGroupMutationNamespaceSettingsUpdate

CI/CD Setting

Grants the ability to update CI/CD settings.

ActionAccessKindName
UpdateProjectMutationProjectCiCdSettingsUpdate
UpdateGroupMutationSafeDisablePipelineVariables

Cluster Agent

Grants the ability to create, delete, and read cluster agents.

ActionAccessKindName
CreateProjectMutationCreateClusterAgent
DeleteProjectMutationClusterAgentDelete
ReadProjectTypeClusterAgent

Cluster Agent Token

Grants the ability to create, read, and revoke cluster agent tokens.

ActionAccessKindName
CreateProjectMutationClusterAgentTokenCreate

Cluster Agent URL Configuration

Grants the ability to create, delete, and read cluster agent URL configurations.

ActionAccessKindName
CreateProjectMutationClusterAgentUrlConfigurationCreate
DeleteProjectMutationClusterAgentUrlConfigurationDelete

Deployment

Grants the ability to approve, create, delete, read, and update deployments.

ActionAccessKindName
ApproveProjectMutationApproveDeployment

Environment

Grants the ability to create, delete, read, stop, and update environments.

ActionAccessKindName
CreateProjectMutationEnvironmentCreate
DeleteProjectMutationEnvironmentDelete
ReadProjectTypeEnvironment
StopProjectMutationEnvironmentStop
UpdateProjectMutationEnvironmentUpdate
UpdateProjectMutationEnvironmentsCanaryIngressUpdate

Freeze Period

Grants the ability to create, delete, read, and update freeze periods.

ActionAccessKindName
ReadProjectTypeCiFreezePeriod

Job

Grants the ability to delete, read, run, and update jobs.

ActionAccessKindName
ReadProjectTypeCiJob
RunProjectMutationJobPlay
RunProjectMutationJobRetry
UpdateProjectMutationJobCancel
UpdateProjectMutationJobUnschedule

Job Artifact

Grants the ability to delete, read, and update job artifacts.

ActionAccessKindName
DeleteProjectMutationArtifactDestroy
DeleteProjectMutationBulkDestroyJobArtifacts
DeleteProjectMutationJobArtifactsDestroy
ReadProjectTypeCiJobArtifact

Merge Train Car

Grants the ability to delete merge train cars.

ActionAccessKindName
DeleteProjectMutationMergeTrainsDeleteCar

Pipeline

Grants the ability to create, delete, read, and update pipelines.

ActionAccessKindName
CreateProjectMutationPipelineCreate
DeleteProjectMutationPipelineDestroy
ReadProjectTypeCiStage
ReadProjectTypePipeline
UpdateProjectMutationPipelineCancel
UpdateProjectMutationPipelineRetry

Pipeline Schedule

Grants the ability to create, delete, read, and update pipeline schedules.

ActionAccessKindName
CreateProjectMutationPipelineScheduleCreate
DeleteProjectMutationPipelineScheduleDelete
ReadProjectTypePipelineSchedule
UpdateProjectMutationPipelineSchedulePlay
UpdateProjectMutationPipelineScheduleTakeOwnership
UpdateProjectMutationPipelineScheduleUpdate

Pipeline Subscription

Grants the ability to create and delete pipeline subscriptions.

ActionAccessKindName
CreateProjectMutationProjectSubscriptionCreate
DeleteProjectMutationProjectSubscriptionDelete

Runner

Grants the ability to assign, create, delete, read, and update runners.

ActionAccessKindName
AssignProjectMutationRunnerAssignToProject
AssignProjectMutationRunnerUnassignFromProject
CreateProjectMutationRunnerCreate
CreateGroupMutationRunnerCreate
CreateInstanceMutationRunnerCreate
DeleteProjectMutationRunnerDelete
DeleteGroupMutationRunnerDelete
DeleteInstanceMutationRunnerDelete
ReadProjectTypeCiRunner
ReadGroupTypeCiRunner
ReadInstanceTypeCiRunner
UpdateProjectMutationRunnerCacheClear
UpdateProjectMutationRunnerUpdate
UpdateGroupMutationRunnerUpdate
UpdateInstanceMutationRunnerUpdate

Runner Usage

Grants the ability to read runner usage data.

ActionAccessKindName
ReadProjectMutationRunnersExportUsage
ReadGroupMutationRunnersExportUsage
ReadInstanceMutationRunnersExportUsage

Terraform State

Grants the ability to create, delete, lock, read, and restore Terraform state.

ActionAccessKindName
DeleteProjectMutationTerraformStateDelete
LockProjectMutationTerraformStateLock
LockProjectMutationTerraformStateUnlock
ReadProjectTypeTerraformState
ReadProjectTypeTerraformStateProtectionRule
ReadProjectTypeTerraformStateVersion
RestoreProjectMutationTerraformStateRestore

Terraform State Protection Rule

Grants the ability to create, delete, and update Terraform state protection rules.

ActionAccessKindName
CreateProjectMutationCreateTerraformStateProtectionRule
DeleteProjectMutationDeleteTerraformStateProtectionRule
UpdateProjectMutationUpdateTerraformStateProtectionRule

Trigger

Grants the ability to create, delete, read, and update triggers.

ActionAccessKindName
CreateProjectMutationPipelineTriggerCreate
DeleteProjectMutationPipelineTriggerDelete
ReadProjectTypePipelineTrigger
UpdateProjectMutationPipelineTriggerUpdate

Verified Namespace

Grants the ability to create verified namespaces.

ActionAccessKindName
CreateInstanceMutationVerifiedNamespaceCreate

Compliance resources

Audit Event Streaming Destination

Grants the ability to create, delete, and update audit event streaming destinations.

ActionAccessKindName
CreateGroupMutationAuditEventsAmazonS3ConfigurationCreate
CreateGroupMutationExternalAuditEventDestinationCreate
CreateGroupMutationGoogleCloudLoggingConfigurationCreate
CreateGroupMutationGroupAuditEventStreamingDestinationsCreate
CreateInstanceMutationAuditEventsInstanceAmazonS3ConfigurationCreate
CreateInstanceMutationInstanceAuditEventStreamingDestinationsCreate
CreateInstanceMutationInstanceExternalAuditEventDestinationCreate
CreateInstanceMutationInstanceGoogleCloudLoggingConfigurationCreate
DeleteGroupMutationAuditEventsAmazonS3ConfigurationDelete
DeleteGroupMutationExternalAuditEventDestinationDestroy
DeleteGroupMutationGoogleCloudLoggingConfigurationDestroy
DeleteGroupMutationGroupAuditEventStreamingDestinationsDelete
DeleteInstanceMutationAuditEventsInstanceAmazonS3ConfigurationDelete
DeleteInstanceMutationInstanceAuditEventStreamingDestinationsDelete
DeleteInstanceMutationInstanceExternalAuditEventDestinationDestroy
DeleteInstanceMutationInstanceGoogleCloudLoggingConfigurationDestroy
UpdateGroupMutationAuditEventsAmazonS3ConfigurationUpdate
UpdateGroupMutationAuditEventsGroupDestinationDenylistEventsAdd
UpdateGroupMutationAuditEventsGroupDestinationDenylistEventsDelete
UpdateGroupMutationAuditEventsGroupDestinationEventsAdd
UpdateGroupMutationAuditEventsGroupDestinationEventsDelete
UpdateGroupMutationAuditEventsGroupDestinationNamespaceFilterCreate
UpdateGroupMutationAuditEventsGroupDestinationNamespaceFilterDelete
UpdateGroupMutationAuditEventsStreamingDestinationEventsAdd
UpdateGroupMutationAuditEventsStreamingDestinationEventsRemove
UpdateGroupMutationAuditEventsStreamingHTTPNamespaceFiltersAdd
UpdateGroupMutationAuditEventsStreamingHTTPNamespaceFiltersDelete
UpdateGroupMutationAuditEventsStreamingHeadersCreate
UpdateGroupMutationAuditEventsStreamingHeadersDestroy
UpdateGroupMutationAuditEventsStreamingHeadersUpdate
UpdateGroupMutationExternalAuditEventDestinationUpdate
UpdateGroupMutationGoogleCloudLoggingConfigurationUpdate
UpdateGroupMutationGroupAuditEventStreamingDestinationsUpdate
UpdateInstanceMutationAuditEventsInstanceAmazonS3ConfigurationUpdate
UpdateInstanceMutationAuditEventsInstanceDestinationEventsAdd
UpdateInstanceMutationAuditEventsInstanceDestinationEventsDelete
UpdateInstanceMutationAuditEventsInstanceDestinationNamespaceFilterCreate
UpdateInstanceMutationAuditEventsInstanceDestinationNamespaceFilterDelete
UpdateInstanceMutationAuditEventsStreamingDestinationInstanceEventsAdd
UpdateInstanceMutationAuditEventsStreamingDestinationInstanceEventsRemove
UpdateInstanceMutationAuditEventsStreamingInstanceHeadersCreate
UpdateInstanceMutationAuditEventsStreamingInstanceHeadersDestroy
UpdateInstanceMutationAuditEventsStreamingInstanceHeadersUpdate
UpdateInstanceMutationInstanceAuditEventStreamingDestinationsUpdate
UpdateInstanceMutationInstanceExternalAuditEventDestinationUpdate
UpdateInstanceMutationInstanceGoogleCloudLoggingConfigurationUpdate

Compliance Dashboard

Grants the ability to read compliance dashboards.

ActionAccessKindName
ReadGroupMutationRefreshStandardsAdherenceChecks

Compliance Framework

Grants the ability to create, delete, and update compliance frameworks.

ActionAccessKindName
CreateGroupMutationCreateComplianceFramework
CreateGroupMutationCreateComplianceFrameworkFromTemplate
CreateGroupMutationCreateComplianceRequirement
CreateGroupMutationCreateComplianceRequirementsControl
DeleteGroupMutationDestroyComplianceFramework
DeleteGroupMutationDestroyComplianceRequirement
DeleteGroupMutationDestroyComplianceRequirementsControl
UpdateProjectMutationProjectSetComplianceFramework
UpdateProjectMutationProjectUpdateComplianceFrameworks
UpdateGroupMutationUpdateComplianceFramework
UpdateGroupMutationUpdateComplianceRequirement
UpdateGroupMutationUpdateComplianceRequirementsControl

Compliance Violations Report

Grants the ability to update compliance violations reports.

ActionAccessKindName
UpdateProjectMutationLinkProjectComplianceViolationIssue
UpdateProjectMutationUnlinkProjectComplianceViolationIssue
UpdateProjectMutationUpdateProjectComplianceViolation

External Status Check

Grants the ability to create, delete, read, retry, and update external status checks.

ActionAccessKindName
CreateProjectMutationBranchRuleExternalStatusCheckCreate
DeleteProjectMutationBranchRuleExternalStatusCheckDestroy
UpdateProjectMutationBranchRuleExternalStatusCheckUpdate

Duo resources

AI Catalog External Agent

Grants the ability to create, delete, and update AI catalog external agents.

ActionAccessKindName
CreateProjectMutationAiCatalogThirdPartyFlowCreate
DeleteProjectMutationAiCatalogThirdPartyFlowDelete
UpdateProjectMutationAiCatalogThirdPartyFlowUpdate

AI catalog item

Grants the ability to create, delete, read, report, restore, and update AI catalog items.

ActionAccessKindName
CreateProjectMutationAiCatalogAgentCreate
CreateProjectMutationAiCatalogFlowCreate
DeleteProjectMutationAiCatalogAgentDelete
DeleteProjectMutationAiCatalogFlowDelete
ReadProjectTypeAiCatalogSkill
ReadProjectTypeAiCatalogSkillVersion
ReadProjectMutationAiCatalogItemStar
ReadUserMutationAiCatalogItemStar
ReadUserFieldQuery.aiCatalogBuiltInTools
ReportProjectMutationAiCatalogItemReport
RestoreProjectMutationAiCatalogItemVersionRestore
UpdateProjectMutationAiCatalogAgentUpdate
UpdateProjectMutationAiCatalogFlowUpdate

AI catalog item consumer

Grants the ability to delete and update AI catalog item consumers.

ActionAccessKindName
DeleteProjectMutationAiCatalogItemConsumerDelete
DeleteGroupMutationAiCatalogItemConsumerDelete
UpdateProjectMutationAiCatalogItemConsumerUpdate
UpdateGroupMutationAiCatalogItemConsumerUpdate

AI catalog MCP server

Grants the ability to block, create, and update AI catalog MCP servers.

ActionAccessKindName
BlockProjectMutationAiCatalogMcpServerSetBlock
BlockGroupMutationAiCatalogMcpServerSetBlock
CreateInstanceMutationAiCatalogMcpServerCreate
UpdateInstanceMutationAiCatalogMcpServerUpdate

AI Domain Settings

Grants the ability to update AI domain settings.

ActionAccessKindName
UpdateGroupMutationAiDomainSettingsNamespaceUpdate
UpdateInstanceMutationAiDomainSettingsInstanceUpdate

Ai Flow Schedule

Grants the ability to create, delete, and update ai flow schedules.

ActionAccessKindName
CreateProjectMutationAiFlowScheduleCreate
DeleteProjectMutationAiFlowScheduleDelete
UpdateProjectMutationAiFlowScheduleUpdate

AI Flow Trigger

Grants the ability to create, delete, and update AI flow triggers.

ActionAccessKindName
CreateProjectMutationAiFlowTriggerCreate
DeleteProjectMutationAiFlowTriggerDelete
UpdateProjectMutationAiFlowTriggerUpdate

AI Self-Hosted Model

Grants the ability to create, delete, and update AI self-hosted models.

ActionAccessKindName
CreateInstanceMutationAiSelfHostedModelCreate
DeleteInstanceMutationAiSelfHostedModelDelete
UpdateInstanceMutationAiSelfHostedModelConnectionCheck
UpdateInstanceMutationAiSelfHostedModelUpdate

AI tool rule

Grants the ability to read and update AI tool rules, which control per-tool approval (Allow, Ask, Deny) for the Duo Agent Platform.

ActionAccessKindName
ReadGroupFieldQuery.aiToolRules
UpdateProjectMutationBulkUpdateAiToolRules
UpdateProjectMutationUpdateAiToolRule
UpdateGroupMutationBulkUpdateAiToolRules
UpdateGroupMutationUpdateAiToolRule

AI usage metric

Grants the ability to read per-user GitLab Duo usage metrics.

ActionAccessKindName
ReadProjectFieldProject.aiUserMetrics
ReadGroupFieldGroup.aiUserMetrics

Conversation Thread

Grants the ability to delete conversation threads.

ActionAccessKindName
DeleteUserMutationDeleteConversationThread

Duo Setting

Grants the ability to update duo settings.

ActionAccessKindName
UpdateGroupMutationAiModelSelectionNamespaceUpdate
UpdateInstanceMutationAiFeatureSettingUpdate
UpdateInstanceMutationDuoSettingsUpdate

Duo user feedback

Grants the ability to create user feedback on Duo AI messages.

ActionAccessKindName
CreateUserMutationDuoUserFeedback

Duo Workflow

Grants the ability to create, delete, read, restart, resume, and update duo workflows.

ActionAccessKindName
CreateProjectMutationAiDuoWorkflowCreate
CreateGroupMutationAiDuoWorkflowCreate
CreateUserMutationAiDuoWorkflowCreate
DeleteUserMutationDeleteDuoWorkflowsWorkflow
ReadUserTypeDuoWorkflow
ReadUserTypeDuoWorkflowMergeRequestLink
ReadUserTypeDuoWorkflowNoteLink
ReadUserTypeDuoWorkflowPipelineLink
ReadUserTypeDuoWorkflowWorkItemLink
ReadUserTypeDuoWorkflowWorkflowLink
ReadUserFieldNote.duoCreatedSession
ReadUserFieldNote.duoTriggeredSession
ReadUserFieldQuery.duoWorkflowBranches
UpdateUserMutationUpdateDuoWorkflowAgentPrivileges
UpdateUserMutationUpdateDuoWorkflowToolCallApprovals
UpdateUserMutationUpdateDuoWorkflowWebSearch

Flows Metadata

Grants the ability to read flows metadata.

ActionAccessKindName
ReadProjectTypeAiFlowsMetadata
ReadGroupTypeAiFlowsMetadata
ReadInstanceTypeAiFlowsMetadata

Functional Verification Check

Grants the ability to read functional verification checks.

ActionAccessKindName
ReadInstanceTypeFunctionalVerificationStatus

Functional Verification Workflow

Grants the ability to create functional verification workflows.

ActionAccessKindName
CreateInstanceMutationCreateFunctionalVerificationWorkflow

Model Selection Allowlist

Grants the ability to read and update model selection allowlists.

ActionAccessKindName
ReadGroupTypeAiModelSelectionAllowList
ReadGroupTypeAiModelSelectionAllowListModel
ReadInstanceTypeAiModelSelectionAllowList
ReadInstanceTypeAiModelSelectionAllowListModel
UpdateGroupMutationAiModelSelectionNamespaceModelAllowlistUpdate
UpdateInstanceMutationAiFeatureSettingModelAllowlistUpdate

Namespace Duo Feature

Grants the ability to lock namespace duo features.

ActionAccessKindName
LockGroupMutationAdminClearDuoAvailability
LockGroupMutationAdminSetDuoAvailability

Geo resources

Geo Node

Grants the ability to create, delete, read, repair, and update Geo nodes.

ActionAccessKindName
ReadInstanceTypeGeoNode

Geo Registry

Grants the ability to read and update Geo registries.

ActionAccessKindName
ReadInstanceTypeAbuseReportUploadRegistry
ReadInstanceTypeAchievementUploadRegistry
ReadInstanceTypeAiVectorizableFileUploadRegistry
ReadInstanceTypeAlertManagementMetricImageUploadRegistry
ReadInstanceTypeAppearanceUploadRegistry
ReadInstanceTypeBulkImportExportUploadUploadRegistry
ReadInstanceTypeCiSecureFileRegistry
ReadInstanceTypeContainerRepositoryRegistry
ReadInstanceTypeDependencyListExportPartUploadRegistry
ReadInstanceTypeDependencyListExportUploadRegistry
ReadInstanceTypeDependencyProxyBlobRegistry
ReadInstanceTypeDependencyProxyManifestRegistry
ReadInstanceTypeDesignManagementActionUploadRegistry
ReadInstanceTypeDesignManagementRepositoryRegistry
ReadInstanceTypeGroupUploadRegistry
ReadInstanceTypeGroupWikiRepositoryRegistry
ReadInstanceTypeImportExportUploadUploadRegistry
ReadInstanceTypeIssuableMetricImageUploadRegistry
ReadInstanceTypeJobArtifactRegistry
ReadInstanceTypeLfsObjectRegistry
ReadInstanceTypeMergeRequestDiffRegistry
ReadInstanceTypeOrganizationDetailUploadRegistry
ReadInstanceTypePackageFileRegistry
ReadInstanceTypePackagesDebianProjectComponentFileRegistry
ReadInstanceTypePackagesHelmMetadataCacheRegistry
ReadInstanceTypePackagesNugetSymbolRegistry
ReadInstanceTypePagesDeploymentRegistry
ReadInstanceTypePersonalSnippetUploadRegistry
ReadInstanceTypePipelineArtifactRegistry
ReadInstanceTypeProjectImportExportRelationExportUploadUploadRegistry
ReadInstanceTypeProjectRepositoryRegistry
ReadInstanceTypeProjectTopicUploadRegistry
ReadInstanceTypeProjectUploadRegistry
ReadInstanceTypeProjectWikiRepositoryRegistry
ReadInstanceTypeSnippetRepositoryRegistry
ReadInstanceTypeTerraformStateVersionRegistry
ReadInstanceTypeUploadRegistry
ReadInstanceTypeUserPermissionExportUploadUploadRegistry
ReadInstanceTypeUserUploadRegistry
ReadInstanceTypeVulnerabilityArchiveExportUploadRegistry
ReadInstanceTypeVulnerabilityExportPartUploadRegistry
ReadInstanceTypeVulnerabilityExportUploadRegistry
ReadInstanceTypeVulnerabilityRemediationUploadRegistry
UpdateInstanceMutationGeoRegistriesBulkUpdate
UpdateInstanceMutationGeoRegistriesUpdate

GitLab Orbit resources

Orbit

Grants the ability to read Orbit data the token owner can access in GitLab. Group and project selections do not limit it.

ActionAccessKindName
ReadUserFieldGroup.orbit
ReadUserFieldProject.orbit
ReadUserFieldQuery.orbit

Orbit Setting

Grants the ability to update Orbit settings.

ActionAccessKindName
UpdateGroupMutationOrbitUpdate
UpdateInstanceMutationKnowledgeGraphExcludedNamespaceCreate
UpdateInstanceMutationKnowledgeGraphExcludedNamespaceDestroy
UpdateInstanceMutationOrbitExcludedGroupCreate
UpdateInstanceMutationOrbitExcludedGroupDestroy

Orbit Trial

Grants the ability to start an Orbit trial for a top-level group or the instance.

ActionAccessKindName
StartGroupMutationOrbitStartTrial
StartInstanceMutationOrbitInstanceStartTrial

Groups resources

Achievement

Grants the ability to award, create, delete, revoke, and update achievements.

ActionAccessKindName
AwardGroupMutationAchievementsAward
CreateGroupMutationAchievementsCreate
DeleteGroupMutationAchievementsDelete
DeleteGroupMutationUserAchievementsDelete
RevokeGroupMutationAchievementsRevoke
UpdateGroupMutationAchievementsUpdate
UpdateUserMutationUserAchievementPrioritiesUpdate
UpdateUserMutationUserAchievementsUpdate

Admin Member Role

Grants the ability to create, delete, read, and update admin member roles.

ActionAccessKindName
CreateInstanceMutationMemberRoleAdminCreate
DeleteInstanceMutationMemberRoleAdminDelete
ReadInstanceTypeAdminMemberRole
UpdateInstanceMutationMemberRoleAdminUpdate

Commit Email

Grants the ability to update commit emails.

ActionAccessKindName
UpdateUserMutationUserSetNamespaceCommitEmail

Custom Emoji

Grants the ability to create, delete, and read custom emojis.

ActionAccessKindName
CreateGroupMutationCreateCustomEmoji
DeleteGroupMutationDestroyCustomEmoji
ReadGroupTypeCustomEmoji

Group

Grants the ability to archive, create, delete, read, share, transfer, and update groups.

ActionAccessKindName
ReadGroupTypeGroup
TransferGroupMutationGroupTransfer
UpdateGroupMutationGroupUpdate

Grants the ability to create, delete, and read LDAP admin role links

ActionAccessKindName
CreateInstanceMutationAdminRolesLdapSync
CreateInstanceMutationLdapAdminRoleLinkCreate
DeleteInstanceMutationLdapAdminRoleLinkDestroy
ReadInstanceTypeLdapAdminRoleLink

Member Role

Grants the ability to assign, create, delete, read, and update member roles.

ActionAccessKindName
AssignInstanceMutationMemberRoleToUserAssign
CreateGroupMutationMemberRoleCreate
CreateInstanceMutationMemberRoleCreate
DeleteGroupMutationMemberRoleDelete
DeleteInstanceMutationMemberRoleDelete
UpdateGroupMutationMemberRoleUpdate
UpdateInstanceMutationMemberRoleUpdate

Namespace

Grants the ability to read and update namespaces.

ActionAccessKindName
ReadProjectMutationNamespacesRegenerateNewWorkItemEmailAddress

Namespace Ban

Grants the ability to delete namespace bans.

ActionAccessKindName
DeleteGroupMutationNamespaceBanDestroy

Preference

Grants the ability to read and update preferences.

ActionAccessKindName
ReadUserTypeUserPreferences
UpdateUserMutationUserPreferencesUpdate

Topic

Grants the ability to create, delete, merge, read, and update topics.

ActionAccessKindName
ReadInstanceTypeTopic

UI Notification

Grants the ability to dismiss UI notifications.

ActionAccessKindName
DismissGroupMutationUserGroupCalloutCreate
DismissUserMutationUserCalloutCreate

Integrations resources

Integration Exclusion

Grants the ability to create and delete integration exclusions.

ActionAccessKindName
CreateInstanceMutationIntegrationExclusionCreate
DeleteInstanceMutationIntegrationExclusionDelete

Jira Import

Grants the ability to create Jira imports.

ActionAccessKindName
CreateProjectMutationJiraImportStart
CreateProjectMutationJiraImportUsers

Monitoring resources

Alert

Grants the ability to update alerts.

ActionAccessKindName
UpdateProjectMutationAlertSetAssignees
UpdateProjectMutationUpdateAlertStatus

Escalation Policy

Grants the ability to create, delete, read, and update escalation policies.

ActionAccessKindName
CreateProjectMutationEscalationPolicyCreate
DeleteProjectMutationEscalationPolicyDestroy
ReadProjectTypeEscalationPolicyType
UpdateProjectMutationEscalationPolicyUpdate

HTTP Integration

Grants the ability to create, delete, and update HTTP integrations.

ActionAccessKindName
CreateProjectMutationHttpIntegrationCreate
CreateProjectMutationPrometheusIntegrationCreate
DeleteProjectMutationHttpIntegrationDestroy
UpdateProjectMutationHttpIntegrationResetToken
UpdateProjectMutationHttpIntegrationUpdate
UpdateProjectMutationPrometheusIntegrationResetToken
UpdateProjectMutationPrometheusIntegrationUpdate

Grants the ability to create and delete issuable resource links.

ActionAccessKindName
CreateProjectMutationIssuableResourceLinkCreate
DeleteProjectMutationIssuableResourceLinkDestroy

On-call Schedule

Grants the ability to create, delete, and update on-call schedules.

ActionAccessKindName
CreateProjectMutationOncallRotationCreate
CreateProjectMutationOncallScheduleCreate
DeleteProjectMutationOncallRotationDestroy
DeleteProjectMutationOncallScheduleDestroy
UpdateProjectMutationOncallRotationUpdate
UpdateProjectMutationOncallScheduleUpdate

Sidekiq Job

Grants the ability to drop Sidekiq jobs.

ActionAccessKindName
DropInstanceMutationAdminSidekiqQueuesDeleteJobs

Timeline Event

Grants the ability to create, delete, and update timeline events.

ActionAccessKindName
CreateProjectMutationTimelineEventCreate
CreateProjectMutationTimelineEventPromoteFromNote
CreateProjectMutationTimelineEventTagCreate
DeleteProjectMutationTimelineEventDestroy
UpdateProjectMutationTimelineEventUpdate

Note resources

Saved Reply

Grants the ability to create, delete, and update saved replies.

ActionAccessKindName
CreateProjectMutationProjectSavedReplyCreate
CreateGroupMutationGroupSavedReplyCreate
CreateUserMutationSavedReplyCreate
DeleteProjectMutationProjectSavedReplyDestroy
DeleteGroupMutationGroupSavedReplyDestroy
DeleteUserMutationSavedReplyDestroy
UpdateProjectMutationProjectSavedReplyUpdate
UpdateGroupMutationGroupSavedReplyUpdate
UpdateUserMutationSavedReplyUpdate

Notifications resources

Todo

Grants the ability to create, delete, read, and update todos.

ActionAccessKindName
CreateProjectMutationAlertTodoCreate
CreateProjectMutationTodoCreate
CreateGroupMutationTodoCreate
DeleteUserMutationTodoDeleteAllDone
DeleteUserMutationTodoDeleteMany
ReadUserTypeTodo
UpdateUserMutationTodoMarkDone
UpdateUserMutationTodoResolveMany
UpdateUserMutationTodoRestore
UpdateUserMutationTodoRestoreMany
UpdateUserMutationTodoSnooze
UpdateUserMutationTodoSnoozeMany
UpdateUserMutationTodoUnSnooze
UpdateUserMutationTodoUnsnoozeMany
UpdateUserMutationTodosMarkAllDone

Organizations resources

Organization

Grants the ability to create, delete, read, restore, and update organizations.

ActionAccessKindName
CreateInstanceMutationOrganizationCreate
DeleteInstanceMutationOrganizationDelete
ReadInstanceTypeOrganization
ReadInstanceTypeOrganizationUser
RestoreInstanceMutationOrganizationRestore
UpdateInstanceMutationOrganizationConfirm
UpdateInstanceMutationOrganizationUpdate

Organization User

Grants the ability to create, delete, and update organization users.

ActionAccessKindName
CreateInstanceMutationOrganizationUserCreate
DeleteInstanceMutationOrganizationUserDelete
UpdateInstanceMutationOrganizationUserUpdate

Packages and Registry resources

Container Expiration Policy

Grants the ability to update container expiration policies.

ActionAccessKindName
UpdateProjectMutationUpdateContainerExpirationPolicy

Container Registry Protection Tag Rule

Grants the ability to create, delete, read, and update container registry protection tag rules.

ActionAccessKindName
CreateProjectMutationcreateContainerProtectionTagRule
DeleteProjectMutationDeleteContainerProtectionTagRule
UpdateProjectMutationUpdateContainerProtectionTagRule

Container Repository

Grants the ability to delete and read container repositories.

ActionAccessKindName
DeleteProjectMutationDestroyContainerRepository
DeleteProjectMutationDestroyContainerRepositoryTags

Container Repository Protection Rule

Grants the ability to create, delete, read, and update container repository protection rules.

ActionAccessKindName
CreateProjectMutationCreateContainerProtectionRepositoryRule
DeleteProjectMutationDeleteContainerProtectionRepositoryRule
UpdateProjectMutationUpdateContainerProtectionRepositoryRule

Dependency Proxy

Grants the ability to read and update dependency proxies.

ActionAccessKindName
UpdateGroupMutationUpdateDependencyProxyImageTtlGroupPolicy
UpdateGroupMutationUpdateDependencyProxySettings

Dependency Proxy Packages Setting

Grants the ability to update dependency proxy packages settings.

ActionAccessKindName
UpdateProjectMutationUpdateDependencyProxyPackagesSettings

Package

Grants the ability to create, delete, read, and update packages.

ActionAccessKindName
CreateProjectMutationCreatePackagesProtectionRule
DeleteProjectMutationDeletePackagesProtectionRule
DeleteProjectMutationDestroyPackage
DeleteProjectMutationDestroyPackageFile
DeleteProjectMutationDestroyPackageFiles
UpdateProjectMutationUpdatePackagesCleanupPolicy
UpdateProjectMutationUpdatePackagesProtectionRule

Package Setting

Grants the ability to update package settings.

ActionAccessKindName
UpdateProjectMutationUpdateNamespacePackageSettings
UpdateGroupMutationUpdateNamespacePackageSettings
UpdateUserMutationUpdateNamespacePackageSettings

Virtual Registry

Grants the ability to create, delete, read, and update virtual registries.

ActionAccessKindName
CreateGroupMutationContainerUpstreamCreate
CreateGroupMutationContainerVirtualRegistryCreate
CreateGroupMutationContainerVirtualRegistryUpstreamCreate
CreateGroupMutationMavenUpstreamCreate
CreateGroupMutationMavenVirtualRegistryCreate
DeleteGroupMutationContainerUpstreamCacheDelete
DeleteGroupMutationContainerUpstreamDelete
DeleteGroupMutationContainerVirtualRegistryCacheDelete
DeleteGroupMutationContainerVirtualRegistryDelete
DeleteGroupMutationContainerVirtualRegistryUpstreamDelete
DeleteGroupMutationMavenUpstreamCacheDelete
DeleteGroupMutationMavenUpstreamDelete
DeleteGroupMutationMavenVirtualRegistryCacheDelete
DeleteGroupMutationMavenVirtualRegistryDelete
DeleteGroupMutationMavenVirtualRegistryUpstreamDelete
UpdateGroupMutationContainerUpstreamTest
UpdateGroupMutationContainerUpstreamUpdate
UpdateGroupMutationContainerVirtualRegistryUpdate
UpdateGroupMutationContainerVirtualRegistryUpstreamUpdate
UpdateGroupMutationMavenUpstreamUpdate
UpdateGroupMutationMavenVirtualRegistryUpdate
UpdateGroupMutationMavenVirtualRegistryUpstreamUpdate
UpdateGroupMutationUpdateVirtualRegistriesSetting

Virtual Registry Cleanup Policy

Grants the ability to create, delete, read, and update virtual registry cleanup policies.

ActionAccessKindName
UpdateGroupMutationVirtualRegistriesCleanupPolicyUpsert

Product Analytics resources

Custom Dashboard

Grants the ability to create, delete, and update custom dashboards.

ActionAccessKindName
CreateInstanceMutationCreateCustomDashboard
DeleteInstanceMutationDeleteCustomDashboard
UpdateInstanceMutationUpdateCustomDashboard

DevOps Adoption

Grants the ability to enable DevOps adoption for namespaces.

ActionAccessKindName
EnableGroupMutationEnableDevopsAdoptionNamespace

Project Features resources

Badge

Grants the ability to create, delete, read, and update badges.

ActionAccessKindName
ReadInstanceTypeOrganizationUserBadge

Cycle Analytics

Grants the ability to read cycle analytics.

ActionAccessKindName
ReadProjectFieldAnalytics.mergeRequests
ReadGroupFieldAnalytics.mergeRequests

Release

Grants the ability to create, delete, read, and update releases.

ActionAccessKindName
CreateProjectMutationReleaseAssetLinkCreate
CreateProjectMutationReleaseCreate
DeleteProjectMutationReleaseDelete
UpdateProjectMutationReleaseUpdate

Grants the ability to create, delete, read, and update release links.

ActionAccessKindName
DeleteProjectMutationReleaseAssetLinkDelete
UpdateProjectMutationReleaseAssetLinkUpdate

Snippet

Grants the ability to create, delete, read, and update snippets.

ActionAccessKindName
CreateProjectMutationCreateSnippet
CreateUserMutationCreateSnippet
DeleteProjectMutationDestroySnippet
DeleteUserMutationDestroySnippet
UpdateProjectMutationUpdateSnippet
UpdateUserMutationUpdateSnippet

Project Model Registry and Experiments resources

ML Experiment

Grants the ability to create, delete, read, and update ML experiments.

ActionAccessKindName
ReadProjectTypeMlExperiment

ML Model

Grants the ability to create, delete, read, and update ML models.

ActionAccessKindName
CreateProjectMutationMlModelCreate
DeleteProjectMutationMlModelDelete
DeleteProjectMutationMlModelDestroy
ReadProjectTypeMlModel
UpdateProjectMutationMlModelEdit

MLflow Run

Grants the ability to create, delete, log, read, and update MLflow runs.

ActionAccessKindName
ReadProjectTypeMlCandidate

Model Version

Grants the ability to create, delete, read, and update model versions.

ActionAccessKindName
CreateProjectMutationMlModelVersionCreate
DeleteProjectMutationMlModelVersionDelete
ReadProjectTypeMlModelVersion
UpdateProjectMutationMlModelVersionEdit

Project Planning resources

Award Emoji

Grants the ability to create and delete award emojis.

ActionAccessKindName
CreateProjectMutationAwardEmojiAdd
Create 1ProjectMutationAwardEmojiToggle
CreateGroupMutationAwardEmojiAdd
Create 1GroupMutationAwardEmojiToggle
DeleteProjectMutationAwardEmojiRemove
DeleteGroupMutationAwardEmojiRemove

1 Also requires the Delete Award Emoji permission.

CRM Contact

Grants the ability to create and update CRM contacts.

ActionAccessKindName
CreateGroupMutationCustomerRelationsContactCreate
UpdateGroupMutationCustomerRelationsContactUpdate

CRM Organization

Grants the ability to create and update CRM organizations.

ActionAccessKindName
CreateGroupMutationCustomerRelationsOrganizationCreate
UpdateGroupMutationCustomerRelationsOrganizationUpdate

Custom Attribute

Grants the ability to delete, read, and update custom attributes.

ActionAccessKindName
DeleteProjectMutationDeleteProjectCustomAttribute
DeleteGroupMutationDeleteGroupCustomAttribute
DeleteInstanceMutationDeleteUserCustomAttribute
UpdateProjectMutationProjectCustomAttributeSet
UpdateGroupMutationSetGroupCustomAttribute
UpdateInstanceMutationUserCustomAttributeSet

Custom Field

Grants the ability to archive custom fields.

ActionAccessKindName
ArchiveGroupMutationCustomFieldArchive
ArchiveGroupMutationCustomFieldUnarchive

Design

Grants the ability to create, delete, and update designs.

ActionAccessKindName
CreateProjectMutationDesignManagementUpload
DeleteProjectMutationDesignManagementDelete
UpdateProjectMutationDesignManagementMove
UpdateProjectMutationDesignManagementUpdate

Issue

Grants the ability to subscribe issues.

ActionAccessKindName
SubscribeProjectMutationIssueSetSubscription

Label

Grants the ability to create, delete, promote, read, subscribe, and update labels.

ActionAccessKindName
CreateProjectMutationLabelCreate
CreateGroupMutationLabelCreate
ReadProjectTypeLabel
ReadGroupTypeLabel
UpdateProjectMutationLabelUpdate
UpdateGroupMutationLabelUpdate

Timelog

Grants the ability to create and delete timelogs.

ActionAccessKindName
CreateProjectMutationTimelogCreate
CreateGroupMutationTimelogCreate
DeleteProjectMutationTimelogDelete
DeleteGroupMutationTimelogDelete

Work Item

Grants the ability to create, delete, read, subscribe, and update work items such as epics and issues.

ActionAccessKindName
CreateProjectMutationBoardListCreate
Create 1ProjectMutationCreateAlertIssue
CreateProjectMutationCreateBoard
CreateProjectMutationCreateDiffNote
CreateProjectMutationCreateDiscussion
CreateProjectMutationCreateImageDiffNote
CreateProjectMutationCreateIssue
CreateProjectMutationCreateLatestDiffNote
CreateProjectMutationCreateNote
CreateProjectMutationCreateRequirement
CreateProjectMutationCreateTestCase
CreateProjectMutationWorkItemCreate
CreateProjectMutationWorkItemsCsvImport
CreateProjectFieldEpicIssue.createNoteEmail
CreateProjectFieldIssue.createNoteEmail
CreateProjectFieldWorkItem.createNoteEmail
CreateGroupMutationBoardEpicCreate
CreateGroupMutationBoardListCreate
CreateGroupMutationCreateBoard
CreateGroupMutationCreateDiffNote
CreateGroupMutationCreateDiscussion
CreateGroupMutationCreateEpic
CreateGroupMutationCreateImageDiffNote
CreateGroupMutationCreateIteration
CreateGroupMutationCreateLatestDiffNote
CreateGroupMutationCreateNote
CreateGroupMutationCustomFieldCreate
CreateGroupMutationEpicAddIssue
CreateGroupMutationEpicBoardCreate
CreateGroupMutationEpicBoardListCreate
CreateGroupMutationIterationCadenceCreate
CreateGroupMutationLifecycleCreate
CreateGroupMutationWorkItemCreate
CreateGroupMutationWorkItemTypeCreate
CreateGroupMutationiterationCreate
DeleteProjectMutationDestroyBoard
DeleteProjectMutationDestroyNote
DeleteProjectMutationWorkItemDelete
DeleteGroupMutationDestroyBoard
DeleteGroupMutationDestroyEpicBoard
DeleteGroupMutationDestroyNote
DeleteGroupMutationIterationCadenceDestroy
DeleteGroupMutationIterationDelete
DeleteGroupMutationLifecycleDelete
DeleteGroupMutationWorkItemDelete
ReadProjectTypeBoard
ReadProjectTypeEpicIssue
ReadProjectTypeIssue
ReadProjectTypeMilestone
ReadProjectTypeNote
ReadProjectTypeWorkItem
ReadProjectMutationExportRequirements
ReadProjectMutationUpdateBoardEpicUserPreferences
ReadProjectMutationWorkItemExport
ReadProjectMutationWorkItemsCsvExport
ReadGroupTypeBoard
ReadGroupTypeBoardEpic
ReadGroupTypeEpic
ReadGroupTypeIteration
ReadGroupTypeIterationCadence
ReadGroupTypeMilestone
ReadGroupTypeNote
ReadGroupTypeWorkItem
ReadGroupTypeWorkItemMoveTarget
ReadGroupMutationUpdateBoardEpicUserPreferences
SubscribeProjectMutationWorkItemSubscribe
SubscribeGroupMutationEpicSetSubscription
SubscribeGroupMutationWorkItemSubscribe
UpdateProjectMutationBoardListUpdateLimitMetrics
UpdateProjectMutationDiscussionToggleResolve
UpdateProjectMutationIssueLinkAlerts
UpdateProjectMutationIssueMove
UpdateProjectMutationIssueSetAssignees
UpdateProjectMutationIssueSetConfidential
UpdateProjectMutationIssueSetCrmContacts
UpdateProjectMutationIssueSetDueDate
UpdateProjectMutationIssueSetEpic
UpdateProjectMutationIssueSetEscalationPolicy
UpdateProjectMutationIssueSetEscalationStatus
UpdateProjectMutationIssueSetIteration
UpdateProjectMutationIssueSetLocked
UpdateProjectMutationIssueSetSeverity
UpdateProjectMutationIssueSetWeight
UpdateProjectMutationIssueUnlinkAlert
UpdateProjectMutationNoteConvertToThread
UpdateProjectMutationPromoteToEpic
UpdateProjectMutationRepositionImageDiffNote
UpdateProjectMutationUpdateBoard
UpdateProjectMutationUpdateImageDiffNote
UpdateProjectMutationUpdateIssue
UpdateProjectMutationUpdateNote
UpdateProjectMutationUpdateRequirement
UpdateProjectMutationWorkItemAddClosingMergeRequest
UpdateProjectMutationWorkItemAddLinkedItems
UpdateProjectMutationWorkItemAvailabilityToggle
UpdateProjectMutationWorkItemBulkMove
UpdateProjectMutationWorkItemBulkUpdate
UpdateProjectMutationWorkItemConvert
UpdateProjectMutationWorkItemCreateFromTask
UpdateProjectMutationWorkItemDecisionArchive
UpdateProjectMutationWorkItemDecisionCreate
UpdateProjectMutationWorkItemDecisionDelete
UpdateProjectMutationWorkItemDecisionResolve
UpdateProjectMutationWorkItemDecisionUpdate
UpdateProjectMutationWorkItemEnableAiPlanning
UpdateProjectMutationWorkItemGenerateReadinessScore
UpdateProjectMutationWorkItemGenerateWorkplan
UpdateProjectMutationWorkItemRemoveLinkedItems
UpdateProjectMutationWorkItemResumeWorkplan
UpdateProjectMutationWorkItemUpdate
UpdateProjectMutationWorkItemUserPreferenceUpdate
UpdateProjectMutationworkItemsHierarchyReorder
UpdateProjectMutationworkItemsReorder
UpdateGroupMutationBoardListUpdateLimitMetrics
UpdateGroupMutationCustomFieldUpdate
UpdateGroupMutationEpicBoardUpdate
UpdateGroupMutationEpicMoveList
UpdateGroupMutationEpicTreeReorder
UpdateGroupMutationIterationCadenceUpdate
UpdateGroupMutationLifecycleAttachWorkItemType
UpdateGroupMutationLifecycleUpdate
UpdateGroupMutationUpdateBoard
UpdateGroupMutationUpdateEpic
UpdateGroupMutationUpdateImageDiffNote
UpdateGroupMutationUpdateIteration
UpdateGroupMutationUpdateNote
UpdateGroupMutationWorkItemAddClosingMergeRequest
UpdateGroupMutationWorkItemAddLinkedItems
UpdateGroupMutationWorkItemAvailabilityToggle
UpdateGroupMutationWorkItemBulkMove
UpdateGroupMutationWorkItemBulkUpdate
UpdateGroupMutationWorkItemConvert
UpdateGroupMutationWorkItemDecisionArchive
UpdateGroupMutationWorkItemDecisionCreate
UpdateGroupMutationWorkItemDecisionDelete
UpdateGroupMutationWorkItemDecisionResolve
UpdateGroupMutationWorkItemDecisionUpdate
UpdateGroupMutationWorkItemEnableAiPlanning
UpdateGroupMutationWorkItemRemoveLinkedItems
UpdateGroupMutationWorkItemSettingsUpdate
UpdateGroupMutationWorkItemTypeUpdate
UpdateGroupMutationWorkItemUpdate
UpdateGroupMutationWorkItemUserPreferenceUpdate
UpdateGroupMutationworkItemsHierarchyReorder
UpdateGroupMutationworkItemsReorder

1 Also requires the Update Alert permission.

Work Item Saved View

Grants the ability to create, delete, subscribe, and update work item saved views.

ActionAccessKindName
CreateProjectMutationWorkItemSavedViewCreate
CreateGroupMutationWorkItemSavedViewCreate
DeleteProjectMutationWorkItemSavedViewDelete
DeleteGroupMutationWorkItemSavedViewDelete
SubscribeProjectMutationWorkItemSavedViewReorder
SubscribeProjectMutationWorkItemSavedViewSubscribe
SubscribeProjectMutationWorkItemSavedViewUnsubscribe
SubscribeGroupMutationWorkItemSavedViewReorder
SubscribeGroupMutationWorkItemSavedViewSubscribe
SubscribeGroupMutationWorkItemSavedViewUnsubscribe
UpdateProjectMutationWorkItemSavedViewUpdate
UpdateGroupMutationWorkItemSavedViewUpdate

Projects resources

Markdown Upload

Grants the ability to create, delete, and read Markdown uploads.

ActionAccessKindName
CreateProjectMutationUploadCreate
CreateGroupMutationUploadCreate
DeleteProjectMutationUploadDelete
DeleteGroupMutationUploadDelete

Page

Grants the ability to delete, read, and update pages.

ActionAccessKindName
DeleteProjectMutationDeletePagesDeployment
DeleteProjectMutationRestorePagesDeployment
ReadProjectTypePagesDeployment
UpdateProjectMutationPagesMarkOnboardingComplete
UpdateProjectMutationSetPagesForceHttps
UpdateProjectMutationSetPagesUseUniqueDomain

Project

Grants the ability to archive, create, delete, fork, read, share, transfer, and update projects.

ActionAccessKindName
ReadProjectTypeProject
ReadProjectTypeRepositoryLanguage
TransferProjectMutationProjectTransfer
UpdateProjectMutationProjectSettingsUpdate
UpdateProjectMutationStarProject

Repository resources

Approval Rule

Grants the ability to create, delete, read, and update approval rules.

ActionAccessKindName
CreateProjectMutationbranchRuleApprovalProjectRuleCreate
DeleteProjectMutationapprovalProjectRuleDelete
ReadProjectTypeApprovalProjectRule
ReadProjectTypeApprovalRule
UpdateProjectMutationMergeRequestUpdateApprovalRule
UpdateProjectMutationapprovalProjectRuleUpdate

Branch

Grants the ability to create, delete, protect, and read branches.

ActionAccessKindName
CreateProjectMutationCreateBranch
DeleteProjectMutationBranchDelete
ReadProjectTypeBranch

Branch Rule

Grants the ability to create, delete, and update branch rules.

ActionAccessKindName
CreateProjectMutationBranchRuleCreate
DeleteProjectMutationBranchRuleDelete
DeleteProjectMutationBranchRuleSquashOptionDelete
UpdateProjectMutationBranchRuleSquashOptionUpdate
UpdateProjectMutationBranchRuleUpdate

Code

Grants the ability to download, push, and read code via Git.

ActionAccessKindName
PushProjectMutationCommitCreate
Push 1ProjectMutationConfigureContainerScanning
Push 1ProjectMutationConfigureDependencyScanning
Push 1ProjectMutationConfigureSast
Push 1ProjectMutationConfigureSastIac
Push 1ProjectMutationConfigureSecretDetection
PushProjectMutationProjectSyncFork
ReadProjectTypeCommit
ReadProjectTypeRepository

1 Also requires the Create Branch permission.

Merge Request

Grants the ability to approve, create, delete, merge, read, subscribe, and update merge requests.

ActionAccessKindName
CreateProjectMutationMergeRequestCreate
MergeProjectMutationMergeRequestAccept
ReadProjectTypeAiSuggestedReviewer
ReadProjectTypeMergeRequest
ReadProjectTypeMergeRequestApprovalState
ReadProjectTypeMergeRequestResourceLabelEvent
ReadProjectTypeMergeRequestWorkItemRelation
ReadProjectTypeUserMergeRequestInteraction
SubscribeProjectMutationMergeRequestSetSubscription
UpdateProjectMutationDismissPolicyViolations
UpdateProjectMutationMergeRequestBypassSecurityPolicy
UpdateProjectMutationMergeRequestCreateWorkItemRelations
UpdateProjectMutationMergeRequestDestroyRequestedChanges
UpdateProjectMutationMergeRequestDestroyWorkItemRelations
UpdateProjectMutationMergeRequestRequestChanges
UpdateProjectMutationMergeRequestResyncSecurityPolicies
UpdateProjectMutationMergeRequestReviewerRereview
UpdateProjectMutationMergeRequestSetAssignees
UpdateProjectMutationMergeRequestSetBlockingMergeRequests
UpdateProjectMutationMergeRequestSetDraft
UpdateProjectMutationMergeRequestSetLabels
UpdateProjectMutationMergeRequestSetLocked
UpdateProjectMutationMergeRequestSetMilestone
UpdateProjectMutationMergeRequestSetReviewers
UpdateProjectMutationMergeRequestUpdate

Merge Request Saved View

Grants the ability to create, delete, read, and update merge request saved views.

ActionAccessKindName
CreateUserMutationMergeRequestSavedViewCreate
DeleteUserMutationMergeRequestSavedViewDelete
ReadUserTypeMergeRequestSavedView
UpdateUserMutationMergeRequestSavedViewUpdate

Path Lock

Grants the ability to create path locks.

ActionAccessKindName
CreateProjectMutationProjectSetLocked

Push Rule

Grants the ability to create, delete, read, and update push rules.

ActionAccessKindName
ReadProjectTypePushRules

Repository

Grants the ability to create, delete, read, and update repositories.

ActionAccessKindName
ReadProjectTypeBlob
ReadProjectTypeRepositoryBlob
ReadProjectTypeTree

Repository History

Grants the ability to rewrite repository histories.

ActionAccessKindName
RewriteProjectMutationprojectBlobsRemove
RewriteProjectMutationprojectTextReplace

Repository Tag

Grants the ability to create, delete, and read repository tags.

ActionAccessKindName
CreateProjectMutationTagCreate
DeleteProjectMutationTagDelete
ReadProjectTypeTag

Target Branch Rule

Grants the ability to create and delete target branch rules.

ActionAccessKindName
CreateProjectMutationProjectTargetBranchRuleCreate
DeleteProjectMutationProjectTargetBranchRuleDestroy

Secrets Management resources

Secrets Manager Add-on

Grants the ability to enable the paid Secrets Manager add-on for a top-level group, which also provisions that group’s secrets manager on GitLab.com, or for the whole instance.

ActionAccessKindName
Enable 1GroupMutationSecretsManagerEnableAddOn
Enable 1GroupMutationSecretsManagerRefreshEntitlement
Enable 1InstanceMutationSecretsManagerInstanceEnableAddOn
Enable 1InstanceMutationSecretsManagerInstanceRefreshEntitlement

1 Also requires the Read Secrets Manager permission.

Secrets Manager Enrollment

Grants the ability to read secrets manager enrollments.

ActionAccessKindName
ReadInstanceTypeSecretsManagerInstanceEnrollment

Secrets Manager Trial

Grants the ability to start a Secrets Manager trial for a top-level group, which also provisions that group’s secrets manager on GitLab.com, or for the whole instance.

ActionAccessKindName
Start 1GroupMutationSecretsManagerStartTrial
Start 1InstanceMutationSecretsManagerInstanceStartTrial

1 Also requires the Read Secrets Manager permission.

Subscription and Licensing resources

Add On Assignment

Grants the ability to create and delete add on assignments.

ActionAccessKindName
CreateGroupMutationUserAddOnAssignmentBulkCreate
CreateGroupMutationUserAddOnAssignmentCreate
CreateInstanceMutationUserAddOnAssignmentBulkCreate
CreateInstanceMutationUserAddOnAssignmentCreate
DeleteGroupMutationUserAddOnAssignmentBulkRemove
DeleteGroupMutationUserAddOnAssignmentRemove
DeleteInstanceMutationUserAddOnAssignmentBulkRemove
DeleteInstanceMutationUserAddOnAssignmentRemove

GitLab Subscription

Grants the ability to create, read, and update GitLab subscriptions.

ActionAccessKindName
UpdateInstanceMutationGitlabSubscriptionActivate

Member Approval

Grants the ability to update member approvals.

ActionAccessKindName
UpdateInstanceMutationProcessUserBillablePromotionRequest

Subscription Usage Cap

Grants the ability to update subscription usage caps.

ActionAccessKindName
UpdateGroupMutationUpsertFlatUserCap
UpdateGroupMutationUpsertUserBudgetCapOverrides
UpdateInstanceMutationUpsertFlatUserCap
UpdateInstanceMutationUpsertUserBudgetCapOverrides

System Access resources

Email

Grants the ability to create, delete, and read emails.

ActionAccessKindName
ReadUserTypeEmail

Job Token Scope

Grants the ability to read and update job token scopes.

ActionAccessKindName
UpdateProjectMutationCiJobTokenScopeUpdatePolicies

Job Token Scope Allowlist

Grants the ability to create, delete, and read job token scope allowlists.

ActionAccessKindName
CreateProjectMutationCiJobTokenScopeAddGroupOrProject
CreateProjectMutationCiJobTokenScopeAddProject
DeleteProjectMutationCiJobTokenScopeRemoveGroup
DeleteProjectMutationCiJobTokenScopeRemoveProject

Member

Grants the ability to create, delete, read, and update members.

ActionAccessKindName
ReadProjectTypeProjectMember
ReadGroupTypeGroupMember
ReadGroupMutationGroupMembersExport
UpdateProjectMutationProjectMemberBulkUpdate
UpdateGroupMutationGroupMemberBulkUpdate

Metadata

Grants the ability to read instance metadata.

ActionAccessKindName
ReadInstanceTypeGitlabInstanceFeatureFlag
ReadInstanceTypeKas
ReadInstanceTypeMetadata
ReadInstanceTypeSecurityScanProfileVariable

Personal Access Token

Grants the ability to create, read, revoke, and rotate personal access tokens.

ActionAccessKindName
CreateUserMutationPersonalAccessTokenCreate
RevokeUserMutationPersonalAccessTokenRevoke
RotateUserMutationPersonalAccessTokenRotate

User

Grants the ability to activate, approve, ban, block, create, deactivate, delete, disable two factor, follow, read, reject, unban, unblock, unfollow, and update users.

ActionAccessKindName
ReadUserTypeAddOnUser
ReadUserTypeAutocompletedUser
ReadUserTypeCurrentUser
ReadUserTypeMergeRequestAssignee
ReadUserTypeMergeRequestAuthor
ReadUserTypeMergeRequestParticipant
ReadUserTypeMergeRequestReviewer
ReadUserTypeUserCore

System Migration resources

Import Source User

Grants the ability to read import source users.

ActionAccessKindName
ReadUserTypeImportSourceUser

Placeholder Reassignment

Grants the ability to create, read, revoke, and update placeholder reassignments.

ActionAccessKindName
RevokeUserMutationImportSourceUserRevoke
UpdateGroupMutationImportSourceUserCancelReassignment
UpdateGroupMutationImportSourceUserKeepAllAsPlaceholder
UpdateGroupMutationImportSourceUserKeepAsPlaceholder
UpdateGroupMutationImportSourceUserResendNotification
UpdateGroupMutationImportSourceUserRetryFailedReassignment
UpdateGroupMutationImportSourceUserUndoKeepAsPlaceholder

Value Stream resources

Value Stream

Grants the ability to create, delete, and update value streams.

ActionAccessKindName
CreateProjectMutationValueStreamCreate
CreateGroupMutationValueStreamCreate
DeleteProjectMutationValueStreamDestroy
DeleteGroupMutationValueStreamDestroy
UpdateProjectMutationValueStreamUpdate
UpdateGroupMutationValueStreamUpdate

Wiki resources

Wiki

Grants the ability to create, delete, read, subscribe, and update wikis.

ActionAccessKindName
SubscribeProjectMutationWikiPageSubscribe

Workspace resources

Cluster Agent Mapping

Grants the ability to create and delete cluster agent mappings.

ActionAccessKindName
CreateGroupMutationNamespaceCreateRemoteDevelopmentClusterAgentMapping
CreateInstanceMutationOrganizationCreateClusterAgentMapping
DeleteGroupMutationNamespaceDeleteRemoteDevelopmentClusterAgentMapping
DeleteInstanceMutationOrganizationDeleteClusterAgentMapping

Workspace

Grants the ability to create and update workspaces.

ActionAccessKindName
CreateProjectMutationWorkspaceCreate
UpdateProjectMutationWorkspaceUpdate