GraphQL API resources

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

The API can be explored using the interactive GraphQL explorer. Developers can also generate a machine-readable GraphQL schema in IDL and JSON formats.

Each table below documents a GraphQL type. Types match loosely to models, but not all fields and methods on a model are available via GraphQL.

Query type

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

Query.abuseReport

Find an abuse report.

Returns AbuseReport.

Arguments:

Query.accessTokenPermissions

List of permissions for fine-grained access tokens.

Returns [AccessTokenPermission!]!.

Query.addOnPurchases

Retrieve all active add-on purchases. This query can be used in GitLab.com and self-managed environments.

Returns [AddOnPurchase!].

Arguments:

Query.adminDuoAvailabilityNamespaces

List groups with their resolved GitLab Duo availability for admin overrides.

Returns AdminDuoAvailabilityNamespaceConnection.

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

Arguments:

Query.adminGroups

Find groups visible to the current admin.

Returns GroupInterfaceConnection.

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

Arguments:

Query.adminMemberRole

Finds a single admin custom role for the instance. Available only for GitLab Self-Managed.

Returns AdminMemberRole.

Arguments:

Query.adminMemberRolePermissions

List of all admin customizable permissions.

Returns CustomizableAdminPermissionConnection.

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

Query.adminMemberRoles

Admin custom roles available for the instance. Available only for GitLab Self-Managed.

Returns AdminMemberRoleConnection.

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

Arguments:

Query.adminProjects

Find projects visible to the current admin.

Returns ProjectInterfaceConnection.

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

Arguments:

Query.aiCatalogAgentFlowConfig

Get flow configuration for an AI Catalog agent.

Returns String.

Arguments:

Query.aiCatalogAvailableFlowsForProject

AI Catalog flows available to enable for a project.

Returns AiCatalogItemConsumerConnection!.

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

Arguments:

Query.aiCatalogBuiltInTools

List of AI Catalog built-in tools.

Returns AiCatalogBuiltInToolConnection!.

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

Query.aiCatalogConfiguredItems

AI Catalog items configured for use.

Returns AiCatalogItemConsumerConnection!.

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

Arguments:

Query.aiCatalogCustomAndFoundationalItems

List of AI Catalog items, including foundational items.

Returns AiCatalogCustomAndFoundationalItemConnection!.

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

Arguments:

Query.aiCatalogItem

Find an AI Catalog item.

Returns AiCatalogItem.

Arguments:

Query.aiCatalogItemConsumer

Find a single AI Catalog item consumer by ID.

Returns AiCatalogItemConsumer.

Arguments:

Query.aiCatalogItemVersions

Public AI Catalog item versions.

Returns AiCatalogItemVersionConnection!.

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

Arguments:

Query.aiCatalogItems

List of AI Catalog items.

Returns AiCatalogItemConnection!.

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

Arguments:

Query.aiCatalogMcpServer

Find an AI Catalog MCP server by ID.

Returns AiCatalogMcpServer.

Arguments:

Query.aiCatalogMcpServers

List of AI Catalog MCP servers.

Returns AiCatalogMcpServerConnection!.

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

Query.aiCatalogMcpTools

List of MCP tools dynamically discovered from the GitLab MCP server.

Returns AiCatalogMcpToolConnection!.

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

Query.aiChatAvailableModels

Get available models for Duo Agentic Chat.

Returns AvailableModels.

Arguments:

Query.aiChatContextPresets

Get available GitLab Duo Chat context presets for the current user for a specific URL.

Returns ContextPreset.

Arguments:

Query.aiChatIncludedProjects

Get projects that can be included by the current user in a GitLab Duo Chat context.

Returns ProjectConnection.

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

Arguments:

Query.aiConversationThreads

List conversation threads of AI features.

Returns AiConversationsThreadConnection!.

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

Arguments:

Query.aiDomainSettings

List of allowed or denied domains for AI features.

Returns StringConnection.

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

Arguments:

Query.aiFeatureSettings

List of configurable AI features.

Returns AiFeatureSettingConnection.

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

Arguments:

Query.aiFlowsMetadata

Metadata describing Duo Agent Platform flow capabilities available to the caller.

Returns AiFlowsMetadata.

Arguments:

Query.aiFoundationalChatAgent

Core agent in GitLab.

Returns AiFoundationalChatAgent.

Arguments:

Query.aiFoundationalChatAgents

Core agents in GitLab.

Returns AiFoundationalChatAgentConnection!.

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

Arguments:

Query.aiMessages

Find GitLab Duo Chat messages.

Returns AiMessageConnection!.

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

Arguments:

Query.aiModelSelectionNamespaceSettings

List of configurable AI features for namespace Model Selection.

Returns AiModelSelectionNamespaceFeatureSettingConnection.

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

Arguments:

Query.aiSelfHostedModels

Returns the self-hosted model if an ID is provided, otherwise returns all models.

Returns AiSelfHostedModelConnection.

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

Arguments:

Query.aiSlashCommands

Get available GitLab Duo Chat slash commands for the current user for a specific URL.

Returns [SlashCommand!].

Arguments:

Query.aiToolRules

AI tool governance rules for a namespace.

Returns AiToolRuleConnection.

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

Arguments:

Query.aiUsageData

Instance level AI-related data. Admins only.

Returns AiInstanceUsageData.

Query.artifactRegistryRoleAssignments

Direct Artifact Registry role assignments on the given resources. Returns only roles assigned on a resource itself, not members who inherit access from a membership on an ancestor namespace, so it is not a complete list of everyone who can access the resource.

Returns ArtifactRegistryRoleAssignmentConnection.

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

Arguments:

Query.auditEventDefinitions

Definitions for all audit events available on the instance.

Returns AuditEventDefinitionConnection!.

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

Query.auditEventsInstanceAmazonS3Configurations

Instance-level Amazon S3 configurations for audit events.

Returns InstanceAmazonS3ConfigurationTypeConnection.

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

Query.auditEventsInstanceStreamingDestinations

Instance-level external audit event streaming destinations.

Returns InstanceAuditEventStreamingDestinationConnection.

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

Query.blobSearch

Find code visible to the current user.

Returns BlobSearch.

Arguments:

Query.boardList

Find an issue board list.

Returns BoardList.

Arguments:

Query.ciApplicationSettings

CI related settings that apply to the entire instance.

Returns CiApplicationSettings.

Query.ciCatalogBundledResources

GitLab-maintained bundled CI/CD Catalog resources available on the current cell.

Returns CiCatalogBundledResourceConnection.

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

Query.ciCatalogResource

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

Returns CiCatalogResource.

Arguments:

Query.ciCatalogResources

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

Returns CiCatalogResourceConnection.

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

Arguments:

Query.ciConfig

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

Returns CiConfig.

Arguments:

Query.ciDedicatedHostedRunnerFilters

Returns available filters for GitLab Dedicated runner usage data.

Returns CiDedicatedHostedRunnerFilters.

Query.ciDedicatedHostedRunnerUsage

Compute usage data for runners across namespaces on GitLab Dedicated. Defaults to the current year if no year or billing month is specified. Ultimate only.

Returns CiDedicatedHostedRunnerUsageConnection.

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

Arguments:

Query.ciMinutesProjectMonthlyUsage

Compute usage data for projects in a namespace for a given month. Returns project usage independent of whether a namespace-level usage record exists.

Returns CiMinutesProjectMonthlyUsageConnection.

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

Arguments:

Query.ciMinutesUsage

Compute usage data for a namespace.

Returns CiMinutesNamespaceMonthlyUsageConnection.

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

Arguments:

Query.ciPipelineStage

Stage belonging to a CI pipeline.

Returns CiStage.

Arguments:

Query.ciQueueingHistory

Time taken for CI jobs to be picked up by runner by percentile. Enable the ClickHouse database backend to use this query.

Returns QueueingDelayHistory.

Arguments:

Query.ciVariables

List of the instance’s CI/CD variables.

Returns CiInstanceVariableConnection.

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

Arguments:

Query.cloudConnectorStatus

Run a series of status checks for Cloud Connector features.

Returns CloudConnectorStatus.

Query.complianceFrameworkTemplates

List of available compliance framework templates.

Returns [ComplianceFrameworkTemplate!].

Arguments:

Query.complianceRequirementControls

Get the list of all the compliance requirement controls.

Returns ComplianceRequirementControl.

Query.containerRepository

Find a container repository.

Returns ContainerRepositoryDetails.

Arguments:

Query.currentLicense

Fields related to the current license.

Returns CurrentLicense.

Query.currentUser

Get information about current user.

Returns CurrentUser.

Query.customDashboard

Find a custom dashboard by ID.

Returns CustomDashboard.

Arguments:

Query.customDashboards

Find custom dashboards for an organization.

Returns CustomDashboardInterfaceConnection.

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

Arguments:

Query.customField

Find a custom field by its ID.

Returns CustomField.

Arguments:

Query.customSystemDashboard

Find a GitLab-provided system dashboard by slug.

Returns CustomSystemDashboard.

Arguments:

Query.dependency

Find a dependency.

Returns Dependency.

Arguments:

Query.designManagement

Fields related to design management.

Returns DesignManagement!.

Query.devopsAdoptionEnabledNamespaces

Get configured DevOps adoption namespaces. Status: Beta. This endpoint is subject to change without notice.

Returns DevopsAdoptionEnabledNamespaceConnection.

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

Arguments:

Query.duoDefaultNamespaceCandidates

List namespaces suitable to be set as default namespace.

Returns NamespaceConnection.

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

Query.duoSettings

Get GitLab Duo settings.

Returns DuoSettings.

Query.duoWorkflowBranches

Other attempts at a turn in a Duo Agent Platform session, created when the user retried it. Always empty until branch reconstruction is released.

Returns [DuoWorkflowBranch!].

Arguments:

Query.duoWorkflowEvents

List the events for a Duo Agent Platform. Returns only the latest checkpoint by default. Use first and after to page through history.

Returns DuoWorkflowEventConnection!.

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

Arguments:

Query.duoWorkflowWorkflows

List the workflows owned by the current user.

Returns DuoWorkflowConnection!.

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

Arguments:

Query.echo

Testing endpoint to validate the API with.

Returns String!.

Arguments:

Query.epicBoardList

Returns EpicList.

Arguments:

Query.featureFlagEnabled

Check if a feature flag is enabled. External API consumers should read the feature flag guidance for external API consumers before using this field.

Returns Boolean!.

Arguments:

Query.frecentGroups

A user’s frecently visited groups.

Returns [Group!].

Query.frecentProjects

A user’s frecently visited projects.

Returns [Project!].

Query.geoNode

Find a Geo node.

Returns GeoNode.

Arguments:

Query.gitlabCreditsAvailable

Whether GitLab credits are available for the current user.

Returns Boolean!.

Arguments:

Query.gitlabCreditsUnavailableReason

Reason GitLab credits are unavailable. Returns “usage_billing_forbidden” when usage billing is not available for the account. Returns null when credits are available or the unavailability reason is not recognized.

Returns AiCreditsDenialReason.

Arguments:

Query.gitpodEnabled

Whether Ona is enabled in application settings.

Returns Boolean.

Query.googleCloudArtifactRegistryRepositoryArtifact

Details about an artifact in the Google Artifact Registry.

Returns GoogleCloudArtifactRegistryArtifactDetails.

Arguments:

Query.group

Find a group.

Returns Group.

Arguments:

Query.groupSecret

View a specific group secret.

Returns GroupSecret.

Arguments:

Query.groupSecrets

List group secrets.

Returns GroupSecretConnection.

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

Arguments:

Query.groupSecretsCount

Total number of secrets in a group.

Returns Int.

Arguments:

Query.groupSecretsManager

Find a group secrets manager.

Returns GroupSecretsManager.

Arguments:

Query.groupSecretsNeedingRotation

List group secrets that need to be rotated.

Returns GroupSecretConnection.

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

Arguments:

Query.groupSecretsPermissions

List group secrets permissions.

Returns GroupSecretsPermissionConnection.

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

Arguments:

Query.groups

Find groups.

Returns GroupConnection.

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

Arguments:

Query.instanceExternalAuditEventDestinations

Instance level external audit event destinations.

Returns InstanceExternalAuditEventDestinationConnection.

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

Query.instanceGoogleCloudLoggingConfigurations

Instance level google cloud logging configurations.

Returns InstanceGoogleCloudLoggingConfigurationTypeConnection.

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

Query.instanceSecretsManagerEnrollment

Check if Secrets Manager is enrolled at the instance level.

Returns SecretsManagerInstanceEnrollment.

Query.instanceSecurityDashboard

Fields related to Instance Security Dashboard.

Returns InstanceSecurityDashboard.

Query.integrationExclusions

Returns IntegrationExclusionConnection.

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

Arguments:

Query.issue

Find an issue.

Returns Issue.

Arguments:

Query.issues

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

Returns IssueConnection.

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

Arguments:

Query.iteration

Find an iteration.

Returns Iteration.

Arguments:

Query.jobs

All jobs on this GitLab instance. Returns an empty result for users without administrator access.

Returns CiJobInterfaceConnection.

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

Arguments:

Query.ldapAdminRoleLinks

LDAP admin links. Available only for GitLab Self-Managed.

Returns LdapAdminRoleLinkConnection.

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

Query.licenseHistoryEntries

Fields related to entries in the license history.

Returns LicenseHistoryEntryConnection.

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

Query.memberRole

Finds a single custom role for the instance. Available only for GitLab Self-Managed.

Returns MemberRole.

Arguments:

Query.memberRolePermissions

List of all standard customizable permissions.

Returns CustomizableStandardPermissionConnection.

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

Query.memberRoles

Custom roles available for the instance. Available only for GitLab Self-Managed.

Returns MemberRoleConnection.

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

Arguments:

Query.mergeRequest

Find a merge request.

Returns MergeRequest.

Arguments:

Query.mergeRequests

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

Returns MergeRequestConnection.

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

Arguments:

Query.metadata

Metadata about GitLab.

Returns Metadata.

Query.milestone

Find a milestone.

Returns Milestone.

Arguments:

Query.mlExperiment

Find a machine learning experiment.

Returns MlExperiment.

Arguments:

Query.mlModel

Find machine learning models.

Returns MlModel.

Arguments:

Query.namespace

Find a namespace.

Returns Namespace.

Arguments:

Query.namespaceSecretsManagerEnrollment

Check Secrets Manager enrollment for a namespace.

Returns SecretsManagerEnrollment.

Arguments:

Query.namespaceSecurityProjects

Security-filtered projects for a namespace.

Returns ProjectConnection.

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

Arguments:

Query.note

Find a note.

Returns Note.

Arguments:

Query.openbaoHealth

Check if OpenBao instance is healthy and reachable.

Returns Boolean!.

Query.organization

Find an organization.

Returns Organization.

Arguments:

Query.organizations

List organizations.

Returns OrganizationConnection.

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

Arguments:

Query.package

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

Returns PackageDetailsType.

Arguments:

Query.packageMetadataAdvisories

Get multiple package metadata advisories.

Returns PackageMetadataAdvisoryConnection.

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

Arguments:

Query.packageMetadataAdvisory

Get a package metadata advisory.

Returns PackageMetadataAdvisory.

Arguments:

Query.pipelineExecutionSchedulePolicyTestRun

Find a pipeline execution schedule policy test run by ID.

Returns PolicyScheduleTestRun.

Arguments:

Query.project

Find a project.

Returns Project.

Arguments:

Query.projectComplianceViolation

Find a project compliance violation.

Returns ProjectComplianceViolation.

Arguments:

Query.projectSecret

View a specific project secret.

Returns ProjectSecret.

Arguments:

Query.projectSecrets

List project secrets.

Returns ProjectSecretConnection.

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

Arguments:

Query.projectSecretsCount

Total number of secrets in a project.

Returns Int.

Arguments:

Query.projectSecretsManager

Find a project secrets manager.

Returns ProjectSecretsManager.

Arguments:

Query.projectSecretsNeedingRotation

List project secrets that need to be rotated.

Returns ProjectSecretConnection.

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

Arguments:

Query.projectSecretsPermissions

List project secrets permissions.

Returns ProjectSecretsPermissionConnection.

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

Arguments:

Query.projects

Find projects visible to the current user.

Returns ProjectConnection.

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

Arguments:

Query.queryComplexity

Information about the complexity of the GraphQL query.

Returns QueryComplexity.

Query.restrictedVisibilityLevels

Visibility levels that are restricted on the instance. Non-administrators cannot use restricted visibility levels for groups, projects, or snippets.

Returns [VisibilityLevelsEnum!].

Query.runner

Find a runner.

Returns CiRunner.

Arguments:

Query.runnerPlatforms

Supported runner platforms.

Returns RunnerPlatformConnection.

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

Query.runnerSetup

Runner setup instructions.

Returns RunnerSetup.

Arguments:

Query.runnerUsage

Runner usage by runner. Enable the ClickHouse database backend to use this query.

Returns [CiRunnerUsage!].

Arguments:

Query.runnerUsageByProject

Runner usage by project. Enable the ClickHouse database backend to use this query.

Returns [CiRunnerUsageByProject!].

Arguments:

Query.runners

Get all runners in the GitLab instance (project and shared). Access is restricted to users with administrator access.

Returns CiRunnerConnection.

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

Arguments:

Query.secretPermissions

List secret permissions.

Returns SecretPermissionConnection.

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

Arguments:

Query.securityConfiguration

Security configuration for the project.

Returns SecurityConfiguration.

Arguments:

Query.securityScanProfile

Get security scan profile by ID.

Returns ScanProfileType!.

Arguments:

Query.selfManagedAddOnEligibleUsers

Users within the self-managed instance who are eligible for add-ons.

Returns AddOnUserConnection.

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

Arguments:

Query.selfManagedUsersQueuedForRolePromotion

Fields related to users within a self-managed instance that are pending role promotion approval.

Returns UsersQueuedForRolePromotionConnection.

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

Query.snippets

Find Snippets visible to the current user.

Returns SnippetConnection.

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

Arguments:

Query.spdxLicenses

List of SPDX licenses from the SPDX licence catalogue.

Returns [SpdxLicense!].

Query.standardRole

Finds a single default role for the instance. Available only for GitLab Self-Managed.

Returns StandardRole.

Arguments:

Query.standardRoles

Default roles available for the instance. Available only for GitLab Self-Managed.

Returns StandardRoleConnection.

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

Arguments:

Query.subscriptionFutureEntries

Fields related to entries in future subscriptions.

Returns SubscriptionFutureEntryConnection.

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

Query.subscriptionUsage

Usage data of consumables under the subscription.

Returns GitlabSubscriptionUsage.

Arguments:

Query.syntheticNote

Find a synthetic note.

Returns Note.

Arguments:

Query.timelogs

Find timelogs visible to the current user.

Returns TimelogConnection.

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

Arguments:

Query.todo

Retrieve a single to-do item.

Returns Todo.

Arguments:

Query.topics

Find project topics.

Returns TopicConnection.

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

Arguments:

Query.trialUsage

Usage data for trial subscriptions.

Returns GitlabTrialUsage.

Arguments:

Query.usageTrendsMeasurements

Get statistics on the instance.

Returns UsageTrendsMeasurementConnection.

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

Arguments:

Query.user

Find a user.

Returns UserCore.

Arguments:

Query.users

Find users.

Returns UserCoreConnection.

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

Arguments:

Query.virtualRegistriesContainerRegistry

Find a container virtual registry. Returns null if the container_virtual_registries feature flag is disabled.

Returns ContainerRegistryDetails.

Arguments:

Query.virtualRegistriesContainerUpstream

Finds a container upstream registry with details. Returns null if the container_virtual_registries feature flag is disabled.

Returns ContainerUpstreamDetails.

Arguments:

Query.virtualRegistriesPackagesMavenRegistry

Find a Maven virtual registry. Returns null if the maven_virtual_registry feature flag is disabled.

Returns MavenRegistryDetails.

Arguments:

Query.virtualRegistriesPackagesMavenUpstream

Find a Maven upstream registry. Returns null if the maven_virtual_registry feature flag is disabled.

Returns MavenUpstreamDetails.

Arguments:

Query.vulnerabilities

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

Returns VulnerabilityConnection.

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

Arguments:

Query.vulnerabilitiesCountByDay

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

Returns VulnerabilitiesCountByDayConnection.

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

Arguments:

Query.vulnerability

Find a vulnerability.

Returns Vulnerability.

Arguments:

Query.wikiPage

Find a wiki page.

Returns WikiPage.

Arguments:

Query.workItem

Find a work item.

Returns WorkItem.

Arguments:

Query.workItemAllowedStatuses

Allowed work item statuses from the root groups the current user belongs to.

Returns WorkItemStatusConnection.

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

Arguments:

Query.workItemDescriptionTemplateContent

Find a work item description template.

Returns WorkItemDescriptionTemplate.

Arguments:

Query.workItemTypeIconDefinitions

Available icon definitions for work item types.

Returns [WorkItemTypeIconDefinition!]!.

Query.workItemsByReference

Find work items by their reference.

Returns WorkItemConnection.

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

Arguments:

Query.workspace

Find a workspace.

Returns Workspace.

Arguments:

Query.workspaces

Find workspaces across the entire instance. This field is only available to instance admins, it will return an empty result for all non-admins.

Returns WorkspaceConnection.

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

Arguments:

Mutation type

The Mutation type contains all the mutations you can execute.

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

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

For example:

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

Mutation.achievementsAward

Input type: AchievementsAwardInput

Arguments:

Fields:

Mutation.achievementsCreate

Input type: AchievementsCreateInput

Arguments:

Fields:

Mutation.achievementsDelete

Input type: AchievementsDeleteInput

Arguments:

Fields:

Mutation.achievementsRevoke

Input type: AchievementsRevokeInput

Arguments:

Fields:

Mutation.achievementsUpdate

Input type: AchievementsUpdateInput

Arguments:

Fields: