Open Connector
All tools

GitLab logoGitLab

Connect to GitLab.com or GitLab Self-Managed to access the GitLab REST API.

gitlabvcatalog-v11695 tools

Authentication

MethodKindStatusDetails
OAuth 2.0oauth2available
Personal access tokenapi_keyavailable

Call a tool

import { createClient } from "@open-connector/sdk";const oc = createClient({  baseUrl: "https://api.openconnector.dev",  apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await oc.executeTool({  slug: "GITLAB_DELETE_API_V4_ADMIN_ACTIVE_CONTEXT_DEAD_QUEUE",  connectedAccountId: "conn_...",  arguments: { /* match this tool's input schema */ },});
import Composio from "@composio/client";const composio = new Composio({  baseURL: "https://api.openconnector.dev/composio",  apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await composio.tools.execute("GITLAB_DELETE_API_V4_ADMIN_ACTIVE_CONTEXT_DEAD_QUEUE", {  connected_account_id: "conn_...",  arguments: { /* match this tool's input schema */ },});
oc tools execute GITLAB_DELETE_API_V4_ADMIN_ACTIVE_CONTEXT_DEAD_QUEUE --data '{ }'

Tool catalog

Available tools

1695 callable operations

Clear the ActiveContext dead queueGITLAB_DELETE_API_V4_ADMIN_ACTIVE_CONTEXT_DEAD_QUEUEClear the ActiveContext dead queue

Clear the ActiveContext dead queue

Authentication

Connected account required

Tags

Active context
Delete instance variableGITLAB_DELETE_API_V4_ADMIN_CI_VARIABLES_KEYDeletes a specified instance variable.

Deletes a specified instance variable.

Authentication

Connected account required

Tags

CI variables
Delete instance clusterGITLAB_DELETE_API_V4_ADMIN_CLUSTERS_CLUSTER_IDDeletes an existing instance cluster. Does not remove existing resources in the connected Kubernetes cluster.

Deletes an existing instance cluster. Does not remove existing resources in the connected Kubernetes cluster.

Authentication

Connected account required

Tags

Clusters
Disable a namespace for Knowledge GraphGITLAB_DELETE_API_V4_ADMIN_KNOWLEDGE_GRAPH_NAMESPACES_IDThis endpoint disables Knowledge Graph for a specific namespace

This endpoint disables Knowledge Graph for a specific namespace

Authentication

Connected account required

Tags

Knowledge graph
Delete Admin RoleGITLAB_DELETE_API_V4_ADMIN_MEMBER_ROLES_MEMBER_ROLE_IDDelete Admin Role

Delete Admin Role

Authentication

Connected account required

Tags

Member roles
Delete jobs from a Sidekiq queueGITLAB_DELETE_API_V4_ADMIN_SIDEKIQ_QUEUES_QUEUE_NAMEDeletes jobs from a Sidekiq queue that match the specified metadata.

Deletes jobs from a Sidekiq queue that match the specified metadata.

Authentication

Connected account required

Tags

Sidekiq
Remove a namespace from a node for Zoekt indexingGITLAB_DELETE_API_V4_ADMIN_ZOEKT_SHARDS_NODE_ID_INDEXED_NAMESPACES_NAMESPACE_IDRemove a namespace from a node for Zoekt indexing

Remove a namespace from a node for Zoekt indexing

Authentication

Connected account required

Tags

Code search
Delete a registered flow callback endpointGITLAB_DELETE_API_V4_AI_DUO_WORKFLOWS_FLOW_CALLBACKS_IDDeletes a registered flow callback endpoint so it no longer receives deliveries.

Deletes a registered flow callback endpoint so it no longer receives deliveries.

Authentication

Connected account required

Tags

Duo workflow flow callback hooks
Delete an applicationGITLAB_DELETE_API_V4_APPLICATIONS_IDDelete a specific application

Delete a specific application

Authentication

Connected account required

Tags

Applications
Delete a broadcast messageGITLAB_DELETE_API_V4_BROADCAST_MESSAGES_IDDeletes a specified broadcast message.

Deletes a specified broadcast message.

Authentication

Connected account required

Tags

Broadcast messages
Clear a variant assignment for an experiment contextGITLAB_DELETE_API_V4_EXPERIMENTS_EXPERIMENT_NAME_ASSIGNMENTSRemoves the cached variant assignment for the given experiment and context, returning the actor to normal rollout assignment. Defaults to current user if no context is provided.

Removes the cached variant assignment for the given experiment and context, returning the actor to normal rollout assignment. Defaults to current user if no context is provided.

Authentication

Connected account required

Tags

Experiments
Delete cached assignments for an experimentGITLAB_DELETE_API_V4_EXPERIMENTS_NAME_CACHERemoves all cached variant assignments for the experiment with the given cache key. Useful for cleaning up completed experiments whose code has been removed from the codebase.

Removes all cached variant assignments for the experiment with the given cache key. Useful for cleaning up completed experiments whose code has been removed from the codebase.

Authentication

Connected account required

Tags

Experiments
Delete a featureGITLAB_DELETE_API_V4_FEATURES_NAMEDeletes a feature gate. Returns the same response if the feature gate does not exist.

Deletes a feature gate. Returns the same response if the feature gate does not exist.

Authentication

Connected account required

Tags

Features
Delete a Geo nodeGITLAB_DELETE_API_V4_GEO_NODES_IDDeletes a specified Geo node.

Deletes a specified Geo node.

Authentication

Connected account required

Tags

Geo
Delete a Geo siteGITLAB_DELETE_API_V4_GEO_SITES_IDDeletes a specified Geo site.

Deletes a specified Geo site.

Authentication

Connected account required

Tags

Geo
Schedule a group for deletionGITLAB_DELETE_API_V4_GROUPS_IDSchedules a group for deletion. Groups are deleted at the end of the retention period (30 days by default). Use the `permanently_remove` param to override the retention period.

Schedules a group for deletion. Groups are deleted at the end of the retention period (30 days by default). Use the `permanently_remove` param to override the retention period.

Authentication

Connected account required

Tags

Groups
Deny an access requestGITLAB_DELETE_API_V4_GROUPS_ID_ACCESS_REQUESTS_USER_IDDenies an access request for a specified user in a group.

Denies an access request for a specified user in a group.

Authentication

Connected account required

Tags

Access requests
Revoke a group access tokenGITLAB_DELETE_API_V4_GROUPS_ID_ACCESS_TOKENS_TOKEN_IDRevokes a specified group access token.

Revokes a specified group access token.

Authentication

Connected account required

Tags

Access tokens
Delete a badge from a groupGITLAB_DELETE_API_V4_GROUPS_ID_BADGES_BADGE_IDDeletes a specified badge from a group.

Deletes a specified badge from a group.

Authentication

Connected account required

Tags

Badges
Remove a billable member from a groupGITLAB_DELETE_API_V4_GROUPS_ID_BILLABLE_MEMBERS_USER_IDRemoves a specified billable member from a group and its subgroups and projects. The user does not need to be a group member to qualify for removal. For example, if the user was added directly to a project in the group, you can still remove them using this operation.

Removes a specified billable member from a group and its subgroups and projects. The user does not need to be a group member to qualify for removal. For example, if the user was added directly to a project in the group, you can still remove them using this operation.

Authentication

Connected account required

Tags

Members
Delete a group issue boardGITLAB_DELETE_API_V4_GROUPS_ID_BOARDS_BOARD_IDDeletes a specified group issue board.

Deletes a specified group issue board.

Authentication

Connected account required

Tags

Boards
Delete a group issue board listGITLAB_DELETE_API_V4_GROUPS_ID_BOARDS_BOARD_ID_LISTS_LIST_IDDeletes a specified group issue board list. Only for administrators and users with the Owner role for the group.

Deletes a specified group issue board list. Only for administrators and users with the Owner role for the group.

Authentication

Connected account required

Tags

Boards
Delete a group clusterGITLAB_DELETE_API_V4_GROUPS_ID_CLUSTERS_CLUSTER_IDDeletes a specified group cluster. Does not remove existing resources in the connected Kubernetes cluster.

Deletes a specified group cluster. Does not remove existing resources in the connected Kubernetes cluster.

Authentication

Connected account required

Tags

Clusters
Delete a custom attribute for a groupGITLAB_DELETE_API_V4_GROUPS_ID_CUSTOM_ATTRIBUTES_KEYDeletes a specified custom attribute for a group.

Deletes a specified custom attribute for a group.

Authentication

Connected account required

Tags

Custom attributes
Delete a Debian group distributionGITLAB_DELETE_API_V4_GROUPS_ID_DASH_DEBIAN_DISTRIBUTIONS_CODENAMEDeletes a specified Debian group distribution for a group.

Deletes a specified Debian group distribution for a group.

Authentication

Connected account required

Tags

Packages: Debian
Destroy an epicGITLAB_DELETE_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IIDDeletes an epic

Deletes an epic

Authentication

Connected account required

Tags

Epics
Remove epics relationGITLAB_DELETE_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IID_EPICS_CHILD_EPIC_IDRemove epics relation

Remove epics relation

Authentication

Connected account required

Tags

Epics
Remove an issue from the epicGITLAB_DELETE_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IID_ISSUES_EPIC_ISSUE_IDRemoves an issue from the epic. Does not delete the issue.

Removes an issue from the epic. Does not delete the issue.

Authentication

Connected account required

Tags

Epics
Purge the dependency proxy for a groupGITLAB_DELETE_API_V4_GROUPS_ID_DEPENDENCY_PROXY_CACHEPurges the dependency proxy for a specified group and schedules the cached manifests and blobs for deletion. This endpoint requires the Owner role for the group.

Purges the dependency proxy for a specified group and schedules the cached manifests and blobs for deletion. This endpoint requires the Owner role for the group.

Authentication

Connected account required

Tags

Dependency proxy
Delete a group deploy tokenGITLAB_DELETE_API_V4_GROUPS_ID_DEPLOY_TOKENS_TOKEN_IDDeletes a group deploy token.

Deletes a group deploy token.

Authentication

Connected account required

Tags

Deploy resources
Delete an enterprise userGITLAB_DELETE_API_V4_GROUPS_ID_ENTERPRISE_USERS_USER_IDDeletes a specified enterprise user.

Deletes a specified enterprise user.

Authentication

Connected account required

Tags

Enterprise users
Delete an emoji reaction from an epicGITLAB_DELETE_API_V4_GROUPS_ID_EPICS_EPIC_IID_AWARD_EMOJI_AWARD_IDDeletes a specified emoji reaction from an epic. Only an administrator or the user who added the reaction can delete it.

Deletes a specified emoji reaction from an epic. Only an administrator or the user who added the reaction can delete it.

Authentication

Connected account required

Tags

Award emoji
Delete an emoji reaction from an epic commentGITLAB_DELETE_API_V4_GROUPS_ID_EPICS_EPIC_IID_NOTES_NOTE_ID_AWARD_EMOJI_AWARD_IDDeletes a specified emoji reaction from a comment on an epic. Only an administrator or the user who added the reaction can delete it.

Deletes a specified emoji reaction from a comment on an epic. Only an administrator or the user who added the reaction can delete it.

Authentication

Connected account required

Tags

Award emoji
Delete a related epic linkGITLAB_DELETE_API_V4_GROUPS_ID_EPICS_EPIC_IID_RELATED_EPICS_RELATED_EPIC_LINK_IDDeletes a two-way relation between two specified epics. The user must have the Guest, Planner, Reporter, Developer, Maintainer, or Owner role for both groups.

Deletes a two-way relation between two specified epics. The user must have the Guest, Planner, Reporter, Developer, Maintainer, or Owner role for both groups.

Authentication

Connected account required

Tags

Epics
Delete a comment from an epic discussionGITLAB_DELETE_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDDeletes a specified comment from a epic discussion.

Deletes a specified comment from a epic discussion.

Authentication

Connected account required

Tags

Discussions
Delete an epic noteGITLAB_DELETE_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_NOTES_NOTE_IDDeletes a specified note from an epic.

Deletes a specified note from an epic.

Authentication

Connected account required

Tags

Notes
Delete a group hookGITLAB_DELETE_API_V4_GROUPS_ID_HOOKS_HOOK_IDDeletes a hook from a group. This is an idempotent method and can be called multiple times. Either the hook is available or not.

Deletes a hook from a group. This is an idempotent method and can be called multiple times. Either the hook is available or not.

Authentication

Connected account required

Tags

Hooks
Delete a custom headerGITLAB_DELETE_API_V4_GROUPS_ID_HOOKS_HOOK_ID_CUSTOM_HEADERS_KEYDeletes a custom header from a specified webhook.

Deletes a custom header from a specified webhook.

Authentication

Connected account required

Tags

Hooks
Delete a URL variableGITLAB_DELETE_API_V4_GROUPS_ID_HOOKS_HOOK_ID_URL_VARIABLES_KEYDeletes a URL variable from a specified webhook.

Deletes a URL variable from a specified webhook.

Authentication

Connected account required

Tags

Hooks
Disable an integrationGITLAB_DELETE_API_V4_GROUPS_ID_INTEGRATIONS_SLUGDisables a specified integration. Integration settings are preserved.

Disables a specified integration. Integration settings are preserved.

Authentication

Connected account required

Tags

Integrations
Delete an invitation to a groupGITLAB_DELETE_API_V4_GROUPS_ID_INVITATIONS_EMAILDeletes a pending invitation to a specified email address for a group.

Deletes a pending invitation to a specified email address for a group.

Authentication

Connected account required

Tags

Invitations
Delete a group labelGITLAB_DELETE_API_V4_GROUPS_ID_LABELSDeletes a specified group label.

Deletes a specified group label.

Authentication

Connected account required

Tags

Labels
Delete a group labelGITLAB_DELETE_API_V4_GROUPS_ID_LABELS_NAMEDeletes a specified group label.

Deletes a specified group label.

Authentication

Connected account required

Tags

Labels
Delete an LDAP group link with CN or filterGITLAB_DELETE_API_V4_GROUPS_ID_LDAP_GROUP_LINKSDeletes an LDAP group link using a CN or filter.Deleting by filter is only supported in the Premium tier and above.

Deletes an LDAP group link using a CN or filter.Deleting by filter is only supported in the Premium tier and above.

Authentication

Connected account required

Tags

LDAP
Delete LDAP group linkGITLAB_DELETE_API_V4_GROUPS_ID_LDAP_GROUP_LINKS_CNDeletes an LDAP group link. Deprecated. Scheduled for removal in a future release.

Deletes an LDAP group link. Deprecated. Scheduled for removal in a future release.

Authentication

Connected account required

Tags

LDAP
Delete LDAP group linkGITLAB_DELETE_API_V4_GROUPS_ID_LDAP_GROUP_LINKS_PROVIDER_CNDeletes an LDAP group link for a specific LDAP provider.Deprecated. Scheduled for removal in a future release.

Deletes an LDAP group link for a specific LDAP provider.Deprecated. Scheduled for removal in a future release.

Authentication

Connected account required

Tags

LDAP
Revoke a personal access token for an enterprise userGITLAB_DELETE_API_V4_GROUPS_ID_MANAGE_PERSONAL_ACCESS_TOKENS_PAT_IDRevokes a specified personal access token for an enterprise user.

Revokes a specified personal access token for an enterprise user.

Authentication

Connected account required

Tags

Group credentials inventory
Revoke a group or project access token for a groupGITLAB_DELETE_API_V4_GROUPS_ID_MANAGE_RESOURCE_ACCESS_TOKENS_PRAT_IDRevokes a specified group or project access token associated with a top-level group.

Revokes a specified group or project access token associated with a top-level group.

Authentication

Connected account required

Tags

Group credentials inventory
Delete an SSH key for an enterprise userGITLAB_DELETE_API_V4_GROUPS_ID_MANAGE_SSH_KEYS_KEY_IDDeletes a specified SSH public key for an enterprise user associated with the top-level group.

Deletes a specified SSH public key for an enterprise user associated with the top-level group.

Authentication

Connected account required

Tags

Group credentials inventory
Remove member role of a groupGITLAB_DELETE_API_V4_GROUPS_ID_MEMBER_ROLES_MEMBER_ROLE_IDRemoves a specified member role from a group.

Removes a specified member role from a group.

Authentication

Connected account required

Tags

Member roles
Remove a member from a groupGITLAB_DELETE_API_V4_GROUPS_ID_MEMBERS_USER_IDRemoves a specified user from a group. The user must be a direct member.

Removes a specified user from a group. The user must be a direct member.

Authentication

Connected account required

Tags

Members
Remove an LDAP access level overrideGITLAB_DELETE_API_V4_GROUPS_ID_MEMBERS_USER_ID_OVERRIDERemoves an LDAP access level override for a member of a group.

Removes an LDAP access level override for a member of a group.

Authentication

Connected account required

Tags

Members
Delete a group milestoneGITLAB_DELETE_API_V4_GROUPS_ID_MILESTONES_MILESTONE_IDDeletes the specified group milestone.

Deletes the specified group milestone.

Authentication

Connected account required

Tags

Milestones
Unprotect repository branchesGITLAB_DELETE_API_V4_GROUPS_ID_PROTECTED_BRANCHES_NAMEUnprotects a specified protected branch Unprotect multiple branches by using a wildcard in the `name`.

Unprotects a specified protected branch Unprotect multiple branches by using a wildcard in the `name`.

Authentication

Connected account required

Tags

Protected branches
Unprotect a group environmentGITLAB_DELETE_API_V4_GROUPS_ID_PROTECTED_ENVIRONMENTS_NAMEUnprotects a specified protected environment for a group.

Unprotects a specified protected environment for a group.

Authentication

Connected account required

Tags

Protected environments
Delete the push rules of a groupGITLAB_DELETE_API_V4_GROUPS_ID_PUSH_RULEDeletes all the push rules of a specified group.

Deletes all the push rules of a specified group.

Authentication

Connected account required

Tags

Push rules
Delete SAML group linkGITLAB_DELETE_API_V4_GROUPS_ID_SAML_GROUP_LINKS_SAML_GROUP_NAMEDeletes a SAML group link for the group

Deletes a SAML group link for the group

Authentication

Connected account required

Tags

SAML group links
Delete a SAML identityGITLAB_DELETE_API_V4_GROUPS_ID_SAML_UIDDeletes a specified SAML identity.

Deletes a specified SAML identity.

Authentication

Connected account required

Tags

Provider identities
Delete a SCIM identityGITLAB_DELETE_API_V4_GROUPS_ID_SCIM_UIDDeletes a specified SCIM identity.

Deletes a specified SCIM identity.

Authentication

Connected account required

Tags

Provider identities
Delete a group service accountGITLAB_DELETE_API_V4_GROUPS_ID_SERVICE_ACCOUNTS_USER_IDDeletes a specified group service account. Available only for group Owners and administrators.

Deletes a specified group service account. Available only for group Owners and administrators.

Authentication

Connected account required

Tags

Service accounts
Revoke a personal access token for a group service accountGITLAB_DELETE_API_V4_GROUPS_ID_SERVICE_ACCOUNTS_USER_ID_PERSONAL_ACCESS_TOKENS_TOKEN_IDRevokes a specified personal access token for a group service account.

Revokes a specified personal access token for a group service account.

Authentication

Connected account required

Tags

Access tokensService accounts
Remove a group from a groupGITLAB_DELETE_API_V4_GROUPS_ID_SHARE_GROUP_IDRemoves a group from a group.

Removes a group from a group.

Authentication

Connected account required

Tags

Groups
Remove a shared project from a groupGITLAB_DELETE_API_V4_GROUPS_ID_SHARED_PROJECTS_PROJECT_IDRemoves a shared project targeting this group. The group Owner can remove a shared project without access to the source project.

Removes a shared project targeting this group. The group Owner can remove a shared project without access to the source project.

Authentication

Connected account required

Tags

Groups
Delete a group SSH certificateGITLAB_DELETE_API_V4_GROUPS_ID_SSH_CERTIFICATES_SSH_CERTIFICATES_IDDeletes a specified group SSH certificate.

Deletes a specified group SSH certificate.

Authentication

Connected account required

Tags

Keys
Delete an uploaded file by secret and filenameGITLAB_DELETE_API_V4_GROUPS_ID_UPLOADS_SECRET_FILENAMEDeletes an uploaded file with a specified secret and filename. You must have the Maintainer or Owner role for the group.

Deletes an uploaded file with a specified secret and filename. You must have the Maintainer or Owner role for the group.

Authentication

Connected account required

Tags

Groups
Delete an uploaded file by IDGITLAB_DELETE_API_V4_GROUPS_ID_UPLOADS_UPLOAD_IDDeletes an uploaded file with a specified ID. You must have the Maintainer or Owner role for the group.

Deletes an uploaded file with a specified ID. You must have the Maintainer or Owner role for the group.

Authentication

Connected account required

Tags

Groups
Delete a group variableGITLAB_DELETE_API_V4_GROUPS_ID_VARIABLES_KEYDeletes a specified group variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Deletes a specified group variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Authentication

Connected account required

Tags

CI variables
Delete a wiki page meta noteGITLAB_DELETE_API_V4_GROUPS_ID_WIKI_PAGES_NOTEABLE_ID_NOTES_NOTE_IDDeletes a specified note from a wiki page meta.

Deletes a specified note from a wiki page meta.

Authentication

Connected account required

Tags

Notes
Delete a wiki page for a groupGITLAB_DELETE_API_V4_GROUPS_ID_WIKIS_SLUGDeletes a specified wiki page from a group.

Deletes a specified wiki page from a group.

Authentication

Connected account required

Tags

Wikis
Delete a system hookGITLAB_DELETE_API_V4_HOOKS_HOOK_IDDeletes a specified system hook. Administrators only.

Deletes a specified system hook. Administrators only.

Authentication

Connected account required

Tags

Hooks
Delete a custom headerGITLAB_DELETE_API_V4_HOOKS_HOOK_ID_CUSTOM_HEADERS_KEYDeletes a custom header from a specified webhook.

Deletes a custom header from a specified webhook.

Authentication

Connected account required

Tags

Hooks
Delete a URL variableGITLAB_DELETE_API_V4_HOOKS_HOOK_ID_URL_VARIABLES_KEYDeletes a URL variable from a specified webhook.

Deletes a URL variable from a specified webhook.

Authentication

Connected account required

Tags

Hooks
Delete a GitLab for Jira (Forge) namespace subscriptionGITLAB_DELETE_API_V4_INTEGRATIONS_JIRA_FORGE_SUBSCRIPTIONS_IDUnsubscribes a GitLab namespace from the Forge installation.

Unsubscribes a GitLab namespace from the Forge installation.

Authentication

Connected account required

Tags

Jira forge subscriptions
Delete a licenseGITLAB_DELETE_API_V4_LICENSE_IDDeletes a specified license.

Deletes a specified license.

Authentication

Connected account required

Tags

Licenses
Delete an instance member roleGITLAB_DELETE_API_V4_MEMBER_ROLES_MEMBER_ROLE_IDDeletes an instance member role.

Deletes an instance member role.

Authentication

Connected account required

Tags

Member roles
Removes a storage limit exclusion for a NamespaceGITLAB_DELETE_API_V4_NAMESPACES_ID_STORAGE_LIMIT_EXCLUSIONRemoves a Namespaces::Storage::LimitExclusion

Removes a Namespaces::Storage::LimitExclusion

Authentication

Connected account required

Tags

Namespaces
Soft-delete an organizationGITLAB_DELETE_API_V4_ORGANIZATIONS_IDThis feature was introduced in GitLab 19.2.

This feature was introduced in GitLab 19.2.

Authentication

Connected account required

Tags

Organizations
Delete a recipe and packageGITLAB_DELETE_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNELDeletes a specified Conan recipe and associated package files from the package registry.

Deletes a specified Conan recipe and associated package files from the package registry.

Authentication

Connected account required

Tags

Packages: Conan
Revoke a personal access tokenGITLAB_DELETE_API_V4_PERSONAL_ACCESS_TOKENS_IDRevokes a specified personal access token. Administrators can revoke tokens for any user. Non-administrators can only revoke their own tokens.

Revokes a specified personal access token. Administrators can revoke tokens for any user. Non-administrators can only revoke their own tokens.

Authentication

Connected account required

Tags

Access tokens
Revoke a personal access tokenGITLAB_DELETE_API_V4_PERSONAL_ACCESS_TOKENS_SELFRevokes a personal access token by passing it to the API in a header.

Revokes a personal access token by passing it to the API in a header.

Authentication

Connected account required

Tags

Access tokens
Delete a project aliasGITLAB_DELETE_API_V4_PROJECT_ALIASES_NAMEDeletes a specified project alias. Administrators only.

Deletes a specified project alias. Administrators only.

Authentication

Connected account required

Tags

Project alias
Delete a projectGITLAB_DELETE_API_V4_PROJECTS_IDDeletes a specified project.

Deletes a specified project.

Authentication

Connected account required

Tags

Projects
Deny an access requestGITLAB_DELETE_API_V4_PROJECTS_ID_ACCESS_REQUESTS_USER_IDDenies an access request for a specified user in a project.

Denies an access request for a specified user in a project.

Authentication

Connected account required

Tags

Access requests
Revoke a project access tokenGITLAB_DELETE_API_V4_PROJECTS_ID_ACCESS_TOKENS_TOKEN_IDRevokes a specified project access token.

Revokes a specified project access token.

Authentication

Connected account required

Tags

Access tokens
Delete a metric imageGITLAB_DELETE_API_V4_PROJECTS_ID_ALERT_MANAGEMENT_ALERTS_ALERT_IID_METRIC_IMAGES_METRIC_IMAGE_IDDeletes a specified metric image for an alert.

Deletes a specified metric image for an alert.

Authentication

Connected account required

Tags

Alert management
Delete an approval rule for a projectGITLAB_DELETE_API_V4_PROJECTS_ID_APPROVAL_RULES_APPROVAL_RULE_IDDeletes an approval rule for a specified project.

Deletes an approval rule for a specified project.

Authentication

Connected account required

Tags

Approval rules
Delete an approval ruleGITLAB_DELETE_API_V4_PROJECTS_ID_APPROVAL_SETTINGS_RULES_APPROVAL_RULE_IDPrivate API subject to change

Private API subject to change

Authentication

Connected account required

Tags

Approval rules
Delete all job artifacts in a projectGITLAB_DELETE_API_V4_PROJECTS_ID_ARTIFACTSDeletes job artifacts from all jobs in a specified project.

Deletes job artifacts from all jobs in a specified project.

Authentication

Connected account required

Tags

Job artifacts
Delete a badge from a projectGITLAB_DELETE_API_V4_PROJECTS_ID_BADGES_BADGE_IDDeletes a specified badge from a project.

Deletes a specified badge from a project.

Authentication

Connected account required

Tags

Badges
Delete an issue boardGITLAB_DELETE_API_V4_PROJECTS_ID_BOARDS_BOARD_IDDeletes a specified issue board in a project.

Deletes a specified issue board in a project.

Authentication

Connected account required

Tags

Boards
Delete a list from an issue boardGITLAB_DELETE_API_V4_PROJECTS_ID_BOARDS_BOARD_ID_LISTS_LIST_IDDeletes a specified list from an issue board.

Deletes a specified list from an issue board.

Authentication

Connected account required

Tags

Boards
Delete an agentGITLAB_DELETE_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_IDDeletes an existing agent registration. You must have the Maintainer or Owner role to use this endpoint.

Deletes an existing agent registration. You must have the Maintainer or Owner role to use this endpoint.

Authentication

Connected account required

Tags

Cluster agents
Revoke an agent tokenGITLAB_DELETE_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_ID_TOKENS_TOKEN_IDRevokes an agent token. You must have the Maintainer or Owner role to use this endpoint.

Revokes an agent token. You must have the Maintainer or Owner role to use this endpoint.

Authentication

Connected account required

Tags

Cluster agents
Delete an agent URL configurationGITLAB_DELETE_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_ID_URL_CONFIGURATIONS_URL_CONFIGURATION_IDDeletes an agent URL configuration. You must have the Maintainer or Owner role to use this endpoint. This feature was introduced in GitLab 17.4.

Deletes an agent URL configuration. You must have the Maintainer or Owner role to use this endpoint. This feature was introduced in GitLab 17.4.

Authentication

Connected account required

Tags

Cluster agents
Delete cluster from a projectGITLAB_DELETE_API_V4_PROJECTS_ID_CLUSTERS_CLUSTER_IDDeletes a specified cluster from a project. Does not remove existing resources in the connected Kubernetes cluster.

Deletes a specified cluster from a project. Does not remove existing resources in the connected Kubernetes cluster.

Authentication

Connected account required

Tags

Clusters
Delete a custom attribute for a projectGITLAB_DELETE_API_V4_PROJECTS_ID_CUSTOM_ATTRIBUTES_KEYDeletes a specified custom attribute for a project.

Deletes a specified custom attribute for a project.

Authentication

Connected account required

Tags

Custom attributes
Delete a Debian project distributionGITLAB_DELETE_API_V4_PROJECTS_ID_DEBIAN_DISTRIBUTIONS_CODENAMEDeletes a specified Debian project distribution for a project.

Deletes a specified Debian project distribution for a project.

Authentication

Connected account required

Tags

Packages: Debian
Delete a deploy keyGITLAB_DELETE_API_V4_PROJECTS_ID_DEPLOY_KEYS_KEY_IDDeletes a deploy key from the project. If the deploy key is used only for this project, it is deleted from the system.

Deletes a deploy key from the project. If the deploy key is used only for this project, it is deleted from the system.

Authentication

Connected account required

Tags

Deploy resources
Delete a project deploy tokenGITLAB_DELETE_API_V4_PROJECTS_ID_DEPLOY_TOKENS_TOKEN_IDDeletes a project deploy token.

Deletes a project deploy token.

Authentication

Connected account required

Tags

Deploy resources
Delete a deploymentGITLAB_DELETE_API_V4_PROJECTS_ID_DEPLOYMENTS_DEPLOYMENT_IDDeletes a specified deployment that is not currently the last deployment for an environment or in a `running` state.

Deletes a specified deployment that is not currently the last deployment for an environment or in a `running` state.

Authentication

Connected account required

Tags

Deploy resources
Delete an environmentGITLAB_DELETE_API_V4_PROJECTS_ID_ENVIRONMENTS_ENVIRONMENT_IDDeletes an environment from a project. The environment must be stopped first.

Deletes an environment from a project. The environment must be stopped first.

Authentication

Connected account required

Tags

Environments
Schedule multiple stopped review apps for deletionGITLAB_DELETE_API_V4_PROJECTS_ID_ENVIRONMENTS_REVIEW_APPSSchedules multiple stopped review apps for deletion. The deletion is performed after 1 week. By default, only environments 30 days or older are deleted.

Schedules multiple stopped review apps for deletion. The deletion is performed after 1 week. By default, only environments 30 days or older are deleted.

Authentication

Connected account required

Tags

Environments
Delete a client keyGITLAB_DELETE_API_V4_PROJECTS_ID_ERROR_TRACKING_CLIENT_KEYS_KEY_IDDeletes an integrated error tracking client key from a specified project.

Deletes an integrated error tracking client key from a specified project.

Authentication

Connected account required

Tags

Error tracking
Delete external status check serviceGITLAB_DELETE_API_V4_PROJECTS_ID_EXTERNAL_STATUS_CHECKS_CHECK_IDDeletes a specified external status check service for a project.

Deletes a specified external status check service for a project.

Authentication

Connected account required

Tags

External status checks
Delete a feature flagGITLAB_DELETE_API_V4_PROJECTS_ID_FEATURE_FLAGS_FEATURE_FLAG_NAMEDeletes a specified feature flag.

Deletes a specified feature flag.

Authentication

Connected account required

Tags

Feature flags
Delete feature flag user listGITLAB_DELETE_API_V4_PROJECTS_ID_FEATURE_FLAGS_USER_LISTS_IIDDeletes a specified feature flag user list.

Deletes a specified feature flag user list.

Authentication

Connected account required

Tags

Feature flags
Delete a fork relationshipGITLAB_DELETE_API_V4_PROJECTS_ID_FORKDeletes a fork relationship between projects.

Deletes a fork relationship between projects.

Authentication

Connected account required

Tags

Projects
Delete a freeze periodGITLAB_DELETE_API_V4_PROJECTS_ID_FREEZE_PERIODS_FREEZE_PERIOD_IDDeletes a freeze period for a specified `freeze_period_id`. You must have the Maintainer or Owner role for the project.

Deletes a freeze period for a specified `freeze_period_id`. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Freeze periods
Delete a project webhookGITLAB_DELETE_API_V4_PROJECTS_ID_HOOKS_HOOK_IDDeletes a specified webhook for a project.

Deletes a specified webhook for a project.

Authentication

Connected account required

Tags

Hooks
Delete a custom headerGITLAB_DELETE_API_V4_PROJECTS_ID_HOOKS_HOOK_ID_CUSTOM_HEADERS_KEYDeletes a custom header from a specified webhook.

Deletes a custom header from a specified webhook.

Authentication

Connected account required

Tags

Hooks
Delete a URL variableGITLAB_DELETE_API_V4_PROJECTS_ID_HOOKS_HOOK_ID_URL_VARIABLES_KEYDeletes a URL variable from a specified webhook.

Deletes a URL variable from a specified webhook.

Authentication

Connected account required

Tags

Hooks
Disable an integrationGITLAB_DELETE_API_V4_PROJECTS_ID_INTEGRATIONS_SLUGDisables a specified integration. Integration settings are preserved.

Disables a specified integration. Integration settings are preserved.

Authentication

Connected account required

Tags

Integrations
Delete an invitation to a projectGITLAB_DELETE_API_V4_PROJECTS_ID_INVITATIONS_EMAILDeletes a pending invitation to a specified email address for a project.

Deletes a pending invitation to a specified email address for a project.

Authentication

Connected account required

Tags

Invitations
Delete an issueGITLAB_DELETE_API_V4_PROJECTS_ID_ISSUES_ISSUE_IIDDeletes a specified issue.

Deletes a specified issue.

Authentication

Connected account required

Tags

Projects
Delete an emoji reaction from an issueGITLAB_DELETE_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_AWARD_EMOJI_AWARD_IDDeletes a specified emoji reaction from an issue. Only an administrator or the user who added the reaction can delete it.

Deletes a specified emoji reaction from an issue. Only an administrator or the user who added the reaction can delete it.

Authentication

Connected account required

Tags

Award emoji
Delete an issue linkGITLAB_DELETE_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_LINKS_ISSUE_LINK_IDDeletes a specified issue link, removing the two-way relationship.

Deletes a specified issue link, removing the two-way relationship.

Authentication

Connected account required

Tags

Issues
Delete a metric image from an incidentGITLAB_DELETE_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_METRIC_IMAGES_METRIC_IMAGE_IDDeletes a metric image from an incident.

Deletes a metric image from an incident.

Authentication

Connected account required

Tags

Metric images
Delete an emoji reaction from an issue commentGITLAB_DELETE_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_NOTES_NOTE_ID_AWARD_EMOJI_AWARD_IDDeletes a specified emoji reaction from a comment on an issue. Only an administrator or the user who added the reaction can delete it.

Deletes a specified emoji reaction from a comment on an issue. Only an administrator or the user who added the reaction can delete it.

Authentication

Connected account required

Tags

Award emoji
Delete a comment from an issue discussionGITLAB_DELETE_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDDeletes a specified comment from a issue discussion.

Deletes a specified comment from a issue discussion.

Authentication

Connected account required

Tags

Discussions
Delete an issue noteGITLAB_DELETE_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_NOTES_NOTE_IDDeletes a specified note from an issue.

Deletes a specified note from an issue.

Authentication

Connected account required

Tags

Notes
Delete a project from a CI/CD job token allowlistGITLAB_DELETE_API_V4_PROJECTS_ID_JOB_TOKEN_SCOPE_ALLOWLIST_TARGET_PROJECT_IDDeletes a project from the CI/CD job token allowlist of a specified project.

Deletes a project from the CI/CD job token allowlist of a specified project.

Authentication

Connected account required

Tags

Projects job token scope
Delete a group from a CI/CD job token allowlistGITLAB_DELETE_API_V4_PROJECTS_ID_JOB_TOKEN_SCOPE_GROUPS_ALLOWLIST_TARGET_GROUP_IDDeletes a group from the CI/CD job token allowlist of a specified project.

Deletes a group from the CI/CD job token allowlist of a specified project.

Authentication

Connected account required

Tags

Projects job token scope
Delete job artifactsGITLAB_DELETE_API_V4_PROJECTS_ID_JOBS_JOB_ID_ARTIFACTSDeletes job artifacts from a specified job in a project.

Deletes job artifacts from a specified job in a project.

Authentication

Connected account required

Tags

Job artifacts
Delete an existing labelGITLAB_DELETE_API_V4_PROJECTS_ID_LABELSDeprecated in GitLab 12.4. Use DELETE /projects/:id/labels/:name instead.

Deprecated in GitLab 12.4. Use DELETE /projects/:id/labels/:name instead.

Authentication

Connected account required

Tags

Labels
Delete a project labelGITLAB_DELETE_API_V4_PROJECTS_ID_LABELS_NAMEDeletes a specified label from a project.

Deletes a specified label from a project.

Authentication

Connected account required

Tags

Labels
Delete a software license policyGITLAB_DELETE_API_V4_PROJECTS_ID_MANAGED_LICENSES_MANAGED_LICENSE_IDDeletes a specified software license policy from a project.

Deletes a specified software license policy from a project.

Authentication

Connected account required

Tags

Licenses
Remove a member from a projectGITLAB_DELETE_API_V4_PROJECTS_ID_MEMBERS_USER_IDRemoves a specified user from a project. The user must be a direct member.

Removes a specified user from a project. The user must be a direct member.

Authentication

Connected account required

Tags

Members
Delete a merge requestGITLAB_DELETE_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IIDDeletes a specified merge request for a project. Administrators and project Owners only.

Deletes a specified merge request for a project. Administrators and project Owners only.

Authentication

Connected account required

Tags

Merge requests
Delete an approval rule for a merge requestGITLAB_DELETE_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_APPROVAL_RULES_APPROVAL_RULE_IDDeletes a specified approval rule for a merge request. The `report_approver` or `code_owner` rules are system-generated, and you cannot edit them.

Deletes a specified approval rule for a merge request. The `report_approver` or `code_owner` rules are system-generated, and you cannot edit them.

Authentication

Connected account required

Tags

Merge request approvals
Delete an emoji reaction from a merge requestGITLAB_DELETE_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_AWARD_EMOJI_AWARD_IDDeletes a specified emoji reaction from a merge request. Only an administrator or the user who added the reaction can delete it.

Deletes a specified emoji reaction from a merge request. Only an administrator or the user who added the reaction can delete it.

Authentication

Connected account required

Tags

Award emoji
Remove a merge request dependencyGITLAB_DELETE_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_BLOCKS_BLOCK_IDRemoves a merge request dependency.

Removes a merge request dependency.

Authentication

Connected account required

Tags

Merge requests
Delete context commits from a merge requestGITLAB_DELETE_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_CONTEXT_COMMITSDeletes specified context commits from a merge request.

Deletes specified context commits from a merge request.

Authentication

Connected account required

Tags

Merge requests
Delete a draft noteGITLAB_DELETE_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_DRAFT_NOTES_DRAFT_NOTE_IDDeletes a draft note for a specified merge request.

Deletes a draft note for a specified merge request.

Authentication

Connected account required

Tags

Draft notes
Delete an emoji reaction from a merge request commentGITLAB_DELETE_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_NOTES_NOTE_ID_AWARD_EMOJI_AWARD_IDDeletes a specified emoji reaction from a comment on a merge request. Only an administrator or the user who added the reaction can delete it.

Deletes a specified emoji reaction from a comment on a merge request. Only an administrator or the user who added the reaction can delete it.

Authentication

Connected account required

Tags

Award emoji
Delete a comment from a merge request discussionGITLAB_DELETE_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDDeletes a specified comment from a merge request discussion.

Deletes a specified comment from a merge request discussion.

Authentication

Connected account required

Tags

Discussions
Delete a merge request noteGITLAB_DELETE_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_NOTES_NOTE_IDDeletes a specified note from a merge request.

Deletes a specified note from a merge request.

Authentication

Connected account required

Tags

Notes
Delete a project milestoneGITLAB_DELETE_API_V4_PROJECTS_ID_MILESTONES_MILESTONE_IDDeletes a specified project milestone. Only for users with the Planner, Reporter, Developer, Maintainer, or Owner role for the project.

Deletes a specified project milestone. Only for users with the Planner, Reporter, Developer, Maintainer, or Owner role for the project.

Authentication

Connected account required

Tags

Milestones
Delete a Registered Model by NameGITLAB_DELETE_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_REGISTERED_MODELS_DELETEhttps://mlflow.org/docs/2.19.0/rest-api.html#delete-registeredmodel

https://mlflow.org/docs/2.19.0/rest-api.html#delete-registeredmodel

Authentication

Connected account required

Tags

MLOps
Delete a recipe and packageGITLAB_DELETE_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNELDeletes a specified Conan recipe and associated package files from the package registry.

Deletes a specified Conan recipe and associated package files from the package registry.

Authentication

Connected account required

Tags

Packages: Conan
Delete recipe revisionGITLAB_DELETE_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISIONDeletes a specified recipe revision from the registry. If the recipe revision is the only one, the package is deleted as well. This feature was introduced in GitLab 18.1.

Deletes a specified recipe revision from the registry. If the recipe revision is the only one, the package is deleted as well. This feature was introduced in GitLab 18.1.

Authentication

Connected account required

Tags

Packages: Conan
Delete a package revisionGITLAB_DELETE_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_PACKAGES_CONAN_PACKAGE_REFERENCE_REVISIONS_PACKAGE_REVISIONDeletes a specified package revision from the registry. If the package reference has only one package revision, the package reference is deleted as well. This feature was introduced in GitLab 18.1.

Deletes a specified package revision from the registry. If the package reference has only one package revision, the package reference is deleted as well. This feature was introduced in GitLab 18.1.

Authentication

Connected account required

Tags

Packages: Conan
Delete a project packageGITLAB_DELETE_API_V4_PROJECTS_ID_PACKAGES_PACKAGE_IDDeletes a specified project package.

Deletes a specified project package.

Authentication

Connected account required

Tags

Packages
Delete a package fileGITLAB_DELETE_API_V4_PROJECTS_ID_PACKAGES_PACKAGE_ID_PACKAGE_FILES_PACKAGE_FILE_IDDeletes a specified package file.

Deletes a specified package file.

Authentication

Connected account required

Tags

Packages
Delete a package protection ruleGITLAB_DELETE_API_V4_PROJECTS_ID_PACKAGES_PROTECTION_RULES_PACKAGE_PROTECTION_RULE_IDDeletes a package protection rule from a specified project.

Deletes a package protection rule from a specified project.

Authentication

Connected account required

Tags

Projects
Unpublish PagesGITLAB_DELETE_API_V4_PROJECTS_ID_PAGESUnpublishes Pages from a specified project. You must have the Maintainer or Owner role for the project.

Unpublishes Pages from a specified project. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

GitLab Pages
Delete Pages domainGITLAB_DELETE_API_V4_PROJECTS_ID_PAGES_DOMAINS_DOMAINDeletes a specified Pages domain in a project.

Deletes a specified Pages domain in a project.

Authentication

Connected account required

Tags

GitLab Pages
Delete a pipeline scheduleGITLAB_DELETE_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_IDDeletes a pipeline schedule for a project.

Deletes a pipeline schedule for a project.

Authentication

Connected account required

Tags

Pipeline schedules
Delete a variable for a pipeline scheduleGITLAB_DELETE_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_ID_VARIABLES_KEYDeletes a specified variable for a pipeline schedule.

Deletes a specified variable for a pipeline schedule.

Authentication

Connected account required

Tags

Pipeline schedules
Delete a pipelineGITLAB_DELETE_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_IDDeletes a specified pipeline for a project.

Deletes a specified pipeline for a project.

Authentication

Connected account required

Tags

Pipelines
Unprotect repository branchesGITLAB_DELETE_API_V4_PROJECTS_ID_PROTECTED_BRANCHES_NAMEUnprotects a specified protected branch or wildcard protected branch.

Unprotects a specified protected branch or wildcard protected branch.

Authentication

Connected account required

Tags

Protected branches
Unprotect a protected environment for a projectGITLAB_DELETE_API_V4_PROJECTS_ID_PROTECTED_ENVIRONMENTS_NAMEUnprotects a specified protected environment for a project.

Unprotects a specified protected environment for a project.

Authentication

Connected account required

Tags

Protected environments
Unprotect repository tagsGITLAB_DELETE_API_V4_PROJECTS_ID_PROTECTED_TAGS_NAMEUnprotects a specified protected tag or wildcard protected tag.

Unprotects a specified protected tag or wildcard protected tag.

Authentication

Connected account required

Tags

Protected tags
Delete the push rules of a projectGITLAB_DELETE_API_V4_PROJECTS_ID_PUSH_RULEDeletes all the push rules of a specified project.

Deletes all the push rules of a specified project.

Authentication

Connected account required

Tags

Push rules
Delete a container repository protection ruleGITLAB_DELETE_API_V4_PROJECTS_ID_REGISTRY_PROTECTION_REPOSITORY_RULES_PROTECTION_RULE_IDDeletes a specified container repository protection rule.

Deletes a specified container repository protection rule.

Authentication

Connected account required

Tags

Projects
Delete a container registry protection tag ruleGITLAB_DELETE_API_V4_PROJECTS_ID_REGISTRY_PROTECTION_TAG_RULES_PROTECTION_RULE_IDDeletes a container registry protection tag rule from a project. This feature was introduced in GitLab 18.9.

Deletes a container registry protection tag rule from a project. This feature was introduced in GitLab 18.9.

Authentication

Connected account required

Tags

Projects
Delete registry repositoryGITLAB_DELETE_API_V4_PROJECTS_ID_REGISTRY_REPOSITORIES_REPOSITORY_IDDeletes a specified repository in the registry. This operation is executed asynchronously and might take some time to execute.

Deletes a specified repository in the registry. This operation is executed asynchronously and might take some time to execute.

Authentication

Connected account required

Tags

Container registry
Delete multiple registry repository tagsGITLAB_DELETE_API_V4_PROJECTS_ID_REGISTRY_REPOSITORIES_REPOSITORY_ID_TAGSDeletes multiple registry repository tags based on the specified criteria.

Deletes multiple registry repository tags based on the specified criteria.

Authentication

Connected account required

Tags

Container registry
Delete a registry repository tagGITLAB_DELETE_API_V4_PROJECTS_ID_REGISTRY_REPOSITORIES_REPOSITORY_ID_TAGS_TAG_NAMEDeletes a specified container registry repository tag.

Deletes a specified container registry repository tag.

Authentication

Connected account required

Tags

Container registry
Delete a releaseGITLAB_DELETE_API_V4_PROJECTS_ID_RELEASES_TAG_NAMEDelete a release. Deleting a release doesn't delete the associated tag. Requires at least the Developer role for the project. This feature was introduced in GitLab 11.7.

Delete a release. Deleting a release doesn't delete the associated tag. Requires at least the Developer role for the project. This feature was introduced in GitLab 11.7.

Authentication

Connected account required

Tags

Releases
Delete a release linkGITLAB_DELETE_API_V4_PROJECTS_ID_RELEASES_TAG_NAME_ASSETS_LINKS_LINK_IDDeletes a specified asset link from a release.

Deletes a specified asset link from a release.

Authentication

Connected account required

Tags

Releases
Delete a remote mirror from a projectGITLAB_DELETE_API_V4_PROJECTS_ID_REMOTE_MIRRORS_MIRROR_IDDeletes a specified remote mirror from a project.

Deletes a specified remote mirror from a project.

Authentication

Connected account required

Tags

Remote mirrors
Delete a repository branchGITLAB_DELETE_API_V4_PROJECTS_ID_REPOSITORY_BRANCHES_BRANCHDeletes a specified branch from the repository.

Deletes a specified branch from the repository.

Authentication

Connected account required

Tags

Branches
Delete a comment from a commit discussionGITLAB_DELETE_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDDeletes a specified comment from a commit discussion.

Deletes a specified comment from a commit discussion.

Authentication

Connected account required

Tags

Discussions
Delete a file in a repositoryGITLAB_DELETE_API_V4_PROJECTS_ID_REPOSITORY_FILES_FILE_PATHDeletes a specified file in a repository. Use the Commits API to delete multiple files with a single request.

Deletes a specified file in a repository. Use the Commits API to delete multiple files with a single request.

Authentication

Connected account required

Tags

Files
Delete all merged branchesGITLAB_DELETE_API_V4_PROJECTS_ID_REPOSITORY_MERGED_BRANCHESDeletes all branches that are merged into the default branch for a project.

Deletes all branches that are merged into the default branch for a project.

Authentication

Connected account required

Tags

Branches
Delete a tagGITLAB_DELETE_API_V4_PROJECTS_ID_REPOSITORY_TAGS_TAG_NAMEDeletes a specified repository tag.

Deletes a specified repository tag.

Authentication

Connected account required

Tags

Tags
Unassign a runner from a projectGITLAB_DELETE_API_V4_PROJECTS_ID_RUNNERS_RUNNER_IDUnassigns a specified project runner from a project. You cannot unassign a runner from the owner project. Use the delete a runner operation instead.

Unassigns a specified project runner from a project. You cannot unassign a runner from the owner project. Use the delete a runner operation instead.

Authentication

Connected account required

Tags

RunnersProjects
Delete a secure fileGITLAB_DELETE_API_V4_PROJECTS_ID_SECURE_FILES_SECURE_FILE_IDDeletes a specified secure file from a project.

Deletes a specified secure file from a project.

Authentication

Connected account required

Tags

Secure files
Delete a project service accountGITLAB_DELETE_API_V4_PROJECTS_ID_SERVICE_ACCOUNTS_USER_IDDeletes a specified project service account. Available only for project Owners, Maintainers, and administrators.

Deletes a specified project service account. Available only for project Owners, Maintainers, and administrators.

Authentication

Connected account required

Tags

Service accounts
Revoke a personal access token for a project service accountGITLAB_DELETE_API_V4_PROJECTS_ID_SERVICE_ACCOUNTS_USER_ID_PERSONAL_ACCESS_TOKENS_TOKEN_IDRevokes a specified personal access token for a project service account.

Revokes a specified personal access token for a project service account.

Authentication

Connected account required

Tags

Access tokensService accounts
Disable an integrationGITLAB_DELETE_API_V4_PROJECTS_ID_SERVICES_SLUGDisables a specified integration. Integration settings are preserved.

Disables a specified integration. Integration settings are preserved.

Authentication

Connected account required

Tags

Integrations
Delete a shared project link in a groupGITLAB_DELETE_API_V4_PROJECTS_ID_SHARE_GROUP_IDDeletes a shared project link in a group.

Deletes a shared project link in a group.

Authentication

Connected account required

Tags

Projects
Delete a comment from a snippet discussionGITLAB_DELETE_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDDeletes a specified comment from a snippet discussion.

Deletes a specified comment from a snippet discussion.

Authentication

Connected account required

Tags

Discussions
Delete a snippet noteGITLAB_DELETE_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_NOTES_NOTE_IDDeletes a specified note from a snippet.

Deletes a specified note from a snippet.

Authentication

Connected account required

Tags

Notes
Delete a project snippetGITLAB_DELETE_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_IDDeletes a specified project snippet.

Deletes a specified project snippet.

Authentication

Connected account required

Tags

Snippets
Delete an emoji reaction from a snippetGITLAB_DELETE_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_AWARD_EMOJI_AWARD_IDDeletes a specified emoji reaction from a snippet. Only an administrator or the user who added the reaction can delete it.

Deletes a specified emoji reaction from a snippet. Only an administrator or the user who added the reaction can delete it.

Authentication

Connected account required

Tags

Award emoji
Delete an emoji reaction from a snippet commentGITLAB_DELETE_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_NOTES_NOTE_ID_AWARD_EMOJI_AWARD_IDDeletes a specified emoji reaction from a comment on a snippet. Only an administrator or the user who added the reaction can delete it.

Deletes a specified emoji reaction from a comment on a snippet. Only an administrator or the user who added the reaction can delete it.

Authentication

Connected account required

Tags

Award emoji
Delete a Terraform stateGITLAB_DELETE_API_V4_PROJECTS_ID_TERRAFORM_STATE_NAMEDeletes a Terraform state for a specified project.

Deletes a Terraform state for a specified project.

Authentication

Connected account required

Tags

Terraform
Unlock a Terraform stateGITLAB_DELETE_API_V4_PROJECTS_ID_TERRAFORM_STATE_NAME_LOCKUnlocks a Terraform state for a specified project.

Unlocks a Terraform state for a specified project.

Authentication

Connected account required

Tags

Terraform
Delete a Terraform state versionGITLAB_DELETE_API_V4_PROJECTS_ID_TERRAFORM_STATE_NAME_VERSIONS_SERIALDeletes a specified Terraform state version.

Deletes a specified Terraform state version.

Authentication

Connected account required

Tags

Terraform
Delete a Terraform state protection ruleGITLAB_DELETE_API_V4_PROJECTS_ID_TERRAFORM_STATE_PROTECTION_RULES_TERRAFORM_STATE_PROTECTION_RULE_IDThis feature was introduced in GitLab 19.0.

This feature was introduced in GitLab 19.0.

Authentication

Connected account required

Tags

Projects
Delete a pipeline trigger tokenGITLAB_DELETE_API_V4_PROJECTS_ID_TRIGGERS_TRIGGER_IDDeletes a pipeline trigger token for a project.

Deletes a pipeline trigger token for a project.

Authentication

Connected account required

Tags

CI triggers
Delete an uploaded file by secret and filenameGITLAB_DELETE_API_V4_PROJECTS_ID_UPLOADS_SECRET_FILENAMEDeletes an uploaded file with a specified secret and filename. You must have the Maintainer or Owner role for the project.

Deletes an uploaded file with a specified secret and filename. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Projects
Delete an uploaded file by IDGITLAB_DELETE_API_V4_PROJECTS_ID_UPLOADS_UPLOAD_IDDeletes an uploaded file with a specified ID. You must have the Maintainer or Owner role for the project.

Deletes an uploaded file with a specified ID. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Projects
Delete a variableGITLAB_DELETE_API_V4_PROJECTS_ID_VARIABLES_KEYDeletes a project variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Deletes a project variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Authentication

Connected account required

Tags

CI variables
Delete a vulnerability noteGITLAB_DELETE_API_V4_PROJECTS_ID_VULNERABILITIES_NOTEABLE_ID_NOTES_NOTE_IDDeletes a specified note from a vulnerability.

Deletes a specified note from a vulnerability.

Authentication

Connected account required

Tags

Notes
Delete a wiki page meta noteGITLAB_DELETE_API_V4_PROJECTS_ID_WIKI_PAGES_NOTEABLE_ID_NOTES_NOTE_IDDeletes a specified note from a wiki page meta.

Deletes a specified note from a wiki page meta.

Authentication

Connected account required

Tags

Notes
Delete a wiki page for a projectGITLAB_DELETE_API_V4_PROJECTS_ID_WIKIS_SLUGDeletes a specified wiki page from a project.

Deletes a specified wiki page from a project.

Authentication

Connected account required

Tags

Wikis
Delete a runner controllerGITLAB_DELETE_API_V4_RUNNER_CONTROLLERS_IDDeletes a specified runner controller. Administrators only.

Deletes a specified runner controller. Administrators only.

Authentication

Connected account required

Tags

Runner controllers
Remove instance scopeGITLAB_DELETE_API_V4_RUNNER_CONTROLLERS_ID_SCOPES_INSTANCERemoves an instance scope from a runner controller.

Removes an instance scope from a runner controller.

Authentication

Connected account required

Tags

Runner controllers
Remove runner scopeGITLAB_DELETE_API_V4_RUNNER_CONTROLLERS_ID_SCOPES_RUNNERS_RUNNER_IDRemoves a runner scope from a runner controller.

Removes a runner scope from a runner controller.

Authentication

Connected account required

Tags

Runner controllers
Revoke a runner controller tokenGITLAB_DELETE_API_V4_RUNNER_CONTROLLERS_RUNNER_CONTROLLER_ID_TOKENS_IDRevokes an existing runner controller token.

Revokes an existing runner controller token.

Authentication

Connected account required

Tags

Runner controller tokens
Delete a registered runnerGITLAB_DELETE_API_V4_RUNNERSDeletes a specified registered runner.

Deletes a specified registered runner.

Authentication

Connected account required

Tags

CI runners
Delete a runnerGITLAB_DELETE_API_V4_RUNNERS_IDDeletes a specified runner.

Deletes a specified runner.

Authentication

Connected account required

Tags

Runners
Delete a registered runner managerGITLAB_DELETE_API_V4_RUNNERS_MANAGERSDelete a registered runner manager

Delete a registered runner manager

Authentication

Connected account required

Tags

CI runners
Delete snippetGITLAB_DELETE_API_V4_SNIPPETS_IDDeletes a specified snippet.

Deletes a specified snippet.

Authentication

Connected account required

Tags

Snippets
Delete a project topicGITLAB_DELETE_API_V4_TOPICS_IDDeletes a specified project topic. Administrators only.

Deletes a specified project topic. Administrators only.

Authentication

Connected account required

Tags

Project topics
Delete an applicationGITLAB_DELETE_API_V4_USER_APPLICATIONS_IDDeletes a specified application owned by the authenticated user.

Deletes a specified application owned by the authenticated user.

Authentication

Connected account required

Tags

Applications
Delete an email addressGITLAB_DELETE_API_V4_USER_EMAILS_EMAIL_IDDeletes the specified email address. You cannot delete a primary email address. Any future emails sent to the deleted email address are sent to the primary email address instead.

Deletes the specified email address. You cannot delete a primary email address. Any future emails sent to the deleted email address are sent to the primary email address instead.

Authentication

Connected account required

Tags

Users
Delete a GPG keyGITLAB_DELETE_API_V4_USER_GPG_KEYS_KEY_IDDeletes a GPG key from your user account.

Deletes a GPG key from your user account.

Authentication

Connected account required

Tags

Keys
Delete an SSH keyGITLAB_DELETE_API_V4_USER_KEYS_KEY_IDDeletes a specified SSH key from the currently authenticated user.

Deletes a specified SSH key from the currently authenticated user.

Authentication

Connected account required

Tags

Keys
Delete a userGITLAB_DELETE_API_V4_USERS_IDDeletes a user. Administrators only.

Deletes a user. Administrators only.

Authentication

Connected account required

Tags

Users
Delete a custom attribute for a userGITLAB_DELETE_API_V4_USERS_ID_CUSTOM_ATTRIBUTES_KEYDeletes a specified custom attribute for a user.

Deletes a specified custom attribute for a user.

Authentication

Connected account required

Tags

Custom attributes
Delete an email address for a userGITLAB_DELETE_API_V4_USERS_ID_EMAILS_EMAIL_IDDeletes a specified email address for a user account. You cannot delete a primary email address. Administrators only.

Deletes a specified email address for a user account. You cannot delete a primary email address. Administrators only.

Authentication

Connected account required

Tags

Users
Delete a GPG key for a userGITLAB_DELETE_API_V4_USERS_ID_GPG_KEYS_KEY_IDDeletes a GPG key from a specified user account. Administrators only.

Deletes a GPG key from a specified user account. Administrators only.

Authentication

Connected account required

Tags

Keys
Delete authentication identity from a userGITLAB_DELETE_API_V4_USERS_ID_IDENTITIES_PROVIDERDeletes a user authentication identity using the provider name associated with that identity. Administrators only.

Deletes a user authentication identity using the provider name associated with that identity. Administrators only.

Authentication

Connected account required

Tags

Users
Delete an SSH key for a userGITLAB_DELETE_API_V4_USERS_ID_KEYS_KEY_IDDeletes an SSH key from a specified user account. Administrators only.

Deletes an SSH key from a specified user account. Administrators only.

Authentication

Connected account required

Tags

Keys
Revoke an impersonation tokenGITLAB_DELETE_API_V4_USERS_USER_ID_IMPERSONATION_TOKENS_IMPERSONATION_TOKEN_IDRevokes an impersonation token for a specified user. Administrators only.

Revokes an impersonation token for a specified user. Administrators only.

Authentication

Connected account required

Tags

Access tokens
Deletes all user vscode setting resourcesGITLAB_DELETE_API_V4_VSCODE_SETTINGS_SYNC_SETTINGS_CONTEXT_HASH_V1_COLLECTIONDeletes all user vscode setting resources

Deletes all user vscode setting resources

Authentication

Connected account required

Tags

VSCode
Deletes all user vscode setting resourcesGITLAB_DELETE_API_V4_VSCODE_SETTINGS_SYNC_V1_COLLECTIONDeletes all user vscode setting resources

Deletes all user vscode setting resources

Authentication

Connected account required

Tags

VSCode
Delete a link between an issue and a vulnerabilityGITLAB_DELETE_API_V4_VULNERABILITIES_ID_ISSUE_LINKS_ISSUE_LINK_IDDelete a link between an issue and a vulnerability

Delete a link between an issue and a vulnerability

Authentication

Connected account required

Tags

Vulnerabilities
Get all ActiveContext connectionsGITLAB_GET_API_V4_ADMIN_ACTIVE_CONTEXT_CONNECTIONSGet all ActiveContext connections

Get all ActiveContext connections

Authentication

Connected account required

Tags

Active context
Get the list of batched background migrationsGITLAB_GET_API_V4_ADMIN_BATCHED_BACKGROUND_MIGRATIONSGet the list of batched background migrations

Get the list of batched background migrations

Authentication

Connected account required

Tags

Batched background migrations
Retrieve a batched background migrationGITLAB_GET_API_V4_ADMIN_BATCHED_BACKGROUND_MIGRATIONS_IDRetrieve a batched background migration

Retrieve a batched background migration

Authentication

Connected account required

Tags

Batched background migrations
Get the list of batched background operationsGITLAB_GET_API_V4_ADMIN_BATCHED_BACKGROUND_OPERATIONSThis feature was introduced in GitLab 19.1.

This feature was introduced in GitLab 19.1.

Authentication

Connected account required

Tags

Batched background operations
Retrieve a batched background operationGITLAB_GET_API_V4_ADMIN_BATCHED_BACKGROUND_OPERATIONS_IDThis feature was introduced in GitLab 19.1.

This feature was introduced in GitLab 19.1.

Authentication

Connected account required

Tags

Batched background operations
List all instance variablesGITLAB_GET_API_V4_ADMIN_CI_VARIABLESLists all instance-level variables. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Lists all instance-level variables. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Authentication

Connected account required

Tags

CI variables
Retrieve instance variable detailsGITLAB_GET_API_V4_ADMIN_CI_VARIABLES_KEYRetrieves details of a specified instance-level variable.

Retrieves details of a specified instance-level variable.

Authentication

Connected account required

Tags

CI variables
List all instance clustersGITLAB_GET_API_V4_ADMIN_CLUSTERSLists all instance clusters for the instance.

Lists all instance clusters for the instance.

Authentication

Connected account required

Tags

Clusters
Retrieve a single instance clusterGITLAB_GET_API_V4_ADMIN_CLUSTERS_CLUSTER_IDRetrieves a specified instance cluster.

Retrieves a specified instance cluster.

Authentication

Connected account required

Tags

Clusters
Retrieve model informationGITLAB_GET_API_V4_ADMIN_DATA_MANAGEMENT_MODEL_NAMERetrieves information about a data model in an instance. Only available to administrators.

Retrieves information about a data model in an instance. Only available to administrators.

Authentication

Connected account required

Tags

Data management
Retrieve information about a model recordGITLAB_GET_API_V4_ADMIN_DATA_MANAGEMENT_MODEL_NAME_RECORD_IDENTIFIERRetrieves information about a specified model record. Only available to administrators.

Retrieves information about a specified model record. Only available to administrators.

Authentication

Connected account required

Tags

Data management
Retrieve dictionary detailsGITLAB_GET_API_V4_ADMIN_DATABASES_DATABASE_NAME_DICTIONARY_TABLES_TABLE_NAMERetrieve dictionary details

Retrieve dictionary details

Authentication

Connected account required

Tags

Database dictionary
Get all enabled namespaces for Knowledge GraphGITLAB_GET_API_V4_ADMIN_KNOWLEDGE_GRAPH_NAMESPACESThis endpoint retrieves all namespaces that have Knowledge Graph enabled

This endpoint retrieves all namespaces that have Knowledge Graph enabled

Authentication

Connected account required

Tags

Knowledge graph
Get Admin Roles for this GitLab instanceGITLAB_GET_API_V4_ADMIN_MEMBER_ROLESGet Admin Roles for this GitLab instance

Get Admin Roles for this GitLab instance

Authentication

Connected account required

Tags

Member roles
List all pending migrationsGITLAB_GET_API_V4_ADMIN_MIGRATIONS_PENDINGLists all pending migrations for the instance.

Lists all pending migrations for the instance.

Authentication

Connected account required

Tags

Migrations
List all advanced search migrationsGITLAB_GET_API_V4_ADMIN_SEARCH_MIGRATIONSLists all advanced search migrations for the GitLab instance.

Lists all advanced search migrations for the GitLab instance.

Authentication

Connected account required

Tags

Search
Retrieve an advanced search migrationGITLAB_GET_API_V4_ADMIN_SEARCH_MIGRATIONS_MIGRATION_IDRetrieves a specified advanced search migration by migration version or name.

Retrieves a specified advanced search migration by migration version or name.

Authentication

Connected account required

Tags

Search
Retrieve security policy settingsGITLAB_GET_API_V4_ADMIN_SECURITY_COMPLIANCE_POLICY_SETTINGSRetrieves the current security policy settings for this GitLab instance.

Retrieves the current security policy settings for this GitLab instance.

Authentication

Connected account required

Tags

Compliance policy settings
Get all the Zoekt nodesGITLAB_GET_API_V4_ADMIN_ZOEKT_SHARDSGet all the Zoekt nodes

Get all the Zoekt nodes

Authentication

Connected account required

Tags

Code search
Get all the indexed namespaces for this nodeGITLAB_GET_API_V4_ADMIN_ZOEKT_SHARDS_NODE_ID_INDEXED_NAMESPACESGet all the indexed namespaces for this node

Get all the indexed namespaces for this node

Authentication

Connected account required

Tags

Code search
Fetch the Duo Code Review custom instructions for a merge requestGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_CODE_REVIEW_CUSTOM_INSTRUCTIONSFetch all Duo Code Review custom instructions for a merge request.

Fetch all Duo Code Review custom instructions for a merge request.

Authentication

Connected account required

Tags

GitLab Duo workflows
List registered flow callback endpointsGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_FLOW_CALLBACKSLists the flow callback endpoints registered for your organization. Secrets are not returned.

Lists the flow callback endpoints registered for your organization. Secrets are not returned.

Authentication

Connected account required

Tags

Duo workflow flow callback hooks
Get a registered flow callback endpointGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_FLOW_CALLBACKS_IDReturns a single registered flow callback endpoint. Secrets are not returned.

Returns a single registered flow callback endpoint. Secrets are not returned.

Authentication

Connected account required

Tags

Duo workflow flow callback hooks
List Duo Agent Platform toolsGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_LIST_TOOLSList Duo Agent Platform tools

List Duo Agent Platform tools

Authentication

Connected account required

Tags

GitLab Duo workflows
List all agent privilegesGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_AGENT_PRIVILEGESLists all available agent privileges with their IDs, names, descriptions, and whether each is enabled by default. This endpoint has no supported attributes.

Lists all available agent privileges with their IDs, names, descriptions, and whether each is enabled by default. This endpoint has no supported attributes.

Authentication

Connected account required

Tags

GitLab Duo workflows
Get workflow detailsGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_IDGet workflow details

Get workflow details

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
List all workflow checkpointsGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_ID_CHECKPOINTSList all workflow checkpoints

List all workflow checkpoints

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
Get details on a workflow checkpointGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_ID_CHECKPOINTS_CHECKPOINT_IDGet details on a workflow checkpoint

Get details on a workflow checkpoint

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
List all workflow eventsGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_ID_EVENTSList all workflow events

List all workflow events

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
Get workflow trace as JSONLGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_WORKFLOW_ID_TRACE_JSONLReturns the full trace of a workflow session as JSON Lines (JSONL). Each line is a JSON object representing one checkpoint event in chronological order.

Returns the full trace of a workflow session as JSON Lines (JSONL). Each line is a JSON object representing one checkpoint event in chronological order.

Authentication

Connected account required

Tags

GitLab Duo workflows
Get Duo Workflows WebSocket connection detailsGITLAB_GET_API_V4_AI_DUO_WORKFLOWS_WSGet Duo Workflows WebSocket connection details

Get Duo Workflows WebSocket connection details

Authentication

Connected account required

Tags

GitLab Duo workflows
List code review information about projectGITLAB_GET_API_V4_ANALYTICS_CODE_REVIEWList code review information about project

List code review information about project

Authentication

Connected account required

Tags

Code review analytics
Retrieve count of recently created issues for a groupGITLAB_GET_API_V4_ANALYTICS_GROUP_ACTIVITY_ISSUES_COUNTRetrieves the count of recently created issues for a specified group.

Retrieves the count of recently created issues for a specified group.

Authentication

Connected account required

Tags

Analytics
Retrieve count of recently created merge requests for a groupGITLAB_GET_API_V4_ANALYTICS_GROUP_ACTIVITY_MERGE_REQUESTS_COUNTRetrieves the count of recently created merge requests for a specified group.

Retrieves the count of recently created merge requests for a specified group.

Authentication

Connected account required

Tags

Analytics
Retrieve count of members recently added to a groupGITLAB_GET_API_V4_ANALYTICS_GROUP_ACTIVITY_NEW_MEMBERS_COUNTRetrieves the count of members recently added to a specified group.

Retrieves the count of members recently added to a specified group.

Authentication

Connected account required

Tags

Analytics
Get the current appearanceGITLAB_GET_API_V4_APPLICATION_APPEARANCEGet the current appearance

Get the current appearance

Authentication

Connected account required

Tags

Instance
Get current plan limitsGITLAB_GET_API_V4_APPLICATION_PLAN_LIMITSList the current limits of a plan on the GitLab instance.

List the current limits of a plan on the GitLab instance.

Authentication

Connected account required

Tags

Plan limits
Retrieve application settingsGITLAB_GET_API_V4_APPLICATION_SETTINGSRetrieves the current application settings for this GitLab instance.

Retrieves the current application settings for this GitLab instance.

Authentication

Connected account required

Tags

Instance
Retrieve application statisticsGITLAB_GET_API_V4_APPLICATION_STATISTICSRetrieves the current application statistics for this GitLab instance.

Retrieves the current application statistics for this GitLab instance.

Authentication

Connected account required

Tags

Instance
Get applicationsGITLAB_GET_API_V4_APPLICATIONSList all registered applications

List all registered applications

Authentication

Connected account required

Tags

Applications
List all instance audit eventsGITLAB_GET_API_V4_AUDIT_EVENTSLists all available instance audit events, limited to a maximum of 30 days for each query.

Lists all available instance audit events, limited to a maximum of 30 days for each query.

Authentication

Connected account required

Tags

Audit events
Retrieve an instance audit eventGITLAB_GET_API_V4_AUDIT_EVENTS_IDRetrieves a specified instance audit event.

Retrieves a specified instance audit event.

Authentication

Connected account required

Tags

Audit events
Return avatar url for a userGITLAB_GET_API_V4_AVATARReturn avatar url for a user

Return avatar url for a user

Authentication

Connected account required

Tags

Avatars
List all broadcast messagesGITLAB_GET_API_V4_BROADCAST_MESSAGESLists all broadcast messages for the instance.

Lists all broadcast messages for the instance.

Authentication

Connected account required

Tags

Broadcast messages
Retrieve a broadcast messageGITLAB_GET_API_V4_BROADCAST_MESSAGES_IDRetrieves a specified broadcast message.

Retrieves a specified broadcast message.

Authentication

Connected account required

Tags

Broadcast messages
List all group or project migrationsGITLAB_GET_API_V4_BULK_IMPORTSLists all group or project migrations.

Lists all group or project migrations.

Authentication

Connected account required

Tags

Imports
List all group or project migration entitiesGITLAB_GET_API_V4_BULK_IMPORTS_ENTITIESLists all group or project migration entities.

Lists all group or project migration entities.

Authentication

Connected account required

Tags

Imports
Retrieve a group or project migrationGITLAB_GET_API_V4_BULK_IMPORTS_IMPORT_IDRetrieves details of a group or project migration.

Retrieves details of a group or project migration.

Authentication

Connected account required

Tags

Imports
List all group or project migration entitiesGITLAB_GET_API_V4_BULK_IMPORTS_IMPORT_ID_ENTITIESLists all group or project migration entities for a specified migration.

Lists all group or project migration entities for a specified migration.

Authentication

Connected account required

Tags

Imports
Retrieve a group or project migration entityGITLAB_GET_API_V4_BULK_IMPORTS_IMPORT_ID_ENTITIES_ENTITY_IDRetrieves details of a group or project migration entity.

Retrieves details of a group or project migration entity.

Authentication

Connected account required

Tags

Imports
List all failed import records for a migration entityGITLAB_GET_API_V4_BULK_IMPORTS_IMPORT_ID_ENTITIES_ENTITY_ID_FAILURESLists all failed import records for a group or project migration entity. This feature was introduced in GitLab 16.6.

Lists all failed import records for a group or project migration entity. This feature was introduced in GitLab 16.6.

Authentication

Connected account required

Tags

Imports
List dictionary tablesGITLAB_GET_API_V4_DATABASES_DATABASE_NAME_DICTIONARY_TABLESReturns database dictionary tables filtered by database and optional table size

Returns database dictionary tables filtered by database and optional table size

Authentication

Connected account required

Tags

Database dictionary
Retrieve a single dependency list exportGITLAB_GET_API_V4_DEPENDENCY_LIST_EXPORTS_EXPORT_IDRetrieves a dependency list export.

Retrieves a dependency list export.

Authentication

Connected account required

Tags

Dependency management
Download dependency list exportGITLAB_GET_API_V4_DEPENDENCY_LIST_EXPORTS_EXPORT_ID_DOWNLOADDownloads a dependency list export.

Downloads a dependency list export.

Authentication

Connected account required

Tags

Dependency management
List all deploy keysGITLAB_GET_API_V4_DEPLOY_KEYSLists all deploy keys for the instance.

Lists all deploy keys for the instance.

Authentication

Connected account required

Tags

Deploy resources
List all deploy tokensGITLAB_GET_API_V4_DEPLOY_TOKENSLists all deploy tokens for the instance.

Lists all deploy tokens for the instance.

Authentication

Connected account required

Tags

Deploy resources
List all certificate-based clustersGITLAB_GET_API_V4_DISCOVER_CERT_BASED_CLUSTERSLists all certificate-based clusters associated with a project. This feature was introduced in GitLab 17.9.

Lists all certificate-based clusters associated with a project. This feature was introduced in GitLab 17.9.

Authentication

Connected account required

Tags

Clusters
List all eventsGITLAB_GET_API_V4_EVENTSLists all events for the authenticated user. Does not return events associated with epics or merge requests. Returns bulk push events with limited commit details.

Lists all events for the authenticated user. Does not return events associated with epics or merge requests. Returns bulk push events with limited commit details.

Authentication

Connected account required

Tags

Events
List all experimentsGITLAB_GET_API_V4_EXPERIMENTSLists all experiments on the GitLab instance. Each experiment has an `enabled` status that indicates whether the experiment is enabled globally, or only in specific contexts.

Lists all experiments on the GitLab instance. Each experiment has an `enabled` status that indicates whether the experiment is enabled globally, or only in specific contexts.

Authentication

Connected account required

Tags

Experiments
Get current variant assignment for an experiment contextGITLAB_GET_API_V4_EXPERIMENTS_EXPERIMENT_NAME_ASSIGNMENTSReturns the currently cached variant assignment for the given experiment and context. Defaults to current user if no context is provided.

Returns the currently cached variant assignment for the given experiment and context. Defaults to current user if no context is provided.

Authentication

Connected account required

Tags

Experiments
Get Unleash featuresGITLAB_GET_API_V4_FEATURE_FLAGS_UNLEASH_PROJECT_IDGet Unleash features

Get Unleash features

Authentication

Connected account required

Tags

Unleash
Get a list of featuresGITLAB_GET_API_V4_FEATURE_FLAGS_UNLEASH_PROJECT_ID_CLIENT_FEATURESGet a list of features

Get a list of features

Authentication

Connected account required

Tags

Unleash
Get a list of features (v2 client support)GITLAB_GET_API_V4_FEATURE_FLAGS_UNLEASH_PROJECT_ID_FEATURESDeprecated in GitLab 15.6

Deprecated in GitLab 15.6

Authentication

Connected account required

Tags

Unleash
List all feature flagsGITLAB_GET_API_V4_FEATURESLists all feature flags for the instance.

Lists all feature flags for the instance.

Authentication

Connected account required

Tags

Features
List all feature flag definitionsGITLAB_GET_API_V4_FEATURES_DEFINITIONSLists all feature flag definitions.

Lists all feature flag definitions.

Authentication

Connected account required

Tags

Features
List all Geo nodesGITLAB_GET_API_V4_GEO_NODESLists all Geo nodes for the instance.

Lists all Geo nodes for the instance.

Authentication

Connected account required

Tags

Geo
Retrieve a single Geo nodeGITLAB_GET_API_V4_GEO_NODES_IDRetrieves a single Geo Node.

Retrieves a single Geo Node.

Authentication

Connected account required

Tags

Geo
Retrieve metrics for a Geo nodeGITLAB_GET_API_V4_GEO_NODES_ID_STATUSRetrieves metrics for a specified Geo node.

Retrieves metrics for a specified Geo node.

Authentication

Connected account required

Tags

Geo
List all Geo node statusesGITLAB_GET_API_V4_GEO_NODES_STATUSLists all Geo node statuses.

Lists all Geo node statuses.

Authentication

Connected account required

Tags

Geo
Returns a Geo proxy responseGITLAB_GET_API_V4_GEO_PROXYReturns a Geo proxy response

Returns a Geo proxy response

Authentication

Connected account required

Tags

Geo
Returns the list of pipeline refs for the projectGITLAB_GET_API_V4_GEO_REPOSITORIES_GL_REPOSITORY_PIPELINE_REFSReturns the list of pipeline refs for the project

Returns the list of pipeline refs for the project

Authentication

Connected account required

Tags

Geo
Returns a replicable file from store (via CDN or sendfile)GITLAB_GET_API_V4_GEO_RETRIEVE_REPLICABLE_NAME_REPLICABLE_IDReturns a replicable file from store (via CDN or sendfile)

Returns a replicable file from store (via CDN or sendfile)

Authentication

Connected account required

Tags

Geo
List all Geo sitesGITLAB_GET_API_V4_GEO_SITESLists all Geo sites for the instance.

Lists all Geo sites for the instance.

Authentication

Connected account required

Tags

Geo
Retrieve a Geo siteGITLAB_GET_API_V4_GEO_SITES_IDRetrieves a specified Geo site.

Retrieves a specified Geo site.

Authentication

Connected account required

Tags

Geo
Retrieve a Geo site statusGITLAB_GET_API_V4_GEO_SITES_ID_STATUSRetrieves the status for a specified Geo site.

Retrieves the status for a specified Geo site.

Authentication

Connected account required

Tags

Geo
List all Geo site statusesGITLAB_GET_API_V4_GEO_SITES_STATUSLists all Geo site statuses.

Lists all Geo site statuses.

Authentication

Connected account required

Tags

Geo
Retrieve repository URL templatesGITLAB_GET_API_V4_GROUP_ID_DASH_PACKAGES_COMPOSER_PACKAGESRetrieves the repository URL templates for requesting individual packages for a group.

Retrieves the repository URL templates for requesting individual packages for a group.

Authentication

Connected account required

Tags

Packages: Composer
List all packages for a groupGITLAB_GET_API_V4_GROUP_ID_DASH_PACKAGES_COMPOSER_PSHALists all repository packages for a specified group. Composer V2 is recommended over V1.

Lists all repository packages for a specified group. Composer V2 is recommended over V1.

Authentication

Connected account required

Tags

Packages: Composer
List all group repository storage movesGITLAB_GET_API_V4_GROUP_REPOSITORY_STORAGE_MOVESLists all group repository storage moves for an instance.

Lists all group repository storage moves for an instance.

Authentication

Connected account required

Tags

Storage moves
Retrieve a group repository storage moveGITLAB_GET_API_V4_GROUP_REPOSITORY_STORAGE_MOVES_REPOSITORY_STORAGE_MOVE_IDRetrieves a specified group repository storage move. This feature was introduced in GitLab 13.9.

Retrieves a specified group repository storage move. This feature was introduced in GitLab 13.9.

Authentication

Connected account required

Tags

Storage moves
List all groupsGITLAB_GET_API_V4_GROUPSLists all visible groups for the authenticated user. Unauthenticated requests return only public groups.

Lists all visible groups for the authenticated user. Unauthenticated requests return only public groups.

Authentication

Connected account required

Tags

Groups
Retrieve a groupGITLAB_GET_API_V4_GROUPS_IDRetrieves a specified group by ID or path.

Retrieves a specified group by ID or path.

Authentication

Connected account required

Tags

Groups
List all access requests for a groupGITLAB_GET_API_V4_GROUPS_ID_ACCESS_REQUESTSLists all access requests for a specified group that are viewable by the authenticated user.

Lists all access requests for a specified group that are viewable by the authenticated user.

Authentication

Connected account required

Tags

Access requests
List all group access tokensGITLAB_GET_API_V4_GROUPS_ID_ACCESS_TOKENSLists all group access tokens for a specified group.

Lists all group access tokens for a specified group.

Authentication

Connected account required

Tags

Access tokens
Retrieve details on a group access tokenGITLAB_GET_API_V4_GROUPS_ID_ACCESS_TOKENS_TOKEN_IDRetrieves details on a specified group access token.

Retrieves details on a specified group access token.

Authentication

Connected account required

Tags

Access tokens
List all approval rules for a groupGITLAB_GET_API_V4_GROUPS_ID_APPROVAL_RULESLists all approval rules and any associated details for a specified group. Restricted to group administrators. Use the `page` and `per_page` pagination parameters to restrict the list of approval rules.

Lists all approval rules and any associated details for a specified group. Restricted to group administrators. Use the `page` and `per_page` pagination parameters to restrict the list of approval rules.

Authentication

Connected account required

Tags

Approval rules
List all group audit eventsGITLAB_GET_API_V4_GROUPS_ID_AUDIT_EVENTSLists all audit events for a specified group.

Lists all audit events for a specified group.

Authentication

Connected account required

Tags

Audit events
Retrieve a group audit eventGITLAB_GET_API_V4_GROUPS_ID_AUDIT_EVENTS_AUDIT_EVENT_IDRetrieves an audit event for a specified group. Only available to group Owners and administrators.

Retrieves an audit event for a specified group. Only available to group Owners and administrators.

Authentication

Connected account required

Tags

Groups
Download a group avatarGITLAB_GET_API_V4_GROUPS_ID_AVATARDownloads a group avatar image.

Downloads a group avatar image.

Authentication

Connected account required

Tags

Avatars
List all badges for a groupGITLAB_GET_API_V4_GROUPS_ID_BADGESLists all badges for a specified group.

Lists all badges for a specified group.

Authentication

Connected account required

Tags

Badges
Retrieve a badge for a groupGITLAB_GET_API_V4_GROUPS_ID_BADGES_BADGE_IDRetrieves a specified badge for a group.

Retrieves a specified badge for a group.

Authentication

Connected account required

Tags

Badges
Retrieve a badge preview for a groupGITLAB_GET_API_V4_GROUPS_ID_BADGES_RENDERPreviews the final `link_url` and `image_url` for a specified group after resolving the placeholder interpolation.

Previews the final `link_url` and `image_url` for a specified group after resolving the placeholder interpolation.

Authentication

Connected account required

Tags

Badges
List all billable group membersGITLAB_GET_API_V4_GROUPS_ID_BILLABLE_MEMBERSLists all billable members of a specified top-level group. Includes members in any subgroups or projects. You must have the Owner role for the group.

Lists all billable members of a specified top-level group. Includes members in any subgroups or projects. You must have the Owner role for the group.

Authentication

Connected account required

Tags

Groups
List all indirect memberships for a billable group memberGITLAB_GET_API_V4_GROUPS_ID_BILLABLE_MEMBERS_USER_ID_INDIRECTLists all indirect memberships for a billable member of a group. This operation works on top-level groups only. It does not work on subgroups.

Lists all indirect memberships for a billable member of a group. This operation works on top-level groups only. It does not work on subgroups.

Authentication

Connected account required

Tags

Members
List all memberships for a billable group memberGITLAB_GET_API_V4_GROUPS_ID_BILLABLE_MEMBERS_USER_ID_MEMBERSHIPSLists all memberships for a specified billable member of a group. The response represents only direct memberships. Inherited memberships are not included.

Lists all memberships for a specified billable member of a group. The response represents only direct memberships. Inherited memberships are not included.

Authentication

Connected account required

Tags

Members
List all group issue boards in a groupGITLAB_GET_API_V4_GROUPS_ID_BOARDSLists all group issue boards for a specified group.

Lists all group issue boards for a specified group.

Authentication

Connected account required

Tags

Boards
Retrieve a group issue boardGITLAB_GET_API_V4_GROUPS_ID_BOARDS_BOARD_IDRetrieves a specified group issue board.

Retrieves a specified group issue board.

Authentication

Connected account required

Tags

Boards
List all group issue board listsGITLAB_GET_API_V4_GROUPS_ID_BOARDS_BOARD_ID_LISTSLists all group issue board lists for a specified board. Does not include `open` and `closed` lists.

Lists all group issue board lists for a specified board. Does not include `open` and `closed` lists.

Authentication

Connected account required

Tags

Boards
Retrieve a group issue board listGITLAB_GET_API_V4_GROUPS_ID_BOARDS_BOARD_ID_LISTS_LIST_IDRetrieves a specified group issue board list.

Retrieves a specified group issue board list.

Authentication

Connected account required

Tags

Boards
List all group clustersGITLAB_GET_API_V4_GROUPS_ID_CLUSTERSLists all group clusters for a specified group.

Lists all group clusters for a specified group.

Authentication

Connected account required

Tags

Clusters
Retrieve a group clusterGITLAB_GET_API_V4_GROUPS_ID_CLUSTERS_CLUSTER_IDRetrieves a specified group cluster.

Retrieves a specified group cluster.

Authentication

Connected account required

Tags

Clusters
List all custom attributes for a groupGITLAB_GET_API_V4_GROUPS_ID_CUSTOM_ATTRIBUTESLists all custom attributes for a specified group.

Lists all custom attributes for a specified group.

Authentication

Connected account required

Tags

Custom attributes
Retrieve a custom attribute for a groupGITLAB_GET_API_V4_GROUPS_ID_CUSTOM_ATTRIBUTES_KEYRetrieves a specified custom attribute for a group.

Retrieves a specified custom attribute for a group.

Authentication

Connected account required

Tags

Custom attributes
List all Debian group distributionsGITLAB_GET_API_V4_GROUPS_ID_DASH_DEBIAN_DISTRIBUTIONSLists all Debian distributions for a specified group.

Lists all Debian distributions for a specified group.

Authentication

Connected account required

Tags

Packages: Debian
Retrieve a Debian group distributionGITLAB_GET_API_V4_GROUPS_ID_DASH_DEBIAN_DISTRIBUTIONS_CODENAMERetrieves a specified Debian group distribution for a group.

Retrieves a specified Debian group distribution for a group.

Authentication

Connected account required

Tags

Packages: Debian
Retrieve a Debian group distribution keyGITLAB_GET_API_V4_GROUPS_ID_DASH_DEBIAN_DISTRIBUTIONS_CODENAME_KEY_ASCRetrieves a specified Debian group distribution key for a group.

Retrieves a specified Debian group distribution key for a group.

Authentication

Connected account required

Tags

Packages: Debian
List all group epicsGITLAB_GET_API_V4_GROUPS_ID_DASH_EPICSLists all epics for a specified group and its subgroups. Responses are paginated and return 20 results by default.

Lists all epics for a specified group and its subgroups. Responses are paginated and return 20 results by default.

Authentication

Connected account required

Tags

Epics
Get details of an epicGITLAB_GET_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IIDGets a single epic

Gets a single epic

Authentication

Connected account required

Tags

Epics
Get related epicsGITLAB_GET_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IID_EPICSGet related epics

Get related epics

Authentication

Connected account required

Tags

Epics
List all issues for an epicGITLAB_GET_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IID_ISSUESLists all issues assigned to a specified epic that are available to the authenticated user. Responses are paginated and return 20 results by default.

Lists all issues assigned to a specified epic that are available to the authenticated user. Responses are paginated and return 20 results by default.

Authentication

Connected account required

Tags

Epics
Download Debian packageGITLAB_GET_API_V4_GROUPS_ID_DASH_PACKAGES_DEBIAN_POOL_DISTRIBUTION_PROJECT_ID_LETTER_PACKAGE_NAME_PACKAGE_VERSION_FILE_NAMEThis feature was introduced in GitLab 14.2

This feature was introduced in GitLab 14.2

Authentication

Connected account required

Tags

Packages: Debian
The NuGet V3 Feed Service IndexGITLAB_GET_API_V4_GROUPS_ID_DASH_PACKAGES_NUGET_INDEXThis feature was introduced in GitLab 12.6

This feature was introduced in GitLab 12.6

Authentication

Connected account required

Tags

Packages: NuGet
The NuGet Search ServiceGITLAB_GET_API_V4_GROUPS_ID_DASH_PACKAGES_NUGET_QUERYThis feature was introduced in GitLab 12.8

This feature was introduced in GitLab 12.8

Authentication

Connected account required

Tags

Packages: NuGet
The NuGet V2 Feed Service IndexGITLAB_GET_API_V4_GROUPS_ID_DASH_PACKAGES_NUGET_V2This feature was introduced in GitLab 16.2

This feature was introduced in GitLab 16.2

Authentication

Connected account required

Tags

Packages: NuGet
The NuGet V2 Feed Package $metadata endpointGITLAB_GET_API_V4_GROUPS_ID_DASH_PACKAGES_NUGET_V2_METADATAThis feature was introduced in GitLab 16.3

This feature was introduced in GitLab 16.3

Authentication

Connected account required

Tags

Packages: NuGet
List all packages for a groupGITLAB_GET_API_V4_GROUPS_ID_DASH_PACKAGES_PYPI_SIMPLELists all packages for a specified group in an HTML file.

Lists all packages for a specified group in an HTML file.

Authentication

Connected account required

Tags

Packages: PyPi
Search on GitLab within a groupGITLAB_GET_API_V4_GROUPS_ID_DASH_SEARCHThis feature was introduced in GitLab 10.5.

This feature was introduced in GitLab 10.5.

Authentication

Connected account required

Tags

Search
List all group deploy tokensGITLAB_GET_API_V4_GROUPS_ID_DEPLOY_TOKENSLists all group deploy tokens.

Lists all group deploy tokens.

Authentication

Connected account required

Tags

Deploy resources
Retrieve a group deploy tokenGITLAB_GET_API_V4_GROUPS_ID_DEPLOY_TOKENS_TOKEN_IDGet a single group's deploy token by ID. This feature was introduced in GitLab 14.9.

Get a single group's deploy token by ID. This feature was introduced in GitLab 14.9.

Authentication

Connected account required

Tags

Deploy resources
List all descendant groupsGITLAB_GET_API_V4_GROUPS_ID_DESCENDANT_GROUPSLists all descendant groups for a specified group.

Lists all descendant groups for a specified group.

Authentication

Connected account required

Tags

Groups
Retrieve group-level DORA metricsGITLAB_GET_API_V4_GROUPS_ID_DORA_METRICSRetrieves DORA metrics for a specified group.

Retrieves DORA metrics for a specified group.

Authentication

Connected account required

Tags

DORA metrics
List all enterprise usersGITLAB_GET_API_V4_GROUPS_ID_ENTERPRISE_USERSLists all enterprise users for a specified top-level group. Use the `page` and `per_page` pagination parameters to filter the results.

Lists all enterprise users for a specified top-level group. Use the `page` and `per_page` pagination parameters to filter the results.

Authentication

Connected account required

Tags

Enterprise users
Retrieve an enterprise userGITLAB_GET_API_V4_GROUPS_ID_ENTERPRISE_USERS_USER_IDRetrieves a specified enterprise user.

Retrieves a specified enterprise user.

Authentication

Connected account required

Tags

Enterprise users
List all epic boards in a groupGITLAB_GET_API_V4_GROUPS_ID_EPIC_BOARDSLists all epic boards for a specified group. This feature was introduced in GitLab 15.9.

Lists all epic boards for a specified group. This feature was introduced in GitLab 15.9.

Authentication

Connected account required

Tags

Epics
Retrieve a group epic boardGITLAB_GET_API_V4_GROUPS_ID_EPIC_BOARDS_BOARD_IDRetrieves a specified group epic board. This feature was introduced in GitLab 15.9.

Retrieves a specified group epic board. This feature was introduced in GitLab 15.9.

Authentication

Connected account required

Tags

Epics
List all group epic board listsGITLAB_GET_API_V4_GROUPS_ID_EPIC_BOARDS_BOARD_ID_LISTSLists all group epic board lists for a specified board. Does not include `open` and `closed` lists. This feature was introduced in GitLab 15.9.

Lists all group epic board lists for a specified board. Does not include `open` and `closed` lists. This feature was introduced in GitLab 15.9.

Authentication

Connected account required

Tags

Epics
Retrieve a group epic board listGITLAB_GET_API_V4_GROUPS_ID_EPIC_BOARDS_BOARD_ID_LISTS_LIST_IDRetrieves a specified group epic board list. This feature was introduced in GitLab 15.9.

Retrieves a specified group epic board list. This feature was introduced in GitLab 15.9.

Authentication

Connected account required

Tags

Epics
List all group epicsGITLAB_GET_API_V4_GROUPS_ID_EPICSLists all epics for a specified group and its subgroups. Responses are paginated and return 20 results by default.

Lists all epics for a specified group and its subgroups. Responses are paginated and return 20 results by default.

Authentication

Connected account required

Tags

Epics
Get details of an epicGITLAB_GET_API_V4_GROUPS_ID_EPICS_EPIC_IIDGets a single epic

Gets a single epic

Authentication

Connected account required

Tags

Epics
List all emoji reactions for an epicGITLAB_GET_API_V4_GROUPS_ID_EPICS_EPIC_IID_AWARD_EMOJILists all emoji reactions for a specified epic. This endpoint can be accessed without authentication if the epic is publicly accessible.

Lists all emoji reactions for a specified epic. This endpoint can be accessed without authentication if the epic is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve an emoji reaction from an epicGITLAB_GET_API_V4_GROUPS_ID_EPICS_EPIC_IID_AWARD_EMOJI_AWARD_IDRetrieves a specified emoji reaction from an epic. This endpoint can be accessed without authentication if the epic is publicly accessible.

Retrieves a specified emoji reaction from an epic. This endpoint can be accessed without authentication if the epic is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
List all issues for an epicGITLAB_GET_API_V4_GROUPS_ID_EPICS_EPIC_IID_ISSUESLists all issues assigned to a specified epic that are available to the authenticated user. Responses are paginated and return 20 results by default.

Lists all issues assigned to a specified epic that are available to the authenticated user. Responses are paginated and return 20 results by default.

Authentication

Connected account required

Tags

Epics
List all emoji reactions for an epic commentGITLAB_GET_API_V4_GROUPS_ID_EPICS_EPIC_IID_NOTES_NOTE_ID_AWARD_EMOJILists all emoji reactions for a specified comment on an epic. This endpoint can be accessed without authentication if the comment is publicly accessible.

Lists all emoji reactions for a specified comment on an epic. This endpoint can be accessed without authentication if the comment is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve an emoji reaction from an epic commentGITLAB_GET_API_V4_GROUPS_ID_EPICS_EPIC_IID_NOTES_NOTE_ID_AWARD_EMOJI_AWARD_IDRetrieves a specified emoji reaction from a comment on an epic. This endpoint can be accessed without authentication if the comment is publicly accessible.

Retrieves a specified emoji reaction from a comment on an epic. This endpoint can be accessed without authentication if the comment is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
List all linked epics for an epicGITLAB_GET_API_V4_GROUPS_ID_EPICS_EPIC_IID_RELATED_EPICSLists all linked epics for a specified epic.

Lists all linked epics for a specified epic.

Authentication

Connected account required

Tags

Epics
List all group epic label eventsGITLAB_GET_API_V4_GROUPS_ID_EPICS_EVENTABLE_ID_RESOURCE_LABEL_EVENTSLists all label events for a specified epic.

Lists all label events for a specified epic.

Authentication

Connected account required

Tags

Resource events
Retrieve an epic label eventGITLAB_GET_API_V4_GROUPS_ID_EPICS_EVENTABLE_ID_RESOURCE_LABEL_EVENTS_EVENT_IDRetrieves a label event for a specified group epic.

Retrieves a label event for a specified group epic.

Authentication

Connected account required

Tags

Resource events
List all group epic state eventsGITLAB_GET_API_V4_GROUPS_ID_EPICS_EVENTABLE_ID_RESOURCE_STATE_EVENTSLists all state events for a specified epic.

Lists all state events for a specified epic.

Authentication

Connected account required

Tags

Resource events
Retrieve an epic state eventGITLAB_GET_API_V4_GROUPS_ID_EPICS_EVENTABLE_ID_RESOURCE_STATE_EVENTS_EVENT_IDRetrieves a state event for a specified group epic.

Retrieves a state event for a specified group epic.

Authentication

Connected account required

Tags

Resource events
List all discussions for an epicGITLAB_GET_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_DISCUSSIONSLists all discussions for a specified epic.

Lists all discussions for a specified epic.

Authentication

Connected account required

Tags

Discussions
Retrieve a discussion for an epicGITLAB_GET_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_IDRetrieves a specified discussion for an epic.

Retrieves a specified discussion for an epic.

Authentication

Connected account required

Tags

Discussions
List comments in an epic discussionGITLAB_GET_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESLists the comments in a specified epic discussion.

Lists the comments in a specified epic discussion.

Authentication

Connected account required

Tags

Discussions
Retrieve a comment from an epic discussionGITLAB_GET_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDRetrieves a specified comment from a epic discussion.

Retrieves a specified comment from a epic discussion.

Authentication

Connected account required

Tags

Discussions
List all epic notesGITLAB_GET_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_NOTESLists all notes for a specified epic.

Lists all notes for a specified epic.

Authentication

Connected account required

Tags

Notes
Retrieve an epic noteGITLAB_GET_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_NOTES_NOTE_IDRetrieves a specified note for an epic.

Retrieves a specified note for an epic.

Authentication

Connected account required

Tags

Notes
Retrieve a group export downloadGITLAB_GET_API_V4_GROUPS_ID_EXPORT_DOWNLOADRetrieves the exported archive for a specified group.

Retrieves the exported archive for a specified group.

Authentication

Connected account required

Tags

Group import and export
Download a relations export for a groupGITLAB_GET_API_V4_GROUPS_ID_EXPORT_RELATIONS_DOWNLOADDownloads a group relations export file.

Downloads a group relations export file.

Authentication

Connected account required

Tags

Group import and export
Retrieve the status of an relations export for a groupGITLAB_GET_API_V4_GROUPS_ID_EXPORT_RELATIONS_STATUSRetrieves the status of a relations export for a group.

Retrieves the status of a relations export for a group.

Authentication

Connected account required

Tags

Group import and export
List all shared groupsGITLAB_GET_API_V4_GROUPS_ID_GROUPS_SHAREDLists all groups shared with a specified group.

Lists all groups shared with a specified group.

Authentication

Connected account required

Tags

Groups
List all group hooksGITLAB_GET_API_V4_GROUPS_ID_HOOKSLists all group hooks.

Lists all group hooks.

Authentication

Connected account required

Tags

Hooks
Retrieve a group hookGITLAB_GET_API_V4_GROUPS_ID_HOOKS_HOOK_IDRetrieves a specified group hook.

Retrieves a specified group hook.

Authentication

Connected account required

Tags

Hooks
List all eventsGITLAB_GET_API_V4_GROUPS_ID_HOOKS_HOOK_ID_EVENTSLists all events for a specified webhook.

Lists all events for a specified webhook.

Authentication

Connected account required

Tags

Hooks
List all active integrationsGITLAB_GET_API_V4_GROUPS_ID_INTEGRATIONSLists all active integrations.

Lists all active integrations.

Authentication

Connected account required

Tags

Integrations
Retrieve integration settingsGITLAB_GET_API_V4_GROUPS_ID_INTEGRATIONS_SLUGRetrieves the settings for a specified integration.

Retrieves the settings for a specified integration.

Authentication

Connected account required

Tags

Integrations
List all pending invitations for a groupGITLAB_GET_API_V4_GROUPS_ID_INVITATIONSLists all pending invitations for a specified group viewable by the authenticated user. Returns invitations to direct members only, and not through inherited ancestor groups. This function takes pagination parameters `page` and `per_page` to restrict the list of members.

Lists all pending invitations for a specified group viewable by the authenticated user. Returns invitations to direct members only, and not through inherited ancestor groups. This function takes pagination parameters `page` and `per_page` to restrict the list of members.

Authentication

Connected account required

Tags

Invitations
List all invited groupsGITLAB_GET_API_V4_GROUPS_ID_INVITED_GROUPSLists all groups invited to a specified group.

Lists all groups invited to a specified group.

Authentication

Connected account required

Tags

Groups
List all issues for a groupGITLAB_GET_API_V4_GROUPS_ID_ISSUESLists all issues for a specified group. If the group is private, you must provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Lists all issues for a specified group. If the group is private, you must provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Authentication

Connected account required

Tags

Groups
Retrieve issues statistics for a groupGITLAB_GET_API_V4_GROUPS_ID_ISSUES_STATISTICSRetrieves statistics for issues in a specified group.

Retrieves statistics for issues in a specified group.

Authentication

Connected account required

Tags

Groups
List all group iterationsGITLAB_GET_API_V4_GROUPS_ID_ITERATIONSLists all iterations for a specified group. Iterations created by **Enable automatic scheduling** in iteration cadences return `null` for the `title` and `description` fields. This feature was introduced in GitLab 13.5.

Lists all iterations for a specified group. Iterations created by **Enable automatic scheduling** in iteration cadences return `null` for the `title` and `description` fields. This feature was introduced in GitLab 13.5.

Authentication

Connected account required

Tags

Iterations
List all group labelsGITLAB_GET_API_V4_GROUPS_ID_LABELSLists all group labels for a specified group.

Lists all group labels for a specified group.

Authentication

Connected account required

Tags

Labels
Retrieve a group labelGITLAB_GET_API_V4_GROUPS_ID_LABELS_NAMERetrieves a specified group label.

Retrieves a specified group label.

Authentication

Connected account required

Tags

Labels
List all LDAP group linksGITLAB_GET_API_V4_GROUPS_ID_LDAP_GROUP_LINKSLists all LDAP group links.

Lists all LDAP group links.

Authentication

Connected account required

Tags

LDAP
List all personal access tokens for a groupGITLAB_GET_API_V4_GROUPS_ID_MANAGE_PERSONAL_ACCESS_TOKENSLists all personal access tokens associated with enterprise users in a top-level group. This feature was introduced in GitLab 17.8.

Lists all personal access tokens associated with enterprise users in a top-level group. This feature was introduced in GitLab 17.8.

Authentication

Connected account required

Tags

Group credentials inventory
List all group and project access tokens for a groupGITLAB_GET_API_V4_GROUPS_ID_MANAGE_RESOURCE_ACCESS_TOKENSLists all group and project access tokens associated with a top-level-group. This feature was introduced in GitLab 17.10.

Lists all group and project access tokens associated with a top-level-group. This feature was introduced in GitLab 17.10.

Authentication

Connected account required

Tags

Group credentials inventory
List all SSH keys for a groupGITLAB_GET_API_V4_GROUPS_ID_MANAGE_SSH_KEYSLists all SSH public keys associated with enterprise users in a top-level-group. This feature was introduced in GitLab 17.9.

Lists all SSH public keys associated with enterprise users in a top-level-group. This feature was introduced in GitLab 17.9.

Authentication

Connected account required

Tags

Group credentials inventory
List all group member rolesGITLAB_GET_API_V4_GROUPS_ID_MEMBER_ROLESLists all member roles in a specified group.

Lists all member roles in a specified group.

Authentication

Connected account required

Tags

Member roles
List all direct members of a groupGITLAB_GET_API_V4_GROUPS_ID_MEMBERSLists all direct members of a specified group viewable by the authenticated user. Does not return inherited members from ancestor groups or invited groups.

Lists all direct members of a specified group viewable by the authenticated user. Does not return inherited members from ancestor groups or invited groups.

Authentication

Connected account required

Tags

Members
List all members of a groupGITLAB_GET_API_V4_GROUPS_ID_MEMBERS_ALLLists all members of a specified group viewable by the authenticated user. Also returns inherited members from ancestor groups or invited groups. If a user is a member of this group and one or more ancestor groups, only returns the highest `access_level`. Members from an invited group are returned if the invited group is public, the requester is a member of an invited group, or the requester is a member of the shared group or project.

Lists all members of a specified group viewable by the authenticated user. Also returns inherited members from ancestor groups or invited groups. If a user is a member of this group and one or more ancestor groups, only returns the highest `access_level`. Members from an invited group are returned if the invited group is public, the requester is a member of an invited group, or the requester is a member of the shared group or project.

Authentication

Connected account required

Tags

Members
Retrieve a group memberGITLAB_GET_API_V4_GROUPS_ID_MEMBERS_ALL_USER_IDRetrieves a specified member of a group. Returns direct members and members inherited or invited through ancestor groups.

Retrieves a specified member of a group. Returns direct members and members inherited or invited through ancestor groups.

Authentication

Connected account required

Tags

Members
Retrieve a direct group memberGITLAB_GET_API_V4_GROUPS_ID_MEMBERS_USER_IDRetrieves a specified member of a group. Returns only direct members and not inherited members through ancestor groups.

Retrieves a specified member of a group. Returns only direct members and not inherited members through ancestor groups.

Authentication

Connected account required

Tags

Members
Retrieve MR approval settings for a groupGITLAB_GET_API_V4_GROUPS_ID_MERGE_REQUEST_APPROVAL_SETTINGRetrieves the merge request approval settings for a specified group.

Retrieves the merge request approval settings for a specified group.

Authentication

Connected account required

Tags

Merge request approvals
List all group merge requestsGITLAB_GET_API_V4_GROUPS_ID_MERGE_REQUESTSLists all merge requests for a specified group and any subgroups.

Lists all merge requests for a specified group and any subgroups.

Authentication

Connected account required

Tags

Merge requests
List all group milestonesGITLAB_GET_API_V4_GROUPS_ID_MILESTONESLists all group milestones for a specified group.

Lists all group milestones for a specified group.

Authentication

Connected account required

Tags

Milestones
Retrieve a group milestoneGITLAB_GET_API_V4_GROUPS_ID_MILESTONES_MILESTONE_IDRetrieves a specified group milestone.

Retrieves a specified group milestone.

Authentication

Connected account required

Tags

Milestones
List all burndown chart events for a milestoneGITLAB_GET_API_V4_GROUPS_ID_MILESTONES_MILESTONE_ID_BURNDOWN_EVENTSLists all burndown chart events for a specified milestone.

Lists all burndown chart events for a specified milestone.

Authentication

Connected account required

Tags

Milestones
List all issues assigned to a single milestoneGITLAB_GET_API_V4_GROUPS_ID_MILESTONES_MILESTONE_ID_ISSUESLists all issues assigned to a specified group milestone.

Lists all issues assigned to a specified group milestone.

Authentication

Connected account required

Tags

Milestones
List all merge requests assigned to a single milestoneGITLAB_GET_API_V4_GROUPS_ID_MILESTONES_MILESTONE_ID_MERGE_REQUESTSLists all merge requests assigned to a specified group milestone.

Lists all merge requests assigned to a specified group milestone.

Authentication

Connected account required

Tags

Milestones
Retrieve notification settings for a groupGITLAB_GET_API_V4_GROUPS_ID_NOTIFICATION_SETTINGSRetrieves the notification level for a specified group.

Retrieves the notification level for a specified group.

Authentication

Connected account required

Tags

Notification settings
List all packages for a groupGITLAB_GET_API_V4_GROUPS_ID_PACKAGESLists all packages for a specified group. When accessed without authentication, only packages of public projects are returned. By default, packages with `default`, `deprecated`, and `error` status are returned. Use the `status` parameter to view other packages.

Lists all packages for a specified group. When accessed without authentication, only packages of public projects are returned. By default, packages with `default`, `deprecated`, and `error` status are returned. Use the `status` parameter to view other packages.

Authentication

Connected account required

Tags

Packages
List all pending group membersGITLAB_GET_API_V4_GROUPS_ID_PENDING_MEMBERSLists all members in an `awaiting` state and those who are invited but do not have a GitLab account for a specified group and any subgroups and projects. This operation works on top-level groups only. It does not work on subgroups.

Lists all members in an `awaiting` state and those who are invited but do not have a GitLab account for a specified group and any subgroups and projects. This operation works on top-level groups only. It does not work on subgroups.

Authentication

Connected account required

Tags

Members
Retrieve pending reassignmentsGITLAB_GET_API_V4_GROUPS_ID_PLACEHOLDER_REASSIGNMENTSRetrieves a CSV file with a list of pending reassignments. This feature was introduced in GitLab 17.10.

Retrieves a CSV file with a list of pending reassignments. This feature was introduced in GitLab 17.10.

Authentication

Connected account required

Tags

Groups
List all projects in a groupGITLAB_GET_API_V4_GROUPS_ID_PROJECTSLists all projects in a specified group accessible to the authenticated user. Unauthenticated requests return only public projects with a limited subset of attributes.

Lists all projects in a specified group accessible to the authenticated user. Unauthenticated requests return only public projects with a limited subset of attributes.

Authentication

Connected account required

Tags

Groups
List all shared projectsGITLAB_GET_API_V4_GROUPS_ID_PROJECTS_SHAREDLists all projects shared with a specified group.

Lists all projects shared with a specified group.

Authentication

Connected account required

Tags

Groups
List all protected branchesGITLAB_GET_API_V4_GROUPS_ID_PROTECTED_BRANCHESLists all protected branches from a group. If a wildcard is set, it is returned instead of the exact name of the branches that match that wildcard.

Lists all protected branches from a group. If a wildcard is set, it is returned instead of the exact name of the branches that match that wildcard.

Authentication

Connected account required

Tags

Protected branches
Retrieve a protected branchGITLAB_GET_API_V4_GROUPS_ID_PROTECTED_BRANCHES_NAMERetrieves a specified protected branch. Retrieve multiple branches by using a wildcard in the `name`.

Retrieves a specified protected branch. Retrieve multiple branches by using a wildcard in the `name`.

Authentication

Connected account required

Tags

Protected branches
List all protected environments for a groupGITLAB_GET_API_V4_GROUPS_ID_PROTECTED_ENVIRONMENTSLists all protected environments for a specified group.

Lists all protected environments for a specified group.

Authentication

Connected account required

Tags

Protected environments
Retrieve a protected environment for a groupGITLAB_GET_API_V4_GROUPS_ID_PROTECTED_ENVIRONMENTS_NAMERetrieves a specified protected environment for a group.

Retrieves a specified protected environment for a group.

Authentication

Connected account required

Tags

Protected environments
List all provisioned usersGITLAB_GET_API_V4_GROUPS_ID_PROVISIONED_USERSLists all provisioned users for a specified group.

Lists all provisioned users for a specified group.

Authentication

Connected account required

Tags

Groups
Retrieve the push rules of a groupGITLAB_GET_API_V4_GROUPS_ID_PUSH_RULERetrieves the push rules of a specified group.

Retrieves the push rules of a specified group.

Authentication

Connected account required

Tags

Push rules
List all registry repositories for a groupGITLAB_GET_API_V4_GROUPS_ID_REGISTRY_REPOSITORIESLists all registry repositories for a specified group.

Lists all registry repositories for a specified group.

Authentication

Connected account required

Tags

Container registry
List all related epic links for a groupGITLAB_GET_API_V4_GROUPS_ID_RELATED_EPIC_LINKSLists all related epic links for a specified group and its subgroups. The user needs to have access to both the `source_epic` and `target_epic` to view the related epic link.

Lists all related epic links for a specified group and its subgroups. The user needs to have access to both the `source_epic` and `target_epic` to view the related epic link.

Authentication

Connected account required

Tags

Epics
List all releases in a groupGITLAB_GET_API_V4_GROUPS_ID_RELEASESLists all releases for projects in a specified group.

Lists all releases for projects in a specified group.

Authentication

Connected account required

Tags

Releases
List all repository storage moves for a groupGITLAB_GET_API_V4_GROUPS_ID_REPOSITORY_STORAGE_MOVESLists all repository storage moves for a specified group.

Lists all repository storage moves for a specified group.

Authentication

Connected account required

Tags

Storage moves
Retrieve a repository storage move for a groupGITLAB_GET_API_V4_GROUPS_ID_REPOSITORY_STORAGE_MOVES_REPOSITORY_STORAGE_MOVE_IDRetrieves a specified repository storage move for a group. This feature was introduced in GitLab 13.9.

Retrieves a specified repository storage move for a group. This feature was introduced in GitLab 13.9.

Authentication

Connected account required

Tags

Storage moves
List all runners in a groupGITLAB_GET_API_V4_GROUPS_ID_RUNNERSLists all runners available in a specified group and any ancestor groups, including any allowed instance runners.

Lists all runners available in a specified group and any ancestor groups, including any allowed instance runners.

Authentication

Connected account required

Tags

RunnersGroups
Lists SAML group linksGITLAB_GET_API_V4_GROUPS_ID_SAML_GROUP_LINKSGet SAML group links for a group

Get SAML group links for a group

Authentication

Connected account required

Tags

SAML group links
Get SAML group linkGITLAB_GET_API_V4_GROUPS_ID_SAML_GROUP_LINKS_SAML_GROUP_NAMEGet a SAML group link for the group

Get a SAML group link for the group

Authentication

Connected account required

Tags

SAML group links
Retrieve SAML identities for a groupGITLAB_GET_API_V4_GROUPS_ID_SAML_IDENTITIESRetrieves SAML identities for a group.

Retrieves SAML identities for a group.

Authentication

Connected account required

Tags

Provider identities
Retrieve a SAML identityGITLAB_GET_API_V4_GROUPS_ID_SAML_UIDRetrieves a specified SAML identity.

Retrieves a specified SAML identity.

Authentication

Connected account required

Tags

Provider identities
List all SAML usersGITLAB_GET_API_V4_GROUPS_ID_SAML_USERSLists all SAML users for a specified top-level group. Use the `page` and `per_page` pagination parameters to filter the results.

Lists all SAML users for a specified top-level group. Use the `page` and `per_page` pagination parameters to filter the results.

Authentication

Connected account required

Tags

Groups
Retrieve SCIM identities for a groupGITLAB_GET_API_V4_GROUPS_ID_SCIM_IDENTITIESRetrieves SCIM identities for a group.

Retrieves SCIM identities for a group.

Authentication

Connected account required

Tags

Provider identities
Retrieve a SCIM identityGITLAB_GET_API_V4_GROUPS_ID_SCIM_UIDRetrieves a specified SCIM identity.

Retrieves a specified SCIM identity.

Authentication

Connected account required

Tags

Provider identities
List all group service accountsGITLAB_GET_API_V4_GROUPS_ID_SERVICE_ACCOUNTSLists all service accounts in a specified group. Use the `page` and `per_page` pagination parameters to filter the results.

Lists all service accounts in a specified group. Use the `page` and `per_page` pagination parameters to filter the results.

Authentication

Connected account required

Tags

Service accounts
List all personal access tokens for a group service accountGITLAB_GET_API_V4_GROUPS_ID_SERVICE_ACCOUNTS_USER_ID_PERSONAL_ACCESS_TOKENSLists all personal access tokens for a specified group service account

Lists all personal access tokens for a specified group service account

Authentication

Connected account required

Tags

Access tokensService accounts
List all group SSH certificatesGITLAB_GET_API_V4_GROUPS_ID_SSH_CERTIFICATESLists all SSH certificates for a specified group.

Lists all SSH certificates for a specified group.

Authentication

Connected account required

Tags

Keys
List all subgroupsGITLAB_GET_API_V4_GROUPS_ID_SUBGROUPSLists all subgroups for a specified group.

Lists all subgroups for a specified group.

Authentication

Connected account required

Tags

Groups
List all transfer locations for a groupGITLAB_GET_API_V4_GROUPS_ID_TRANSFER_LOCATIONSLists all groups that a specified source group can be transferred to.

Lists all groups that a specified source group can be transferred to.

Authentication

Connected account required

Tags

Groups
List all uploads for a groupGITLAB_GET_API_V4_GROUPS_ID_UPLOADSLists all uploads for a specified group sorted by `created_at` in descending order. You must have the Maintainer or Owner role for the group.

Lists all uploads for a specified group sorted by `created_at` in descending order. You must have the Maintainer or Owner role for the group.

Authentication

Connected account required

Tags

Groups
Download an uploaded file by secret and filenameGITLAB_GET_API_V4_GROUPS_ID_UPLOADS_SECRET_FILENAMEDownloads an uploaded file with a specified secret and filename. You must have the Guest, Planner, Reporter, Developer, Maintainer, or Owner role for the group.

Downloads an uploaded file with a specified secret and filename. You must have the Guest, Planner, Reporter, Developer, Maintainer, or Owner role for the group.

Authentication

Connected account required

Tags

Groups
Download an uploaded file by IDGITLAB_GET_API_V4_GROUPS_ID_UPLOADS_UPLOAD_IDDownloads an uploaded file with a specified ID. You must have the Maintainer or Owner role for the group.

Downloads an uploaded file with a specified ID. You must have the Maintainer or Owner role for the group.

Authentication

Connected account required

Tags

Groups
List all group variablesGITLAB_GET_API_V4_GROUPS_ID_VARIABLESLists all variables for a specified group. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Lists all variables for a specified group. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Authentication

Connected account required

Tags

CI variables
Retrieve details of a group variableGITLAB_GET_API_V4_GROUPS_ID_VARIABLES_KEYRetrieves details of a specified group variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Retrieves details of a specified group variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Authentication

Connected account required

Tags

CI variables
List all wiki page meta notesGITLAB_GET_API_V4_GROUPS_ID_WIKI_PAGES_NOTEABLE_ID_NOTESLists all notes for a specified wiki page meta.

Lists all notes for a specified wiki page meta.

Authentication

Connected account required

Tags

Notes
Retrieve a wiki page meta noteGITLAB_GET_API_V4_GROUPS_ID_WIKI_PAGES_NOTEABLE_ID_NOTES_NOTE_IDRetrieves a specified note for a wiki page meta.

Retrieves a specified note for a wiki page meta.

Authentication

Connected account required

Tags

Notes
List all wiki pages for a groupGITLAB_GET_API_V4_GROUPS_ID_WIKISLists all wiki pages for a specified group.

Lists all wiki pages for a specified group.

Authentication

Connected account required

Tags

Wikis
Retrieve a wiki page for a groupGITLAB_GET_API_V4_GROUPS_ID_WIKIS_SLUGRetrieves a specified wiki page for a group.

Retrieves a specified wiki page for a group.

Authentication

Connected account required

Tags

Wikis
List all system hooksGITLAB_GET_API_V4_HOOKSLists all system hooks for the instance.

Lists all system hooks for the instance.

Authentication

Connected account required

Tags

Hooks
Retrieve a system hookGITLAB_GET_API_V4_HOOKS_HOOK_IDRetrieves a specified system hook.

Retrieves a specified system hook.

Authentication

Connected account required

Tags

Hooks
List GitLab for Jira (Forge) namespace subscriptionsGITLAB_GET_API_V4_INTEGRATIONS_JIRA_FORGE_SUBSCRIPTIONSLists the GitLab namespaces subscribed to the Forge installation.

Lists the GitLab namespaces subscribed to the Forge installation.

Authentication

Connected account required

Tags

Jira forge subscriptions
Gets agentw infoGITLAB_GET_API_V4_INTERNAL_AGENTS_AGENTW_AGENT_INFORetrieves agent info for agentw for the given workspace token

Retrieves agent info for agentw for the given workspace token

Authentication

Connected account required

Tags

WorkspacesInternal operations
authorize_user_accessGITLAB_GET_API_V4_INTERNAL_AGENTS_AGENTW_AUTHORIZE_USER_ACCESSReturns whether the user is authorized to access the workspace.

Returns whether the user is authorized to access the workspace.

Authentication

Connected account required

Tags

WorkspacesInternal operations
server_configGITLAB_GET_API_V4_INTERNAL_AGENTS_AGENTW_SERVER_CONFIGReturns configuration for Workspaces HTTP Server.

Returns configuration for Workspaces HTTP Server.

Authentication

Connected account required

Tags

OAuth applicationsInternal operations
List Gitaly object pool membersGITLAB_GET_API_V4_INTERNAL_GITALY_OBJECT_POOL_MEMBERSList Gitaly object pool members

List Gitaly object pool members

Authentication

Connected account required

Tags

getapiv4internalgitalyobjectpoolmembers
List all issues for the currently authenticated userGITLAB_GET_API_V4_ISSUESLists all issues accessible by the currently authenticated user. By default, returns only issues created by the current user. To list all issues, use parameter `scope=all`.

Lists all issues accessible by the currently authenticated user. By default, returns only issues created by the current user. To list all issues, use parameter `scope=all`.

Authentication

Connected account required

Tags

Issues
Retrieve an issueGITLAB_GET_API_V4_ISSUES_IDRetrieves a specified issue. Administrators only.

Retrieves a specified issue. Administrators only.

Authentication

Connected account required

Tags

Issues
Retrieve issues statistics for the currently authenticated userGITLAB_GET_API_V4_ISSUES_STATISTICSRetrieves statistics for issues accessible by the currently authenticated user. By default, returns only issues created by the current user. To get all issues, set the `scope` attribute to `all`.

Retrieves statistics for issues accessible by the currently authenticated user. By default, returns only issues created by the current user. To get all issues, set the `scope` attribute to `all`.

Authentication

Connected account required

Tags

Issues
Retrieve a job by job tokenGITLAB_GET_API_V4_JOBRetrieves a job that was generated by a specified job token.

Retrieves a job that was generated by a specified job token.

Authentication

Connected account required

Tags

CI jobs
List all GitLab agents for Kubernetes by job tokenGITLAB_GET_API_V4_JOB_ALLOWED_AGENTSLists all GitLab agents for Kubernetes with a specified `CI_JOB_TOKEN`.

Lists all GitLab agents for Kubernetes with a specified `CI_JOB_TOKEN`.

Authentication

Connected account required

Tags

Agents
Download job artifactsGITLAB_GET_API_V4_JOBS_ID_ARTIFACTSDownloads artifacts for a specified job.

Downloads artifacts for a specified job.

Authentication

Connected account required

Tags

Jobs
Download an SBOM scan resultGITLAB_GET_API_V4_JOBS_ID_SBOM_SCANS_SBOM_SCAN_IDDownloads an SBOM scan result file for a specified job.

Downloads an SBOM scan result file for a specified job.

Authentication

Connected account required

Tags

Software composition analysis
Retrieve user by SSH key fingerprintGITLAB_GET_API_V4_KEYSRetrieves user by SSH key fingerprint. Administrators only.

Retrieves user by SSH key fingerprint. Administrators only.

Authentication

Connected account required

Tags

Keys
Retrieve user by SSH key IDGITLAB_GET_API_V4_KEYS_IDRetrieves user by SSH key ID. Administrators only.

Retrieves user by SSH key ID. Administrators only.

Authentication

Connected account required

Tags

Keys
List all LDAP groupsGITLAB_GET_API_V4_LDAP_GROUPSLists all LDAP groups on the GitLab instance. Limited to 20 results.

Lists all LDAP groups on the GitLab instance. Limited to 20 results.

Authentication

Connected account required

Tags

LDAP
List all LDAP groups by providerGITLAB_GET_API_V4_LDAP_PROVIDER_GROUPSLists all LDAP groups for the specified provider. Limited to 20 results.

Lists all LDAP groups for the specified provider. Limited to 20 results.

Authentication

Connected account required

Tags

LDAP
Retrieve license informationGITLAB_GET_API_V4_LICENSERetrieves information about the current license.

Retrieves information about the current license.

Authentication

Connected account required

Tags

Licenses
Retrieve a licenseGITLAB_GET_API_V4_LICENSE_IDRetrieves information about a specified license.

Retrieves information about a specified license.

Authentication

Connected account required

Tags

Licenses
Download license usage dataGITLAB_GET_API_V4_LICENSE_USAGE_EXPORTDownloads usage data for the currently active license.

Downloads usage data for the currently active license.

Authentication

Connected account required

Tags

Licenses
List all licensesGITLAB_GET_API_V4_LICENSESLists all information about all licenses.

Lists all information about all licenses.

Authentication

Connected account required

Tags

Licenses
Get MCP response listenerGITLAB_GET_API_V4_MCPListens for Model Context Protocol responses

Listens for Model Context Protocol responses

Authentication

Connected account required

Tags

MCP
List all instance member rolesGITLAB_GET_API_V4_MEMBER_ROLESLists all member roles for this GitLab instance.

Lists all member roles for this GitLab instance.

Authentication

Connected account required

Tags

Member roles
List all merge requestsGITLAB_GET_API_V4_MERGE_REQUESTSLists all merge requests accessible to the authenticated user. By default, returns only merge requests created by the current user. Use `scope=all` to get all merge requests.

Lists all merge requests accessible to the authenticated user. By default, returns only merge requests created by the current user. Use `scope=all` to get all merge requests.

Authentication

Connected account required

Tags

Merge requests
Retrieve metadata information for this GitLab instanceGITLAB_GET_API_V4_METADATARetrieves metadata information for the GitLab instance.

Retrieves metadata information for the GitLab instance.

Authentication

Connected account required

Tags

Metadata
List all namespacesGITLAB_GET_API_V4_NAMESPACESLists all namespaces available to the current user. If the user is an administrator, this endpoint returns all namespaces in the instance.

Lists all namespaces available to the current user. If the user is an administrator, this endpoint returns all namespaces in the instance.

Authentication

Connected account required

Tags

Namespaces
Retrieve namespace detailsGITLAB_GET_API_V4_NAMESPACES_IDRetrieves a specified namespace.

Retrieves a specified namespace.

Authentication

Connected account required

Tags

Namespaces
Verify namespace availabilityGITLAB_GET_API_V4_NAMESPACES_ID_EXISTSVerifies that a namespace is available for use.

Verifies that a namespace is available for use.

Authentication

Connected account required

Tags

Namespaces
Retrieve namespace subscriptionGITLAB_GET_API_V4_NAMESPACES_ID_GITLAB_SUBSCRIPTIONRetrieves GitLab subscription details for a specified namespace.

Retrieves GitLab subscription details for a specified namespace.

Authentication

Connected account required

Tags

Namespaces
Returns an add-on purchase for the namespaceGITLAB_GET_API_V4_NAMESPACES_ID_SUBSCRIPTION_ADD_ON_PURCHASE_ADD_ON_NAMEDeprecated in GitLab 17.7

Deprecated in GitLab 17.7

Authentication

Connected account required

Tags

Add on purchases
Retrieve all limit exclusionsGITLAB_GET_API_V4_NAMESPACES_STORAGE_LIMIT_EXCLUSIONSGets all records for namespaces that have been excluded

Gets all records for namespaces that have been excluded

Authentication

Connected account required

Tags

Namespaces
Retrieve global notification settingsGITLAB_GET_API_V4_NOTIFICATION_SETTINGSRetrieves the global notification level and email address.

Retrieves the global notification level and email address.

Authentication

Connected account required

Tags

Notification settings
Get vulnerabilitiesGITLAB_GET_API_V4_OCCURRENCES_VULNERABILITIESReturns vulnerabilities related to an occurrence.

Returns vulnerabilities related to an occurrence.

Authentication

Connected account required

Tags

Dependency management
List all offline transfer exportsGITLAB_GET_API_V4_OFFLINE_EXPORTSLists all offline transfer exports

Lists all offline transfer exports

Authentication

Connected account required

Tags

Offline transfers
Get offline transfer export detailsGITLAB_GET_API_V4_OFFLINE_EXPORTS_IDRetrieves details of an offline transfer export

Retrieves details of an offline transfer export

Authentication

Connected account required

Tags

Offline transfers
Retrieve a recipe snapshotGITLAB_GET_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNELRetrieves a snapshot of the files for a specified Conan recipe. The snapshot is a list of filenames with their associated MD5 hash.

Retrieves a snapshot of the files for a specified Conan recipe. The snapshot is a list of filenames with their associated MD5 hash.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a recipe manifestGITLAB_GET_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_DIGESTRetrieves a manifest that includes a list of files and associated download URLs for a specified recipe.

Retrieves a manifest that includes a list of files and associated download URLs for a specified recipe.

Authentication

Connected account required

Tags

Packages: Conan
List all recipe download URLsGITLAB_GET_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_DOWNLOAD_URLSLists all files and associated download URLs for a specified recipe in the package registry. Returns the same payload as the recipe manifest endpoint.

Lists all files and associated download URLs for a specified recipe in the package registry. Returns the same payload as the recipe manifest endpoint.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a package snapshotGITLAB_GET_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_PACKAGES_CONAN_PACKAGE_REFERENCERetrieves a snapshot of the files for a specified Conan package and reference. The snapshot is a list of filenames with their associated MD5 hash.

Retrieves a snapshot of the files for a specified Conan package and reference. The snapshot is a list of filenames with their associated MD5 hash.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a package manifestGITLAB_GET_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_PACKAGES_CONAN_PACKAGE_REFERENCE_DIGESTRetrieves a manifest that includes a list of files and associated download URLs for a specified package.

Retrieves a manifest that includes a list of files and associated download URLs for a specified package.

Authentication

Connected account required

Tags

Packages: Conan
List all package download URLsGITLAB_GET_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_PACKAGES_CONAN_PACKAGE_REFERENCE_DOWNLOAD_URLSLists all files and associated download URLs for a specified package in the package registry. Returns the same payload as the package manifest endpoint.

Lists all files and associated download URLs for a specified package in the package registry. Returns the same payload as the package manifest endpoint.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve package references metadataGITLAB_GET_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_SEARCHRetrieves the metadata for all package references of a specified package. This feature was introduced in GitLab 18.0.

Retrieves the metadata for all package references of a specified package. This feature was introduced in GitLab 18.0.

Authentication

Connected account required

Tags

Packages: Conan
Search for a Conan packageGITLAB_GET_API_V4_PACKAGES_CONAN_V1_CONANS_SEARCHSearches the instance for a specified Conan package.

Searches the instance for a specified Conan package.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a recipe fileGITLAB_GET_API_V4_PACKAGES_CONAN_V1_FILES_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_RECIPE_REVISION_EXPORT_FILE_NAMERetrieves a specified recipe file from the package registry. You must use the download URL returned from the recipe download URLs endpoint.

Retrieves a specified recipe file from the package registry. You must use the download URL returned from the recipe download URLs endpoint.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a package fileGITLAB_GET_API_V4_PACKAGES_CONAN_V1_FILES_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_RECIPE_REVISION_PACKAGE_CONAN_PACKAGE_REFERENCE_PACKAGE_REVISION_FILE_NAMERetrieves a specified package file from the package registry. You must use the download URL returned from the package download URLs endpoint.

Retrieves a specified package file from the package registry. You must use the download URL returned from the package download URLs endpoint.

Authentication

Connected account required

Tags

Packages: Conan
Verify availability of a Conan repositoryGITLAB_GET_API_V4_PACKAGES_CONAN_V1_PINGVerifies availability of a Conan repository.

Verifies availability of a Conan repository.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve an authentication tokenGITLAB_GET_API_V4_PACKAGES_CONAN_V1_USERS_AUTHENTICATERetrieves an authentication token. Creates a JSON Web Token (JWT) for use as a Bearer header in other requests to the package registry.

Retrieves an authentication token. Creates a JSON Web Token (JWT) for use as a Bearer header in other requests to the package registry.

Authentication

Connected account required

Tags

Packages: Conan
Verify authentication credentialsGITLAB_GET_API_V4_PACKAGES_CONAN_V1_USERS_CHECK_CREDENTIALSVerifies authentication credentials for a Conan package registry.

Verifies authentication credentials for a Conan package registry.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve latest version for a moduleGITLAB_GET_API_V4_PACKAGES_TERRAFORM_MODULES_V1_MODULE_NAMESPACE_MODULE_NAME_MODULE_SYSTEMRetrieves latest version for a specified module.

Retrieves latest version for a specified module.

Authentication

Connected account required

Tags

Terraform
Retrieve download URL for latest module versionGITLAB_GET_API_V4_PACKAGES_TERRAFORM_MODULES_V1_MODULE_NAMESPACE_MODULE_NAME_MODULE_SYSTEM_DOWNLOADRetrieves download URL for latest module version.

Retrieves download URL for latest module version.

Authentication

Connected account required

Tags

Terraform
List all available versions for a moduleGITLAB_GET_API_V4_PACKAGES_TERRAFORM_MODULES_V1_MODULE_NAMESPACE_MODULE_NAME_MODULE_SYSTEM_VERSIONSLists all available versions for a specified module.

Lists all available versions for a specified module.

Authentication

Connected account required

Tags

Terraform
List all Pages domainsGITLAB_GET_API_V4_PAGES_DOMAINSLists all Pages domains on the instance. You must have administrator access to the instance.

Lists all Pages domains on the instance. You must have administrator access to the instance.

Authentication

Connected account required

Tags

GitLab Pages
List all personal access tokensGITLAB_GET_API_V4_PERSONAL_ACCESS_TOKENSLists all personal access tokens accessible by the authenticated user. For administrators, returns all personal access tokens in the instance. For non-administrators, returns all of their personal access tokens.

Lists all personal access tokens accessible by the authenticated user. For administrators, returns all personal access tokens in the instance. For non-administrators, returns all of their personal access tokens.

Authentication

Connected account required

Tags

Access tokens
Retrieve a personal access tokenGITLAB_GET_API_V4_PERSONAL_ACCESS_TOKENS_IDRetrieves details for a specified personal access token. Administrators can retrieve details on any token. Non-administrators can only retrieve details on their own tokens.

Retrieves details for a specified personal access token. Administrators can retrieve details on any token. Non-administrators can only retrieve details on their own tokens.

Authentication

Connected account required

Tags

Access tokens
Retrieve a personal access tokenGITLAB_GET_API_V4_PERSONAL_ACCESS_TOKENS_SELFRetrieves a specified personal access token by passing it to the API in a header.

Retrieves a specified personal access token by passing it to the API in a header.

Authentication

Connected account required

Tags

Access tokens
List all token associationsGITLAB_GET_API_V4_PERSONAL_ACCESS_TOKENS_SELF_ASSOCIATIONSLists all groups and projects accessible by the personal access token used to authenticate the request. Generally, this includes any groups or projects that the user is a member of.

Lists all groups and projects accessible by the personal access token used to authenticate the request. Generally, this includes any groups or projects that the user is a member of.

Authentication

Connected account required

Tags

Access tokens
List all project aliasesGITLAB_GET_API_V4_PROJECT_ALIASESLists all project aliases for the instance.

Lists all project aliases for the instance.

Authentication

Connected account required

Tags

Project alias
Retrieve a project aliasGITLAB_GET_API_V4_PROJECT_ALIASES_NAMERetrieves details of a specified project alias.

Retrieves details of a specified project alias.

Authentication

Connected account required

Tags

Project alias
List all project repository storage movesGITLAB_GET_API_V4_PROJECT_REPOSITORY_STORAGE_MOVESLists all project repository storage moves.

Lists all project repository storage moves.

Authentication

Connected account required

Tags

Storage moves
Retrieve a project repository storage moveGITLAB_GET_API_V4_PROJECT_REPOSITORY_STORAGE_MOVES_REPOSITORY_STORAGE_MOVE_IDRetrieves a specified project repository storage move.

Retrieves a specified project repository storage move.

Authentication

Connected account required

Tags

Storage moves
List all projectsGITLAB_GET_API_V4_PROJECTSLists all projects. Unauthenticated requests return only public projects with a limited subset of attributes. You can filter responses by custom attributes.

Lists all projects. Unauthenticated requests return only public projects with a limited subset of attributes. You can filter responses by custom attributes.

Authentication

Connected account required

Tags

Projects
Retrieve a projectGITLAB_GET_API_V4_PROJECTS_IDRetrieves details on a specified project. This endpoint can be accessed without authentication if the project is publicly accessible.

Retrieves details on a specified project. This endpoint can be accessed without authentication if the project is publicly accessible.

Authentication

Connected account required

Tags

Projects
List all access requests for a projectGITLAB_GET_API_V4_PROJECTS_ID_ACCESS_REQUESTSLists all access requests for a specified project that are viewable by the authenticated user.

Lists all access requests for a specified project that are viewable by the authenticated user.

Authentication

Connected account required

Tags

Access requests
List all project access tokensGITLAB_GET_API_V4_PROJECTS_ID_ACCESS_TOKENSLists all project access tokens for a specified project.

Lists all project access tokens for a specified project.

Authentication

Connected account required

Tags

Access tokens
Retrieve details on a project access tokenGITLAB_GET_API_V4_PROJECTS_ID_ACCESS_TOKENS_TOKEN_IDRetrieves details on a specified project access token.

Retrieves details on a specified project access token.

Authentication

Connected account required

Tags

Access tokens
List all metric imagesGITLAB_GET_API_V4_PROJECTS_ID_ALERT_MANAGEMENT_ALERTS_ALERT_IID_METRIC_IMAGESLists all metric images for a specified alert.

Lists all metric images for a specified alert.

Authentication

Connected account required

Tags

Alert management
List deployment frequencies for the projectGITLAB_GET_API_V4_PROJECTS_ID_ANALYTICS_DEPLOYMENT_FREQUENCYList deployment frequencies for the project

List deployment frequencies for the project

Authentication

Connected account required

Tags

Analytics
List all approval rules for a projectGITLAB_GET_API_V4_PROJECTS_ID_APPROVAL_RULESLists all approval rules and any associated details for a specified project. To restrict the list of approval rules, use the `page` and `per_page` pagination parameters.

Lists all approval rules and any associated details for a specified project. To restrict the list of approval rules, use the `page` and `per_page` pagination parameters.

Authentication

Connected account required

Tags

Approval rules
Retrieve an approval rule for a projectGITLAB_GET_API_V4_PROJECTS_ID_APPROVAL_RULES_APPROVAL_RULE_IDRetrieves information about a specified approval rule for a project.

Retrieves information about a specified approval rule for a project.

Authentication

Connected account required

Tags

Approval rules
Get all project approval rulesGITLAB_GET_API_V4_PROJECTS_ID_APPROVAL_SETTINGSPrivate API subject to change

Private API subject to change

Authentication

Connected account required

Tags

Approval rules
Retrieve approval configuration for a projectGITLAB_GET_API_V4_PROJECTS_ID_APPROVALSRetrieves the approval configuration for a project.

Retrieves the approval configuration for a project.

Authentication

Connected account required

Tags

Project approvals
Retrieve an attestation bundleGITLAB_GET_API_V4_PROJECTS_ID_ATTESTATIONS_ATTESTATION_IID_DOWNLOADThis feature was introduced in GitLab 18.7

This feature was introduced in GitLab 18.7

Authentication

Connected account required

Tags

Attestations
List all attestations for a projectGITLAB_GET_API_V4_PROJECTS_ID_ATTESTATIONS_SUBJECT_DIGESTLists all attestations for a specified project and artifact hash. This feature was introduced in GitLab 18.7.

Lists all attestations for a specified project and artifact hash. This feature was introduced in GitLab 18.7.

Authentication

Connected account required

Tags

Attestations
List all project audit eventsGITLAB_GET_API_V4_PROJECTS_ID_AUDIT_EVENTSLists all audit events for a specified project.

Lists all audit events for a specified project.

Authentication

Connected account required

Tags

Projects
Retrieve a project audit eventGITLAB_GET_API_V4_PROJECTS_ID_AUDIT_EVENTS_AUDIT_EVENT_IDRetrieves an audit event for a specified project. Only available to users with at least the Developer role for the project.

Retrieves an audit event for a specified project. Only available to users with at least the Developer role for the project.

Authentication

Connected account required

Tags

Projects
Download a project avatarGITLAB_GET_API_V4_PROJECTS_ID_AVATARDownloads a project avatar. You can access this endpoint without authentication if the project is publicly accessible. This feature was introduced in GitLab 16.9.

Downloads a project avatar. You can access this endpoint without authentication if the project is publicly accessible. This feature was introduced in GitLab 16.9.

Authentication

Connected account required

Tags

Avatars
List all badges for a projectGITLAB_GET_API_V4_PROJECTS_ID_BADGESLists all badges for a specified project, including group badges.

Lists all badges for a specified project, including group badges.

Authentication

Connected account required

Tags

Badges
Retrieve a badge for a projectGITLAB_GET_API_V4_PROJECTS_ID_BADGES_BADGE_IDRetrieves a specified badge for a project.

Retrieves a specified badge for a project.

Authentication

Connected account required

Tags

Badges
Retrieve a badge preview for a projectGITLAB_GET_API_V4_PROJECTS_ID_BADGES_RENDERPreviews the final `link_url` and `image_url` for a specified project after resolving the placeholder interpolation.

Previews the final `link_url` and `image_url` for a specified project after resolving the placeholder interpolation.

Authentication

Connected account required

Tags

Badges
List all project issue boardsGITLAB_GET_API_V4_PROJECTS_ID_BOARDSLists all issue boards in a specified project.

Lists all issue boards in a specified project.

Authentication

Connected account required

Tags

Boards
Retrieve an issue boardGITLAB_GET_API_V4_PROJECTS_ID_BOARDS_BOARD_IDRetrieves a specified issue board in a project.

Retrieves a specified issue board in a project.

Authentication

Connected account required

Tags

Boards
List all board lists in an issue boardGITLAB_GET_API_V4_PROJECTS_ID_BOARDS_BOARD_ID_LISTSLists all lists in a specified issue board. Does not include `open` and `closed` lists.

Lists all lists in a specified issue board. Does not include `open` and `closed` lists.

Authentication

Connected account required

Tags

Boards
Retrieve a board listGITLAB_GET_API_V4_PROJECTS_ID_BOARDS_BOARD_ID_LISTS_LIST_IDRetrieves a specified list from an issue board.

Retrieves a specified list from an issue board.

Authentication

Connected account required

Tags

Boards
Validate existing CI/CD configurationGITLAB_GET_API_V4_PROJECTS_ID_CI_LINTValidates the `.gitlab-ci.yml` configuration for a specified project.

Validates the `.gitlab-ci.yml` configuration for a specified project.

Authentication

Connected account required

Tags

CI lint
List all agentsGITLAB_GET_API_V4_PROJECTS_ID_CLUSTER_AGENTSLists all agents registered for the project. You must have the Developer, Maintainer, or Owner role to use this endpoint.

Lists all agents registered for the project. You must have the Developer, Maintainer, or Owner role to use this endpoint.

Authentication

Connected account required

Tags

Cluster agents
Retrieve details on an agentGITLAB_GET_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_IDRetrieves details on a specified agent. You must have the Developer, Maintainer, or Owner role to use this endpoint.

Retrieves details on a specified agent. You must have the Developer, Maintainer, or Owner role to use this endpoint.

Authentication

Connected account required

Tags

Cluster agents
List all agent tokensGITLAB_GET_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_ID_TOKENSLists all active tokens for an agent. You must have the Developer, Maintainer, or Owner role to use this endpoint.

Lists all active tokens for an agent. You must have the Developer, Maintainer, or Owner role to use this endpoint.

Authentication

Connected account required

Tags

Cluster agents
Retrieve an agent tokenGITLAB_GET_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_ID_TOKENS_TOKEN_IDRetrieves a specified agent token. You must have the Developer, Maintainer, or Owner role to use this endpoint. Returns a `404` if the agent token has been revoked.

Retrieves a specified agent token. You must have the Developer, Maintainer, or Owner role to use this endpoint. Returns a `404` if the agent token has been revoked.

Authentication

Connected account required

Tags

Cluster agents
List all agent URL configurationsGITLAB_GET_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_ID_URL_CONFIGURATIONSLists all agent URL configurations for a specified agent. You must have the Developer, Maintainer, or Owner role to use this endpoint. This feature was introduced in GitLab 17.4.

Lists all agent URL configurations for a specified agent. You must have the Developer, Maintainer, or Owner role to use this endpoint. This feature was introduced in GitLab 17.4.

Authentication

Connected account required

Tags

Cluster agents
Retrieve an agent URL configurationGITLAB_GET_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_ID_URL_CONFIGURATIONS_URL_CONFIGURATION_IDRetrieves an agent URL configuration. You must have the Developer, Maintainer, or Owner role to use this endpoint. This feature was introduced in GitLab 17.4.

Retrieves an agent URL configuration. You must have the Developer, Maintainer, or Owner role to use this endpoint. This feature was introduced in GitLab 17.4.

Authentication

Connected account required

Tags

Cluster agents
List all clusters in a projectGITLAB_GET_API_V4_PROJECTS_ID_CLUSTERSLists all clusters in a specified project.

Lists all clusters in a specified project.

Authentication

Connected account required

Tags

Clusters
Retrieve a cluster from a projectGITLAB_GET_API_V4_PROJECTS_ID_CLUSTERS_CLUSTER_IDRetrieves a specified cluster in a project.

Retrieves a specified cluster in a project.

Authentication

Connected account required

Tags

Clusters
List all custom attributes for a projectGITLAB_GET_API_V4_PROJECTS_ID_CUSTOM_ATTRIBUTESLists all custom attributes for a specified project.

Lists all custom attributes for a specified project.

Authentication

Connected account required

Tags

Custom attributes
Retrieve a custom attribute for a projectGITLAB_GET_API_V4_PROJECTS_ID_CUSTOM_ATTRIBUTES_KEYRetrieves a specified custom attribute for a project.

Retrieves a specified custom attribute for a project.

Authentication

Connected account required

Tags

Custom attributes
Search a projectGITLAB_GET_API_V4_PROJECTS_ID_DASH_SEARCHSearches for content in a specified project.

Searches for content in a specified project.

Authentication

Connected account required

Tags

SearchProjects
Search project code using natural languageGITLAB_GET_API_V4_PROJECTS_ID_DASH_SEARCH_SEMANTICIntroduced in GitLab 18.11. Searches indexed project code using semantic (meaning-based) similarity rather than keyword matching. Use this when you do not know the exact symbol or file name, or to discover how a behavior is implemented across the codebase. Primary use cases: - When you do not know the exact symbol or file path - To see how a behavior or feature is implemented across the codebase - To discover related implementations (clients, jobs, workers) How to use: - Provide a concise, specific query with concrete keywords - Use directory_path to narrow scope (e.g. "app/services/") - Prefer precise intent over broad terms Results are grouped by file. Each file includes merged line ranges with content and a relevance score (0.0-1.0). The response includes an overall confidence level (high/medium/low/unknown) based on score distribution. Results are filtered by Duo context exclusion settings. Requires semantic code search to be enabled and indexed for the project namespace.

Introduced in GitLab 18.11. Searches indexed project code using semantic (meaning-based) similarity rather than keyword matching. Use this when you do not know the exact symbol or file name, or to discover how a behavior is implemented across the codebase. Primary use cases: - When you do not know the exact symbol or file path - To see how a behavior or feature is implemented across the codebase - To discover related implementations (clients, jobs, workers) How to use: - Provide a concise, specific query with concrete keywords - Use directory_path to narrow scope (e.g. "app/services/") - Prefer precise intent over broad terms Results are grouped by file. Each file includes merged line ranges with content and a relevance score (0.0-1.0). The response includes an overall confidence level (high/medium/low/unknown) based on score distribution. Results are filtered by Duo context exclusion settings. Requires semantic code search to be enabled and indexed for the project namespace.

Authentication

Connected account required

Tags

Search
List all Debian project distributionsGITLAB_GET_API_V4_PROJECTS_ID_DEBIAN_DISTRIBUTIONSLists all Debian distributions for a specified project.

Lists all Debian distributions for a specified project.

Authentication

Connected account required

Tags

Packages: Debian
Retrieve a Debian project distributionGITLAB_GET_API_V4_PROJECTS_ID_DEBIAN_DISTRIBUTIONS_CODENAMERetrieves a specified Debian project distribution for a project.

Retrieves a specified Debian project distribution for a project.

Authentication

Connected account required

Tags

Packages: Debian
Retrieve a Debian project distribution keyGITLAB_GET_API_V4_PROJECTS_ID_DEBIAN_DISTRIBUTIONS_CODENAME_KEY_ASCRetrieves a specified Debian project distribution key for a project.

Retrieves a specified Debian project distribution key for a project.

Authentication

Connected account required

Tags

Packages: Debian
List all project dependenciesGITLAB_GET_API_V4_PROJECTS_ID_DEPENDENCIESLists all dependencies for a specified project. This operation partially mirrors the dependency list feature, which is available only for languages and package managers supported by Gemnasium. Responses are paginated and return 20 results by default.

Lists all dependencies for a specified project. This operation partially mirrors the dependency list feature, which is available only for languages and package managers supported by Gemnasium. Responses are paginated and return 20 results by default.

Authentication

Connected account required

Tags

Dependency management
List all deploy keys for projectGITLAB_GET_API_V4_PROJECTS_ID_DEPLOY_KEYSLists all deploy keys for a specified project.

Lists all deploy keys for a specified project.

Authentication

Connected account required

Tags

Deploy resources
Retrieve a deploy keyGITLAB_GET_API_V4_PROJECTS_ID_DEPLOY_KEYS_KEY_IDRetrieves a specified deploy key.

Retrieves a specified deploy key.

Authentication

Connected account required

Tags

Deploy resources
List all project deploy tokensGITLAB_GET_API_V4_PROJECTS_ID_DEPLOY_TOKENSLists all project deploy tokens.

Lists all project deploy tokens.

Authentication

Connected account required

Tags

Deploy resources
Retrieve a project deploy tokenGITLAB_GET_API_V4_PROJECTS_ID_DEPLOY_TOKENS_TOKEN_IDRetrieves a project deploy token.

Retrieves a project deploy token.

Authentication

Connected account required

Tags

Deploy resources
List all project deploymentsGITLAB_GET_API_V4_PROJECTS_ID_DEPLOYMENTSLists all deployments in a project.

Lists all deployments in a project.

Authentication

Connected account required

Tags

Deploy resources
Retrieve a deploymentGITLAB_GET_API_V4_PROJECTS_ID_DEPLOYMENTS_DEPLOYMENT_IDRetrieves a specified deployment.

Retrieves a specified deployment.

Authentication

Connected account required

Tags

Deploy resources
List all merge requests associated with a deploymentGITLAB_GET_API_V4_PROJECTS_ID_DEPLOYMENTS_DEPLOYMENT_ID_MERGE_REQUESTSLists all merge requests shipped with a specified deployment.

Lists all merge requests shipped with a specified deployment.

Authentication

Connected account required

Tags

Deploy resources
Retrieve project-level DORA metricsGITLAB_GET_API_V4_PROJECTS_ID_DORA_METRICSRetrieves DORA metrics for a specified project.

Retrieves DORA metrics for a specified project.

Authentication

Connected account required

Tags

DORA metrics
List all environmentsGITLAB_GET_API_V4_PROJECTS_ID_ENVIRONMENTSLists all environments for a specified project.

Lists all environments for a specified project.

Authentication

Connected account required

Tags

Environments
Retrieve an environmentGITLAB_GET_API_V4_PROJECTS_ID_ENVIRONMENTS_ENVIRONMENT_IDRetrieves a specified environment for a project.

Retrieves a specified environment for a project.

Authentication

Connected account required

Tags

Environments
List all project client keysGITLAB_GET_API_V4_PROJECTS_ID_ERROR_TRACKING_CLIENT_KEYSLists all integrated error tracking client keys for a specified project.

Lists all integrated error tracking client keys for a specified project.

Authentication

Connected account required

Tags

Error tracking
Retrieve Error Tracking settings for a projectGITLAB_GET_API_V4_PROJECTS_ID_ERROR_TRACKING_SETTINGSRetrieves the Error Tracking settings for a specified project.

Retrieves the Error Tracking settings for a specified project.

Authentication

Connected account required

Tags

Error tracking
List all visible events for a projectGITLAB_GET_API_V4_PROJECTS_ID_EVENTSLists all visible events for a specified project. When a push exceeds the Push event activities limit, a single bulk push event is returned instead of individual commit events. Bulk push events have limited commit details: `commit_count` is `0`, `ref_count` shows the number of refs pushed, and individual commit attributes are `null`.

Lists all visible events for a specified project. When a push exceeds the Push event activities limit, a single bulk push event is returned instead of individual commit events. Bulk push events have limited commit details: `commit_count` is `0`, `ref_count` shows the number of refs pushed, and individual commit attributes are `null`.

Authentication

Connected account required

Tags

Events
Retrieve the status of a project exportGITLAB_GET_API_V4_PROJECTS_ID_EXPORTRetrieves the status of the most recent export for a specified project.

Retrieves the status of the most recent export for a specified project.

Authentication

Connected account required

Tags

Project import
Download a project exportGITLAB_GET_API_V4_PROJECTS_ID_EXPORT_DOWNLOADDownloads the most recent export of a specified project.

Downloads the most recent export of a specified project.

Authentication

Connected account required

Tags

Project import
Download a relations export for a projectGITLAB_GET_API_V4_PROJECTS_ID_EXPORT_RELATIONS_DOWNLOADDownloads a project relations export file.

Downloads a project relations export file.

Authentication

Connected account required

Tags

Project import
Retrieve the status of an relations export for a projectGITLAB_GET_API_V4_PROJECTS_ID_EXPORT_RELATIONS_STATUSRetrieves the status of a relations export for a project.

Retrieves the status of a relations export for a project.

Authentication

Connected account required

Tags

Project import
Retrieve project external status check servicesGITLAB_GET_API_V4_PROJECTS_ID_EXTERNAL_STATUS_CHECKSRetrieves information on external status check services for a project.

Retrieves information on external status check services for a project.

Authentication

Connected account required

Tags

External status checks
List all feature flags for a projectGITLAB_GET_API_V4_PROJECTS_ID_FEATURE_FLAGSLists all feature flags of the requested project. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Lists all feature flags of the requested project. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Authentication

Connected account required

Tags

Feature flags
Retrieve a feature flagGITLAB_GET_API_V4_PROJECTS_ID_FEATURE_FLAGS_FEATURE_FLAG_NAMERetrieves a specified feature flag.

Retrieves a specified feature flag.

Authentication

Connected account required

Tags

Feature flags
List all feature flag user lists for a projectGITLAB_GET_API_V4_PROJECTS_ID_FEATURE_FLAGS_USER_LISTSLists all feature flag user lists for a specified project.

Lists all feature flag user lists for a specified project.

Authentication

Connected account required

Tags

Feature flags
Retrieve a feature flag user listGITLAB_GET_API_V4_PROJECTS_ID_FEATURE_FLAGS_USER_LISTS_IIDRetrieves a specified feature flag user list.

Retrieves a specified feature flag user list.

Authentication

Connected account required

Tags

Feature flags
List all forks of a projectGITLAB_GET_API_V4_PROJECTS_ID_FORKSLists all forks of a project.

Lists all forks of a project.

Authentication

Connected account required

Tags

Projects
List all freeze periodsGITLAB_GET_API_V4_PROJECTS_ID_FREEZE_PERIODSLists all freeze periods for a specified project.

Lists all freeze periods for a specified project.

Authentication

Connected account required

Tags

Freeze periods
Retrieve a freeze periodGITLAB_GET_API_V4_PROJECTS_ID_FREEZE_PERIODS_FREEZE_PERIOD_IDRetrieves a freeze period for a specified `freeze_period_id`. You must have the Reporter, Developer, Maintainer, or Owner role for the project.

Retrieves a freeze period for a specified `freeze_period_id`. You must have the Reporter, Developer, Maintainer, or Owner role for the project.

Authentication

Connected account required

Tags

Freeze periods
Retrieve setup script for Google Cloud integrationGITLAB_GET_API_V4_PROJECTS_ID_GOOGLE_CLOUD_SETUP_INTEGRATIONS_SHRetrieves the setup script for Google Cloud integration.

Retrieves the setup script for Google Cloud integration.

Authentication

Connected account required

Tags

Project Google Cloud integration
Retrieve configuration script for Google Cloud runner provisioningGITLAB_GET_API_V4_PROJECTS_ID_GOOGLE_CLOUD_SETUP_RUNNER_DEPLOYMENT_PROJECT_SHRetrieves the configuration script for Google Cloud runner provisioning.

Retrieves the configuration script for Google Cloud runner provisioning.

Authentication

Connected account required

Tags

Project Google Cloud integration
List all ancestor groupsGITLAB_GET_API_V4_PROJECTS_ID_GROUPSLists all ancestor groups for a specified project.

Lists all ancestor groups for a specified project.

Authentication

Connected account required

Tags

Projects
List all webhooks for a projectGITLAB_GET_API_V4_PROJECTS_ID_HOOKSLists all webhooks for a specified project.

Lists all webhooks for a specified project.

Authentication

Connected account required

Tags

Hooks
Retrieve a project webhookGITLAB_GET_API_V4_PROJECTS_ID_HOOKS_HOOK_IDRetrieves a specified webhook for a project.

Retrieves a specified webhook for a project.

Authentication

Connected account required

Tags

Hooks
List all eventsGITLAB_GET_API_V4_PROJECTS_ID_HOOKS_HOOK_ID_EVENTSLists all events for a specified webhook.

Lists all events for a specified webhook.

Authentication

Connected account required

Tags

Hooks
Retrieve the status of a project importGITLAB_GET_API_V4_PROJECTS_ID_IMPORTRetrieves the status of the most recent import for a specified project.

Retrieves the status of the most recent import for a specified project.

Authentication

Connected account required

Tags

Project import
List all active integrationsGITLAB_GET_API_V4_PROJECTS_ID_INTEGRATIONSLists all active integrations.

Lists all active integrations.

Authentication

Connected account required

Tags

Integrations
Retrieve integration settingsGITLAB_GET_API_V4_PROJECTS_ID_INTEGRATIONS_SLUGRetrieves the settings for a specified integration.

Retrieves the settings for a specified integration.

Authentication

Connected account required

Tags

Integrations
List all pending invitations for a projectGITLAB_GET_API_V4_PROJECTS_ID_INVITATIONSLists all pending invitations for a specified project viewable by the authenticated user. Returns invitations to direct members only, and not through inherited ancestor groups. This function takes pagination parameters `page` and `per_page` to restrict the list of members.

Lists all pending invitations for a specified project viewable by the authenticated user. Returns invitations to direct members only, and not through inherited ancestor groups. This function takes pagination parameters `page` and `per_page` to restrict the list of members.

Authentication

Connected account required

Tags

Invitations
List all invited groups in a projectGITLAB_GET_API_V4_PROJECTS_ID_INVITED_GROUPSLists all invited groups in a project. Unauthenticated requests return only public invited groups. Limited to 60 requests a minute per user account for authenticated requires and per IP address for unauthenticated requests. Supports offset-based pagination (up to 50,000 projects) and keyset-based pagination (greater than 50,000 projects).

Lists all invited groups in a project. Unauthenticated requests return only public invited groups. Limited to 60 requests a minute per user account for authenticated requires and per IP address for unauthenticated requests. Supports offset-based pagination (up to 50,000 projects) and keyset-based pagination (greater than 50,000 projects).

Authentication

Connected account required

Tags

Projects
List all project issuesGITLAB_GET_API_V4_PROJECTS_ID_ISSUESLists all issues for a specified project. If the project is private, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Lists all issues for a specified project. If the project is private, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Authentication

Connected account required

Tags

Projects
List all issue iteration eventsGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_ITERATION_EVENTSLists all iteration events for a specified issue.

Lists all iteration events for a specified issue.

Authentication

Connected account required

Tags

Resource events
Retrieve an issue iteration eventGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_ITERATION_EVENTS_EVENT_IDRetrieves an iteration event for a specified issue.

Retrieves an iteration event for a specified issue.

Authentication

Connected account required

Tags

Resource events
List all project issue label eventsGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_LABEL_EVENTSLists all label events for a specified issue.

Lists all label events for a specified issue.

Authentication

Connected account required

Tags

Resource events
Retrieve an issue label eventGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_LABEL_EVENTS_EVENT_IDRetrieves a label event for a specified project issue.

Retrieves a label event for a specified project issue.

Authentication

Connected account required

Tags

Resource events
List all project issue milestone eventsGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_MILESTONE_EVENTSLists all milestone events for a specified issue.

Lists all milestone events for a specified issue.

Authentication

Connected account required

Tags

Resource events
Retrieve an issue milestone eventGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_MILESTONE_EVENTS_EVENT_IDRetrieves a specified milestone event for a project issue.

Retrieves a specified milestone event for a project issue.

Authentication

Connected account required

Tags

Resource events
List all project issue state eventsGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_STATE_EVENTSLists all state events for a specified issue.

Lists all state events for a specified issue.

Authentication

Connected account required

Tags

Resource events
Retrieve an issue state eventGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_STATE_EVENTS_EVENT_IDRetrieves a state event for a specified project issue.

Retrieves a state event for a specified project issue.

Authentication

Connected account required

Tags

Resource events
List all project issue weight eventsGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_WEIGHT_EVENTSLists all weight events for a specified issue.

Lists all weight events for a specified issue.

Authentication

Connected account required

Tags

Resource events
Retrieve single issue weight eventGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_EVENTABLE_ID_RESOURCE_WEIGHT_EVENTS_EVENT_IDRetrieves a single weight event for a specified project issue.

Retrieves a single weight event for a specified project issue.

Authentication

Connected account required

Tags

Resource events
Retrieve a project issueGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IIDRetrieves a specified issue for a project. If the project is private or the issue is confidential, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Retrieves a specified issue for a project. If the project is private or the issue is confidential, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Authentication

Connected account required

Tags

Projects
List all emoji reactions for an issueGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_AWARD_EMOJILists all emoji reactions for a specified issue. This endpoint can be accessed without authentication if the issue is publicly accessible.

Lists all emoji reactions for a specified issue. This endpoint can be accessed without authentication if the issue is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve an emoji reaction from an issueGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_AWARD_EMOJI_AWARD_IDRetrieves a specified emoji reaction from an issue. This endpoint can be accessed without authentication if the issue is publicly accessible.

Retrieves a specified emoji reaction from an issue. This endpoint can be accessed without authentication if the issue is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
List all merge requests that close an issue on mergeGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_CLOSED_BYLists all merge requests that close a specified issue when merged. If the project is private or the issue is confidential, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Lists all merge requests that close a specified issue when merged. If the project is private or the issue is confidential, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Authentication

Connected account required

Tags

Projects
List all issue linksGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_LINKSLists all linked issues for a specified issue, sorted by the relationship creation datetime (ascending). Issues are filtered according to the user authorizations.

Lists all linked issues for a specified issue, sorted by the relationship creation datetime (ascending). Issues are filtered according to the user authorizations.

Authentication

Connected account required

Tags

Issues
Retrieve an issue linkGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_LINKS_ISSUE_LINK_IDRetrieves a specified issue link.

Retrieves a specified issue link.

Authentication

Connected account required

Tags

Issues
List all metric images for an incidentGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_METRIC_IMAGESLists all metric images for an incident.

Lists all metric images for an incident.

Authentication

Connected account required

Tags

Metric images
List all emoji reactions for an issue commentGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_NOTES_NOTE_ID_AWARD_EMOJILists all emoji reactions for a specified comment on an issue. This endpoint can be accessed without authentication if the comment is publicly accessible.

Lists all emoji reactions for a specified comment on an issue. This endpoint can be accessed without authentication if the comment is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve an emoji reaction from an issue commentGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_NOTES_NOTE_ID_AWARD_EMOJI_AWARD_IDRetrieves a specified emoji reaction from a comment on an issue. This endpoint can be accessed without authentication if the comment is publicly accessible.

Retrieves a specified emoji reaction from a comment on an issue. This endpoint can be accessed without authentication if the comment is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
List all participants in an issueGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_PARTICIPANTSLists all users that are participants in a specified issue. If the project is private or the issue is confidential, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Lists all users that are participants in a specified issue. If the project is private or the issue is confidential, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Authentication

Connected account required

Tags

Issues
List all merge requests related to an issueGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_RELATED_MERGE_REQUESTSLists all merge requests that are related to a specified issue. If the project is private or the issue is confidential, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Lists all merge requests that are related to a specified issue. If the project is private or the issue is confidential, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.

Authentication

Connected account required

Tags

Issues
Retrieve time tracking stats for an issueGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_TIME_STATSRetrieves time tracking stats for a specified issue, including time estimate and time spent in seconds and human-readable format (for example, `1h 30m`).

Retrieves time tracking stats for a specified issue, including time estimate and time spent in seconds and human-readable format (for example, `1h 30m`).

Authentication

Connected account required

Tags

Issues
Retrieve user agent details for an issueGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_USER_AGENT_DETAILRetrieves user agent details for an issue.

Retrieves user agent details for an issue.

Authentication

Connected account required

Tags

Issues
List all discussions for an issueGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_DISCUSSIONSLists all discussions for a specified issue.

Lists all discussions for a specified issue.

Authentication

Connected account required

Tags

Discussions
Retrieve a discussion for an issueGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_IDRetrieves a specified discussion for an issue.

Retrieves a specified discussion for an issue.

Authentication

Connected account required

Tags

Discussions
List comments in an issue discussionGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESLists the comments in a specified issue discussion.

Lists the comments in a specified issue discussion.

Authentication

Connected account required

Tags

Discussions
Retrieve a comment from an issue discussionGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDRetrieves a specified comment from a issue discussion.

Retrieves a specified comment from a issue discussion.

Authentication

Connected account required

Tags

Discussions
List all issue notesGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_NOTESLists all notes for a specified issue.

Lists all notes for a specified issue.

Authentication

Connected account required

Tags

Notes
Retrieve an issue noteGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_NOTES_NOTE_IDRetrieves a specified note for an issue.

Retrieves a specified note for an issue.

Authentication

Connected account required

Tags

Notes
Retrieve issues statistics for a projectGITLAB_GET_API_V4_PROJECTS_ID_ISSUES_STATISTICSRetrieves statistics for issues in a specified project.

Retrieves statistics for issues in a specified project.

Authentication

Connected account required

Tags

Projects
List all project iterationsGITLAB_GET_API_V4_PROJECTS_ID_ITERATIONSLists all iterations for a specified project. Iterations created by **Enable automatic scheduling** in iteration cadences return `null` for the `title` and `description` fields. This feature was introduced in GitLab 13.5.

Lists all iterations for a specified project. Iterations created by **Enable automatic scheduling** in iteration cadences return `null` for the `title` and `description` fields. This feature was introduced in GitLab 13.5.

Authentication

Connected account required

Tags

Iterations
Retrieve the CI/CD job token access settings for a projectGITLAB_GET_API_V4_PROJECTS_ID_JOB_TOKEN_SCOPERetrieves the CI/CD job token access settings (job token scope) of a specified project.

Retrieves the CI/CD job token access settings (job token scope) of a specified project.

Authentication

Connected account required

Tags

Projects job token scope
List all projects in a CI/CD job token allowlistGITLAB_GET_API_V4_PROJECTS_ID_JOB_TOKEN_SCOPE_ALLOWLISTLists all projects in the CI/CD job token allowlist of a specified project.

Lists all projects in the CI/CD job token allowlist of a specified project.

Authentication

Connected account required

Tags

Projects job token scope
List all groups in a CI/CD job token allowlistGITLAB_GET_API_V4_PROJECTS_ID_JOB_TOKEN_SCOPE_GROUPS_ALLOWLISTLists all groups in the CI/CD job token allowlist of a specified project.

Lists all groups in the CI/CD job token allowlist of a specified project.

Authentication

Connected account required

Tags

Projects job token scope
List all jobs for a projectGITLAB_GET_API_V4_PROJECTS_ID_JOBSLists all jobs for a specified project. By default, this request returns 20 results at a time because the API results are paginated.

Lists all jobs for a specified project. By default, this request returns 20 results at a time because the API results are paginated.

Authentication

Connected account required

Tags

CI jobs
Retrieve job artifactsGITLAB_GET_API_V4_PROJECTS_ID_JOBS_ARTIFACTS_REF_NAME_DOWNLOADRetrieves the artifacts archive for the latest successful job on a specified branch or tag.

Retrieves the artifacts archive for the latest successful job on a specified branch or tag.

Authentication

Connected account required

Tags

Job artifacts
Retrieve a jobGITLAB_GET_API_V4_PROJECTS_ID_JOBS_JOB_IDRetrieves a job with the specified job ID.

Retrieves a job with the specified job ID.

Authentication

Connected account required

Tags

CI jobs
Download the artifacts archive from a jobGITLAB_GET_API_V4_PROJECTS_ID_JOBS_JOB_ID_ARTIFACTSThis feature was introduced in GitLab 8.5

This feature was introduced in GitLab 8.5

Authentication

Connected account required

Tags

Job artifacts
List all files in an artifacts archiveGITLAB_GET_API_V4_PROJECTS_ID_JOBS_JOB_ID_ARTIFACTS_TREELists all files in a specified artifacts archive without extracting them.

Lists all files in a specified artifacts archive without extracting them.

Authentication

Connected account required

Tags

Job artifacts
Get a trace of a specific job of a projectGITLAB_GET_API_V4_PROJECTS_ID_JOBS_JOB_ID_TRACERetrieves a log file for a job.

Retrieves a log file for a job.

Authentication

Connected account required

Tags

CI jobs
List all project labelsGITLAB_GET_API_V4_PROJECTS_ID_LABELSLists all labels for a specified project. By default, this request returns 20 results at a time because the API results are paginated.

Lists all labels for a specified project. By default, this request returns 20 results at a time because the API results are paginated.

Authentication

Connected account required

Tags

Labels
Retrieve a project labelGITLAB_GET_API_V4_PROJECTS_ID_LABELS_NAMERetrieves a specified label for a project.

Retrieves a specified label for a project.

Authentication

Connected account required

Tags

Labels
Retrieve programming language usage informationGITLAB_GET_API_V4_PROJECTS_ID_LANGUAGESRetrieves information about all programming languages used in a specified project.

Retrieves information about all programming languages used in a specified project.

Authentication

Connected account required

Tags

Projects
List all software license policiesGITLAB_GET_API_V4_PROJECTS_ID_MANAGED_LICENSESLists all software license policies for a specified project.

Lists all software license policies for a specified project.

Authentication

Connected account required

Tags

Licenses
Retrieve a software license policyGITLAB_GET_API_V4_PROJECTS_ID_MANAGED_LICENSES_MANAGED_LICENSE_IDRetrieves a specified software license policy from a project.

Retrieves a specified software license policy from a project.

Authentication

Connected account required

Tags

Licenses
List all direct members of a projectGITLAB_GET_API_V4_PROJECTS_ID_MEMBERSLists all direct members of a specified project viewable by the authenticated user. Does not return inherited members from ancestor groups or invited groups.

Lists all direct members of a specified project viewable by the authenticated user. Does not return inherited members from ancestor groups or invited groups.

Authentication

Connected account required

Tags

Members
List all members of a projectGITLAB_GET_API_V4_PROJECTS_ID_MEMBERS_ALLLists all members of a specified project viewable by the authenticated user. Also returns inherited members from ancestor groups or invited groups. If a user is a member of this project and one or more ancestor groups, only returns the highest `access_level`. Members from an invited group are returned if the invited group is public, the requester is a member of an invited group, or the requester is a member of the shared group or project.

Lists all members of a specified project viewable by the authenticated user. Also returns inherited members from ancestor groups or invited groups. If a user is a member of this project and one or more ancestor groups, only returns the highest `access_level`. Members from an invited group are returned if the invited group is public, the requester is a member of an invited group, or the requester is a member of the shared group or project.

Authentication

Connected account required

Tags

Members
Retrieve a project memberGITLAB_GET_API_V4_PROJECTS_ID_MEMBERS_ALL_USER_IDRetrieves a specified member of a project. Returns direct members and members inherited or invited through ancestor groups.

Retrieves a specified member of a project. Returns direct members and members inherited or invited through ancestor groups.

Authentication

Connected account required

Tags

Members
Retrieve a direct project memberGITLAB_GET_API_V4_PROJECTS_ID_MEMBERS_USER_IDRetrieves a specified member of a project. Returns only direct members and not inherited members through ancestor groups.

Retrieves a specified member of a project. Returns only direct members and not inherited members through ancestor groups.

Authentication

Connected account required

Tags

Members
Retrieve MR approval settings for a projectGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUEST_APPROVAL_SETTINGRetrieves the merge request approval settings for a specified project.

Retrieves the merge request approval settings for a specified project.

Authentication

Connected account required

Tags

Merge request approvals
List all project merge requestsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTSLists all project merge requests.

Lists all project merge requests.

Authentication

Connected account required

Tags

Merge requests
List all project merge request label eventsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_EVENTABLE_ID_RESOURCE_LABEL_EVENTSLists all label events for a specified merge request.

Lists all label events for a specified merge request.

Authentication

Connected account required

Tags

Resource events
Retrieve a merge request label eventGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_EVENTABLE_ID_RESOURCE_LABEL_EVENTS_EVENT_IDRetrieves a label event for a specified project merge request.

Retrieves a label event for a specified project merge request.

Authentication

Connected account required

Tags

Resource events
List all project merge request milestone eventsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_EVENTABLE_ID_RESOURCE_MILESTONE_EVENTSLists all milestone events for a specified merge request.

Lists all milestone events for a specified merge request.

Authentication

Connected account required

Tags

Resource events
Retrieve a merge request milestone eventGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_EVENTABLE_ID_RESOURCE_MILESTONE_EVENTS_EVENT_IDRetrieves a specified milestone event for a project merge request.

Retrieves a specified milestone event for a project merge request.

Authentication

Connected account required

Tags

Resource events
List all project merge request state eventsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_EVENTABLE_ID_RESOURCE_STATE_EVENTSLists all state events for a specified merge request.

Lists all state events for a specified merge request.

Authentication

Connected account required

Tags

Resource events
Retrieve a merge request state eventGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_EVENTABLE_ID_RESOURCE_STATE_EVENTS_EVENT_IDRetrieves a state event for a specified project merge request.

Retrieves a state event for a specified project merge request.

Authentication

Connected account required

Tags

Resource events
Retrieve a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IIDRetrieves a merge request for a specified project.

Retrieves a merge request for a specified project.

Authentication

Connected account required

Tags

Merge requests
List all approval rules for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_APPROVAL_RULESLists all approval rules and any associated details for a specified merge request. Use the `page` and `per_page` pagination parameters to restrict the list of approval rules.

Lists all approval rules and any associated details for a specified merge request. Use the `page` and `per_page` pagination parameters to restrict the list of approval rules.

Authentication

Connected account required

Tags

Merge request approvals
Retrieve an approval rule for a specific merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_APPROVAL_RULES_APPROVAL_RULE_IDRetrieves information about an approval rule for a specified merge request.

Retrieves information about an approval rule for a specified merge request.

Authentication

Connected account required

Tags

Merge request approvals
Retrieve approval details for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_APPROVAL_STATERetrieves approval details for a specified merge request. If a user has modified the approval rules for the merge request, the response includes `approval_rules_overwritten`.

Retrieves approval details for a specified merge request. If a user has modified the approval rules for the merge request, the response includes `approval_rules_overwritten`.

Authentication

Connected account required

Tags

Merge request approvals
Retrieve approval state for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_APPROVALSRetrieves the approval state for a specified merge request. In the response, `approved_by` contains information about all approvers of the merge request, regardless of whether those approvals satisfy any approval rule.

Retrieves the approval state for a specified merge request. In the response, `approved_by` contains information about all approvers of the merge request, regardless of whether those approvals satisfy any approval rule.

Authentication

Connected account required

Tags

Merge request approvals
List all emoji reactions for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_AWARD_EMOJILists all emoji reactions for a specified merge request. This endpoint can be accessed without authentication if the merge request is publicly accessible.

Lists all emoji reactions for a specified merge request. This endpoint can be accessed without authentication if the merge request is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve an emoji reaction from a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_AWARD_EMOJI_AWARD_IDRetrieves a specified emoji reaction from a merge request. This endpoint can be accessed without authentication if the merge request is publicly accessible.

Retrieves a specified emoji reaction from a merge request. This endpoint can be accessed without authentication if the merge request is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve blocked merge requestsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_BLOCKEESRetrieves merge requests blocked by a specified merge request.

Retrieves merge requests blocked by a specified merge request.

Authentication

Connected account required

Tags

Merge requests
List all dependencies for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_BLOCKSList all merge request dependencies for a specified merge request.

List all merge request dependencies for a specified merge request.

Authentication

Connected account required

Tags

Merge requests
Retrieve a merge request dependencyGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_BLOCKS_BLOCK_IDRetrieves a specified merge request dependency.

Retrieves a specified merge request dependency.

Authentication

Connected account required

Tags

Merge requests
Retrieve merge request changesGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_CHANGESRetrieves changes for a specified merge request.

Retrieves changes for a specified merge request.

Authentication

Connected account required

Tags

Merge requests
List all issues that close on mergeGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_CLOSES_ISSUESLists all issues that close on merge.

Lists all issues that close on merge.

Authentication

Connected account required

Tags

Merge requests
Retrieve merge request commitsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_COMMITSRetrieves commits for a specified merge request.

Retrieves commits for a specified merge request.

Authentication

Connected account required

Tags

Merge requests
List all context commits for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_CONTEXT_COMMITSLists all context commits for a specified merge request.

Lists all context commits for a specified merge request.

Authentication

Connected account required

Tags

Merge requests
List all merge request diffsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_DIFFSLists all merge request diffs.

Lists all merge request diffs.

Authentication

Connected account required

Tags

Merge requests
List all merge request draft notesGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_DRAFT_NOTESLists all merge request draft notes.

Lists all merge request draft notes.

Authentication

Connected account required

Tags

Draft notes
Retrieve a draft noteGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_DRAFT_NOTES_DRAFT_NOTE_IDRetrieves a draft note for a specified merge request.

Retrieves a draft note for a specified merge request.

Authentication

Connected account required

Tags

Draft notes
Merge to default merge ref pathGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_MERGE_REFMerges the changes between the merge request source and target branches into the `refs/merge-requests/:iid/merge` ref, of the target project repository, if possible. This ref has the state the target branch would have if a regular merge action was taken.

Merges the changes between the merge request source and target branches into the `refs/merge-requests/:iid/merge` ref, of the target project repository, if possible. This ref has the state the target branch would have if a regular merge action was taken.

Authentication

Connected account required

Tags

Merge requests
List all emoji reactions for a merge request commentGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_NOTES_NOTE_ID_AWARD_EMOJILists all emoji reactions for a specified comment on a merge request. This endpoint can be accessed without authentication if the comment is publicly accessible.

Lists all emoji reactions for a specified comment on a merge request. This endpoint can be accessed without authentication if the comment is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve an emoji reaction from a merge request commentGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_NOTES_NOTE_ID_AWARD_EMOJI_AWARD_IDRetrieves a specified emoji reaction from a comment on a merge request. This endpoint can be accessed without authentication if the comment is publicly accessible.

Retrieves a specified emoji reaction from a comment on a merge request. This endpoint can be accessed without authentication if the comment is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve merge request participantsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_PARTICIPANTSRetrieves participants for a specified merge request.

Retrieves participants for a specified merge request.

Authentication

Connected account required

Tags

Merge requests
List all merge request pipelinesGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_PIPELINESLists all merge request pipelines.

Lists all merge request pipelines.

Authentication

Connected account required

Tags

Merge requests
Retrieve merge request raw diffsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_RAW_DIFFSRetrieves the raw diffs of the files changed in a merge request.

Retrieves the raw diffs of the files changed in a merge request.

Authentication

Connected account required

Tags

Merge requests
List all issues related to the merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_RELATED_ISSUESLists all issues related to the merge request.

Lists all issues related to the merge request.

Authentication

Connected account required

Tags

Merge requests
Retrieve merge request reviewersGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_REVIEWERSRetrieves reviewers for a specified merge request.

Retrieves reviewers for a specified merge request.

Authentication

Connected account required

Tags

Merge requests
List all status checks for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_STATUS_CHECKSLists all external status check services for a specified merge request and their status.

Lists all external status check services for a specified merge request and their status.

Authentication

Connected account required

Tags

External status checks
Retrieve time tracking stats for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_TIME_STATSRetrieves time tracking stats for a specified merge request, including time estimate and time spent in seconds and human-readable format (for example, `1h 30m`).

Retrieves time tracking stats for a specified merge request, including time estimate and time spent in seconds and human-readable format (for example, `1h 30m`).

Authentication

Connected account required

Tags

Merge requests
Retrieve merge request diff versionsGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_VERSIONSRetrieves merge request diff versions.

Retrieves merge request diff versions.

Authentication

Connected account required

Tags

Merge requests
Retrieve a merge request diff versionGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_VERSIONS_VERSION_IDRetrieves a merge request diff version.

Retrieves a merge request diff version.

Authentication

Connected account required

Tags

Merge requests
List all discussions for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_DISCUSSIONSLists all discussions for a specified merge request.

Lists all discussions for a specified merge request.

Authentication

Connected account required

Tags

Discussions
Retrieve a discussion for a merge requestGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_IDRetrieves a specified discussion for a merge request.

Retrieves a specified discussion for a merge request.

Authentication

Connected account required

Tags

Discussions
List comments in a merge request discussionGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESLists the comments in a specified merge request discussion.

Lists the comments in a specified merge request discussion.

Authentication

Connected account required

Tags

Discussions
Retrieve a comment from a merge request discussionGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDRetrieves a specified comment from a merge request discussion.

Retrieves a specified comment from a merge request discussion.

Authentication

Connected account required

Tags

Discussions
List all merge request notesGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_NOTESLists all notes for a specified merge request.

Lists all notes for a specified merge request.

Authentication

Connected account required

Tags

Notes
Retrieve a merge request noteGITLAB_GET_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_NOTES_NOTE_IDRetrieves a specified note for a merge request.

Retrieves a specified note for a merge request.

Authentication

Connected account required

Tags

Notes
List all merge trains for a projectGITLAB_GET_API_V4_PROJECTS_ID_MERGE_TRAINSLists all merge trains for a specified project.

Lists all merge trains for a specified project.

Authentication

Connected account required

Tags

Merge trains
Retrieve merge train statusGITLAB_GET_API_V4_PROJECTS_ID_MERGE_TRAINS_MERGE_REQUESTS_MERGE_REQUEST_IIDRetrieves the merge train status of a specified merge request.

Retrieves the merge train status of a specified merge request.

Authentication

Connected account required

Tags

Merge trains
List all merge requests in a merge trainGITLAB_GET_API_V4_PROJECTS_ID_MERGE_TRAINS_TARGET_BRANCHLists all merge requests in a merge train for a target branch.

Lists all merge requests in a merge train for a target branch.

Authentication

Connected account required

Tags

Merge trains
List all project milestonesGITLAB_GET_API_V4_PROJECTS_ID_MILESTONESLists all milestones for a specified project.

Lists all milestones for a specified project.

Authentication

Connected account required

Tags

Milestones
Retrieve a project milestoneGITLAB_GET_API_V4_PROJECTS_ID_MILESTONES_MILESTONE_IDRetrieves a specified project milestone.

Retrieves a specified project milestone.

Authentication

Connected account required

Tags

Milestones
List all burndown chart events for a milestoneGITLAB_GET_API_V4_PROJECTS_ID_MILESTONES_MILESTONE_ID_BURNDOWN_EVENTSLists all burndown chart events for a specified milestone.

Lists all burndown chart events for a specified milestone.

Authentication

Connected account required

Tags

Milestones
List all issues for a project milestoneGITLAB_GET_API_V4_PROJECTS_ID_MILESTONES_MILESTONE_ID_ISSUESLists all issues assigned to a specified project milestone.

Lists all issues assigned to a specified project milestone.

Authentication

Connected account required

Tags

Milestones
List all merge requests for a project milestoneGITLAB_GET_API_V4_PROJECTS_ID_MILESTONES_MILESTONE_ID_MERGE_REQUESTSLists all merge requests assigned to a specified project milestone.

Lists all merge requests assigned to a specified project milestone.

Authentication

Connected account required

Tags

Milestones
Retrieve project pull mirror detailsGITLAB_GET_API_V4_PROJECTS_ID_MIRROR_PULLRetrieves pull mirror details for a specified project.

Retrieves pull mirror details for a specified project.

Authentication

Connected account required

Tags

Project mirrors
MLflow artifact APIGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_ARTIFACTS_ARTIFACTSMLflow artifacts mapping to GitLab artifacts

MLflow artifacts mapping to GitLab artifacts

Authentication

Connected account required

Tags

MLOps
Fetch experiment by experiment_idGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_EXPERIMENTS_GEThttps://www.mlflow.org/docs/2.19.0/rest-api.html#get-experiment

https://www.mlflow.org/docs/2.19.0/rest-api.html#get-experiment

Authentication

Connected account required

Tags

MLOps
Fetch experiment by experiment_nameGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_EXPERIMENTS_GET_BY_NAMEhttps://www.mlflow.org/docs/2.19.0/rest-api.html#get-experiment-by-name

https://www.mlflow.org/docs/2.19.0/rest-api.html#get-experiment-by-name

Authentication

Connected account required

Tags

MLOps
List experimentsGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_EXPERIMENTS_LISThttps://www.mlflow.org/docs/2.19.0/rest-api.html#search-experiments

https://www.mlflow.org/docs/2.19.0/rest-api.html#search-experiments

Authentication

Connected account required

Tags

MLOps
Gets metric history for a runGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_METRICS_GET_HISTORYhttps://www.mlflow.org/docs/2.19.0/rest-api.html#get-metric-history

https://www.mlflow.org/docs/2.19.0/rest-api.html#get-metric-history

Authentication

Connected account required

Tags

MLOps
Fetch model version by name and versionGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_MODEL_VERSIONS_GEThttps://mlflow.org/docs/2.19.0/rest-api.html#get-modelversion

https://mlflow.org/docs/2.19.0/rest-api.html#get-modelversion

Authentication

Connected account required

Tags

MLOps
Fetch the download URI for the model version.GITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_MODEL_VERSIONS_GET_DOWNLOAD_URIReturns version in MLflow format "mlflow-artifacts:<version>" https://mlflow.org/docs/2.19.0/rest-api.html#get-download-uri-for-modelversion-artifacts

Returns version in MLflow format "mlflow-artifacts:<version>" https://mlflow.org/docs/2.19.0/rest-api.html#get-download-uri-for-modelversion-artifacts

Authentication

Connected account required

Tags

MLOps
Gets a Model Version by aliasGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_REGISTERED_MODELS_ALIAShttps://mlflow.org/docs/2.19.0/rest-api.html#get-model-version-by-alias

https://mlflow.org/docs/2.19.0/rest-api.html#get-model-version-by-alias

Authentication

Connected account required

Tags

MLOps
Fetch a Registered Model by NameGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_REGISTERED_MODELS_GEThttps://www.mlflow.org/docs/2.19.0/rest-api.html#get-registeredmodel

https://www.mlflow.org/docs/2.19.0/rest-api.html#get-registeredmodel

Authentication

Connected account required

Tags

MLOps
Search Registered Models within a projectGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_REGISTERED_MODELS_SEARCHhttps://mlflow.org/docs/2.19.0/rest-api.html#search-registeredmodels

https://mlflow.org/docs/2.19.0/rest-api.html#search-registeredmodels

Authentication

Connected account required

Tags

MLOps
Gets an MLFlow Run, which maps to GitLab CandidatesGITLAB_GET_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_RUNS_GEThttps://www.mlflow.org/docs/1.28.0/rest-api.html#get-run

https://www.mlflow.org/docs/1.28.0/rest-api.html#get-run

Authentication

Connected account required

Tags

MLOps
Retrieve notification settings for a projectGITLAB_GET_API_V4_PROJECTS_ID_NOTIFICATION_SETTINGSRetrieves the notification level for a specified project.

Retrieves the notification level for a specified project.

Authentication

Connected account required

Tags

Notification settings
List all packages for a projectGITLAB_GET_API_V4_PROJECTS_ID_PACKAGESLists all packages for a specified project. All package types are included in results. Unauthenticated requests return only packages of public projects. By default, packages with `default`, `deprecated`, and `error` status are returned. Use the `status` parameter to view other packages.

Lists all packages for a specified project. All package types are included in results. Unauthenticated requests return only packages of public projects. By default, packages with `default`, `deprecated`, and `error` status are returned. Use the `status` parameter to view other packages.

Authentication

Connected account required

Tags

Packages
Get config.jsonGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CARGO_CONFIG_JSONThis will be used by cargo for further requests

This will be used by cargo for further requests

Authentication

Connected account required

Tags

Packages: Cargo
Download a Cargo crateGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CARGO_PACKAGE_NAME_PACKAGE_VERSION_DOWNLOADThis endpoint serves the .crate file for a given package name and version

This endpoint serves the .crate file for a given package name and version

Authentication

Connected account required

Tags

Packages: Cargo
Get the sparse index for a Cargo crate (4+ character name)GITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CARGO_PREFIX1_PREFIX2_PACKAGE_NAMEReturns newline-delimited JSON, one line per published version, most recently published first. Limited to the 500 most recently published versions.

Returns newline-delimited JSON, one line per published version, most recently published first. Limited to the 500 most recently published versions.

Authentication

Connected account required

Tags

Packages: Cargo
Get the sparse index for a Cargo crate (1-character name)GITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CARGO1_PACKAGE_NAMEReturns newline-delimited JSON, one line per published version, most recently published first. Limited to the 500 most recently published versions.

Returns newline-delimited JSON, one line per published version, most recently published first. Limited to the 500 most recently published versions.

Authentication

Connected account required

Tags

Packages: Cargo
Get the sparse index for a Cargo crate (2-character name)GITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CARGO2_PACKAGE_NAMEReturns newline-delimited JSON, one line per published version, most recently published first. Limited to the 500 most recently published versions.

Returns newline-delimited JSON, one line per published version, most recently published first. Limited to the 500 most recently published versions.

Authentication

Connected account required

Tags

Packages: Cargo
Get the sparse index for a Cargo crate (3-character name)GITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CARGO3_FIRST_CHAR_PACKAGE_NAMEReturns newline-delimited JSON, one line per published version, most recently published first. Limited to the 500 most recently published versions.

Returns newline-delimited JSON, one line per published version, most recently published first. Limited to the 500 most recently published versions.

Authentication

Connected account required

Tags

Packages: Cargo
Retrieve a recipe snapshotGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNELRetrieves a snapshot of the files for a specified Conan recipe. The snapshot is a list of filenames with their associated MD5 hash.

Retrieves a snapshot of the files for a specified Conan recipe. The snapshot is a list of filenames with their associated MD5 hash.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a recipe manifestGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_DIGESTRetrieves a manifest that includes a list of files and associated download URLs for a specified recipe.

Retrieves a manifest that includes a list of files and associated download URLs for a specified recipe.

Authentication

Connected account required

Tags

Packages: Conan
List all recipe download URLsGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_DOWNLOAD_URLSLists all files and associated download URLs for a specified recipe in the package registry. Returns the same payload as the recipe manifest endpoint.

Lists all files and associated download URLs for a specified recipe in the package registry. Returns the same payload as the recipe manifest endpoint.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a package snapshotGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_PACKAGES_CONAN_PACKAGE_REFERENCERetrieves a snapshot of the files for a specified Conan package and reference. The snapshot is a list of filenames with their associated MD5 hash.

Retrieves a snapshot of the files for a specified Conan package and reference. The snapshot is a list of filenames with their associated MD5 hash.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a package manifestGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_PACKAGES_CONAN_PACKAGE_REFERENCE_DIGESTRetrieves a manifest that includes a list of files and associated download URLs for a specified package.

Retrieves a manifest that includes a list of files and associated download URLs for a specified package.

Authentication

Connected account required

Tags

Packages: Conan
List all package download URLsGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_PACKAGES_CONAN_PACKAGE_REFERENCE_DOWNLOAD_URLSLists all files and associated download URLs for a specified package in the package registry. Returns the same payload as the package manifest endpoint.

Lists all files and associated download URLs for a specified package in the package registry. Returns the same payload as the package manifest endpoint.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve package references metadataGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_SEARCHRetrieves the metadata for all package references of a specified package. This feature was introduced in GitLab 18.0.

Retrieves the metadata for all package references of a specified package. This feature was introduced in GitLab 18.0.

Authentication

Connected account required

Tags

Packages: Conan
Search for a Conan packageGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_SEARCHSearches the instance for a specified Conan package.

Searches the instance for a specified Conan package.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a recipe fileGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_FILES_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_RECIPE_REVISION_EXPORT_FILE_NAMERetrieves a specified recipe file from the package registry. You must use the download URL returned from the recipe download URLs endpoint.

Retrieves a specified recipe file from the package registry. You must use the download URL returned from the recipe download URLs endpoint.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a package fileGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_FILES_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_RECIPE_REVISION_PACKAGE_CONAN_PACKAGE_REFERENCE_PACKAGE_REVISION_FILE_NAMERetrieves a specified package file from the package registry. You must use the download URL returned from the package download URLs endpoint.

Retrieves a specified package file from the package registry. You must use the download URL returned from the package download URLs endpoint.

Authentication

Connected account required

Tags

Packages: Conan
Verify availability of a Conan repositoryGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_PINGVerifies availability of a Conan repository.

Verifies availability of a Conan repository.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve an authentication tokenGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_USERS_AUTHENTICATERetrieves an authentication token. Creates a JSON Web Token (JWT) for use as a Bearer header in other requests to the package registry.

Retrieves an authentication token. Creates a JSON Web Token (JWT) for use as a Bearer header in other requests to the package registry.

Authentication

Connected account required

Tags

Packages: Conan
Verify authentication credentialsGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_USERS_CHECK_CREDENTIALSVerifies authentication credentials for a Conan package registry.

Verifies authentication credentials for a Conan package registry.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve latest recipe revisionGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_LATESTRetrieves the revision hash and creation date of the latest package recipe. This feature was introduced in GitLab 17.11.

Retrieves the revision hash and creation date of the latest package recipe. This feature was introduced in GitLab 17.11.

Authentication

Connected account required

Tags

Packages: Conan
List all recipe revisionsGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONSLists all revisions for a package recipe. This feature was introduced in GitLab 17.11.

Lists all revisions for a package recipe. This feature was introduced in GitLab 17.11.

Authentication

Connected account required

Tags

Packages: Conan
List all recipe filesGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_FILESLists all recipe files from the package registry. This feature was introduced in GitLab 17.11.

Lists all recipe files from the package registry. This feature was introduced in GitLab 17.11.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a recipe fileGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_FILES_FILE_NAMERetrieves a specified recipe file from the package registry. This feature was introduced in GitLab 17.8.

Retrieves a specified recipe file from the package registry. This feature was introduced in GitLab 17.8.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve latest package revisionGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_PACKAGES_CONAN_PACKAGE_REFERENCE_LATESTRetrieves the revision hash and creation date of the latest package revision for a specified recipe revision and package reference. This feature was introduced in GitLab 17.11.

Retrieves the revision hash and creation date of the latest package revision for a specified recipe revision and package reference. This feature was introduced in GitLab 17.11.

Authentication

Connected account required

Tags

Packages: Conan
List all package revisionsGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_PACKAGES_CONAN_PACKAGE_REFERENCE_REVISIONSLists all package revisions for a specified recipe revision and package reference. This feature was introduced in GitLab 18.0.

Lists all package revisions for a specified recipe revision and package reference. This feature was introduced in GitLab 18.0.

Authentication

Connected account required

Tags

Packages: Conan
List all package filesGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_PACKAGES_CONAN_PACKAGE_REFERENCE_REVISIONS_PACKAGE_REVISION_FILESLists all package files. This feature was introduced in GitLab 18.0.

Lists all package files. This feature was introduced in GitLab 18.0.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve a package fileGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_PACKAGES_CONAN_PACKAGE_REFERENCE_REVISIONS_PACKAGE_REVISION_FILES_FILE_NAMERetrieves a specified package file from the package registry. This feature was introduced in GitLab 17.11.

Retrieves a specified package file from the package registry. This feature was introduced in GitLab 17.11.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve package references metadata by recipe revisionGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_SEARCHRetrieves the metadata for all package references associated with a specified recipe revision. This feature was introduced in GitLab 18.1.

Retrieves the metadata for all package references associated with a specified recipe revision. This feature was introduced in GitLab 18.1.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve package references metadataGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_SEARCHRetrieves the metadata for all package references of a specified package. This feature was introduced in GitLab 18.0.

Retrieves the metadata for all package references of a specified package. This feature was introduced in GitLab 18.0.

Authentication

Connected account required

Tags

Packages: Conan
Search for a Conan packageGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_SEARCHSearches the instance for a specified Conan package.

Searches the instance for a specified Conan package.

Authentication

Connected account required

Tags

Packages: Conan
Retrieve an authentication tokenGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_USERS_AUTHENTICATERetrieves an authentication token. Creates a JSON Web Token (JWT) for use as a Bearer header in other requests to the package registry.

Retrieves an authentication token. Creates a JSON Web Token (JWT) for use as a Bearer header in other requests to the package registry.

Authentication

Connected account required

Tags

Packages: Conan
Verify authentication credentialsGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_USERS_CHECK_CREDENTIALSVerifies authentication credentials for a Conan package registry.

Verifies authentication credentials for a Conan package registry.

Authentication

Connected account required

Tags

Packages: Conan
Download a Debian package fileGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_DEBIAN_POOL_DISTRIBUTION_LETTER_PACKAGE_NAME_PACKAGE_VERSION_FILE_NAMEDownloads a specified Debian package file for a project.

Downloads a specified Debian package file for a project.

Authentication

Connected account required

Tags

Packages: Debian
Download a chartGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_HELM_CHANNEL_CHARTS_FILE_NAME_TGZDownloads a specified chart for a project.

Downloads a specified chart for a project.

Authentication

Connected account required

Tags

Packages: Helm
Download a chart indexGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_HELM_CHANNEL_INDEX_YAMLDownloads a specified chart index for a project.

Downloads a specified chart index for a project.

Authentication

Connected account required

Tags

Packages: Helm
The NuGet V3 Feed Service IndexGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_NUGET_INDEXThis feature was introduced in GitLab 12.6

This feature was introduced in GitLab 12.6

Authentication

Connected account required

Tags

Packages: NuGet
The NuGet Search ServiceGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_NUGET_QUERYThis feature was introduced in GitLab 12.8

This feature was introduced in GitLab 12.8

Authentication

Connected account required

Tags

Packages: NuGet
The NuGet V2 Feed Service IndexGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_NUGET_V2This feature was introduced in GitLab 16.2

This feature was introduced in GitLab 16.2

Authentication

Connected account required

Tags

Packages: NuGet
The NuGet V2 Feed Package $metadata endpointGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_NUGET_V2_METADATAThis feature was introduced in GitLab 16.3

This feature was introduced in GitLab 16.3

Authentication

Connected account required

Tags

Packages: NuGet
Retrieve a project packageGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_PACKAGE_IDRetrieves a specified project package. Only packages with status `default` or `deprecated` are returned.

Retrieves a specified project package. Only packages with status `default` or `deprecated` are returned.

Authentication

Connected account required

Tags

Packages
List all package filesGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_PACKAGE_ID_PACKAGE_FILESLists all package files for a specified package.

Lists all package files for a specified package.

Authentication

Connected account required

Tags

Packages
Download a package fileGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_PACKAGE_ID_PACKAGE_FILES_PACKAGE_FILE_ID_DOWNLOADThis feature was introduced in GitLab 18.4

This feature was introduced in GitLab 18.4

Authentication

Connected account required

Tags

Packages
List all package pipelinesGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_PACKAGE_ID_PIPELINESLists all pipelines for a specified package. The results are sorted by `id` in descending order. The results are paginated and return up to 20 records per page. This feature was introduced in GitLab 16.1.

Lists all pipelines for a specified package. The results are sorted by `id` in descending order. The results are paginated and return up to 20 records per page. This feature was introduced in GitLab 16.1.

Authentication

Connected account required

Tags

Packages
List all package protection rulesGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_PROTECTION_RULESLists all package protection rules for a specified project.

Lists all package protection rules for a specified project.

Authentication

Connected account required

Tags

Projects
List all packages for a projectGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_PYPI_SIMPLELists all packages for a specified project in an HTML file.

Lists all packages for a specified project in an HTML file.

Authentication

Connected account required

Tags

Packages: PyPi
Retrieve dependenciesGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_RUBYGEMS_API_V1_DEPENDENCIESRetrieves a list of dependencies for specified gems. The response is a marshalled array of hashes for all versions of the requested gems. Because the response is marshalled, you can store it in a file.

Retrieves a list of dependencies for specified gems. The response is a marshalled array of hashes for all versions of the requested gems. Because the response is marshalled, you can store it in a file.

Authentication

Connected account required

Tags

Packages: RubyGem
Download the spec index fileGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_RUBYGEMS_FILE_NAMEDownloads a RubyGems spec index file (specs.4.8.gz, latest_specs.4.8.gz, or prerelease_specs.4.8.gz) for a project.

Downloads a RubyGems spec index file (specs.4.8.gz, latest_specs.4.8.gz, or prerelease_specs.4.8.gz) for a project.

Authentication

Connected account required

Tags

Packages: RubyGem
Download a gem fileGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_RUBYGEMS_GEMS_FILE_NAMEDownloads a specified gem file for a project.

Downloads a specified gem file for a project.

Authentication

Connected account required

Tags

Packages: RubyGem
Download a gemspec fileGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_RUBYGEMS_QUICK_MARSHAL48_FILE_NAMEDownloads a gemspec file in Marshal format for a specified gem version.

Downloads a gemspec file in Marshal format for a specified gem version.

Authentication

Connected account required

Tags

Packages: RubyGem
Download the latest version of a moduleGITLAB_GET_API_V4_PROJECTS_ID_PACKAGES_TERRAFORM_MODULES_MODULE_NAME_MODULE_SYSTEMDownloads the latest version of a specified module. This feature was introduced in GitLab 16.7.

Downloads the latest version of a specified module. This feature was introduced in GitLab 16.7.

Authentication

Connected account required

Tags

Terraform
Retrieve Pages settings for a projectGITLAB_GET_API_V4_PROJECTS_ID_PAGESRetrieves Pages settings for a specified project. You must have the Maintainer or Owner role for the project.

Retrieves Pages settings for a specified project. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

GitLab Pages
Check pages access of this projectGITLAB_GET_API_V4_PROJECTS_ID_PAGES_ACCESSCheck pages access of this project

Check pages access of this project

Authentication

Connected account required

Tags

Projects
List all Pages domains in a projectGITLAB_GET_API_V4_PROJECTS_ID_PAGES_DOMAINSLists all Pages domains in a specified project. You must have permissions to view Pages domains.

Lists all Pages domains in a specified project. You must have permissions to view Pages domains.

Authentication

Connected account required

Tags

GitLab Pages
Retrieve a Pages domainGITLAB_GET_API_V4_PROJECTS_ID_PAGES_DOMAINS_DOMAINRetrieves a Pages domain from a specified project. You must have permissions to view Pages domains.

Retrieves a Pages domain from a specified project. You must have permissions to view Pages domains.

Authentication

Connected account required

Tags

GitLab Pages
List all pipeline schedulesGITLAB_GET_API_V4_PROJECTS_ID_PIPELINE_SCHEDULESLists all pipeline schedules for a project.

Lists all pipeline schedules for a project.

Authentication

Connected account required

Tags

Pipeline schedules
Retrieve a pipeline scheduleGITLAB_GET_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_IDRetrieves a pipeline schedule for a project.

Retrieves a pipeline schedule for a project.

Authentication

Connected account required

Tags

Pipeline schedules
List all pipelines triggered by a pipeline scheduleGITLAB_GET_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_ID_PIPELINESLists all pipelines triggered by a pipeline schedule in a project.

Lists all pipelines triggered by a pipeline schedule in a project.

Authentication

Connected account required

Tags

Pipeline schedules
Retrieve a variable for a pipeline scheduleGITLAB_GET_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_ID_VARIABLES_KEYRetrieves a specified variable for a pipeline schedule.

Retrieves a specified variable for a pipeline schedule.

Authentication

Connected account required

Tags

Pipeline schedules
List all project pipelinesGITLAB_GET_API_V4_PROJECTS_ID_PIPELINESLists all pipelines in a project. By default, child pipelines are not included in the results. To return child pipelines, set `source` to `parent_pipeline`.

Lists all pipelines in a project. By default, child pipelines are not included in the results. To return child pipelines, set `source` to `parent_pipeline`.

Authentication

Connected account required

Tags

Pipelines
Retrieve the latest pipelineGITLAB_GET_API_V4_PROJECTS_ID_PIPELINES_LATESTRetrieves the latest pipeline for the most recent commit on a specified ref in a project. If no pipeline exists for the commit, a `403` status code is returned. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Retrieves the latest pipeline for the most recent commit on a specified ref in a project. If no pipeline exists for the commit, a `403` status code is returned. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Authentication

Connected account required

Tags

Pipelines
Retrieve a pipelineGITLAB_GET_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_IDRetrieves a specified pipeline from a project. You can also get a child pipeline.

Retrieves a specified pipeline from a project. You can also get a child pipeline.

Authentication

Connected account required

Tags

Pipelines
List all bridge jobs by pipelineGITLAB_GET_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_ID_BRIDGESDeprecated in GitLab 19.2. Use trigger_jobs endpoint instead.

Deprecated in GitLab 19.2. Use trigger_jobs endpoint instead.

Authentication

Connected account required

Tags

Pipelines
List all jobs by pipelineGITLAB_GET_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_ID_JOBSLists all jobs for a specified pipeline.

Lists all jobs for a specified pipeline.

Authentication

Connected account required

Tags

Pipelines
Retrieve a test report for a pipelineGITLAB_GET_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_ID_TEST_REPORTRetrieves a test report for a pipeline.

Retrieves a test report for a pipeline.

Authentication

Connected account required

Tags

Pipelines
Retrieve a test report summary for a pipelineGITLAB_GET_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_ID_TEST_REPORT_SUMMARYRetrieves a test report summary for a pipeline.

Retrieves a test report summary for a pipeline.

Authentication

Connected account required

Tags

Pipelines
List all trigger jobs by pipelineGITLAB_GET_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_ID_TRIGGER_JOBSLists all trigger jobs for a specified pipeline.

Lists all trigger jobs for a specified pipeline.

Authentication

Connected account required

Tags

Pipelines
List all pipeline variablesGITLAB_GET_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_ID_VARIABLESLists all pipeline variables for a specified pipeline. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Lists all pipeline variables for a specified pipeline. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Authentication

Connected account required

Tags

Pipelines
List all protected branchesGITLAB_GET_API_V4_PROJECTS_ID_PROTECTED_BRANCHESLists all protected branches for a specified project.

Lists all protected branches for a specified project.

Authentication

Connected account required

Tags

Protected branches
Retrieve a protected branch or wildcard protected branchGITLAB_GET_API_V4_PROJECTS_ID_PROTECTED_BRANCHES_NAMERetrieves a specified protected branch or wildcard protected branch.

Retrieves a specified protected branch or wildcard protected branch.

Authentication

Connected account required

Tags

Protected branches
List all protected environments for a projectGITLAB_GET_API_V4_PROJECTS_ID_PROTECTED_ENVIRONMENTSLists all protected environments for a specified project.

Lists all protected environments for a specified project.

Authentication

Connected account required

Tags

Protected environments
Retrieve a protected environment for a projectGITLAB_GET_API_V4_PROJECTS_ID_PROTECTED_ENVIRONMENTS_NAMERetrieves a specified protected environment for a project.

Retrieves a specified protected environment for a project.

Authentication

Connected account required

Tags

Protected environments
List all protected tagsGITLAB_GET_API_V4_PROJECTS_ID_PROTECTED_TAGSLists all protected tags for a specified project.

Lists all protected tags for a specified project.

Authentication

Connected account required

Tags

Protected tags
Retrieve a protected tag or wildcard protected tagGITLAB_GET_API_V4_PROJECTS_ID_PROTECTED_TAGS_NAMERetrieves a specified protected tag or wildcard protected tag.

Retrieves a specified protected tag or wildcard protected tag.

Authentication

Connected account required

Tags

Protected tags
Retrieve the push rules of a projectGITLAB_GET_API_V4_PROJECTS_ID_PUSH_RULERetrieves the push rules of a specified project.

Retrieves the push rules of a specified project.

Authentication

Connected account required

Tags

Push rules
List all container repository protection rulesGITLAB_GET_API_V4_PROJECTS_ID_REGISTRY_PROTECTION_REPOSITORY_RULESLists all container repository protection rules for a specified project.

Lists all container repository protection rules for a specified project.

Authentication

Connected account required

Tags

Projects
List all container registry protection tag rulesGITLAB_GET_API_V4_PROJECTS_ID_REGISTRY_PROTECTION_TAG_RULESLists all container registry protection tag rules for a project. This feature was introduced in GitLab 18.7.

Lists all container registry protection tag rules for a project. This feature was introduced in GitLab 18.7.

Authentication

Connected account required

Tags

Projects
List all registry repositories for a projectGITLAB_GET_API_V4_PROJECTS_ID_REGISTRY_REPOSITORIESLists all registry repositories for a specified project. Responses are paginated and return 20 results by default.

Lists all registry repositories for a specified project. Responses are paginated and return 20 results by default.

Authentication

Connected account required

Tags

Container registry
List all registry repository tags for a projectGITLAB_GET_API_V4_PROJECTS_ID_REGISTRY_REPOSITORIES_REPOSITORY_ID_TAGSLists all tags for a specified registry repository. Responses are paginated and return 20 results by default.

Lists all tags for a specified registry repository. Responses are paginated and return 20 results by default.

Authentication

Connected account required

Tags

Container registry
Retrieve details of a registry repository tagGITLAB_GET_API_V4_PROJECTS_ID_REGISTRY_REPOSITORIES_REPOSITORY_ID_TAGS_TAG_NAMERetrieves details of a specified registry repository tag.

Retrieves details of a specified registry repository tag.

Authentication

Connected account required

Tags

Container registry
Retrieve the status of a project resource importGITLAB_GET_API_V4_PROJECTS_ID_RELATION_IMPORTSRetrieves the status of the most recent relation import for a specified project. Because only one relation import can be scheduled at a time, you can use this endpoint to check whether the previous import completed successfully. This feature was introduced in GitLab 16.11.

Retrieves the status of the most recent relation import for a specified project. Because only one relation import can be scheduled at a time, you can use this endpoint to check whether the previous import completed successfully. This feature was introduced in GitLab 16.11.

Authentication

Connected account required

Tags

Project import
List all releases in a projectGITLAB_GET_API_V4_PROJECTS_ID_RELEASESLists all releases for a specified project. Sorted by `released_at`.

Lists all releases for a specified project. Sorted by `released_at`.

Authentication

Connected account required

Tags

Releases
Retrieve a release by tag nameGITLAB_GET_API_V4_PROJECTS_ID_RELEASES_TAG_NAMERetrieves a release with a specified tag name.

Retrieves a release with a specified tag name.

Authentication

Connected account required

Tags

Releases
List all release linksGITLAB_GET_API_V4_PROJECTS_ID_RELEASES_TAG_NAME_ASSETS_LINKSLists all assets as links from a release.

Lists all assets as links from a release.

Authentication

Connected account required

Tags

Releases
Retrieve a release linkGITLAB_GET_API_V4_PROJECTS_ID_RELEASES_TAG_NAME_ASSETS_LINKS_LINK_IDRetrieves a specified asset as a link from a release.

Retrieves a specified asset as a link from a release.

Authentication

Connected account required

Tags

Releases
List all remote mirrors for a projectGITLAB_GET_API_V4_PROJECTS_ID_REMOTE_MIRRORSLists all remote mirrors for a specified project.

Lists all remote mirrors for a specified project.

Authentication

Connected account required

Tags

Remote mirrors
Retrieve a remote mirror for a projectGITLAB_GET_API_V4_PROJECTS_ID_REMOTE_MIRRORS_MIRROR_IDRetrieves a specified remote mirror for a project.

Retrieves a specified remote mirror for a project.

Authentication

Connected account required

Tags

Remote mirrors
Retrieve a public key for a remote mirrorGITLAB_GET_API_V4_PROJECTS_ID_REMOTE_MIRRORS_MIRROR_ID_PUBLIC_KEYRetrieves the public key of a specified remote mirror that uses SSH authentication.

Retrieves the public key of a specified remote mirror that uses SSH authentication.

Authentication

Connected account required

Tags

Remote mirrors
Retrieve file archive from a repositoryGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_ARCHIVERetrieves the file archive of a specified repository. This endpoint can be accessed without authentication if the repository is publicly accessible. For GitLab.com users, this endpoint has a rate limit threshold of 5 requests per minute.

Retrieves the file archive of a specified repository. This endpoint can be accessed without authentication if the repository is publicly accessible. For GitLab.com users, this endpoint has a rate limit threshold of 5 requests per minute.

Authentication

Connected account required

Tags

Repositories
Retrieve a blob from a repositoryGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_BLOBS_SHARetrieves information, such as size and content, about blobs in a repository. Blob content is Base64 encoded. This endpoint can be accessed without authentication, if the repository is publicly accessible.

Retrieves information, such as size and content, about blobs in a repository. Blob content is Base64 encoded. This endpoint can be accessed without authentication, if the repository is publicly accessible.

Authentication

Connected account required

Tags

Repositories
Retrieve raw blob contentGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_BLOBS_SHA_RAWRetrieves the raw file contents for a blob, by blob SHA. This endpoint can be accessed without authentication if the repository is publicly accessible.

Retrieves the raw file contents for a blob, by blob SHA. This endpoint can be accessed without authentication if the repository is publicly accessible.

Authentication

Connected account required

Tags

Repositories
List all repository branchesGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_BRANCHESLists all repository branches from a specified project, sorted alphabetically by name. Search by name, or use regular expressions to find specific branch patterns. Returns detailed information about the branch, including its protection status, merge status, and commit details.

Lists all repository branches from a specified project, sorted alphabetically by name. Search by name, or use regular expressions to find specific branch patterns. Returns detailed information about the branch, including its protection status, merge status, and commit details.

Authentication

Connected account required

Tags

Branches
Retrieve a repository branchGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_BRANCHES_BRANCHRetrieves a specified project repository branch.

Retrieves a specified project repository branch.

Authentication

Connected account required

Tags

Branches
Generate changelog dataGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_CHANGELOGGenerates changelog data based on commits in a repository, without committing them to a changelog file. Works exactly like `POST /projects/:id/repository/changelog`, except the changelog data is not committed to any changelog file.

Generates changelog data based on commits in a repository, without committing them to a changelog file. Works exactly like `POST /projects/:id/repository/changelog`, except the changelog data is not committed to any changelog file.

Authentication

Connected account required

Tags

Repositories
List all repository commitsGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITSLists all commits for a specified project repository.

Lists all commits for a specified project repository.

Authentication

Connected account required

Tags

Commits
List all discussions for a commitGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_NOTEABLE_ID_DISCUSSIONSLists all discussions for a specified commit.

Lists all discussions for a specified commit.

Authentication

Connected account required

Tags

Discussions
Retrieve a discussion for a commitGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_IDRetrieves a specified discussion for a commit.

Retrieves a specified discussion for a commit.

Authentication

Connected account required

Tags

Discussions
List comments in a commit discussionGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESLists the comments in a specified commit discussion.

Lists the comments in a specified commit discussion.

Authentication

Connected account required

Tags

Discussions
Retrieve a comment from a commit discussionGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDRetrieves a specified comment from a commit discussion.

Retrieves a specified comment from a commit discussion.

Authentication

Connected account required

Tags

Discussions
Retrieve a commitGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHARetrieves a specified commit identified by the commit hash or name of a branch or tag.

Retrieves a specified commit identified by the commit hash or name of a branch or tag.

Authentication

Connected account required

Tags

Commits
List all commit commentsGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_COMMENTSLists all the comments of a commit in a project.

Lists all the comments of a commit in a project.

Authentication

Connected account required

Tags

Commits
Retrieve a commit diffGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_DIFFRetrieves the diff of a commit in a project.

Retrieves the diff of a commit in a project.

Authentication

Connected account required

Tags

Commits
List all merge requests associated with a commitGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_MERGE_REQUESTSLists all merge requests associated with a specified commit.

Lists all merge requests associated with a specified commit.

Authentication

Connected account required

Tags

Commits
List all references a commit is pushed toGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_REFSLists all references (from branches or tags) a commit is pushed to. The pagination parameters `page` and `per_page` can be used to restrict the list of references.

Lists all references (from branches or tags) a commit is pushed to. The pagination parameters `page` and `per_page` can be used to restrict the list of references.

Authentication

Connected account required

Tags

Commits
Retrieve a commit sequenceGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_SEQUENCERetrieves the commit sequence for a specified commit.

Retrieves the commit sequence for a specified commit.

Authentication

Connected account required

Tags

Commits
Retrieve a commit signatureGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_SIGNATURERetrieves the signature from a commit, if it is signed. For unsigned commits, it results in a 404 response.

Retrieves the signature from a commit, if it is signed. For unsigned commits, it results in a 404 response.

Authentication

Connected account required

Tags

Commits
List all commit statusesGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_STATUSESLists all commit statuses for a specified project.

Lists all commit statuses for a specified project.

Authentication

Connected account required

Tags

Commit statuses
Compare branches, tags, or commitsGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_COMPARECompares branches, tags, or commits. Retrieves the differences between two branches, tags, or commits in a specified project.

Compares branches, tags, or commits. Retrieves the differences between two branches, tags, or commits in a specified project.

Authentication

Connected account required

Tags

Repositories
Retrieve contributors metricsGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_CONTRIBUTORSRetrieves a list of contributors to a specified repository.

Retrieves a list of contributors to a specified repository.

Authentication

Connected account required

Tags

Repositories
Retrieve diverging commit counts between two refsGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_DIVERGING_COMMITSRetrieve diverging commit counts between two refs

Retrieve diverging commit counts between two refs

Authentication

Connected account required

Tags

Repositories
Retrieve a file from a repositoryGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_FILES_FILE_PATHRetrieves information about a specified file in a repository. This includes information like the name, size, and the file contents. File content is Base64 encoded.

Retrieves information about a specified file in a repository. This includes information like the name, size, and the file contents. File content is Base64 encoded.

Authentication

Connected account required

Tags

Files
Retrieve file blame history from a repositoryGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_FILES_FILE_PATH_BLAMERetrieves blame history for a specified file in a repository. Each blame range contains lines and their corresponding commit information.

Retrieves blame history for a specified file in a repository. Each blame range contains lines and their corresponding commit information.

Authentication

Connected account required

Tags

Files
Retrieve a raw file from a repositoryGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_FILES_FILE_PATH_RAWRetrieves the raw file contents for a specified file in a repository.

Retrieves the raw file contents for a specified file in a repository.

Authentication

Connected account required

Tags

Files
Retrieve repository health statisticsGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_HEALTHRetrieves statistics related to the health of a project repository. This endpoint is rate-limited to 5 requests/hour per project when `generate` is `true`. Available only to users with push access to the repository.

Retrieves statistics related to the health of a project repository. This endpoint is rate-limited to 5 requests/hour per project when `generate` is `true`. Available only to users with push access to the repository.

Authentication

Connected account required

Tags

Repositories
Retrieve a merge baseGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_MERGE_BASERetrieves the merge base for two specified commits.

Retrieves the merge base for two specified commits.

Authentication

Connected account required

Tags

Repositories
List all repository storage moves for a projectGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_STORAGE_MOVESLists all repository storage moves for a project.

Lists all repository storage moves for a project.

Authentication

Connected account required

Tags

Storage moves
Retrieve a repository storage move for a projectGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_STORAGE_MOVES_REPOSITORY_STORAGE_MOVE_IDRetrieves a specified repository storage move for a project.

Retrieves a specified repository storage move for a project.

Authentication

Connected account required

Tags

Storage moves
List all project repository tagsGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_TAGSLists all repository tags from a project, sorted by update date and time in descending order.

Lists all repository tags from a project, sorted by update date and time in descending order.

Authentication

Connected account required

Tags

Tags
Retrieve a single repository tagGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_TAGS_TAG_NAMERetrieves a repository tag with a specified name. This endpoint can be accessed without authentication if the repository is publicly accessible.

Retrieves a repository tag with a specified name. This endpoint can be accessed without authentication if the repository is publicly accessible.

Authentication

Connected account required

Tags

Tags
Retrieve X.509 signature of a tagGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_TAGS_TAG_NAME_SIGNATURERetrieves the X.509 signature from a signed tag. Unsigned tags return a `404 Not Found` response.

Retrieves the X.509 signature from a signed tag. Unsigned tags return a `404 Not Found` response.

Authentication

Connected account required

Tags

Tags
List all repository trees in a projectGITLAB_GET_API_V4_PROJECTS_ID_REPOSITORY_TREELists all repository files and directories in a specified project. This endpoint can be accessed without authentication if the repository is publicly accessible. This command provides essentially the same features as the `git ls-tree` command.

Lists all repository files and directories in a specified project. This endpoint can be accessed without authentication if the repository is publicly accessible. This command provides essentially the same features as the `git ls-tree` command.

Authentication

Connected account required

Tags

Repositories
List all resource groupsGITLAB_GET_API_V4_PROJECTS_ID_RESOURCE_GROUPSLists all resource groups for a specified project.

Lists all resource groups for a specified project.

Authentication

Connected account required

Tags

CI resource groups
Retrieve a resource groupGITLAB_GET_API_V4_PROJECTS_ID_RESOURCE_GROUPS_KEYRetrieves a specified resource group for a project.

Retrieves a specified resource group for a project.

Authentication

Connected account required

Tags

CI resource groups
Retrieve current job for a resource groupGITLAB_GET_API_V4_PROJECTS_ID_RESOURCE_GROUPS_KEY_CURRENT_JOBRetrieves the current job for a specified resource group in a project.

Retrieves the current job for a specified resource group in a project.

Authentication

Connected account required

Tags

CI resource groups
List all upcoming jobs for a resource groupGITLAB_GET_API_V4_PROJECTS_ID_RESOURCE_GROUPS_KEY_UPCOMING_JOBSLists all upcoming jobs for a specified resource group.

Lists all upcoming jobs for a specified resource group.

Authentication

Connected account required

Tags

CI resource groups
List all runners for a projectGITLAB_GET_API_V4_PROJECTS_ID_RUNNERSList all runners available in the project, including from ancestor groups and any allowed shared runners.

List all runners available in the project, including from ancestor groups and any allowed shared runners.

Authentication

Connected account required

Tags

RunnersProjects
List all secure files for a projectGITLAB_GET_API_V4_PROJECTS_ID_SECURE_FILESLists all secure files for a specified project.

Lists all secure files for a specified project.

Authentication

Connected account required

Tags

Secure files
Retrieve details of a secure fileGITLAB_GET_API_V4_PROJECTS_ID_SECURE_FILES_SECURE_FILE_IDRetrieves details of a specified secure file in a project.

Retrieves details of a specified secure file in a project.

Authentication

Connected account required

Tags

Secure files
Download a secure fileGITLAB_GET_API_V4_PROJECTS_ID_SECURE_FILES_SECURE_FILE_ID_DOWNLOADDownloads the contents of a specified secure file in a project.

Downloads the contents of a specified secure file in a project.

Authentication

Connected account required

Tags

Secure files
List all project security settingsGITLAB_GET_API_V4_PROJECTS_ID_SECURITY_SETTINGSLists all security settings for the project. You must have the Security Manager, Developer, Maintainer, or Owner role for the project.

Lists all security settings for the project. You must have the Security Manager, Developer, Maintainer, or Owner role for the project.

Authentication

Connected account required

Tags

Projects
List all project service accountsGITLAB_GET_API_V4_PROJECTS_ID_SERVICE_ACCOUNTSLists all service accounts in a specified project. Use the `page` and `per_page` pagination parameters to filter the results.

Lists all service accounts in a specified project. Use the `page` and `per_page` pagination parameters to filter the results.

Authentication

Connected account required

Tags

Service accounts
List all personal access tokens for a project service accountGITLAB_GET_API_V4_PROJECTS_ID_SERVICE_ACCOUNTS_USER_ID_PERSONAL_ACCESS_TOKENSLists all personal access tokens for a specified project service account

Lists all personal access tokens for a specified project service account

Authentication

Connected account required

Tags

Access tokensService accounts
List all active integrationsGITLAB_GET_API_V4_PROJECTS_ID_SERVICESLists all active integrations.

Lists all active integrations.

Authentication

Connected account required

Tags

Integrations
Retrieve integration settingsGITLAB_GET_API_V4_PROJECTS_ID_SERVICES_SLUGRetrieves the settings for a specified integration.

Retrieves the settings for a specified integration.

Authentication

Connected account required

Tags

Integrations
List all groups available to invite to a projectGITLAB_GET_API_V4_PROJECTS_ID_SHARE_LOCATIONSLists all groups that can be invited to a project.

Lists all groups that can be invited to a project.

Authentication

Connected account required

Tags

ProjectsGroups
Download snapshot of a Git repositoryGITLAB_GET_API_V4_PROJECTS_ID_SNAPSHOTDownloads snapshot of a Git repository.

Downloads snapshot of a Git repository.

Authentication

Connected account required

Tags

Project snapshots
List all snippets for a projectGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETSLists all snippets for a specified project.

Lists all snippets for a specified project.

Authentication

Connected account required

Tags

Snippets
List all discussions for a snippetGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_DISCUSSIONSLists all discussions for a specified snippet.

Lists all discussions for a specified snippet.

Authentication

Connected account required

Tags

Discussions
Retrieve a discussion for a snippetGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_IDRetrieves a specified discussion for a snippet.

Retrieves a specified discussion for a snippet.

Authentication

Connected account required

Tags

Discussions
List comments in a snippet discussionGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESLists the comments in a specified snippet discussion.

Lists the comments in a specified snippet discussion.

Authentication

Connected account required

Tags

Discussions
Retrieve a comment from a snippet discussionGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDRetrieves a specified comment from a snippet discussion.

Retrieves a specified comment from a snippet discussion.

Authentication

Connected account required

Tags

Discussions
List all snippet notesGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_NOTESLists all notes for a specified snippet.

Lists all notes for a specified snippet.

Authentication

Connected account required

Tags

Notes
Retrieve a snippet noteGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_NOTES_NOTE_IDRetrieves a specified note for a snippet.

Retrieves a specified note for a snippet.

Authentication

Connected account required

Tags

Notes
Retrieve a project snippetGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_IDRetrieves a specified project snippet.

Retrieves a specified project snippet.

Authentication

Connected account required

Tags

Snippets
List all emoji reactions for a snippetGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_AWARD_EMOJILists all emoji reactions for a specified snippet. This endpoint can be accessed without authentication if the snippet is publicly accessible.

Lists all emoji reactions for a specified snippet. This endpoint can be accessed without authentication if the snippet is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve an emoji reaction from a snippetGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_AWARD_EMOJI_AWARD_IDRetrieves a specified emoji reaction from a snippet. This endpoint can be accessed without authentication if the snippet is publicly accessible.

Retrieves a specified emoji reaction from a snippet. This endpoint can be accessed without authentication if the snippet is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve snippet repository file contentGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_FILES_REF_FILE_PATH_RAWRetrieves the raw file content from a snippet repository as plain text.

Retrieves the raw file content from a snippet repository as plain text.

Authentication

Connected account required

Tags

Snippets
List all emoji reactions for a snippet commentGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_NOTES_NOTE_ID_AWARD_EMOJILists all emoji reactions for a specified comment on a snippet. This endpoint can be accessed without authentication if the comment is publicly accessible.

Lists all emoji reactions for a specified comment on a snippet. This endpoint can be accessed without authentication if the comment is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve an emoji reaction from a snippet commentGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_NOTES_NOTE_ID_AWARD_EMOJI_AWARD_IDRetrieves a specified emoji reaction from a comment on a snippet. This endpoint can be accessed without authentication if the comment is publicly accessible.

Retrieves a specified emoji reaction from a comment on a snippet. This endpoint can be accessed without authentication if the comment is publicly accessible.

Authentication

Connected account required

Tags

Award emoji
Retrieve a raw project snippetGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_RAWRetrieves the raw contents of a specified project snippet as plain text

Retrieves the raw contents of a specified project snippet as plain text

Authentication

Connected account required

Tags

Snippets
Retrieve user agent details for a project snippetGITLAB_GET_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_USER_AGENT_DETAILRetrieves user agent details for a specified snippet. Available only for administrators.

Retrieves user agent details for a specified snippet. Available only for administrators.

Authentication

Connected account required

Tags

Snippets
List all users who starred a projectGITLAB_GET_API_V4_PROJECTS_ID_STARRERSLists all users who starred a specified project.

Lists all users who starred a specified project.

Authentication

Connected account required

Tags

Projects
Retrieve the statistics of the last 30 daysGITLAB_GET_API_V4_PROJECTS_ID_STATISTICSRetrieves the clone and pull statistics for the last 30 days from a specified project.

Retrieves the clone and pull statistics for the last 30 days from a specified project.

Authentication

Connected account required

Tags

Projects
Retrieve the path to repository storageGITLAB_GET_API_V4_PROJECTS_ID_STORAGERetrieves the path to repository storage for a specified project. If you are using Gitaly Cluster (Praefect), see Praefect-generated replica paths instead. Administrators only.

Retrieves the path to repository storage for a specified project. If you are using Gitaly Cluster (Praefect), see Praefect-generated replica paths instead. Administrators only.

Authentication

Connected account required

Tags

Projects
List all templates of a particular typeGITLAB_GET_API_V4_PROJECTS_ID_TEMPLATES_TYPELists all templates of a specified type for a project.

Lists all templates of a specified type for a project.

Authentication

Connected account required

Tags

Project templates
Retrieve a template of a particular typeGITLAB_GET_API_V4_PROJECTS_ID_TEMPLATES_TYPE_NAMERetrieves a template of a specified type for a project.

Retrieves a template of a specified type for a project.

Authentication

Connected account required

Tags

Project templates
Retrieve a Terraform stateGITLAB_GET_API_V4_PROJECTS_ID_TERRAFORM_STATE_NAMERetrieves a Terraform state by name for a specified project.

Retrieves a Terraform state by name for a specified project.

Authentication

Connected account required

Tags

Terraform
Retrieve a Terraform state versionGITLAB_GET_API_V4_PROJECTS_ID_TERRAFORM_STATE_NAME_VERSIONS_SERIALRetrieves a specified Terraform state version.

Retrieves a specified Terraform state version.

Authentication

Connected account required

Tags

Terraform
List all Terraform state protection rules for a projectGITLAB_GET_API_V4_PROJECTS_ID_TERRAFORM_STATE_PROTECTION_RULESLists all Terraform state protection rules for a project. This feature was introduced in GitLab 18.11.

Lists all Terraform state protection rules for a project. This feature was introduced in GitLab 18.11.

Authentication

Connected account required

Tags

Projects
List all transferable namespaces for a projectGITLAB_GET_API_V4_PROJECTS_ID_TRANSFER_LOCATIONSLists all namespaces where a specified project can be transferred.

Lists all namespaces where a specified project can be transferred.

Authentication

Connected account required

Tags

Projects
List all project trigger tokensGITLAB_GET_API_V4_PROJECTS_ID_TRIGGERSLists all pipeline trigger tokens for a specified project.

Lists all pipeline trigger tokens for a specified project.

Authentication

Connected account required

Tags

CI triggers
Retrieve trigger token detailsGITLAB_GET_API_V4_PROJECTS_ID_TRIGGERS_TRIGGER_IDRetrieves details of a pipeline trigger token for a project.

Retrieves details of a pipeline trigger token for a project.

Authentication

Connected account required

Tags

CI triggers
List all uploadsGITLAB_GET_API_V4_PROJECTS_ID_UPLOADSLists all uploads of a project sorted by `created_at` in descending order. You must have the Maintainer or Owner role for the project.

Lists all uploads of a project sorted by `created_at` in descending order. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Projects
Download an uploaded file by secret and filenameGITLAB_GET_API_V4_PROJECTS_ID_UPLOADS_SECRET_FILENAMEDownloads an uploaded file with a specified secret and filename. You must have the Guest, Planner, Reporter, Developer, Maintainer, or Owner role for the project.

Downloads an uploaded file with a specified secret and filename. You must have the Guest, Planner, Reporter, Developer, Maintainer, or Owner role for the project.

Authentication

Connected account required

Tags

Projects
Download an uploaded file by IDGITLAB_GET_API_V4_PROJECTS_ID_UPLOADS_UPLOAD_IDDownloads an uploaded file with a specified ID. You must have the Maintainer or Owner role for the project.

Downloads an uploaded file with a specified ID. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Projects
List all members of a projectGITLAB_GET_API_V4_PROJECTS_ID_USERSLists all members with access to a specified project.

Lists all members with access to a specified project.

Authentication

Connected account required

Tags

Projects
List all project variablesGITLAB_GET_API_V4_PROJECTS_ID_VARIABLESLists all variables for a project. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Lists all variables for a project. Use the `page` and `per_page` pagination parameters to control the pagination of results.

Authentication

Connected account required

Tags

CI variables
Retrieve a single variableGITLAB_GET_API_V4_PROJECTS_ID_VARIABLES_KEYRetrieves details of a specified variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Retrieves details of a specified variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Authentication

Connected account required

Tags

CI variables
List all project vulnerabilitiesGITLAB_GET_API_V4_PROJECTS_ID_VULNERABILITIESLists all vulnerabilities for a specified project.

Lists all vulnerabilities for a specified project.

Authentication

Connected account required

Tags

Vulnerabilities
List all vulnerability notesGITLAB_GET_API_V4_PROJECTS_ID_VULNERABILITIES_NOTEABLE_ID_NOTESLists all notes for a specified vulnerability.

Lists all notes for a specified vulnerability.

Authentication

Connected account required

Tags

Notes
Retrieve a vulnerability noteGITLAB_GET_API_V4_PROJECTS_ID_VULNERABILITIES_NOTEABLE_ID_NOTES_NOTE_IDRetrieves a specified note for a vulnerability.

Retrieves a specified note for a vulnerability.

Authentication

Connected account required

Tags

Notes
List all project vulnerability findingsGITLAB_GET_API_V4_PROJECTS_ID_VULNERABILITY_FINDINGSLists all vulnerability findings for a specified project. Responses are paginated and return 20 results by default.

Lists all vulnerability findings for a specified project. Responses are paginated and return 20 results by default.

Authentication

Connected account required

Tags

Vulnerabilities
List all wiki page meta notesGITLAB_GET_API_V4_PROJECTS_ID_WIKI_PAGES_NOTEABLE_ID_NOTESLists all notes for a specified wiki page meta.

Lists all notes for a specified wiki page meta.

Authentication

Connected account required

Tags

Notes
Retrieve a wiki page meta noteGITLAB_GET_API_V4_PROJECTS_ID_WIKI_PAGES_NOTEABLE_ID_NOTES_NOTE_IDRetrieves a specified note for a wiki page meta.

Retrieves a specified note for a wiki page meta.

Authentication

Connected account required

Tags

Notes
List all wiki pages for a projectGITLAB_GET_API_V4_PROJECTS_ID_WIKISLists all wiki pages for a specified project.

Lists all wiki pages for a specified project.

Authentication

Connected account required

Tags

Wikis
Retrieve a wiki page for a projectGITLAB_GET_API_V4_PROJECTS_ID_WIKIS_SLUGRetrieves a specified wiki page for a project.

Retrieves a specified wiki page for a project.

Authentication

Connected account required

Tags

Wikis
The NuGet V2 Feed Find Packages by ID endpointGITLAB_GET_API_V4_PROJECTS_PROJECT_ID_PACKAGES_NUGET_V2_FINDPACKAGESBYIDThis feature was introduced in GitLab 16.4

This feature was introduced in GitLab 16.4

Authentication

Connected account required

Tags

Packages: NuGet
The NuGet V2 Feed Enumerate Packages endpointGITLAB_GET_API_V4_PROJECTS_PROJECT_ID_PACKAGES_NUGET_V2_PACKAGESThis feature was introduced in GitLab 16.4

This feature was introduced in GitLab 16.4

Authentication

Connected account required

Tags

Packages: NuGet
Retrieve details of a container registry repositoryGITLAB_GET_API_V4_REGISTRY_REPOSITORIES_IDRetrieves details of a specified container registry repository.

Retrieves details of a specified container registry repository.

Authentication

Connected account required

Tags

Container registry
List all runner controllersGITLAB_GET_API_V4_RUNNER_CONTROLLERSLists all runner controllers.

Lists all runner controllers.

Authentication

Connected account required

Tags

Runners
Retrieve a single runner controllerGITLAB_GET_API_V4_RUNNER_CONTROLLERS_IDRetrieves details of a specified runner controller.

Retrieves details of a specified runner controller.

Authentication

Connected account required

Tags

Runner controllers
List all scopes for a runner controllerGITLAB_GET_API_V4_RUNNER_CONTROLLERS_ID_SCOPESLists all scopes for a runner controller.

Lists all scopes for a runner controller.

Authentication

Connected account required

Tags

Runner controllers
List all runner controller tokensGITLAB_GET_API_V4_RUNNER_CONTROLLERS_RUNNER_CONTROLLER_ID_TOKENSLists all runner controller tokens.

Lists all runner controller tokens.

Authentication

Connected account required

Tags

Runners
Retrieve a single runner controller tokenGITLAB_GET_API_V4_RUNNER_CONTROLLERS_RUNNER_CONTROLLER_ID_TOKENS_IDRetrieves details of a specified runner controller token by its ID.

Retrieves details of a specified runner controller token by its ID.

Authentication

Connected account required

Tags

Runner controller tokens
List all available runnersGITLAB_GET_API_V4_RUNNERSLists all runners available to the user. For group runners, you must have the Owner role in the owner namespace.

Lists all runners available to the user. For group runners, you must have the Owner role in the owner namespace.

Authentication

Connected account required

Tags

Runners
List all runnersGITLAB_GET_API_V4_RUNNERS_ALLLists all runners in the GitLab instance (project and shared). You must have either administrator access or auditor access.

Lists all runners in the GitLab instance (project and shared). You must have either administrator access or auditor access.

Authentication

Connected account required

Tags

Runners
Retrieve details on a runnerGITLAB_GET_API_V4_RUNNERS_IDRetrieves details of a runner. Instance runner details are available to all authenticated users through this endpoint. For groups and projects, you must have the Maintainer or Owner role for the associated project or group.

Retrieves details of a runner. Instance runner details are available to all authenticated users through this endpoint. For groups and projects, you must have the Maintainer or Owner role for the associated project or group.

Authentication

Connected account required

Tags

Runners
List all jobs processed by a runnerGITLAB_GET_API_V4_RUNNERS_ID_JOBSLists all jobs that are being processed or were processed by a specified runner. The list of jobs is limited to projects where the user has the Reporter, Developer, Maintainer, or Owner role.

Lists all jobs that are being processed or were processed by a specified runner. The list of jobs is limited to projects where the user has the Reporter, Developer, Maintainer, or Owner role.

Authentication

Connected account required

Tags

RunnersJobs
List all managers for a runnerGITLAB_GET_API_V4_RUNNERS_ID_MANAGERSList all managers for a specified runner.

List all managers for a specified runner.

Authentication

Connected account required

Tags

Runners
Get projects associated with a runnerGITLAB_GET_API_V4_RUNNERS_ID_PROJECTSGet a paginated list of all projects associated with the specified runner. Access is restricted based on user permissions.

Get a paginated list of all projects associated with the specified runner. Access is restricted based on user permissions.

Authentication

Connected account required

Tags

RunnersProjects
Discover Job Router informationGITLAB_GET_API_V4_RUNNERS_ROUTER_DISCOVERYDiscovers Job Router information for a runner. You must provide a valid runner authentication token.

Discovers Job Router information for a runner. You must provide a valid runner authentication token.

Authentication

Connected account required

Tags

CI runners
Search an instanceGITLAB_GET_API_V4_SEARCHSearches for a term across the entire GitLab instance. The response depends on the requested scope.

Searches for a term across the entire GitLab instance. The response depends on the requested scope.

Authentication

Connected account required

Tags

Search
Retrieve a vulnerability archive exportGITLAB_GET_API_V4_SECURITY_VULNERABILITY_ARCHIVE_EXPORTS_IDRetrieves the attributes for a specified vulnerability archive export. You can use this endpoint to poll the export status until it is `finished`. Clients should use the `Poll-Interval` response header to determine how long to wait before sending the next poll. The `Poll-Interval` represents the time in milliseconds.

Retrieves the attributes for a specified vulnerability archive export. You can use this endpoint to poll the export status until it is `finished`. Clients should use the `Poll-Interval` response header to determine how long to wait before sending the next poll. The `Poll-Interval` represents the time in milliseconds.

Authentication

Connected account required

Tags

Vulnerabilities
Download a vulnerability archive exportGITLAB_GET_API_V4_SECURITY_VULNERABILITY_ARCHIVE_EXPORTS_ID_DOWNLOADDownloads a vulnerability archive export.

Downloads a vulnerability archive export.

Authentication

Connected account required

Tags

Vulnerabilities
Retrieve a vulnerability exportGITLAB_GET_API_V4_SECURITY_VULNERABILITY_EXPORTS_IDRetrieves a specified vulnerability export.

Retrieves a specified vulnerability export.

Authentication

Connected account required

Tags

Vulnerabilities
Download a vulnerability exportGITLAB_GET_API_V4_SECURITY_VULNERABILITY_EXPORTS_ID_DOWNLOADDownloads a specified vulnerability export.

Downloads a specified vulnerability export.

Authentication

Connected account required

Tags

Vulnerabilities
List all instance service accountsGITLAB_GET_API_V4_SERVICE_ACCOUNTSLists all instance service accounts. Use the `page` and `per_page` pagination parameters to filter the results.

Lists all instance service accounts. Use the `page` and `per_page` pagination parameters to filter the results.

Authentication

Connected account required

Tags

Service accounts
List all Sidekiq metricsGITLAB_GET_API_V4_SIDEKIQ_COMPOUND_METRICSLists all Sidekiq metrics. Includes queue, process, and job completion metrics.

Lists all Sidekiq metrics. Includes queue, process, and job completion metrics.

Authentication

Connected account required

Tags

Sidekiq
Retrieve job completion metricsGITLAB_GET_API_V4_SIDEKIQ_JOB_STATSRetrieves statistics on the completion status of all Sidekiq jobs.

Retrieves statistics on the completion status of all Sidekiq jobs.

Authentication

Connected account required

Tags

Sidekiq
List all Sidekiq processesGITLAB_GET_API_V4_SIDEKIQ_PROCESS_METRICSLists all details about all registered Sidekiq worker processes, including hostname, process ID, queues, and concurrency settings.

Lists all details about all registered Sidekiq worker processes, including hostname, process ID, queues, and concurrency settings.

Authentication

Connected account required

Tags

Sidekiq
List all job queue metricsGITLAB_GET_API_V4_SIDEKIQ_QUEUE_METRICSLists all details about all Sidekiq job queues, including backlog size and latency.

Lists all details about all Sidekiq job queues, including backlog size and latency.

Authentication

Connected account required

Tags

Sidekiq
List all snippet repository storage movesGITLAB_GET_API_V4_SNIPPET_REPOSITORY_STORAGE_MOVESLists all snippet repository storage moves. By default, `GET` requests return 20 results at a time because the API results are paginated.

Lists all snippet repository storage moves. By default, `GET` requests return 20 results at a time because the API results are paginated.

Authentication

Connected account required

Tags

Storage moves
Retrieve a snippet repository storage moveGITLAB_GET_API_V4_SNIPPET_REPOSITORY_STORAGE_MOVES_REPOSITORY_STORAGE_MOVE_IDRetrieves a specified snippet repository storage move.

Retrieves a specified snippet repository storage move.

Authentication

Connected account required

Tags

Storage moves
List all snippets for current userGITLAB_GET_API_V4_SNIPPETSLists all snippets for the currently authenticated user.

Lists all snippets for the currently authenticated user.

Authentication

Connected account required

Tags

Snippets
List all snippetsGITLAB_GET_API_V4_SNIPPETS_ALLLists all snippets available to the currently authenticated user. Users with Administrator or Auditor access levels can see all snippets (both personal and project). This feature was introduced in GitLab 16.3.

Lists all snippets available to the currently authenticated user. Users with Administrator or Auditor access levels can see all snippets (both personal and project). This feature was introduced in GitLab 16.3.

Authentication

Connected account required

Tags

Snippets
Retrieve a snippetGITLAB_GET_API_V4_SNIPPETS_IDRetrieves a specified snippet.

Retrieves a specified snippet.

Authentication

Connected account required

Tags

Snippets
Retrieve snippet file contentGITLAB_GET_API_V4_SNIPPETS_ID_FILES_REF_FILE_PATH_RAWRetrieves the raw file content from a snippet as plain text.

Retrieves the raw file content from a snippet as plain text.

Authentication

Connected account required

Tags

Snippets
Retrieve a raw snippetGITLAB_GET_API_V4_SNIPPETS_ID_RAWRetrieves the raw contents of a specified snippet as plain text

Retrieves the raw contents of a specified snippet as plain text

Authentication

Connected account required

Tags

Snippets
List all repository storage moves for a snippetGITLAB_GET_API_V4_SNIPPETS_ID_REPOSITORY_STORAGE_MOVESLists all repository storage moves for a specified snippet. By default, `GET` requests return 20 results at a time because the API results are paginated.

Lists all repository storage moves for a specified snippet. By default, `GET` requests return 20 results at a time because the API results are paginated.

Authentication

Connected account required

Tags

Storage moves
Retrieve a repository storage move for a snippetGITLAB_GET_API_V4_SNIPPETS_ID_REPOSITORY_STORAGE_MOVES_REPOSITORY_STORAGE_MOVE_IDRetrieves a repository storage move for a specified snippet.

Retrieves a repository storage move for a specified snippet.

Authentication

Connected account required

Tags

Storage moves
Retrieve user agent details for a snippetGITLAB_GET_API_V4_SNIPPETS_ID_USER_AGENT_DETAILRetrieves user agent details for a specified snippet.

Retrieves user agent details for a specified snippet.

Authentication

Connected account required

Tags

Snippets
List all public snippetsGITLAB_GET_API_V4_SNIPPETS_PUBLICLists all public snippets accessible to the currently authenticated user.

Lists all public snippets accessible to the currently authenticated user.

Authentication

Connected account required

Tags

Snippets
Swagger compatible API descriptionGITLAB_GET_API_V4_SWAGGER_DOCSwagger compatible API description

Swagger compatible API description

Authentication

Connected account required

Tags

getapiv4swaggerdoc
Swagger compatible API description for specific APIGITLAB_GET_API_V4_SWAGGER_DOC_NAMESwagger compatible API description for specific API

Swagger compatible API description for specific API

Authentication

Connected account required

Tags

getapiv4swaggerdocname
List all Dockerfile templatesGITLAB_GET_API_V4_TEMPLATES_DOCKERFILESLists all Dockerfile templates.

Lists all Dockerfile templates.

Authentication

Connected account required

Tags

Templates
Retrieve a Dockerfile templateGITLAB_GET_API_V4_TEMPLATES_DOCKERFILES_NAMERetrieves a specified Dockerfile template.

Retrieves a specified Dockerfile template.

Authentication

Connected account required

Tags

Templates
List all .gitignore templatesGITLAB_GET_API_V4_TEMPLATES_GITIGNORESLists all .gitignore templates.

Lists all .gitignore templates.

Authentication

Connected account required

Tags

Templates
Retrieve a .gitignore templateGITLAB_GET_API_V4_TEMPLATES_GITIGNORES_NAMERetrieves a specified .gitignore template.

Retrieves a specified .gitignore template.

Authentication

Connected account required

Tags

Templates
List all GitLab CI/CD YAML templatesGITLAB_GET_API_V4_TEMPLATES_GITLAB_CI_YMLSLists all GitLab CI/CD YAML templates.

Lists all GitLab CI/CD YAML templates.

Authentication

Connected account required

Tags

Templates
Retrieve a GitLab CI/CD YAML templateGITLAB_GET_API_V4_TEMPLATES_GITLAB_CI_YMLS_NAMERetrieves a specified GitLab CI/CD YAML template.

Retrieves a specified GitLab CI/CD YAML template.

Authentication

Connected account required

Tags

Templates
List all license templatesGITLAB_GET_API_V4_TEMPLATES_LICENSESLists all available license templates.

Lists all available license templates.

Authentication

Connected account required

Tags

Templates
Retrieve a license templateGITLAB_GET_API_V4_TEMPLATES_LICENSES_NAMERetrieves a specified license template. You can pass parameters to replace the license placeholder.

Retrieves a specified license template. You can pass parameters to replace the license placeholder.

Authentication

Connected account required

Tags

Templates
List all to-do itemsGITLAB_GET_API_V4_TODOSLists all to-do items. When no filter is applied, it returns all pending to-do items for the current user. Different filters allow the user to refine the request.

Lists all to-do items. When no filter is applied, it returns all pending to-do items for the current user. Different filters allow the user to refine the request.

Authentication

Connected account required

Tags

To-dos
List all topicsGITLAB_GET_API_V4_TOPICSLists all project topics sorted by the number of associated projects.

Lists all project topics sorted by the number of associated projects.

Authentication

Connected account required

Tags

Project topics
Retrieve a topicGITLAB_GET_API_V4_TOPICS_IDRetrieves a specified project topic.

Retrieves a specified project topic.

Authentication

Connected account required

Tags

Project topics
Download metric definitionsGITLAB_GET_API_V4_USAGE_DATA_METRIC_DEFINITIONSDownloads all metric definitions as a single YAML file.

Downloads all metric definitions as a single YAML file.

Authentication

Connected account required

Tags

Metrics
List all non-SQL metricsGITLAB_GET_API_V4_USAGE_DATA_NON_SQL_METRICSLists all non-SQL metrics data used in the Service ping. This action is behind the `usage_data_non_sql_metrics` feature flag. Administrators only.

Lists all non-SQL metrics data used in the Service ping. This action is behind the `usage_data_non_sql_metrics` feature flag. Administrators only.

Authentication

Connected account required

Tags

Usage data
List all Service Ping SQL queriesGITLAB_GET_API_V4_USAGE_DATA_QUERIESLists all raw SQL queries used to compute Service Ping. This action is behind the `usage_data_queries_api` feature flag. Administrators only.

Lists all raw SQL queries used to compute Service Ping. This action is behind the `usage_data_queries_api` feature flag. Administrators only.

Authentication

Connected account required

Tags

Usage data
Retrieve Service Ping payloadGITLAB_GET_API_V4_USAGE_DATA_SERVICE_PINGRetrieves the Service Ping payload from the application cache as JSON. If no cached payload is available, returns an empty response. Requires a personal access token with the `read_service_ping` scope. Introduced in GitLab 16.9.

Retrieves the Service Ping payload from the application cache as JSON. If no cached payload is available, returns an empty response. Requires a personal access token with the `read_service_ping` scope. Introduced in GitLab 16.9.

Authentication

Connected account required

Tags

Usage data
Retrieve current user detailsGITLAB_GET_API_V4_USERRetrieves details about your user account.

Retrieves details about your user account.

Authentication

Connected account required

Tags

Users
List all activity for a userGITLAB_GET_API_V4_USER_ACTIVITIESLists all activity for a specified user.

Lists all activity for a specified user.

Authentication

Connected account required

Tags

Users
List all applicationsGITLAB_GET_API_V4_USER_APPLICATIONSLists all applications owned by the authenticated user.

Lists all applications owned by the authenticated user.

Authentication

Connected account required

Tags

Applications
Retrieve an applicationGITLAB_GET_API_V4_USER_APPLICATIONS_IDRetrieves details of a specific application owned by the authenticated user.

Retrieves details of a specific application owned by the authenticated user.

Authentication

Connected account required

Tags

Applications
Return the user specific countsGITLAB_GET_API_V4_USER_COUNTSAssigned open issues, assigned MRs and pending todos count

Assigned open issues, assigned MRs and pending todos count

Authentication

Connected account required

Tags

Users
List all email addresses for a userGITLAB_GET_API_V4_USER_EMAILSLists all email addresses for the currently authenticated user.

Lists all email addresses for the currently authenticated user.

Authentication

Connected account required

Tags

Users
Retrieve details on an email addressGITLAB_GET_API_V4_USER_EMAILS_EMAIL_IDRetrieves details on a specified email address for the currently authenticated user.

Retrieves details on a specified email address for the currently authenticated user.

Authentication

Connected account required

Tags

Users
List all GPG keysGITLAB_GET_API_V4_USER_GPG_KEYSLists all GPG keys for the currently authenticated user.

Lists all GPG keys for the currently authenticated user.

Authentication

Connected account required

Tags

Keys
Retrieve a GPG keyGITLAB_GET_API_V4_USER_GPG_KEYS_KEY_IDRetrieves a GPG key for the currently authenticated user.

Retrieves a GPG key for the currently authenticated user.

Authentication

Connected account required

Tags

Keys
List all SSH keysGITLAB_GET_API_V4_USER_KEYSLists all SSH keys for the currently authenticated user.

Lists all SSH keys for the currently authenticated user.

Authentication

Connected account required

Tags

Keys
Retrieve an SSH keyGITLAB_GET_API_V4_USER_KEYS_KEY_IDRetrieves a specified SSH key for the currently authenticated user.

Retrieves a specified SSH key for the currently authenticated user.

Authentication

Connected account required

Tags

Keys
Retrieve your user preferencesGITLAB_GET_API_V4_USER_PREFERENCESRetrieves your user preferences.

Retrieves your user preferences.

Authentication

Connected account required

Tags

Users
Retrieve your user statusGITLAB_GET_API_V4_USER_STATUSRetrieves your user status.

Retrieves your user status.

Authentication

Connected account required

Tags

Users
Retrieve Support PINGITLAB_GET_API_V4_USER_SUPPORT_PINRetrieves a Support PIN for the currently authenticated user. GitLab Support may ask for this PIN to validate your identity.

Retrieves a Support PIN for the currently authenticated user. GitLab Support may ask for this PIN to validate your identity.

Authentication

Connected account required

Tags

Users
List all usersGITLAB_GET_API_V4_USERSLists all users on the instance. This endpoint supports keyset pagination. In GitLab 17.0 and later, keyset pagination is used by default.

Lists all users on the instance. This endpoint supports keyset pagination. In GitLab 17.0 and later, keyset pagination is used by default.

Authentication

Connected account required

Tags

Users
Retrieve a user as a regular userGITLAB_GET_API_V4_USERS_IDRetrieves a specified user as a regular user.

Retrieves a specified user as a regular user.

Authentication

Connected account required

Tags

Users
Retrieve association counts for a userGITLAB_GET_API_V4_USERS_ID_ASSOCIATIONS_COUNTRetrieves the number of groups, projects, issues, and merge requests associated with a specified user.

Retrieves the number of groups, projects, issues, and merge requests associated with a specified user.

Authentication

Connected account required

Tags

Users
List all custom attributes for a userGITLAB_GET_API_V4_USERS_ID_CUSTOM_ATTRIBUTESLists all custom attributes for a specified user.

Lists all custom attributes for a specified user.

Authentication

Connected account required

Tags

Custom attributes
Retrieve a custom attribute for a userGITLAB_GET_API_V4_USERS_ID_CUSTOM_ATTRIBUTES_KEYRetrieves a specified custom attribute for a user.

Retrieves a specified custom attribute for a user.

Authentication

Connected account required

Tags

Custom attributes
List all email addresses for a userGITLAB_GET_API_V4_USERS_ID_EMAILSLists all email addresses for a specified user account. Administrators only.

Lists all email addresses for a specified user account. Administrators only.

Authentication

Connected account required

Tags

Users
Retrieve contribution events for a userGITLAB_GET_API_V4_USERS_ID_EVENTSRetrieves the contribution events for a specified user. Does not return events associated with epics or merge requests. Returns bulk push events with limited commit details.

Retrieves the contribution events for a specified user. Does not return events associated with epics or merge requests. Returns bulk push events with limited commit details.

Authentication

Connected account required

Tags

Events
List all accounts that follow a userGITLAB_GET_API_V4_USERS_ID_FOLLOWERSLists all user accounts that follow a specified user.

Lists all user accounts that follow a specified user.

Authentication

Connected account required

Tags

Users
List all accounts followed by a userGITLAB_GET_API_V4_USERS_ID_FOLLOWINGLists all user accounts being followed by a specified user.

Lists all user accounts being followed by a specified user.

Authentication

Connected account required

Tags

Users
List all GPG keys for a userGITLAB_GET_API_V4_USERS_ID_GPG_KEYSLists all GPG keys for a specified user account. This endpoint does not require authentication.

Lists all GPG keys for a specified user account. This endpoint does not require authentication.

Authentication

Connected account required

Tags

Keys
Retrieve a GPG key for a userGITLAB_GET_API_V4_USERS_ID_GPG_KEYS_KEY_IDRetrieves a GPG key for a specified user account. This endpoint does not require authentication.

Retrieves a GPG key for a specified user account. This endpoint does not require authentication.

Authentication

Connected account required

Tags

Keys
Retrieve an SSH key for a userGITLAB_GET_API_V4_USERS_ID_KEYS_KEY_IDRetrieves an SSH key for a specified user account. This endpoint does not require authentication.

Retrieves an SSH key for a specified user account. This endpoint does not require authentication.

Authentication

Connected account required

Tags

Keys
Retrieve a Support PIN for a userGITLAB_GET_API_V4_USERS_ID_SUPPORT_PINRetrieves a Support PIN for a specified user. GitLab Support may ask for this PIN to validate your identity. Administrators only.

Retrieves a Support PIN for a specified user. GitLab Support may ask for this PIN to validate your identity. Administrators only.

Authentication

Connected account required

Tags

Users
List all projects contributions for a userGITLAB_GET_API_V4_USERS_USER_ID_CONTRIBUTED_PROJECTSLists all contributions to visible projects for a specified user. Returns only contributions in the past year.

Lists all contributions to visible projects for a specified user. Returns only contributions in the past year.

Authentication

Connected account required

Tags

Projects
List all impersonation tokens for a userGITLAB_GET_API_V4_USERS_USER_ID_IMPERSONATION_TOKENSLists all impersonation tokens for a specified user. Administrators only.

Lists all impersonation tokens for a specified user. Administrators only.

Authentication

Connected account required

Tags

Access tokens
Retrieve an impersonation token for a userGITLAB_GET_API_V4_USERS_USER_ID_IMPERSONATION_TOKENS_IMPERSONATION_TOKEN_IDRetrieves an impersonation token for a specified user. Administrators only.

Retrieves an impersonation token for a specified user. Administrators only.

Authentication

Connected account required

Tags

Access tokens
List all SSH keys for a userGITLAB_GET_API_V4_USERS_USER_ID_KEYSLists all SSH keys for a specified user account.

Lists all SSH keys for a specified user account.

Authentication

Connected account required

Tags

Keys
List all project and group memberships for a userGITLAB_GET_API_V4_USERS_USER_ID_MEMBERSHIPSLists all project and group memberships for a specified user. Administrators only.

Lists all project and group memberships for a specified user. Administrators only.

Authentication

Connected account required

Tags

Users
List all project deploy keys for a userGITLAB_GET_API_V4_USERS_USER_ID_PROJECT_DEPLOY_KEYSLists all project deploy keys accessible to a specified user.

Lists all project deploy keys accessible to a specified user.

Authentication

Connected account required

Tags

Deploy resources
List all personal projects for a userGITLAB_GET_API_V4_USERS_USER_ID_PROJECTSLists all personal projects for a specified user. Does not return group or subgroup projects. If the user profile is private, returns only an empty list.

Lists all personal projects for a specified user. Does not return group or subgroup projects. If the user profile is private, returns only an empty list.

Authentication

Connected account required

Tags

Projects
List all projects starred by a userGITLAB_GET_API_V4_USERS_USER_ID_STARRED_PROJECTSLists all visible projects starred by a specified user. Unauthenticated requests return only public projects.

Lists all visible projects starred by a specified user. Unauthenticated requests return only public projects.

Authentication

Connected account required

Tags

Projects
Retrieve the status of a userGITLAB_GET_API_V4_USERS_USER_ID_STATUSRetrieves the status of a user. You can access this endpoint without authentication.

Retrieves the status of a user. You can access this endpoint without authentication.

Authentication

Connected account required

Tags

Users
Retrieves version information for the GitLab instanceGITLAB_GET_API_V4_VERSIONThis feature was introduced in GitLab 8.13 and deprecated in 15.5. We recommend you instead use the Metadata API.

This feature was introduced in GitLab 8.13 and deprecated in 15.5. We recommend you instead use the Metadata API.

Authentication

Connected account required

Tags

Metadata
Get the settings manifest for Settings SyncGITLAB_GET_API_V4_VSCODE_SETTINGS_SYNC_SETTINGS_CONTEXT_HASH_V1_MANIFESTGet the settings manifest for Settings Sync

Get the settings manifest for Settings Sync

Authentication

Connected account required

Tags

VSCode
Get a list of references to one or more vscode setting resourcesGITLAB_GET_API_V4_VSCODE_SETTINGS_SYNC_SETTINGS_CONTEXT_HASH_V1_RESOURCE_RESOURCE_NAMEGet a list of references to one or more vscode setting resources

Get a list of references to one or more vscode setting resources

Authentication

Connected account required

Tags

VSCode
Get a specific setting resourceGITLAB_GET_API_V4_VSCODE_SETTINGS_SYNC_SETTINGS_CONTEXT_HASH_V1_RESOURCE_RESOURCE_NAME_IDGet a specific setting resource

Get a specific setting resource

Authentication

Connected account required

Tags

VSCode
Get the settings manifest for Settings SyncGITLAB_GET_API_V4_VSCODE_SETTINGS_SYNC_V1_MANIFESTGet the settings manifest for Settings Sync

Get the settings manifest for Settings Sync

Authentication

Connected account required

Tags

VSCode
Get a list of references to one or more vscode setting resourcesGITLAB_GET_API_V4_VSCODE_SETTINGS_SYNC_V1_RESOURCE_RESOURCE_NAMEGet a list of references to one or more vscode setting resources

Get a list of references to one or more vscode setting resources

Authentication

Connected account required

Tags

VSCode
Get a specific setting resourceGITLAB_GET_API_V4_VSCODE_SETTINGS_SYNC_V1_RESOURCE_RESOURCE_NAME_IDGet a specific setting resource

Get a specific setting resource

Authentication

Connected account required

Tags

VSCode
Retrieve a vulnerabilityGITLAB_GET_API_V4_VULNERABILITIES_IDRetrieves a specified vulnerability.

Retrieves a specified vulnerability.

Authentication

Connected account required

Tags

Vulnerabilities
Get related issues for a vulnerabilityGITLAB_GET_API_V4_VULNERABILITIES_ID_ISSUE_LINKSGet related issues for a vulnerability

Get related issues for a vulnerability

Authentication

Connected account required

Tags

Vulnerabilities
Retrieve the public signing keyGITLAB_GET_API_V4_WEB_COMMITS_PUBLIC_KEYRetrieves the GitLab public key for signing web commits. This feature was introduced in GitLab 17.4.

Retrieves the GitLab public key for signing web commits. This feature was introduced in GitLab 17.4.

Authentication

Connected account required

Tags

Web commits
Update the number of replicas override for an enabled namespaceGITLAB_PATCH_API_V4_ADMIN_ZOEKT_NAMESPACES_IDUpdate the number of replicas override for an enabled namespace

Update the number of replicas override for an enabled namespace

Authentication

Connected account required

Tags

Code search
Update the workflow statusGITLAB_PATCH_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_IDUpdate the workflow status

Update the workflow status

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
Update an enterprise userGITLAB_PATCH_API_V4_GROUPS_ID_ENTERPRISE_USERS_USER_IDUpdates a specified enterprise user.

Updates a specified enterprise user.

Authentication

Connected account required

Tags

Enterprise users
Disable two-factor authentication for an enterprise userGITLAB_PATCH_API_V4_GROUPS_ID_ENTERPRISE_USERS_USER_ID_DISABLE_TWO_FACTORDisables two-factor authentication (2FA) for a specified enterprise user.

Disables two-factor authentication (2FA) for a specified enterprise user.

Authentication

Connected account required

Tags

Enterprise users
Update a protected branchGITLAB_PATCH_API_V4_GROUPS_ID_PROTECTED_BRANCHES_NAMEUpdates a protected branch for a specified group.

Updates a protected branch for a specified group.

Authentication

Connected account required

Tags

Protected branches
Update `extern_uid` field for a SAML identityGITLAB_PATCH_API_V4_GROUPS_ID_SAML_UIDUpdates the `extern_uid` field for a specified SAML identity.

Updates the `extern_uid` field for a specified SAML identity.

Authentication

Connected account required

Tags

Provider identities
Update `extern_uid` field for a SCIM identityGITLAB_PATCH_API_V4_GROUPS_ID_SCIM_UIDUpdates the `extern_uid` field for a specified SCIM identity.

Updates the `extern_uid` field for a specified SCIM identity.

Authentication

Connected account required

Tags

Provider identities
Update a group service accountGITLAB_PATCH_API_V4_GROUPS_ID_SERVICE_ACCOUNTS_USER_IDUpdate a specified group service account.

Update a specified group service account.

Authentication

Connected account required

Tags

Service accounts
Append a patch to the job traceGITLAB_PATCH_API_V4_JOBS_ID_TRACEAppend a patch to the job trace

Append a patch to the job trace

Authentication

Connected account required

Tags

Jobs
Transfer purchased compute minutes packs to another namespaceGITLAB_PATCH_API_V4_NAMESPACES_ID_MINUTES_MOVE_TARGET_IDDeprecated in GitLab 17.7

Deprecated in GitLab 17.7

Authentication

Connected account required

Tags

CI minutes
Set status of an external controlGITLAB_PATCH_API_V4_PROJECTS_ID_COMPLIANCE_EXTERNAL_CONTROLS_CONTROL_ID_STATUSSets the status of a specified external control. Use this operation to inform GitLab that a control has passed or failed a check by an external service.

Sets the status of a specified external control. Use this operation to inform GitLab that a control has passed or failed a check by an external service.

Authentication

Connected account required

Tags

Compliance policy settings
Update Error Tracking settings for a projectGITLAB_PATCH_API_V4_PROJECTS_ID_ERROR_TRACKING_SETTINGSUpdates Error Tracking settings for a specified project. You must have the Maintainer or Owner role for the project.

Updates Error Tracking settings for a specified project. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Error tracking
Update the CI/CD job token access settings for a projectGITLAB_PATCH_API_V4_PROJECTS_ID_JOB_TOKEN_SCOPEUpdates the **Authorized groups and projects** setting (job token scope) of a specified project.

Updates the **Authorized groups and projects** setting (job token scope) of a specified project.

Authentication

Connected account required

Tags

Projects job token scope
Update a software license policyGITLAB_PATCH_API_V4_PROJECTS_ID_MANAGED_LICENSES_MANAGED_LICENSE_IDUpdates a specified software license policy for a project.

Updates a specified software license policy for a project.

Authentication

Connected account required

Tags

Licenses
Updates a Model Version.GITLAB_PATCH_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_MODEL_VERSIONS_UPDATEhttps://mlflow.org/docs/2.19.0/rest-api.html#update-modelversion

https://mlflow.org/docs/2.19.0/rest-api.html#update-modelversion

Authentication

Connected account required

Tags

MLOps
Update a Registered Model by NameGITLAB_PATCH_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_REGISTERED_MODELS_UPDATEhttps://mlflow.org/docs/2.19.0/rest-api.html#update-registeredmodel

https://mlflow.org/docs/2.19.0/rest-api.html#update-registeredmodel

Authentication

Connected account required

Tags

MLOps
Update a package protection ruleGITLAB_PATCH_API_V4_PROJECTS_ID_PACKAGES_PROTECTION_RULES_PACKAGE_PROTECTION_RULE_IDUpdates a package protection rule for a specified project.

Updates a package protection rule for a specified project.

Authentication

Connected account required

Tags

Projects
Update Pages settings for a projectGITLAB_PATCH_API_V4_PROJECTS_ID_PAGESUpdates Pages settings for a specified project. You must have the Maintainer or Owner role for the project.

Updates Pages settings for a specified project. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

GitLab Pages
Update a protected branchGITLAB_PATCH_API_V4_PROJECTS_ID_PROTECTED_BRANCHES_NAMEUpdates a protected branch for a specified project.

Updates a protected branch for a specified project.

Authentication

Connected account required

Tags

Protected branches
Update a container repository protection ruleGITLAB_PATCH_API_V4_PROJECTS_ID_REGISTRY_PROTECTION_REPOSITORY_RULES_PROTECTION_RULE_IDUpdates a container repository protection rule for a specified project.

Updates a container repository protection rule for a specified project.

Authentication

Connected account required

Tags

Projects
Update a container registry protection tag ruleGITLAB_PATCH_API_V4_PROJECTS_ID_REGISTRY_PROTECTION_TAG_RULES_PROTECTION_RULE_IDUpdates a container registry protection tag rule for a project. This feature was introduced in GitLab 18.9.

Updates a container registry protection tag rule for a project. This feature was introduced in GitLab 18.9.

Authentication

Connected account required

Tags

Projects
Update a project service accountGITLAB_PATCH_API_V4_PROJECTS_ID_SERVICE_ACCOUNTS_USER_IDUpdate a specified project service account.

Update a specified project service account.

Authentication

Connected account required

Tags

Service accounts
Update a Terraform state protection rule for a projectGITLAB_PATCH_API_V4_PROJECTS_ID_TERRAFORM_STATE_PROTECTION_RULES_TERRAFORM_STATE_PROTECTION_RULE_IDThis feature was introduced in GitLab 19.0.

This feature was introduced in GitLab 19.0.

Authentication

Connected account required

Tags

Projects
Update an instance service accountGITLAB_PATCH_API_V4_SERVICE_ACCOUNTS_USER_IDUpdates a specified instance service account.

Updates a specified instance service account.

Authentication

Connected account required

Tags

Service accounts
Update a user statusGITLAB_PATCH_API_V4_USER_STATUSSets the status of the currently authenticated user. Any parameters that are not passed are ignored. This operation is similar but distinct from the Set a user status operation.

Sets the status of the currently authenticated user. Any parameters that are not passed are ignored. This operation is similar but distinct from the Set a user status operation.

Authentication

Connected account required

Tags

Users
Disable two-factor authentication for a userGITLAB_PATCH_API_V4_USERS_ID_DISABLE_TWO_FACTORDisables two-factor authentication for a specified user account. Administrators only.

Disables two-factor authentication for a specified user account. Administrators only.

Authentication

Connected account required

Tags

Users
Replay items from the dead queue into another queueGITLAB_POST_API_V4_ADMIN_ACTIVE_CONTEXT_DEAD_QUEUE_REPLAYReplay items from the dead queue into another queue

Replay items from the dead queue into another queue

Authentication

Connected account required

Tags

Active context
Create instance variableGITLAB_POST_API_V4_ADMIN_CI_VARIABLESCreates a instance-level variable. The maximum number of instance-level variables can be changed.

Creates a instance-level variable. The maximum number of instance-level variables can be changed.

Authentication

Connected account required

Tags

CI variables
Create an instance clusterGITLAB_POST_API_V4_ADMIN_CLUSTERS_ADDCreates an instance cluster by adding an existing Kubernetes cluster.

Creates an instance cluster by adding an existing Kubernetes cluster.

Authentication

Connected account required

Tags

Clusters
Create Admin Role on the GitLab instanceGITLAB_POST_API_V4_ADMIN_MEMBER_ROLESCreate Admin Role on the GitLab instance

Create Admin Role on the GitLab instance

Authentication

Connected account required

Tags

Member roles
Update status of a migrationGITLAB_POST_API_V4_ADMIN_MIGRATIONS_TIMESTAMP_MARKUpdates the status of a migration to indicate a successful execution. This prevent them from being executed by the `db:migrate` tasks. Use this API to skip failing migrations after you determine they are safe to skip.

Updates the status of a migration to indicate a successful execution. This prevent them from being executed by the `db:migrate` tasks. Use this API to skip failing migrations after you determine they are safe to skip.

Authentication

Connected account required

Tags

Migrations
Create workflow persistence (agent-initiated, limited privileges)GITLAB_POST_API_V4_AI_DUO_WORKFLOWS_AGENT_WORKFLOWSAccessible via ai_workflows scope token. Does not accept agent_privileges or pre_approved_agent_privileges.

Accessible via ai_workflows scope token. Does not accept agent_privileges or pre_approved_agent_privileges.

Authentication

Connected account required

Tags

GitLab Duo workflows
Add code review comments to a merge requestGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_CODE_REVIEW_ADD_COMMENTSAdds review comments generated by Duo Workflows to a merge request.

Adds review comments generated by Duo Workflows to a merge request.

Authentication

Connected account required

Tags

GitLab Duo workflows
Connection details for accessing Duo Agent Platform Service directlyGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_DIRECT_ACCESSConnection details for accessing Duo Agent Platform Service directly

Connection details for accessing Duo Agent Platform Service directly

Authentication

Connected account required

Tags

GitLab Duo workflows
Register a flow callback endpointGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_FLOW_CALLBACKSRegisters an HTTPS endpoint for Duo flow lifecycle callbacks. Reference the returned id via callback_hook_id when creating a flow. Secrets are never returned.

Registers an HTTPS endpoint for Duo flow lifecycle callbacks. Reference the returned id via callback_hook_id when creating a flow. Secrets are never returned.

Authentication

Connected account required

Tags

Duo workflow flow callback hooks
Revoke ai_workflows tokenGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_REVOKE_TOKENRevoke ai_workflows token

Revoke ai_workflows token

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
Create a flowGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_WORKFLOWSCreates and starts a flow.

Creates and starts a flow.

Authentication

Connected account required

Tags

GitLab Duo workflows
Ingest AI audit events from Duo Workflow ServiceGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_ID_AUDIT_EVENTSIngest AI audit events from Duo Workflow Service

Ingest AI audit events from Duo Workflow Service

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
Create multiple workflow checkpoint writesGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_ID_CHECKPOINT_WRITES_BATCHCreate multiple workflow checkpoint writes

Create multiple workflow checkpoint writes

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
Create workflow checkpointGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_ID_CHECKPOINTSCreate workflow checkpoint

Create workflow checkpoint

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
Create workflow eventGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_ID_EVENTSCreate workflow event

Create workflow event

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
Resume a paused workflowGITLAB_POST_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_WORKFLOW_ID_RESUMEResume a paused workflow

Resume a paused workflow

Authentication

Connected account required

Tags

GitLab Duo workflows
Generate Git commands from natural textGITLAB_POST_API_V4_AI_LLM_GIT_COMMANDGenerates Git commands from natural language input

Generates Git commands from natural language input

Authentication

Connected account required

Tags

GitLab Duo
Get connection details for third party agentsGITLAB_POST_API_V4_AI_THIRD_PARTY_AGENTS_DIRECT_ACCESSReturns connection details including tokens for accessing third-party agents.

Returns connection details including tokens for accessing third-party agents.

Authentication

Connected account required

Tags

GitLab Duo
Create a new applicationGITLAB_POST_API_V4_APPLICATIONSThis feature was introduced in GitLab 10.5

This feature was introduced in GitLab 10.5

Authentication

Connected account required

Tags

Applications
Renew an application secretGITLAB_POST_API_V4_APPLICATIONS_ID_RENEW_SECRETRenew the secret of a specific application

Renew the secret of a specific application

Authentication

Connected account required

Tags

Applications
Create a broadcast messageGITLAB_POST_API_V4_BROADCAST_MESSAGESCreates a broadcast message.

Creates a broadcast message.

Authentication

Connected account required

Tags

Broadcast messages
Start a group or project migrationGITLAB_POST_API_V4_BULK_IMPORTSStarts a group or project migration. To migrate a project, specify `entities[project_entity]`.

Starts a group or project migration. To migrate a project, specify `entities[project_entity]`.

Authentication

Connected account required

Tags

Imports
Cancel a migrationGITLAB_POST_API_V4_BULK_IMPORTS_IMPORT_ID_CANCELCancels a direct transfer migration. This feature was introduced in GitLab 17.1.

Cancels a direct transfer migration. This feature was introduced in GitLab 17.1.

Authentication

Connected account required

Tags

Imports
Generate a Chat responseGITLAB_POST_API_V4_CHAT_COMPLETIONSGenerates a response for a GitLab Duo Chat question.

Generates a response for a GitLab Duo Chat question.

Authentication

Connected account required

Tags

GitLab Duo
Generate code completionsGITLAB_POST_API_V4_CODE_SUGGESTIONS_COMPLETIONSGenerates code completions. Uses the AI abstraction layer to generate code completions. Requests to this endpoint are proxied to the AI Gateway.

Generates code completions. Uses the AI abstraction layer to generate code completions. Requests to this endpoint are proxied to the AI Gateway.

Authentication

Connected account required

Tags

postapiv4codesuggestionscompletions
Retrieve connection detailsGITLAB_POST_API_V4_CODE_SUGGESTIONS_CONNECTION_DETAILSRetrieves user-specific connection details which can be used by IDEs or clients for telemetry, including an instance-specific application ID, application access token, and clickhouse data plane URL.

Retrieves user-specific connection details which can be used by IDEs or clients for telemetry, including an instance-specific application ID, application access token, and clickhouse data plane URL.

Authentication

Connected account required

Tags

postapiv4codesuggestionsconnectiondetails
Retrieve direct connection details for the AI GatewayGITLAB_POST_API_V4_CODE_SUGGESTIONS_DIRECT_ACCESSRetrieves user-specific connection details which can be used by IDEs or clients to send `completion` requests to Code Suggestions directly through the AI Gateway.

Retrieves user-specific connection details which can be used by IDEs or clients to send `completion` requests to Code Suggestions directly through the AI Gateway.

Authentication

Connected account required

Tags

postapiv4codesuggestionsdirectaccess
Validate status of Code SuggestionsGITLAB_POST_API_V4_CODE_SUGGESTIONS_ENABLEDValidates the status Code Suggestions for a specified project. This checks if the project has `code_suggestions` enabled or if an ancestor group has the Code Suggestions add-on enabled.

Validates the status Code Suggestions for a specified project. This checks if the project has `code_suggestions` enabled or if an ancestor group has the Code Suggestions add-on enabled.

Authentication

Connected account required

Tags

postapiv4codesuggestionsenabled
Receives notifications from the container registry when an operation occursGITLAB_POST_API_V4_CONTAINER_REGISTRY_EVENT_EVENTSThis feature was introduced in GitLab 12.10

This feature was introduced in GitLab 12.10

Authentication

Connected account required

Tags

Container registry
Create a deploy keyGITLAB_POST_API_V4_DEPLOY_KEYSCreates a deploy key for the GitLab instance. Requires administrator access.

Creates a deploy key for the GitLab instance. Requires administrator access.

Authentication

Connected account required

Tags

Deploy resources
Evaluate code reviewGITLAB_POST_API_V4_DUO_CODE_REVIEW_EVALUATIONSEvaluates code changes using GitLab Duo code review

Evaluates code changes using GitLab Duo code review

Authentication

Connected account required

Tags

GitLab Duo
Force a variant assignment for an experiment contextGITLAB_POST_API_V4_EXPERIMENTS_EXPERIMENT_NAME_ASSIGNMENTSForces a specific variant assignment for the given experiment and context. The assignment is stored in Redis cache and will persist until overwritten. Defaults to current user if no context is provided.

Forces a specific variant assignment for the given experiment and context. The assignment is stored in Redis cache and will persist until overwritten. Defaults to current user if no context is provided.

Authentication

Connected account required

Tags

Experiments
Report Unleash client metricsGITLAB_POST_API_V4_FEATURE_FLAGS_UNLEASH_PROJECT_ID_CLIENT_METRICSReport Unleash client metrics

Report Unleash client metrics

Authentication

Connected account required

Tags

Unleash
Register Unleash clientGITLAB_POST_API_V4_FEATURE_FLAGS_UNLEASH_PROJECT_ID_CLIENT_REGISTERRegister Unleash client

Register Unleash client

Authentication

Connected account required

Tags

Unleash
Create or update a feature flagGITLAB_POST_API_V4_FEATURES_NAMECreates or updates a feature flag value. If a feature with the given name doesn't exist yet, the operation creates one. The value can be a boolean or an integer to indicate percentage of time.

Creates or updates a feature flag value. If a feature with the given name doesn't exist yet, the operation creates one. The value can be a boolean or an integer to indicate percentage of time.

Authentication

Connected account required

Tags

Features
Query the GraphQL endpoint of an existing Geo nodeGITLAB_POST_API_V4_GEO_NODE_PROXY_ID_GRAPHQLQuery the GraphQL endpoint of an existing Geo node

Query the GraphQL endpoint of an existing Geo node

Authentication

Connected account required

Tags

Geo
Create a Geo nodeGITLAB_POST_API_V4_GEO_NODESCreates a Geo node.

Creates a Geo node.

Authentication

Connected account required

Tags

Geo
Repair authentication of the Geo nodeGITLAB_POST_API_V4_GEO_NODES_ID_REPAIRRepairs the OAuth authentication of a primary Geo node.

Repairs the OAuth authentication of a primary Geo node.

Authentication

Connected account required

Tags

Geo
Responsible for making HTTP GET /repo.git/info/refs?service=git-receive-pack request from secondary gitlab-shell to primaryGITLAB_POST_API_V4_GEO_PROXY_GIT_SSH_INFO_REFS_RECEIVE_PACKResponsible for making HTTP GET /repo.git/info/refs?service=git-receive-pack request from secondary gitlab-shell to primary

Responsible for making HTTP GET /repo.git/info/refs?service=git-receive-pack request from secondary gitlab-shell to primary

Authentication

Connected account required

Tags

Geo
Responsible for making HTTP GET /repo.git/info/refs?service=git-upload-pack request from secondary gitlab-shell to primaryGITLAB_POST_API_V4_GEO_PROXY_GIT_SSH_INFO_REFS_UPLOAD_PACKResponsible for making HTTP GET /repo.git/info/refs?service=git-upload-pack request from secondary gitlab-shell to primary

Responsible for making HTTP GET /repo.git/info/refs?service=git-upload-pack request from secondary gitlab-shell to primary

Authentication

Connected account required

Tags

Geo
Responsible for making HTTP POST /repo.git/info/refs?service=git-receive-pack request from secondary gitlab-shell to primaryGITLAB_POST_API_V4_GEO_PROXY_GIT_SSH_RECEIVE_PACKResponsible for making HTTP POST /repo.git/info/refs?service=git-receive-pack request from secondary gitlab-shell to primary

Responsible for making HTTP POST /repo.git/info/refs?service=git-receive-pack request from secondary gitlab-shell to primary

Authentication

Connected account required

Tags

Geo
Responsible for making HTTP POST /repo.git/git-upload-pack request from secondary gitlab-shell to primaryGITLAB_POST_API_V4_GEO_PROXY_GIT_SSH_UPLOAD_PACKResponsible for making HTTP POST /repo.git/git-upload-pack request from secondary gitlab-shell to primary

Responsible for making HTTP POST /repo.git/git-upload-pack request from secondary gitlab-shell to primary

Authentication

Connected account required

Tags

Geo
Create a Geo siteGITLAB_POST_API_V4_GEO_SITESCreates a Geo site.

Creates a Geo site.

Authentication

Connected account required

Tags

Geo
Repair a Geo siteGITLAB_POST_API_V4_GEO_SITES_ID_REPAIRRepairs the OAuth authentication of a Geo site if there is an OAuth synchronization problem between the primary or secondary Geo sites.

Repairs the OAuth authentication of a Geo site if there is an OAuth synchronization problem between the primary or secondary Geo sites.

Authentication

Connected account required

Tags

Geo
Posts the current node status to the primary siteGITLAB_POST_API_V4_GEO_STATUSPosts the current node status to the primary site

Posts the current node status to the primary site

Authentication

Connected account required

Tags

Geo
Execute a GLQL queryGITLAB_POST_API_V4_GLQLExecutes a GLQL query to search and filter GitLab resources.

Executes a GLQL query to search and filter GitLab resources.

Authentication

Connected account required

Tags

GLQL
Create group repository storage moves for a storage shardGITLAB_POST_API_V4_GROUP_REPOSITORY_STORAGE_MOVESCreates repository storage moves for all groups on a specified storage shard.

Creates repository storage moves for all groups on a specified storage shard.

Authentication

Connected account required

Tags

Storage moves
Request access to a groupGITLAB_POST_API_V4_GROUPS_ID_ACCESS_REQUESTSRequests access to a specified group for the authenticated user.

Requests access to a specified group for the authenticated user.

Authentication

Connected account required

Tags

Access requests
Create a group access tokenGITLAB_POST_API_V4_GROUPS_ID_ACCESS_TOKENSCreates a group access token for a specified group. You cannot create a token with an access level greater than your account. For example, a user with the Maintainer role cannot create a group access token with the Owner role. You must use a personal access token with this endpoint. You cannot authenticate with a group access token.

Creates a group access token for a specified group. You cannot create a token with an access level greater than your account. For example, a user with the Maintainer role cannot create a group access token with the Owner role. You must use a personal access token with this endpoint. You cannot authenticate with a group access token.

Authentication

Connected account required

Tags

Access tokens
Rotate a group access tokenGITLAB_POST_API_V4_GROUPS_ID_ACCESS_TOKENS_SELF_ROTATERotates a group access token by passing it to the API in a header.

Rotates a group access token by passing it to the API in a header.

Authentication

Connected account required

Tags

Access tokens
Rotate a group access tokenGITLAB_POST_API_V4_GROUPS_ID_ACCESS_TOKENS_TOKEN_ID_ROTATERotates a group access token. This immediately revokes the previous token and creates a token. Generally, this endpoint rotates a specific group access token by authenticating with a personal access token. You can also use a group access token to rotate itself. If you attempt to use this endpoint to rotate a token that was previously revoked, any active tokens from the same token family are revoked. This feature was introduced in GitLab 16.0.

Rotates a group access token. This immediately revokes the previous token and creates a token. Generally, this endpoint rotates a specific group access token by authenticating with a personal access token. You can also use a group access token to rotate itself. If you attempt to use this endpoint to rotate a token that was previously revoked, any active tokens from the same token family are revoked. This feature was introduced in GitLab 16.0.

Authentication

Connected account required

Tags

Access tokens
Create an approval rule for a groupGITLAB_POST_API_V4_GROUPS_ID_APPROVAL_RULESCreates an approval rule for a group. Restricted to group administrators. Do not use the `rule_type` field when building approval rules from the API. The field supports these rule types: - `any_approver`: A pre-configured default rule with `approvals_required` set to `0`.

Creates an approval rule for a group. Restricted to group administrators. Do not use the `rule_type` field when building approval rules from the API. The field supports these rule types: - `any_approver`: A pre-configured default rule with `approvals_required` set to `0`.

Authentication

Connected account required

Tags

Approval rules
Archive a groupGITLAB_POST_API_V4_GROUPS_ID_ARCHIVEArchives a specified group. You must be an administrator or have the Owner role for the group.

Archives a specified group. You must be an administrator or have the Owner role for the group.

Authentication

Connected account required

Tags

Groups
Create a badge for a groupGITLAB_POST_API_V4_GROUPS_ID_BADGESCreates a badge for a specified group.

Creates a badge for a specified group.

Authentication

Connected account required

Tags

Badges
Create a group issue boardGITLAB_POST_API_V4_GROUPS_ID_BOARDSCreates a group issue board for a specified group.

Creates a group issue board for a specified group.

Authentication

Connected account required

Tags

Boards
Create a group issue board listGITLAB_POST_API_V4_GROUPS_ID_BOARDS_BOARD_ID_LISTSCreates a group issue board list for a specified board.

Creates a group issue board list for a specified board.

Authentication

Connected account required

Tags

Boards
Create a group clusterGITLAB_POST_API_V4_GROUPS_ID_CLUSTERS_USERCreates a group cluster for a specified group by adding an existing Kubernetes cluster.

Creates a group cluster for a specified group by adding an existing Kubernetes cluster.

Authentication

Connected account required

Tags

Clusters
Create a Debian group distributionGITLAB_POST_API_V4_GROUPS_ID_DASH_DEBIAN_DISTRIBUTIONSCreates a Debian group distribution for a specified group.

Creates a Debian group distribution for a specified group.

Authentication

Connected account required

Tags

Packages: Debian
Create a new epicGITLAB_POST_API_V4_GROUPS_ID_DASH_EPICSCreates a new epic

Creates a new epic

Authentication

Connected account required

Tags

Epics
Create and relate epic to a parentGITLAB_POST_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IID_EPICSCreate and relate epic to a parent

Create and relate epic to a parent

Authentication

Connected account required

Tags

Epics
Relate epicsGITLAB_POST_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IID_EPICS_CHILD_EPIC_IDRelate epics

Relate epics

Authentication

Connected account required

Tags

Epics
Add an issue to an epicGITLAB_POST_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IID_ISSUES_ISSUE_IDAdds a specified issue to an epic. If the issue already belongs to another epic, it is removed from the original epic.

Adds a specified issue to an epic. If the issue already belongs to another epic, it is removed from the original epic.

Authentication

Connected account required

Tags

Epics
NPM registry bulk advisory endpointGITLAB_POST_API_V4_GROUPS_ID_DASH_PACKAGES_NPM_DASH_NPM_V1_SECURITY_ADVISORIES_BULKThis feature was introduced in GitLab 15.6

This feature was introduced in GitLab 15.6

Authentication

Connected account required

Tags

Packages: NPM
NPM registry quick audit endpointGITLAB_POST_API_V4_GROUPS_ID_DASH_PACKAGES_NPM_DASH_NPM_V1_SECURITY_AUDITS_QUICKThis feature was introduced in GitLab 15.6

This feature was introduced in GitLab 15.6

Authentication

Connected account required

Tags

Packages: NPM
Create a dependency list exportGITLAB_POST_API_V4_GROUPS_ID_DEPENDENCY_LIST_EXPORTSCreates a CycloneDX JSON export for all the project dependencies detected in a pipeline. If an authenticated user does not have the read_dependency permission, this request returns a `403 Forbidden` status code.

Creates a CycloneDX JSON export for all the project dependencies detected in a pipeline. If an authenticated user does not have the read_dependency permission, this request returns a `403 Forbidden` status code.

Authentication

Connected account required

Tags

Dependency management
Create a group deploy tokenGITLAB_POST_API_V4_GROUPS_ID_DEPLOY_TOKENSCreates a group deploy token.

Creates a group deploy token.

Authentication

Connected account required

Tags

Deploy resources
Add an emoji reaction to an epicGITLAB_POST_API_V4_GROUPS_ID_EPICS_EPIC_IID_AWARD_EMOJIAdds an emoji reaction to an epic.

Adds an emoji reaction to an epic.

Authentication

Connected account required

Tags

Award emoji
Add an emoji reaction to an epic commentGITLAB_POST_API_V4_GROUPS_ID_EPICS_EPIC_IID_NOTES_NOTE_ID_AWARD_EMOJIAdds an emoji reaction to a comment on an epic.

Adds an emoji reaction to a comment on an epic.

Authentication

Connected account required

Tags

Award emoji
Create a related epic linkGITLAB_POST_API_V4_GROUPS_ID_EPICS_EPIC_IID_RELATED_EPICSCreates a two-way relation between two epics. The user must have the Guest, Planner, Reporter, Developer, Maintainer, or Owner role for both groups.

Creates a two-way relation between two epics. The user must have the Guest, Planner, Reporter, Developer, Maintainer, or Owner role for both groups.

Authentication

Connected account required

Tags

Epics
Create a to-do item for an epicGITLAB_POST_API_V4_GROUPS_ID_EPICS_EPIC_IID_TODOCreates a to-do item for the current user on a specified epic. If a to-do item already exists for the user on that epic, status code 304 is returned.

Creates a to-do item for the current user on a specified epic. If a to-do item already exists for the user on that epic, status code 304 is returned.

Authentication

Connected account required

Tags

Epics
Create an epic discussionGITLAB_POST_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_DISCUSSIONSCreates a discussion for a specified epic. Replies can be added to it later.

Creates a discussion for a specified epic. Replies can be added to it later.

Authentication

Connected account required

Tags

Discussions
Add a comment to an epic discussionGITLAB_POST_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESAdds a comment to a specified epic discussion.

Adds a comment to a specified epic discussion.

Authentication

Connected account required

Tags

Discussions
Create an epic noteGITLAB_POST_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_NOTESCreates a note for an epic.

Creates a note for an epic.

Authentication

Connected account required

Tags

Notes
Create a group exportGITLAB_POST_API_V4_GROUPS_ID_EXPORTCreates a group export for a specified group.

Creates a group export for a specified group.

Authentication

Connected account required

Tags

Group import and export
Schedule a relations export for a groupGITLAB_POST_API_V4_GROUPS_ID_EXPORT_RELATIONSSchedules a relations export for a specified group.

Schedules a relations export for a specified group.

Authentication

Connected account required

Tags

Group import and export
Create a group hookGITLAB_POST_API_V4_GROUPS_ID_HOOKSCreates a hook for a specified group.

Creates a hook for a specified group.

Authentication

Connected account required

Tags

Hooks
Resend a webhook eventGITLAB_POST_API_V4_GROUPS_ID_HOOKS_HOOK_ID_EVENTS_HOOK_LOG_ID_RESENDResends a webhook event. This endpoint has a rate limit of five requests per minute for each authenticated user for a given project or group. On GitLab Self-Managed and GitLab Dedicated, an administrator can change this limit in the application settings.

Resends a webhook event. This endpoint has a rate limit of five requests per minute for each authenticated user for a given project or group. On GitLab Self-Managed and GitLab Dedicated, an administrator can change this limit in the application settings.

Authentication

Connected account required

Tags

Hooks
Trigger a test webhookGITLAB_POST_API_V4_GROUPS_ID_HOOKS_HOOK_ID_TEST_TRIGGERTriggers a test webhook. This endpoint has a rate limit of five requests per minute for each authenticated user for a given project or group. On GitLab Self-Managed and GitLab Dedicated, an administrator can change this limit in the application settings.

Triggers a test webhook. This endpoint has a rate limit of five requests per minute for each authenticated user for a given project or group. On GitLab Self-Managed and GitLab Dedicated, an administrator can change this limit in the application settings.

Authentication

Connected account required

Tags

Hooks
Add a member to a groupGITLAB_POST_API_V4_GROUPS_ID_INVITATIONSAdds a member to a group. You can specify a user ID or invite a user by email.

Adds a member to a group. You can specify a user ID or invite a user by email.

Authentication

Connected account required

Tags

Invitations
Create a group labelGITLAB_POST_API_V4_GROUPS_ID_LABELSCreates a group label.

Creates a group label.

Authentication

Connected account required

Tags

Labels
Subscribe to a group labelGITLAB_POST_API_V4_GROUPS_ID_LABELS_SUBSCRIBABLE_ID_SUBSCRIBESubscribes the currently authenticated user to a specified group label. They will receive notifications on changes to this item.

Subscribes the currently authenticated user to a specified group label. They will receive notifications on changes to this item.

Authentication

Connected account required

Tags

Resource subscriptions
Unsubscribe to a group labelGITLAB_POST_API_V4_GROUPS_ID_LABELS_SUBSCRIBABLE_ID_UNSUBSCRIBEUnsubscribes the currently authenticated user from a specified group label. They will no longer receive notifications on changes to this item.

Unsubscribes the currently authenticated user from a specified group label. They will no longer receive notifications on changes to this item.

Authentication

Connected account required

Tags

Resource subscriptions
Add an LDAP group link with CN or filterGITLAB_POST_API_V4_GROUPS_ID_LDAP_GROUP_LINKSAdds an LDAP group link using a CN or filter.Adding a group link by filter is only supported in the Premium tier and above.

Adds an LDAP group link using a CN or filter.Adding a group link by filter is only supported in the Premium tier and above.

Authentication

Connected account required

Tags

LDAP
Sync a group with LDAPGITLAB_POST_API_V4_GROUPS_ID_LDAP_SYNCSyncs a specified group with its linked LDAP group. You must be an administrator or have the Owner role for the group.

Syncs a specified group with its linked LDAP group. You must be an administrator or have the Owner role for the group.

Authentication

Connected account required

Tags

LDAP
Rotate a personal access token for an enterprise userGITLAB_POST_API_V4_GROUPS_ID_MANAGE_PERSONAL_ACCESS_TOKENS_PAT_ID_ROTATERotates a specified personal access token for an enterprise user associated with the top-level group. This revokes the previous token and creates a token that expires after one week.

Rotates a specified personal access token for an enterprise user associated with the top-level group. This revokes the previous token and creates a token that expires after one week.

Authentication

Connected account required

Tags

Group credentials inventory
Rotate a group or project access token for a groupGITLAB_POST_API_V4_GROUPS_ID_MANAGE_RESOURCE_ACCESS_TOKENS_PRAT_ID_ROTATERotates a specified group or project access token associated with a top-level group. This revokes the previous token and creates a new token.

Rotates a specified group or project access token associated with a top-level group. This revokes the previous token and creates a new token.

Authentication

Connected account required

Tags

Group credentials inventory
Add a member role to a groupGITLAB_POST_API_V4_GROUPS_ID_MEMBER_ROLESAdds a member role to a group. You can only add member roles at the root level of the group.

Adds a member role to a group. You can only add member roles at the root level of the group.

Authentication

Connected account required

Tags

Member roles
Add a member to a groupGITLAB_POST_API_V4_GROUPS_ID_MEMBERSAdds a member to a specified group.

Adds a member to a specified group.

Authentication

Connected account required

Tags

Members
Approve all pending group membersGITLAB_POST_API_V4_GROUPS_ID_MEMBERS_APPROVE_ALLApproves all pending users for a specified top-level group and any subgroups or projects.

Approves all pending users for a specified top-level group and any subgroups or projects.

Authentication

Connected account required

Tags

Members
Set override flag for a member of a groupGITLAB_POST_API_V4_GROUPS_ID_MEMBERS_USER_ID_OVERRIDESets the override flag for a member of a group. By default, the access level of LDAP group members is set to the value specified by LDAP through Group Sync.

Sets the override flag for a member of a group. By default, the access level of LDAP group members is set to the value specified by LDAP through Group Sync.

Authentication

Connected account required

Tags

Members
Create a group milestoneGITLAB_POST_API_V4_GROUPS_ID_MILESTONESCreates a milestone for the specified group.

Creates a milestone for the specified group.

Authentication

Connected account required

Tags

Milestones
Workhorse authorization for the reassignment CSV fileGITLAB_POST_API_V4_GROUPS_ID_PLACEHOLDER_REASSIGNMENTS_AUTHORIZEAuthorizes Workhorse to handle CSV file uploads for placeholder reassignments. This feature was introduced in GitLab 17.10

Authorizes Workhorse to handle CSV file uploads for placeholder reassignments. This feature was introduced in GitLab 17.10

Authentication

Connected account required

Tags

Groups
Transfer a project to a groupGITLAB_POST_API_V4_GROUPS_ID_PROJECTS_PROJECT_IDTransfers a specified project to another group. Administrators only.

Transfers a specified project to another group. Administrators only.

Authentication

Connected account required

Tags

Groups
Protect a repository branchGITLAB_POST_API_V4_GROUPS_ID_PROTECTED_BRANCHESProtects a specified repository branch. Protect multiple branches by using a wildcard in the `name`.

Protects a specified repository branch. Protect multiple branches by using a wildcard in the `name`.

Authentication

Connected account required

Tags

Protected branches
Protect an environment for a groupGITLAB_POST_API_V4_GROUPS_ID_PROTECTED_ENVIRONMENTSProtects a specified environment for a group.

Protects a specified environment for a group.

Authentication

Connected account required

Tags

Protected environments
Add push rules to a groupGITLAB_POST_API_V4_GROUPS_ID_PUSH_RULEAdds push rules to a specified group. Use only if you have not defined any push rules so far.

Adds push rules to a specified group. Use only if you have not defined any push rules so far.

Authentication

Connected account required

Tags

Push rules
Create a group repository storage moveGITLAB_POST_API_V4_GROUPS_ID_REPOSITORY_STORAGE_MOVESCreates a group repository storage move for a specified group. This operation moves only group wiki repositories and does not move repositories for projects in a group.

Creates a group repository storage move for a specified group. This operation moves only group wiki repositories and does not move repositories for projects in a group.

Authentication

Connected account required

Tags

Storage moves
Restore a groupGITLAB_POST_API_V4_GROUPS_ID_RESTORERestores a specified group that was previously scheduled for deletion. Can not restore groups outside of the retention period (30 days by default).

Restores a specified group that was previously scheduled for deletion. Can not restore groups outside of the retention period (30 days by default).

Authentication

Connected account required

Tags

Groups
Reset the runner registration token for a groupGITLAB_POST_API_V4_GROUPS_ID_RUNNERS_RESET_REGISTRATION_TOKENResets the runner registration token for a specified group.

Resets the runner registration token for a specified group.

Authentication

Connected account required

Tags

RunnersGroups
Add SAML group linkGITLAB_POST_API_V4_GROUPS_ID_SAML_GROUP_LINKSAdd a SAML group link for a group

Add a SAML group link for a group

Authentication

Connected account required

Tags

SAML group links
Create a group service accountGITLAB_POST_API_V4_GROUPS_ID_SERVICE_ACCOUNTSCreates a service account in a specified group.

Creates a service account in a specified group.

Authentication

Connected account required

Tags

Service accounts
Create a personal access token for a group service accountGITLAB_POST_API_V4_GROUPS_ID_SERVICE_ACCOUNTS_USER_ID_PERSONAL_ACCESS_TOKENSCreates a personal access token for a specified group service account. Available only for group Owners and administrators. This feature was introduced in GitLab 16.1.

Creates a personal access token for a specified group service account. Available only for group Owners and administrators. This feature was introduced in GitLab 16.1.

Authentication

Connected account required

Tags

Access tokensService accounts
Rotate a personal access token for a group service accountGITLAB_POST_API_V4_GROUPS_ID_SERVICE_ACCOUNTS_USER_ID_PERSONAL_ACCESS_TOKENS_TOKEN_ID_ROTATERotates a specified personal access token for a group service account. This revokes the existing token and creates a token with the same name, description, and scopes.

Rotates a specified personal access token for a group service account. This revokes the existing token and creates a token with the same name, description, and scopes.

Authentication

Connected account required

Tags

Access tokensService accounts
Add a group to a groupGITLAB_POST_API_V4_GROUPS_ID_SHAREAdds a group to a group.

Adds a group to a group.

Authentication

Connected account required

Tags

Groups
Add a group SSH certificateGITLAB_POST_API_V4_GROUPS_ID_SSH_CERTIFICATESAdds a group SSH certificate for a specified group.

Adds a group SSH certificate for a specified group.

Authentication

Connected account required

Tags

Keys
Transfer a groupGITLAB_POST_API_V4_GROUPS_ID_TRANSFERTransfers a group to another parent group or transforms a subgroup into a top-level group. You must be an administrator or have the Owner role for the group.

Transfers a group to another parent group or transforms a subgroup into a top-level group. You must be an administrator or have the Owner role for the group.

Authentication

Connected account required

Tags

Groups
Transfer a group to an organizationGITLAB_POST_API_V4_GROUPS_ID_TRANSFER_TO_ORGANIZATIONTransfer a group to an organization

Transfer a group to an organization

Authentication

Connected account required

Tags

Groups
Unarchive a groupGITLAB_POST_API_V4_GROUPS_ID_UNARCHIVEUnarchives a specified group. You must be an administrator or have the Owner role for the group.

Unarchives a specified group. You must be an administrator or have the Owner role for the group.

Authentication

Connected account required

Tags

Groups
Workhorse authorize the file uploadGITLAB_POST_API_V4_GROUPS_ID_UPLOADS_AUTHORIZEThis feature was introduced in GitLab 19.0

This feature was introduced in GitLab 19.0

Authentication

Connected account required

Tags

Groups
Create a group variableGITLAB_POST_API_V4_GROUPS_ID_VARIABLESCreates a group variable.

Creates a group variable.

Authentication

Connected account required

Tags

CI variables
Create a wiki page meta noteGITLAB_POST_API_V4_GROUPS_ID_WIKI_PAGES_NOTEABLE_ID_NOTESCreates a note for a wiki page meta.

Creates a note for a wiki page meta.

Authentication

Connected account required

Tags

Notes
Create a wiki page for a groupGITLAB_POST_API_V4_GROUPS_ID_WIKISCreates a wiki page for a specified group. Requests can define the title, slug, and content.

Creates a wiki page for a specified group. Requests can define the title, slug, and content.

Authentication

Connected account required

Tags

Wikis
Workhorse authorize the group import uploadGITLAB_POST_API_V4_GROUPS_IMPORT_AUTHORIZEThis feature was introduced in GitLab 12.8

This feature was introduced in GitLab 12.8

Authentication

Connected account required

Tags

Group import and export
Create a system hookGITLAB_POST_API_V4_HOOKSCreates a system hook.

Creates a system hook.

Authentication

Connected account required

Tags

Hooks
Create a test runGITLAB_POST_API_V4_HOOKS_HOOK_IDCreates a test run for a webhook. Executes the webhook with mock data.

Creates a test run for a webhook. Executes the webhook with mock data.

Authentication

Connected account required

Tags

Hooks
Import repository from Bitbucket CloudGITLAB_POST_API_V4_IMPORT_BITBUCKETImports a repository from Bitbucket Cloud to GitLab. Prerequisites: - The prerequisites for Bitbucket Cloud importer. This feature was introduced in GitLab 17.0.

Imports a repository from Bitbucket Cloud to GitLab. Prerequisites: - The prerequisites for Bitbucket Cloud importer. This feature was introduced in GitLab 17.0.

Authentication

Connected account required

Tags

Project import
Import repository from Bitbucket ServerGITLAB_POST_API_V4_IMPORT_BITBUCKET_SERVERImports a repository from Bitbucket Server to GitLab. The Bitbucket Project Key is only used for finding the repository in Bitbucket. You must specify a `target_namespace` if you want to import the repository to a GitLab group.

Imports a repository from Bitbucket Server to GitLab. The Bitbucket Project Key is only used for finding the repository in Bitbucket. You must specify a `target_namespace` if you want to import the repository to a GitLab group.

Authentication

Connected account required

Tags

Project import
Import a repository from GitHubGITLAB_POST_API_V4_IMPORT_GITHUBImports a repository from GitHub to GitLab.

Imports a repository from GitHub to GitLab.

Authentication

Connected account required

Tags

Project import
Cancel a GitHub project importGITLAB_POST_API_V4_IMPORT_GITHUB_CANCELCancels an in-progress import of a GitHub project to GitLab.

Cancels an in-progress import of a GitHub project to GitLab.

Authentication

Connected account required

Tags

Project import
Import GitHub gists into GitLab snippetsGITLAB_POST_API_V4_IMPORT_GITHUB_GISTSImports personal GitHub gists into GitLab snippets. You can import gists with up to 10 files. GitHub gists with more than 10 files are skipped. You should manually migrate these GitHub gists. If any gists cannot be imported, an email is sent with a list of gists that were not imported.

Imports personal GitHub gists into GitLab snippets. You can import gists with up to 10 files. GitHub gists with more than 10 files are skipped. You should manually migrate these GitHub gists. If any gists cannot be imported, an email is sent with a list of gists that were not imported.

Authentication

Connected account required

Tags

Imports
Subscribe a namespace to a JiraConnectInstallationGITLAB_POST_API_V4_INTEGRATIONS_JIRA_CONNECT_SUBSCRIPTIONSSubscribes the namespace to the JiraConnectInstallation

Subscribes the namespace to the JiraConnectInstallation

Authentication

Connected account required

Tags

Jira Connect subscriptions
Register the GitLab for Jira (Forge) system token for direct dev-info syncGITLAB_POST_API_V4_INTEGRATIONS_JIRA_FORGE_INSTALLATION_FORGE_TOKENStores the Forge app system OAuth token (X-Forge-Oauth-System header) and the Jira apiBaseUrl (from the FIT), so GitLab pushes dev-info directly to Jira. See Atlassian::Forge::SystemTokenClient.

Stores the Forge app system OAuth token (X-Forge-Oauth-System header) and the Jira apiBaseUrl (from the FIT), so GitLab pushes dev-info directly to Jira. See Atlassian::Forge::SystemTokenClient.

Authentication

Connected account required

Tags

Jira forge installation
Create a GitLab for Jira (Forge) namespace subscriptionGITLAB_POST_API_V4_INTEGRATIONS_JIRA_FORGE_SUBSCRIPTIONSSubscribes a GitLab namespace to the Forge installation so its development data syncs to Jira. Authenticated as the GitLab user (OAuth); the Jira installation and user are resolved from the Forge invocation context.

Subscribes a GitLab namespace to the Forge installation so its development data syncs to Jira. Authenticated as the GitLab user (OAuth); the Jira installation and user are resolved from the Forge invocation context.

Authentication

Connected account required

Tags

Jira forge subscriptions
Receive Slack eventsGITLAB_POST_API_V4_INTEGRATIONS_SLACK_EVENTSReceive Slack events

Receive Slack events

Authentication

Connected account required

Tags

Integrations
Process Slack interaction eventsGITLAB_POST_API_V4_INTEGRATIONS_SLACK_INTERACTIONSProcesses interaction events from Slack

Processes interaction events from Slack

Authentication

Connected account required

Tags

IntegrationsInternal operations
Get Slack interactive component optionsGITLAB_POST_API_V4_INTEGRATIONS_SLACK_OPTIONSRetrieves options for Slack interactive components

Retrieves options for Slack interactive components

Authentication

Connected account required

Tags

IntegrationsInternal operations
Authorize artifacts uploadGITLAB_POST_API_V4_JOBS_ID_ARTIFACTS_AUTHORIZEAuthorizes uploading artifacts for a specified job.

Authorizes uploading artifacts for a specified job.

Authentication

Connected account required

Tags

Jobs
Authorize SBOM file uploadGITLAB_POST_API_V4_JOBS_ID_SBOM_SCANS_AUTHORIZEAuthorizes uploading an SBOM file to be scanned for a specified job.

Authorizes uploading an SBOM file to be scanned for a specified job.

Authentication

Connected account required

Tags

Software composition analysis
Reuse SBOM scan resultsGITLAB_POST_API_V4_JOBS_ID_SBOM_SCANS_SBOM_DIGESTReuses existing SBOM scan results if scans for the specified digest already exist.

Reuses existing SBOM scan results if scans for the specified digest already exist.

Authentication

Connected account required

Tags

Software composition analysis
Request a jobGITLAB_POST_API_V4_JOBS_REQUESTRequests a job for a runner to execute.

Requests a job for a runner to execute.

Authentication

Connected account required

Tags

Jobs
Create a licenseGITLAB_POST_API_V4_LICENSECreates a license.

Creates a license.

Authentication

Connected account required

Tags

Licenses
Render Markdown contentGITLAB_POST_API_V4_MARKDOWNRenders Markdown content as HTML.

Renders Markdown content as HTML.

Authentication

Connected account required

Tags

Markdown
Create MCP request handlerGITLAB_POST_API_V4_MCPHandles Model Context Protocol requests

Handles Model Context Protocol requests

Authentication

Connected account required

Tags

MCP
Create an instance member roleGITLAB_POST_API_V4_MEMBER_ROLESCreates an instance member role.

Creates an instance member role.

Authentication

Connected account required

Tags

Member roles
Create a subscription for the namespaceGITLAB_POST_API_V4_NAMESPACES_ID_GITLAB_SUBSCRIPTIONDeprecated in GitLab 17.7

Deprecated in GitLab 17.7

Authentication

Connected account required

Tags

GitLab subscriptions
Create a compute minutes purchase record for the namespaceGITLAB_POST_API_V4_NAMESPACES_ID_MINUTESDeprecated in GitLab 17.7

Deprecated in GitLab 17.7

Authentication

Connected account required

Tags

CI minutes
Creates a storage limit exclusion for a NamespaceGITLAB_POST_API_V4_NAMESPACES_ID_STORAGE_LIMIT_EXCLUSIONCreates a Namespaces::Storage::LimitExclusion

Creates a Namespaces::Storage::LimitExclusion

Authentication

Connected account required

Tags

Namespaces
Create an add-on purchase for the namespaceGITLAB_POST_API_V4_NAMESPACES_ID_SUBSCRIPTION_ADD_ON_PURCHASE_ADD_ON_NAMEDeprecated in GitLab 17.7

Deprecated in GitLab 17.7

Authentication

Connected account required

Tags

Add on purchases
Start a new offline transfer exportGITLAB_POST_API_V4_OFFLINE_EXPORTSInitiates a new offline transfer export

Initiates a new offline transfer export

Authentication

Connected account required

Tags

Offline transfers
Start a new offline transfer importGITLAB_POST_API_V4_OFFLINE_IMPORTSInitiates a new offline transfer import from object storage

Initiates a new offline transfer import from object storage

Authentication

Connected account required

Tags

Offline transfers
List all package upload URLsGITLAB_POST_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_PACKAGES_CONAN_PACKAGE_REFERENCE_UPLOAD_URLSLists all the upload URLs for a specified collection of package files. The request must include a JSON object with the name and size of the individual files.

Lists all the upload URLs for a specified collection of package files. The request must include a JSON object with the name and size of the individual files.

Authentication

Connected account required

Tags

Packages: Conan
List all recipe upload URLsGITLAB_POST_API_V4_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_UPLOAD_URLSLists all the upload URLs for a specified collection of recipe files. The request must include a JSON object with the name and size of the individual files.

Lists all the upload URLs for a specified collection of recipe files. The request must include a JSON object with the name and size of the individual files.

Authentication

Connected account required

Tags

Packages: Conan
NPM registry bulk advisory endpointGITLAB_POST_API_V4_PACKAGES_NPM_DASH_NPM_V1_SECURITY_ADVISORIES_BULKThis feature was introduced in GitLab 15.6

This feature was introduced in GitLab 15.6

Authentication

Connected account required

Tags

Packages: NPM
NPM registry quick audit endpointGITLAB_POST_API_V4_PACKAGES_NPM_DASH_NPM_V1_SECURITY_AUDITS_QUICKThis feature was introduced in GitLab 15.6

This feature was introduced in GitLab 15.6

Authentication

Connected account required

Tags

Packages: NPM
Rotate a personal access tokenGITLAB_POST_API_V4_PERSONAL_ACCESS_TOKENS_ID_ROTATERotates a specified personal access token. This revokes the previous token and creates a token that expires after one week. Administrators can revoke tokens for any user. Non-administrators can only revoke their own tokens.

Rotates a specified personal access token. This revokes the previous token and creates a token that expires after one week. Administrators can revoke tokens for any user. Non-administrators can only revoke their own tokens.

Authentication

Connected account required

Tags

Access tokens
Rotate a personal access tokenGITLAB_POST_API_V4_PERSONAL_ACCESS_TOKENS_SELF_ROTATERotates a personal access token by passing it to the API in a header

Rotates a personal access token by passing it to the API in a header

Authentication

Connected account required

Tags

Access tokens
Create a dependency list exportGITLAB_POST_API_V4_PIPELINES_ID_DEPENDENCY_LIST_EXPORTSCreates a CycloneDX JSON export for all the project dependencies detected in a pipeline. If an authenticated user does not have the read_dependency permission, this request returns a `403 Forbidden` status code.

Creates a CycloneDX JSON export for all the project dependencies detected in a pipeline. If an authenticated user does not have the read_dependency permission, this request returns a `403 Forbidden` status code.

Authentication

Connected account required

Tags

Dependency management
Create a project aliasGITLAB_POST_API_V4_PROJECT_ALIASESCreates a project alias.

Creates a project alias.

Authentication

Connected account required

Tags

Project alias
Create repository storage moves for all projects on a storage shardGITLAB_POST_API_V4_PROJECT_REPOSITORY_STORAGE_MOVESCreates repository storage moves for each project repository stored on the source storage shard. This endpoint migrates all projects at once.

Creates repository storage moves for each project repository stored on the source storage shard. This endpoint migrates all projects at once.

Authentication

Connected account required

Tags

Storage moves
Request access to a projectGITLAB_POST_API_V4_PROJECTS_ID_ACCESS_REQUESTSRequests access to a specified project for the authenticated user.

Requests access to a specified project for the authenticated user.

Authentication

Connected account required

Tags

Access requests
Create a project access tokenGITLAB_POST_API_V4_PROJECTS_ID_ACCESS_TOKENSCreates a project access token for a specified project. You cannot create a token with an access level greater than your account. For example, a user with the Maintainer role cannot create a project access token with the Owner role. You must use a personal access token with this endpoint. You cannot authenticate with a project access token.

Creates a project access token for a specified project. You cannot create a token with an access level greater than your account. For example, a user with the Maintainer role cannot create a project access token with the Owner role. You must use a personal access token with this endpoint. You cannot authenticate with a project access token.

Authentication

Connected account required

Tags

Access tokens
Rotate a project access tokenGITLAB_POST_API_V4_PROJECTS_ID_ACCESS_TOKENS_SELF_ROTATERotates a project access token by passing it to the API in a header.

Rotates a project access token by passing it to the API in a header.

Authentication

Connected account required

Tags

Access tokens
Rotate a project access tokenGITLAB_POST_API_V4_PROJECTS_ID_ACCESS_TOKENS_TOKEN_ID_ROTATERotates a project access token. This immediately revokes the previous token and creates a token. Generally, this endpoint rotates a specific project access token by authenticating with a personal access token. You can also use a project access token to rotate itself. If you attempt to use this endpoint to rotate a token that was previously revoked, any active tokens from the same token family are revoked. This feature was introduced in GitLab 16.0.

Rotates a project access token. This immediately revokes the previous token and creates a token. Generally, this endpoint rotates a specific project access token by authenticating with a personal access token. You can also use a project access token to rotate itself. If you attempt to use this endpoint to rotate a token that was previously revoked, any active tokens from the same token family are revoked. This feature was introduced in GitLab 16.0.

Authentication

Connected account required

Tags

Access tokens
Register an external agent identity.GITLAB_POST_API_V4_PROJECTS_ID_AI_AGENT_IDENTITIESRegisters a new agent identity for the current user, project, agent type, and machine fingerprint combination. Returns an existing record if one already exists. Returns 403 if the identity has been revoked.

Registers a new agent identity for the current user, project, agent type, and machine fingerprint combination. Returns an existing record if one already exists. Returns 403 if the identity has been revoked.

Authentication

Connected account required

Tags

ProjectsAi agent identities
Workhorse authorize metric image file uploadGITLAB_POST_API_V4_PROJECTS_ID_ALERT_MANAGEMENT_ALERTS_ALERT_IID_METRIC_IMAGES_AUTHORIZEWorkhorse authorize metric image file upload

Workhorse authorize metric image file upload

Authentication

Connected account required

Tags

Alert management
Create an approval rule for a projectGITLAB_POST_API_V4_PROJECTS_ID_APPROVAL_RULESCreates an approval rule for a specified project.

Creates an approval rule for a specified project.

Authentication

Connected account required

Tags

Approval rules
Create new approval ruleGITLAB_POST_API_V4_PROJECTS_ID_APPROVAL_SETTINGS_RULESPrivate API subject to change

Private API subject to change

Authentication

Connected account required

Tags

Approval rules
Create or update approval configuration for a projectGITLAB_POST_API_V4_PROJECTS_ID_APPROVALSCreates or updates the approval configuration for a project. The currently authenticated user must be an eligible approver.

Creates or updates the approval configuration for a project. The currently authenticated user must be an eligible approver.

Authentication

Connected account required

Tags

Project approvals
Archive a projectGITLAB_POST_API_V4_PROJECTS_ID_ARCHIVEArchives a specified project. You must be an administrator or be assigned the Owner role on the project.

Archives a specified project. You must be an administrator or be assigned the Owner role on the project.

Authentication

Connected account required

Tags

Projects
Create a badge for a projectGITLAB_POST_API_V4_PROJECTS_ID_BADGESCreates a badge for a specified project.

Creates a badge for a specified project.

Authentication

Connected account required

Tags

Badges
Create an issue boardGITLAB_POST_API_V4_PROJECTS_ID_BOARDSCreates an issue board in a specified project.

Creates an issue board in a specified project.

Authentication

Connected account required

Tags

Boards
Create an issue board listGITLAB_POST_API_V4_PROJECTS_ID_BOARDS_BOARD_ID_LISTSCreates an issue board list.

Creates an issue board list.

Authentication

Connected account required

Tags

Boards
Publish a new component project release as version to the CI/CD catalogGITLAB_POST_API_V4_PROJECTS_ID_CATALOG_PUBLISHPublishes a release of a catalog resource as version to the CI/CD catalog.

Publishes a release of a catalog resource as version to the CI/CD catalog.

Authentication

Connected account required

Tags

CI catalog
Validate a CI/CD configurationGITLAB_POST_API_V4_PROJECTS_ID_CI_LINTValidates a provided CI/CD configuration in the context of a specified project.

Validates a provided CI/CD configuration in the context of a specified project.

Authentication

Connected account required

Tags

CI lint
Create an agentGITLAB_POST_API_V4_PROJECTS_ID_CLUSTER_AGENTSCreates an agent for the project. You must have the Maintainer or Owner role to use this endpoint.

Creates an agent for the project. You must have the Maintainer or Owner role to use this endpoint.

Authentication

Connected account required

Tags

Cluster agents
Create an agent tokenGITLAB_POST_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_ID_TOKENSCreates a token for an agent. You must have the Maintainer or Owner role to use this endpoint. An agent can have only two active tokens at one time.

Creates a token for an agent. You must have the Maintainer or Owner role to use this endpoint. An agent can have only two active tokens at one time.

Authentication

Connected account required

Tags

Cluster agents
Create an agent URL configurationGITLAB_POST_API_V4_PROJECTS_ID_CLUSTER_AGENTS_AGENT_ID_URL_CONFIGURATIONSCreates an agent URL configuration. You must have the Maintainer or Owner role to use this endpoint. An agent can have only one URL configuration at the time. This feature was introduced in GitLab 17.4.

Creates an agent URL configuration. You must have the Maintainer or Owner role to use this endpoint. An agent can have only one URL configuration at the time. This feature was introduced in GitLab 17.4.

Authentication

Connected account required

Tags

Cluster agents
Add a cluster to a projectGITLAB_POST_API_V4_PROJECTS_ID_CLUSTERS_USERAdds a cluster to a specified project.

Adds a cluster to a specified project.

Authentication

Connected account required

Tags

Clusters
Create a CI configuration merge requestGITLAB_POST_API_V4_PROJECTS_ID_CREATE_CI_CONFIGCreates a merge request to add CI configuration to a specified project.

Creates a merge request to add CI configuration to a specified project.

Authentication

Connected account required

Tags

ProjectsMerge requests
Create a Debian project distributionGITLAB_POST_API_V4_PROJECTS_ID_DEBIAN_DISTRIBUTIONSCreates a Debian project distribution for a specified project.

Creates a Debian project distribution for a specified project.

Authentication

Connected account required

Tags

Packages: Debian
Create a dependency list exportGITLAB_POST_API_V4_PROJECTS_ID_DEPENDENCY_LIST_EXPORTSCreates a CycloneDX JSON export for all the project dependencies detected in a pipeline. If an authenticated user does not have the read_dependency permission, this request returns a `403 Forbidden` status code.

Creates a CycloneDX JSON export for all the project dependencies detected in a pipeline. If an authenticated user does not have the read_dependency permission, this request returns a `403 Forbidden` status code.

Authentication

Connected account required

Tags

Dependency management
Add a deploy key for a projectGITLAB_POST_API_V4_PROJECTS_ID_DEPLOY_KEYSAdds a deploy key for a specified project. If the deploy key already exists in another project, it is joined to the current project only if the original one is accessible by the same user.

Adds a deploy key for a specified project. If the deploy key already exists in another project, it is joined to the current project only if the original one is accessible by the same user.

Authentication

Connected account required

Tags

Deploy resources
Enable a deploy keyGITLAB_POST_API_V4_PROJECTS_ID_DEPLOY_KEYS_KEY_ID_ENABLEEnables a deploy key for a project so this can be used. Returns the enabled key, with a status code 201 when successful.

Enables a deploy key for a project so this can be used. Returns the enabled key, with a status code 201 when successful.

Authentication

Connected account required

Tags

Deploy resources
Create a project deploy tokenGITLAB_POST_API_V4_PROJECTS_ID_DEPLOY_TOKENSCreates a project deploy token.

Creates a project deploy token.

Authentication

Connected account required

Tags

Deploy resources
Create a deploymentGITLAB_POST_API_V4_PROJECTS_ID_DEPLOYMENTSCreates a deployment.

Creates a deployment.

Authentication

Connected account required

Tags

Deploy resources
Approve or reject a deploymentGITLAB_POST_API_V4_PROJECTS_ID_DEPLOYMENTS_DEPLOYMENT_ID_APPROVALApproves or rejects a deployment.

Approves or rejects a deployment.

Authentication

Connected account required

Tags

Deploy resources
Create an environmentGITLAB_POST_API_V4_PROJECTS_ID_ENVIRONMENTSCreates an environment for a specified project.

Creates an environment for a specified project.

Authentication

Connected account required

Tags

Environments
Stop an environmentGITLAB_POST_API_V4_PROJECTS_ID_ENVIRONMENTS_ENVIRONMENT_ID_STOPStops a specified running environment.

Stops a specified running environment.

Authentication

Connected account required

Tags

Environments
Stop stale environmentsGITLAB_POST_API_V4_PROJECTS_ID_ENVIRONMENTS_STOP_STALEStops all environments that were last modified or deployed to before a specified date. Excludes protected environments.

Stops all environments that were last modified or deployed to before a specified date. Excludes protected environments.

Authentication

Connected account required

Tags

Environments
Create a client keyGITLAB_POST_API_V4_PROJECTS_ID_ERROR_TRACKING_CLIENT_KEYSCreates a client key for integrated error tracking in a specified project. The public key attribute is generated automatically.

Creates a client key for integrated error tracking in a specified project. The public key attribute is generated automatically.

Authentication

Connected account required

Tags

Error tracking
Export a projectGITLAB_POST_API_V4_PROJECTS_ID_EXPORTExports a project. Use the `upload` hash parameter to upload the exported project to a web server or any S3-compatible platform.

Exports a project. Use the `upload` hash parameter to upload the exported project to a web server or any S3-compatible platform.

Authentication

Connected account required

Tags

Project import
Schedule a relations export for a projectGITLAB_POST_API_V4_PROJECTS_ID_EXPORT_RELATIONSSchedules a relations export for a specified project.

Schedules a relations export for a specified project.

Authentication

Connected account required

Tags

Project import
Create external status check serviceGITLAB_POST_API_V4_PROJECTS_ID_EXTERNAL_STATUS_CHECKSCreates an external status check service for a specified project.

Creates an external status check service for a specified project.

Authentication

Connected account required

Tags

External status checks
Create a feature flagGITLAB_POST_API_V4_PROJECTS_ID_FEATURE_FLAGSCreates a feature flag for a specified project.

Creates a feature flag for a specified project.

Authentication

Connected account required

Tags

Feature flags
Create a feature flag user listGITLAB_POST_API_V4_PROJECTS_ID_FEATURE_FLAGS_USER_LISTSCreates a feature flag user list in a specified project.

Creates a feature flag user list in a specified project.

Authentication

Connected account required

Tags

Feature flags
Create a fork of a projectGITLAB_POST_API_V4_PROJECTS_ID_FORKCreates a fork of a project.

Creates a fork of a project.

Authentication

Connected account required

Tags

Projects
Create a fork relationshipGITLAB_POST_API_V4_PROJECTS_ID_FORK_FORKED_FROM_IDCreates a fork relationship between a project and an upstream project.

Creates a fork relationship between a project and an upstream project.

Authentication

Connected account required

Tags

Projects
Create a freeze periodGITLAB_POST_API_V4_PROJECTS_ID_FREEZE_PERIODSCreates a freeze period for a specified project. You must have the Maintainer or Owner role for the project.

Creates a freeze period for a specified project. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Freeze periods
Add a webhook to a projectGITLAB_POST_API_V4_PROJECTS_ID_HOOKSAdds a webhook to a specified project.

Adds a webhook to a specified project.

Authentication

Connected account required

Tags

Hooks
Resend a webhook eventGITLAB_POST_API_V4_PROJECTS_ID_HOOKS_HOOK_ID_EVENTS_HOOK_LOG_ID_RESENDResends a webhook event. This endpoint has a rate limit of five requests per minute for each authenticated user for a given project or group. On GitLab Self-Managed and GitLab Dedicated, an administrator can change this limit in the application settings.

Resends a webhook event. This endpoint has a rate limit of five requests per minute for each authenticated user for a given project or group. On GitLab Self-Managed and GitLab Dedicated, an administrator can change this limit in the application settings.

Authentication

Connected account required

Tags

Hooks
Trigger a test webhookGITLAB_POST_API_V4_PROJECTS_ID_HOOKS_HOOK_ID_TEST_TRIGGERTriggers a test webhook. This endpoint has a rate limit of five requests per minute for each authenticated user for a given project or group. On GitLab Self-Managed and GitLab Dedicated, an administrator can change this limit in the application settings.

Triggers a test webhook. This endpoint has a rate limit of five requests per minute for each authenticated user for a given project or group. On GitLab Self-Managed and GitLab Dedicated, an administrator can change this limit in the application settings.

Authentication

Connected account required

Tags

Hooks
Start the housekeeping task for a projectGITLAB_POST_API_V4_PROJECTS_ID_HOUSEKEEPINGStarts the housekeeping task for a project.

Starts the housekeeping task for a project.

Authentication

Connected account required

Tags

Projects
Import a project from a Git URLGITLAB_POST_API_V4_PROJECTS_ID_IMPORT_GITImports a project from a specified Git URL. This feature was introduced in GitLab 18.10.

Imports a project from a specified Git URL. This feature was introduced in GitLab 18.10.

Authentication

Connected account required

Tags

Project import
Import membersGITLAB_POST_API_V4_PROJECTS_ID_IMPORT_PROJECT_MEMBERS_PROJECT_IDImports members from another project. If the role of the importing member for the target project is a Maintainer, then members with the Owner role for the source project are imported with the Maintainer role. If the importing member is an Owner, then members with the Owner role for the source project are imported with the Owner role.

Imports members from another project. If the role of the importing member for the target project is a Maintainer, then members with the Owner role for the source project are imported with the Maintainer role. If the importing member is an Owner, then members with the Owner role for the source project are imported with the Owner role.

Authentication

Connected account required

Tags

Projects
Trigger a slash command for mattermost-slash-commandsGITLAB_POST_API_V4_PROJECTS_ID_INTEGRATIONS_MATTERMOST_SLASH_COMMANDS_TRIGGERTriggers a slash command for mattermost-slash-commands.

Triggers a slash command for mattermost-slash-commands.

Authentication

Connected account required

Tags

Integrations
Add a member to a projectGITLAB_POST_API_V4_PROJECTS_ID_INVITATIONSAdds a member to a project. You can specify a user ID or invite a user by email.

Adds a member to a project. You can specify a user ID or invite a user by email.

Authentication

Connected account required

Tags

Invitations
Create an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUESCreates an issue for a specified project.

Creates an issue for a specified project.

Authentication

Connected account required

Tags

Projects
Add spent time for an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_ADD_SPENT_TIMEAdds spent time for a specified issue.

Adds spent time for a specified issue.

Authentication

Connected account required

Tags

Issues
Add an emoji reaction to an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_AWARD_EMOJIAdds an emoji reaction to an issue.

Adds an emoji reaction to an issue.

Authentication

Connected account required

Tags

Award emoji
Clone an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_CLONEClones a specified issue to a project. Copies as much data as possible as long as the target project contains equivalent criteria, such as labels or milestones. If you have insufficient permissions, an error message with status code `400` is returned.

Clones a specified issue to a project. Copies as much data as possible as long as the target project contains equivalent criteria, such as labels or milestones. If you have insufficient permissions, an error message with status code `400` is returned.

Authentication

Connected account required

Tags

Projects
Create an issue linkGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_LINKSCreates a two-way relationship between two issues. The user must be allowed to update both issues to succeed.

Creates a two-way relationship between two issues. The user must be allowed to update both issues to succeed.

Authentication

Connected account required

Tags

Issues
Authorize metric image uploadGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_METRIC_IMAGES_AUTHORIZEAuthorizes uploading a metric image for a specified incident.

Authorizes uploading a metric image for a specified incident.

Authentication

Connected account required

Tags

Metric images
Move an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_MOVEMoves a specified issue to a different project. If the target project is the source project or the user has insufficient permissions, an error message with status code `400` is returned. If a label or milestone with the same name also exists in the target project, it is then assigned to the issue being moved.

Moves a specified issue to a different project. If the target project is the source project or the user has insufficient permissions, an error message with status code `400` is returned. If a label or milestone with the same name also exists in the target project, it is then assigned to the issue being moved.

Authentication

Connected account required

Tags

Projects
Add an emoji reaction to an issue commentGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_NOTES_NOTE_ID_AWARD_EMOJIAdds an emoji reaction to a comment on an issue.

Adds an emoji reaction to a comment on an issue.

Authentication

Connected account required

Tags

Award emoji
Reset spent time for an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_RESET_SPENT_TIMEResets the total spent time for a specified issue to `0` seconds.

Resets the total spent time for a specified issue to `0` seconds.

Authentication

Connected account required

Tags

Issues
Reset the estimated time for an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_RESET_TIME_ESTIMATEResets the estimated time for a specified issue to `0` seconds.

Resets the estimated time for a specified issue to `0` seconds.

Authentication

Connected account required

Tags

Issues
Set the estimated time for an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_TIME_ESTIMATESets an estimated time of work for a specified issue.

Sets an estimated time of work for a specified issue.

Authentication

Connected account required

Tags

Issues
Create a to-do item for an issuableGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_TODOCreates a to-do item for the current user on a specified issuable. If a to-do item already exists for the user on that issuable, returns a `304` status code.

Creates a to-do item for the current user on a specified issuable. If a to-do item already exists for the user on that issuable, returns a `304` status code.

Authentication

Connected account required

Tags

To-dos
Create an issue discussionGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_DISCUSSIONSCreates a discussion for a specified issue. Replies can be added to it later.

Creates a discussion for a specified issue. Replies can be added to it later.

Authentication

Connected account required

Tags

Discussions
Add a comment to an issue discussionGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESAdds a comment to a specified issue discussion.

Adds a comment to a specified issue discussion.

Authentication

Connected account required

Tags

Discussions
Create an issue noteGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_NOTESCreates a note for an issue.

Creates a note for an issue.

Authentication

Connected account required

Tags

Notes
Subscribe to an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_SUBSCRIBABLE_ID_SUBSCRIBESubscribes the currently authenticated user to a specified issue. They will receive notifications on changes to this item.

Subscribes the currently authenticated user to a specified issue. They will receive notifications on changes to this item.

Authentication

Connected account required

Tags

Resource subscriptions
Unsubscribe to an issueGITLAB_POST_API_V4_PROJECTS_ID_ISSUES_SUBSCRIBABLE_ID_UNSUBSCRIBEUnsubscribes the currently authenticated user from a specified issue. They will no longer receive notifications on changes to this item.

Unsubscribes the currently authenticated user from a specified issue. They will no longer receive notifications on changes to this item.

Authentication

Connected account required

Tags

Resource subscriptions
Add a project to a CI/CD job token allowlistGITLAB_POST_API_V4_PROJECTS_ID_JOB_TOKEN_SCOPE_ALLOWLISTAdds a project to the CI/CD job token allowlist of a specified project.

Adds a project to the CI/CD job token allowlist of a specified project.

Authentication

Connected account required

Tags

Projects job token scope
Add a group to a CI/CD job token allowlistGITLAB_POST_API_V4_PROJECTS_ID_JOB_TOKEN_SCOPE_GROUPS_ALLOWLISTAdds a group to the CI/CD job token allowlist of a specified project.

Adds a group to the CI/CD job token allowlist of a specified project.

Authentication

Connected account required

Tags

Projects job token scope
Retain job artifactsGITLAB_POST_API_V4_PROJECTS_ID_JOBS_JOB_ID_ARTIFACTS_KEEPRetains job artifacts. Prevents artifacts for a job from being automatically deleted when they reach their expiration date.

Retains job artifacts. Prevents artifacts for a job from being automatically deleted when they reach their expiration date.

Authentication

Connected account required

Tags

Job artifacts
Cancel a jobGITLAB_POST_API_V4_PROJECTS_ID_JOBS_JOB_ID_CANCELCancels a specified job in a project.

Cancels a specified job in a project.

Authentication

Connected account required

Tags

CI jobs
Erase a jobGITLAB_POST_API_V4_PROJECTS_ID_JOBS_JOB_ID_ERASEErases a specified job in a project. This removes job artifacts and the job log.

Erases a specified job in a project. This removes job artifacts and the job log.

Authentication

Connected account required

Tags

CI jobs
Run a jobGITLAB_POST_API_V4_PROJECTS_ID_JOBS_JOB_ID_PLAYRuns a specified job. For a job in manual status, triggers an action to start the job.

Runs a specified job. For a job in manual status, triggers an action to start the job.

Authentication

Connected account required

Tags

CI jobs
Retry a jobGITLAB_POST_API_V4_PROJECTS_ID_JOBS_JOB_ID_RETRYRetries a specified job in a project.

Retries a specified job in a project.

Authentication

Connected account required

Tags

CI jobs
Create a project labelGITLAB_POST_API_V4_PROJECTS_ID_LABELSCreates a label for a specified project.

Creates a label for a specified project.

Authentication

Connected account required

Tags

Labels
Subscribe to a project labelGITLAB_POST_API_V4_PROJECTS_ID_LABELS_SUBSCRIBABLE_ID_SUBSCRIBESubscribes the currently authenticated user to a specified project label. They will receive notifications on changes to this item.

Subscribes the currently authenticated user to a specified project label. They will receive notifications on changes to this item.

Authentication

Connected account required

Tags

Resource subscriptions
Unsubscribe to a project labelGITLAB_POST_API_V4_PROJECTS_ID_LABELS_SUBSCRIBABLE_ID_UNSUBSCRIBEUnsubscribes the currently authenticated user from a specified project label. They will no longer receive notifications on changes to this item.

Unsubscribes the currently authenticated user from a specified project label. They will no longer receive notifications on changes to this item.

Authentication

Connected account required

Tags

Resource subscriptions
Create a software license policyGITLAB_POST_API_V4_PROJECTS_ID_MANAGED_LICENSESCreates a software license policy for a specified project.

Creates a software license policy for a specified project.

Authentication

Connected account required

Tags

Licenses
Add a member to a projectGITLAB_POST_API_V4_PROJECTS_ID_MEMBERSAdds a member to a specified project.

Adds a member to a specified project.

Authentication

Connected account required

Tags

Members
Create a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTSCreates a merge request for a project.

Creates a merge request for a project.

Authentication

Connected account required

Tags

Merge requests
Add spent time for a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_ADD_SPENT_TIMEAdds spent time for a specified merge request.

Adds spent time for a specified merge request.

Authentication

Connected account required

Tags

Merge requests
Create an approval rule for a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_APPROVAL_RULESCreates an approval rule for a specified merge request. If `approval_project_rule_id` is set with the ID of an existing approval rule from the project, this endpoint copies the values for `name`, `users`, and `groups` from the project rule.

Creates an approval rule for a specified merge request. If `approval_project_rule_id` is set with the ID of an existing approval rule from the project, this endpoint copies the values for `name`, `users`, and `groups` from the project rule.

Authentication

Connected account required

Tags

Merge request approvals
Change approval-related configurationGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_APPROVALSDeprecated in 16.0. Use the merge request approvals API instead.

Deprecated in 16.0. Use the merge request approvals API instead.

Authentication

Connected account required

Tags

Merge request approvals
Approve merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_APPROVEApproves a specified merge request. The currently authenticated user must be an eligible approver. The `sha` parameter ensures you are approving the current version of the merge request. If defined, the value must match the merge request’s HEAD commit SHA. A mismatch returns a `409 Conflict` response.

Approves a specified merge request. The currently authenticated user must be an eligible approver. The `sha` parameter ensures you are approving the current version of the merge request. If defined, the value must match the merge request’s HEAD commit SHA. A mismatch returns a `409 Conflict` response.

Authentication

Connected account required

Tags

Merge request approvals
Add an emoji reaction to a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_AWARD_EMOJIAdds an emoji reaction to a merge request.

Adds an emoji reaction to a merge request.

Authentication

Connected account required

Tags

Award emoji
Create a merge request dependencyGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_BLOCKSCreates a merge request dependency between two merge requests. The merge request is blocked until the dependency merges.

Creates a merge request dependency between two merge requests. The merge request is blocked until the dependency merges.

Authentication

Connected account required

Tags

Merge requests
Cancel merge when pipeline succeedsGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_CANCEL_MERGE_WHEN_PIPELINE_SUCCEEDSCancels an automatic merge for a merge request that has been set to merge when the pipeline succeeds.

Cancels an automatic merge for a merge request that has been set to merge when the pipeline succeeds.

Authentication

Connected account required

Tags

Merge requests
Create context commits for a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_CONTEXT_COMMITSCreates context commits for a specified merge request.

Creates context commits for a specified merge request.

Authentication

Connected account required

Tags

Merge requests
Create a draft noteGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_DRAFT_NOTESCreates a draft note for a specified merge request.

Creates a draft note for a specified merge request.

Authentication

Connected account required

Tags

Draft notes
Publish all pending draft notesGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_DRAFT_NOTES_BULK_PUBLISHPublishes all pending draft notes for the current user on the specified merge request. Optionally sets the reviewer state and posts a summary note.

Publishes all pending draft notes for the current user on the specified merge request. Optionally sets the reviewer state and posts a summary note.

Authentication

Connected account required

Tags

Draft notes
Add an emoji reaction to a merge request commentGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_NOTES_NOTE_ID_AWARD_EMOJIAdds an emoji reaction to a comment on a merge request.

Adds an emoji reaction to a comment on a merge request.

Authentication

Connected account required

Tags

Award emoji
Create a merge request pipelineGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_PIPELINESCreates a merge request pipeline. Pipelines created with this operation must configure `.gitlab-ci.yml` with `only: [merge_requests]` to create jobs.

Creates a merge request pipeline. Pipelines created with this operation must configure `.gitlab-ci.yml` with `only: [merge_requests]` to create jobs.

Authentication

Connected account required

Tags

Merge requests
Reset spent time for a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_RESET_SPENT_TIMEResets the total spent time for a specified merge request to `0` seconds.

Resets the total spent time for a specified merge request to `0` seconds.

Authentication

Connected account required

Tags

Merge requests
Reset the estimated time for a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_RESET_TIME_ESTIMATEResets the estimated time for a specified merge request to `0` seconds.

Resets the estimated time for a specified merge request to `0` seconds.

Authentication

Connected account required

Tags

Merge requests
Update status of an external status checkGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_STATUS_CHECK_RESPONSESUpdates the status of an external status check for a specified merge request, informing GitLab that a merge request has passed a check by an external service. To set the status of an external check, the personal access token used must belong to a user with the Developer, Maintainer, or Owner role on the target project of the merge request. Any user with permission to approve the merge request can use this operation.

Updates the status of an external status check for a specified merge request, informing GitLab that a merge request has passed a check by an external service. To set the status of an external check, the personal access token used must belong to a user with the Developer, Maintainer, or Owner role on the target project of the merge request. Any user with permission to approve the merge request can use this operation.

Authentication

Connected account required

Tags

External status checks
Retry failed status check for a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_STATUS_CHECKS_EXTERNAL_STATUS_CHECK_ID_RETRYRetries a specified failed external status check for a merge request. Even though the merge request has not changed, this endpoint resends the current state of merge request to the defined external service.

Retries a specified failed external status check for a merge request. Even though the merge request has not changed, this endpoint resends the current state of merge request to the defined external service.

Authentication

Connected account required

Tags

External status checks
Set the estimated time for a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_TIME_ESTIMATESets an estimated time of work for a specified merge request.

Sets an estimated time of work for a specified merge request.

Authentication

Connected account required

Tags

Merge requests
Create a to-do item for an issuableGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_TODOCreates a to-do item for the current user on a specified issuable. If a to-do item already exists for the user on that issuable, returns a `304` status code.

Creates a to-do item for the current user on a specified issuable. If a to-do item already exists for the user on that issuable, returns a `304` status code.

Authentication

Connected account required

Tags

To-dos
Unapprove a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_UNAPPROVEUnapproves a merge request. Removes the approval for the currently authenticated user from a specified merge request.

Unapproves a merge request. Removes the approval for the currently authenticated user from a specified merge request.

Authentication

Connected account required

Tags

Merge request approvals
Create a merge request discussionGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_DISCUSSIONSCreates a discussion for a specified merge request. Replies can be added to it later.

Creates a discussion for a specified merge request. Replies can be added to it later.

Authentication

Connected account required

Tags

Discussions
Add a comment to a merge request discussionGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESAdds a comment to a specified merge request discussion.

Adds a comment to a specified merge request discussion.

Authentication

Connected account required

Tags

Discussions
Create a merge request noteGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_NOTESCreates a note for a merge request.

Creates a note for a merge request.

Authentication

Connected account required

Tags

Notes
Subscribe to a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_SUBSCRIBABLE_ID_SUBSCRIBESubscribes the currently authenticated user to a specified merge request. They will receive notifications on changes to this item.

Subscribes the currently authenticated user to a specified merge request. They will receive notifications on changes to this item.

Authentication

Connected account required

Tags

Resource subscriptions
Unsubscribe to a merge requestGITLAB_POST_API_V4_PROJECTS_ID_MERGE_REQUESTS_SUBSCRIBABLE_ID_UNSUBSCRIBEUnsubscribes the currently authenticated user from a specified merge request. They will no longer receive notifications on changes to this item.

Unsubscribes the currently authenticated user from a specified merge request. They will no longer receive notifications on changes to this item.

Authentication

Connected account required

Tags

Resource subscriptions
Add a merge request to a merge trainGITLAB_POST_API_V4_PROJECTS_ID_MERGE_TRAINS_MERGE_REQUESTS_MERGE_REQUEST_IIDAdds a specified merge request to a merge train.

Adds a specified merge request to a merge train.

Authentication

Connected account required

Tags

Merge trains
Create a project milestoneGITLAB_POST_API_V4_PROJECTS_ID_MILESTONESCreates a project milestone.

Creates a project milestone.

Authentication

Connected account required

Tags

Milestones
Promote a project milestone to a group milestoneGITLAB_POST_API_V4_PROJECTS_ID_MILESTONES_MILESTONE_ID_PROMOTEPromotes a specified project milestone to a group milestone. Only for users with the Planner, Reporter, Developer, Maintainer, or Owner role for the group.

Promotes a specified project milestone to a group milestone. Only for users with the Planner, Reporter, Developer, Maintainer, or Owner role for the group.

Authentication

Connected account required

Tags

Milestones
Start the pull mirroring process for a projectGITLAB_POST_API_V4_PROJECTS_ID_MIRROR_PULLStarts the pull mirroring process for a specified project.

Starts the pull mirroring process for a specified project.

Authentication

Connected account required

Tags

Project mirrors
Create experimentGITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_EXPERIMENTS_CREATEhttps://www.mlflow.org/docs/2.19.0/rest-api.html#create-experiment

https://www.mlflow.org/docs/2.19.0/rest-api.html#create-experiment

Authentication

Connected account required

Tags

MLOps
Delete an experiment.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_EXPERIMENTS_DELETEhttps://mlflow.org/docs/2.19.0/rest-api.html#delete-experiment

https://mlflow.org/docs/2.19.0/rest-api.html#delete-experiment

Authentication

Connected account required

Tags

MLOps
Search experimentsGITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_EXPERIMENTS_SEARCHhttps://www.mlflow.org/docs/2.19.0/rest-api.html#search-experiments

https://www.mlflow.org/docs/2.19.0/rest-api.html#search-experiments

Authentication

Connected account required

Tags

MLOps
Sets a tag for an experiment.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_EXPERIMENTS_SET_EXPERIMENT_TAGhttps://www.mlflow.org/docs/2.19.0/rest-api.html#set-experiment-tag

https://www.mlflow.org/docs/2.19.0/rest-api.html#set-experiment-tag

Authentication

Connected account required

Tags

MLOps
Creates a Model Version.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_MODEL_VERSIONS_CREATEMLFlow Model Versions map to GitLab Model Versions. https://mlflow.org/docs/2.19.0/rest-api.html#create-modelversion

MLFlow Model Versions map to GitLab Model Versions. https://mlflow.org/docs/2.19.0/rest-api.html#create-modelversion

Authentication

Connected account required

Tags

MLOps
Creates a Registered Model.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_REGISTERED_MODELS_CREATEMLFlow Registered Models map to GitLab Models. https://mlflow.org/docs/2.19.0/rest-api.html#create-registeredmodel

MLFlow Registered Models map to GitLab Models. https://mlflow.org/docs/2.19.0/rest-api.html#create-registeredmodel

Authentication

Connected account required

Tags

MLOps
Fetch the latest Model Version for the given Registered Model NameGITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_REGISTERED_MODELS_GET_LATEST_VERSIONShttps://mlflow.org/docs/2.19.0/rest-api.html#get-latest-modelversions

https://mlflow.org/docs/2.19.0/rest-api.html#get-latest-modelversions

Authentication

Connected account required

Tags

MLOps
Creates a Run.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_RUNS_CREATEMLFlow Runs map to GitLab Candidates. https://www.mlflow.org/docs/2.19.0/rest-api.html#create-run

MLFlow Runs map to GitLab Candidates. https://www.mlflow.org/docs/2.19.0/rest-api.html#create-run

Authentication

Connected account required

Tags

MLOps
Delete a run.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_RUNS_DELETEhttps://mlflow.org/docs/2.19.0/rest-api.html#delete-run

https://mlflow.org/docs/2.19.0/rest-api.html#delete-run

Authentication

Connected account required

Tags

MLOps
Logs multiple parameters and metrics.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_RUNS_LOG_BATCHhttps://www.mlflow.org/docs/2.19.0/rest-api.html#log-param

https://www.mlflow.org/docs/2.19.0/rest-api.html#log-param

Authentication

Connected account required

Tags

MLOps
Logs a metric to a run.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_RUNS_LOG_METRIChttps://www.mlflow.org/docs/1.28.0/rest-api.html#log-metric

https://www.mlflow.org/docs/1.28.0/rest-api.html#log-metric

Authentication

Connected account required

Tags

MLOps
Logs a parameter to a run.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_RUNS_LOG_PARAMETERhttps://www.mlflow.org/docs/2.19.0/rest-api.html#log-param

https://www.mlflow.org/docs/2.19.0/rest-api.html#log-param

Authentication

Connected account required

Tags

MLOps
Searches runs/candidates within a projectGITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_RUNS_SEARCHhttps://www.mlflow.org/docs/2.19.0/rest-api.html#search-runsexperiment_ids supports only a single experiment ID.Introduced in GitLab 16.4

https://www.mlflow.org/docs/2.19.0/rest-api.html#search-runsexperiment_ids supports only a single experiment ID.Introduced in GitLab 16.4

Authentication

Connected account required

Tags

MLOps
Sets a tag for a run.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_RUNS_SET_TAGhttps://www.mlflow.org/docs/2.19.0/rest-api.html#set-tag

https://www.mlflow.org/docs/2.19.0/rest-api.html#set-tag

Authentication

Connected account required

Tags

MLOps
Updates a Run.GITLAB_POST_API_V4_PROJECTS_ID_ML_MLFLOW_API20_MLFLOW_RUNS_UPDATEMLFlow Runs map to GitLab Candidates. https://www.mlflow.org/docs/2.19.0/rest-api.html#update-run

MLFlow Runs map to GitLab Candidates. https://www.mlflow.org/docs/2.19.0/rest-api.html#update-run

Authentication

Connected account required

Tags

MLOps
Create a packageGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_COMPOSERCreates a Composer package from a specified Git tag or branch for a project.

Creates a Composer package from a specified Git tag or branch for a project.

Authentication

Connected account required

Tags

Packages: Composer
List all package upload URLsGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_PACKAGES_CONAN_PACKAGE_REFERENCE_UPLOAD_URLSLists all the upload URLs for a specified collection of package files. The request must include a JSON object with the name and size of the individual files.

Lists all the upload URLs for a specified collection of package files. The request must include a JSON object with the name and size of the individual files.

Authentication

Connected account required

Tags

Packages: Conan
List all recipe upload URLsGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_UPLOAD_URLSLists all the upload URLs for a specified collection of recipe files. The request must include a JSON object with the name and size of the individual files.

Lists all the upload URLs for a specified collection of recipe files. The request must include a JSON object with the name and size of the individual files.

Authentication

Connected account required

Tags

Packages: Conan
Authorize a chart upload from workhorseGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_HELM_API_CHANNEL_CHARTS_AUTHORIZEThis feature was introduced in GitLab 14.0

This feature was introduced in GitLab 14.0

Authentication

Connected account required

Tags

Packages: Helm
NPM registry bulk advisory endpointGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_NPM_DASH_NPM_V1_SECURITY_ADVISORIES_BULKThis feature was introduced in GitLab 15.6

This feature was introduced in GitLab 15.6

Authentication

Connected account required

Tags

Packages: NPM
NPM registry quick audit endpointGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_NPM_DASH_NPM_V1_SECURITY_AUDITS_QUICKThis feature was introduced in GitLab 15.6

This feature was introduced in GitLab 15.6

Authentication

Connected account required

Tags

Packages: NPM
Create a package protection ruleGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_PROTECTION_RULESCreates a package protection rule for a specified project.

Creates a package protection rule for a specified project.

Authentication

Connected account required

Tags

Projects
Authorize the PyPi package upload from workhorseGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_PYPI_AUTHORIZEThis feature was introduced in GitLab 12.10

This feature was introduced in GitLab 12.10

Authentication

Connected account required

Tags

Packages: PyPi
Upload a RPM packageGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_RPMThis feature was introduced in GitLab 15.7

This feature was introduced in GitLab 15.7

Authentication

Connected account required

Tags

Packages: RPM
Authorize package upload from workhorseGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_RPM_AUTHORIZEThis feature was introduced in GitLab 15.7

This feature was introduced in GitLab 15.7

Authentication

Connected account required

Tags

Packages: RPM
Authorize a gem upload from workhorseGITLAB_POST_API_V4_PROJECTS_ID_PACKAGES_RUBYGEMS_API_V1_GEMS_AUTHORIZEThis feature was introduced in GitLab 13.9

This feature was introduced in GitLab 13.9

Authentication

Connected account required

Tags

Packages: RubyGem
Create Pages domainGITLAB_POST_API_V4_PROJECTS_ID_PAGES_DOMAINSCreates a Pages domain in a specified project. You must have permissions to create Pages domains.

Creates a Pages domain in a specified project. You must have permissions to create Pages domains.

Authentication

Connected account required

Tags

GitLab Pages
Create a pipelineGITLAB_POST_API_V4_PROJECTS_ID_PIPELINECreates a pipeline in the specified project.

Creates a pipeline in the specified project.

Authentication

Connected account required

Tags

Pipelines
Create a pipeline scheduleGITLAB_POST_API_V4_PROJECTS_ID_PIPELINE_SCHEDULESCreates a pipeline schedule.

Creates a pipeline schedule.

Authentication

Connected account required

Tags

Pipeline schedules
Run a pipeline scheduleGITLAB_POST_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_ID_PLAYRuns a pipeline schedule immediately. The next scheduled run of this pipeline is not affected.

Runs a pipeline schedule immediately. The next scheduled run of this pipeline is not affected.

Authentication

Connected account required

Tags

Pipeline schedules
Create or update ownership of a pipeline scheduleGITLAB_POST_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_ID_TAKE_OWNERSHIPCreates or updates the owner of a pipeline schedule for a project.

Creates or updates the owner of a pipeline schedule for a project.

Authentication

Connected account required

Tags

Pipeline schedules
Create a variable for a pipeline scheduleGITLAB_POST_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_ID_VARIABLESCreates a variable for a pipeline schedule.

Creates a variable for a pipeline schedule.

Authentication

Connected account required

Tags

Pipeline schedules
Cancel all jobs for a pipelineGITLAB_POST_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_ID_CANCELCancels all jobs in a specified pipeline.

Cancels all jobs in a specified pipeline.

Authentication

Connected account required

Tags

Pipelines
Retry jobs in a pipelineGITLAB_POST_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_ID_RETRYRetries failed or canceled jobs in a pipeline. If there are no failed or canceled jobs in the pipeline, calling this endpoint has no effect.

Retries failed or canceled jobs in a pipeline. If there are no failed or canceled jobs in the pipeline, calling this endpoint has no effect.

Authentication

Connected account required

Tags

Pipelines
Protect repository branchesGITLAB_POST_API_V4_PROJECTS_ID_PROTECTED_BRANCHESProtects a specified repository branch or several project repository branches using a wildcard protected branch.

Protects a specified repository branch or several project repository branches using a wildcard protected branch.

Authentication

Connected account required

Tags

Protected branches
Protect an environment for a projectGITLAB_POST_API_V4_PROJECTS_ID_PROTECTED_ENVIRONMENTSProtects a specified environment for a project.

Protects a specified environment for a project.

Authentication

Connected account required

Tags

Protected environments
Protect a repository tagGITLAB_POST_API_V4_PROJECTS_ID_PROTECTED_TAGSProtects a specified repository tag using a wildcard protected tag.

Protects a specified repository tag using a wildcard protected tag.

Authentication

Connected account required

Tags

Protected tags
Add push rules to a projectGITLAB_POST_API_V4_PROJECTS_ID_PUSH_RULEAdds push rules to a specified project.

Adds push rules to a specified project.

Authentication

Connected account required

Tags

Push rules
Trigger a pipeline with a tokenGITLAB_POST_API_V4_PROJECTS_ID_REF_REF_TRIGGER_PIPELINETriggers a pipeline with a token. With a CI/CD job token, the triggered pipeline is a multi-project pipeline. The job that authenticates the request becomes associated with the upstream pipeline, which is visible on the pipeline graph. If you use a trigger token in a job, the job is not associated with the upstream pipeline.

Triggers a pipeline with a token. With a CI/CD job token, the triggered pipeline is a multi-project pipeline. The job that authenticates the request becomes associated with the upstream pipeline, which is visible on the pipeline graph. If you use a trigger token in a job, the job is not associated with the upstream pipeline.

Authentication

Connected account required

Tags

CI triggers
Create a container repository protection ruleGITLAB_POST_API_V4_PROJECTS_ID_REGISTRY_PROTECTION_REPOSITORY_RULESCreates a container repository protection rule for a specified project to control who can push or delete container images.

Creates a container repository protection rule for a specified project to control who can push or delete container images.

Authentication

Connected account required

Tags

Projects
Create a container registry protection tag ruleGITLAB_POST_API_V4_PROJECTS_ID_REGISTRY_PROTECTION_TAG_RULESCreates a container registry protection tag rule for a project to control who can push or delete container tags. This feature was introduced in GitLab 18.8.

Creates a container registry protection tag rule for a project to control who can push or delete container tags. This feature was introduced in GitLab 18.8.

Authentication

Connected account required

Tags

Projects
Create a releaseGITLAB_POST_API_V4_PROJECTS_ID_RELEASESCreates a release. Developer level access to the project is required to create a release.

Creates a release. Developer level access to the project is required to create a release.

Authentication

Connected account required

Tags

Releases
Create a release linkGITLAB_POST_API_V4_PROJECTS_ID_RELEASES_TAG_NAME_ASSETS_LINKSCreates an asset link for a specified release.

Creates an asset link for a specified release.

Authentication

Connected account required

Tags

Releases
Generate release evidenceGITLAB_POST_API_V4_PROJECTS_ID_RELEASES_TAG_NAME_EVIDENCEGenerates an evidence for an existing release.

Generates an evidence for an existing release.

Authentication

Connected account required

Tags

Releases
Create a push mirrorGITLAB_POST_API_V4_PROJECTS_ID_REMOTE_MIRRORSCreates a push mirror.

Creates a push mirror.

Authentication

Connected account required

Tags

Remote mirrors
Force push mirror updateGITLAB_POST_API_V4_PROJECTS_ID_REMOTE_MIRRORS_MIRROR_ID_SYNCForces an update to a push mirror.

Forces an update to a push mirror.

Authentication

Connected account required

Tags

Remote mirrors
Get contents of multiple files in a single requestGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_BLOBS_BATCHEach blob is truncated to the first 1 MB; the `truncated` field indicates when this happens.

Each blob is truncated to the first 1 MB; the `truncated` field indicates when this happens.

Authentication

Connected account required

Tags

Repositories
Create a repository branchGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_BRANCHESCreates a branch in the repository.

Creates a branch in the repository.

Authentication

Connected account required

Tags

Branches
Add changelog data to fileGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_CHANGELOGAdds changelog data to file.

Adds changelog data to file.

Authentication

Connected account required

Tags

Repositories
Create a commit discussionGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_NOTEABLE_ID_DISCUSSIONSCreates a discussion for a specified commit. Replies can be added to it later.

Creates a discussion for a specified commit. Replies can be added to it later.

Authentication

Connected account required

Tags

Discussions
Add a comment to a commit discussionGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESAdds a comment to a specified commit discussion.

Adds a comment to a specified commit discussion.

Authentication

Connected account required

Tags

Discussions
Cherry-pick a commitGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_CHERRY_PICKCherry-picks a commit to a specified branch.

Cherry-picks a commit to a specified branch.

Authentication

Connected account required

Tags

Commits
Create a comment on a commitGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_COMMENTSCreates a comment on a commit. To comment on a specific line in a file, specify the full commit SHA, `path`, `line`, and set `line_type` to `new`.

Creates a comment on a commit. To comment on a specific line in a file, specify the full commit SHA, `path`, `line`, and set `line_type` to `new`.

Authentication

Connected account required

Tags

Commits
Revert a commitGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_SHA_REVERTReverts a commit in a specified branch.

Reverts a commit in a specified branch.

Authentication

Connected account required

Tags

Commits
Start a task to recalculate repository size for a projectGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_SIZEThis feature was introduced in GitLab 15.0.

This feature was introduced in GitLab 15.0.

Authentication

Connected account required

Tags

Projects
Create a repository storage move for a projectGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_STORAGE_MOVESCreates a repository storage move for a specified project.

Creates a repository storage move for a specified project.

Authentication

Connected account required

Tags

Storage moves
Create a tagGITLAB_POST_API_V4_PROJECTS_ID_REPOSITORY_TAGSCreates a tag in the repository that points to a specified reference.

Creates a tag in the repository that points to a specified reference.

Authentication

Connected account required

Tags

Tags
Restore a project marked for deletionGITLAB_POST_API_V4_PROJECTS_ID_RESTORERestores a specified project that was marked for deletion.

Restores a specified project that was marked for deletion.

Authentication

Connected account required

Tags

Projects
Assign a runner to a projectGITLAB_POST_API_V4_PROJECTS_ID_RUNNERSAssigns an available project runner to a project.

Assigns an available project runner to a project.

Authentication

Connected account required

Tags

RunnersProjects
Reset the runner registration token for a projectGITLAB_POST_API_V4_PROJECTS_ID_RUNNERS_RESET_REGISTRATION_TOKENResets the runner registration token for a specified project.

Resets the runner registration token for a specified project.

Authentication

Connected account required

Tags

RunnersProjects
Scan a file for vulnerabilitiesGITLAB_POST_API_V4_PROJECTS_ID_SECURITY_SCANS_SAST_SAST_ENDPOINTScans a specified file for security vulnerabilities using SAST.

Scans a specified file for security vulnerabilities using SAST.

Authentication

Connected account required

Tags

Security scans
Create a project service accountGITLAB_POST_API_V4_PROJECTS_ID_SERVICE_ACCOUNTSCreates a service account in a specified project.

Creates a service account in a specified project.

Authentication

Connected account required

Tags

Service accounts
Create a personal access token for a project service accountGITLAB_POST_API_V4_PROJECTS_ID_SERVICE_ACCOUNTS_USER_ID_PERSONAL_ACCESS_TOKENSCreates a personal access token for a specified project service account. Available only for project Owners, Maintainers, and administrators.

Creates a personal access token for a specified project service account. Available only for project Owners, Maintainers, and administrators.

Authentication

Connected account required

Tags

Access tokensService accounts
Rotate a personal access token for a project service accountGITLAB_POST_API_V4_PROJECTS_ID_SERVICE_ACCOUNTS_USER_ID_PERSONAL_ACCESS_TOKENS_TOKEN_ID_ROTATERotates a specified personal access token for a project service account. This revokes the existing token and creates a token with the same name, description, and scopes.

Rotates a specified personal access token for a project service account. This revokes the existing token and creates a token with the same name, description, and scopes.

Authentication

Connected account required

Tags

Access tokensService accounts
Trigger a slash command for mattermost-slash-commandsGITLAB_POST_API_V4_PROJECTS_ID_SERVICES_MATTERMOST_SLASH_COMMANDS_TRIGGERTriggers a slash command for mattermost-slash-commands.

Triggers a slash command for mattermost-slash-commands.

Authentication

Connected account required

Tags

Integrations
Share a project with a groupGITLAB_POST_API_V4_PROJECTS_ID_SHAREShares a specified project with a group.

Shares a specified project with a group.

Authentication

Connected account required

Tags

Projects
Create a project snippetGITLAB_POST_API_V4_PROJECTS_ID_SNIPPETSCreates a project snippet. The user must have permission to create snippets.

Creates a project snippet. The user must have permission to create snippets.

Authentication

Connected account required

Tags

Snippets
Create a snippet discussionGITLAB_POST_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_DISCUSSIONSCreates a discussion for a specified snippet. Replies can be added to it later.

Creates a discussion for a specified snippet. Replies can be added to it later.

Authentication

Connected account required

Tags

Discussions
Add a comment to a snippet discussionGITLAB_POST_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTESAdds a comment to a specified snippet discussion.

Adds a comment to a specified snippet discussion.

Authentication

Connected account required

Tags

Discussions
Create a snippet noteGITLAB_POST_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_NOTESCreates a note for a snippet.

Creates a note for a snippet.

Authentication

Connected account required

Tags

Notes
Add an emoji reaction to a snippetGITLAB_POST_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_AWARD_EMOJIAdds an emoji reaction to a snippet.

Adds an emoji reaction to a snippet.

Authentication

Connected account required

Tags

Award emoji
Add an emoji reaction to a snippet commentGITLAB_POST_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_ID_NOTES_NOTE_ID_AWARD_EMOJIAdds an emoji reaction to a comment on a snippet.

Adds an emoji reaction to a comment on a snippet.

Authentication

Connected account required

Tags

Award emoji
Star a projectGITLAB_POST_API_V4_PROJECTS_ID_STARStars a specified project.

Stars a specified project.

Authentication

Connected account required

Tags

Projects
Create or update a commit pipeline statusGITLAB_POST_API_V4_PROJECTS_ID_STATUSES_SHACreates or updates the status of a commit represented by a job in an `external` stage. If the commit is associated with a merge request, target the commit in the merge request source branch.

Creates or updates the status of a commit represented by a job in an `external` stage. If the commit is associated with a merge request, target the commit in the merge request source branch.

Authentication

Connected account required

Tags

Commit statuses
Authorize Terraform state uploadGITLAB_POST_API_V4_PROJECTS_ID_TERRAFORM_STATE_NAME_AUTHORIZEAuthorizes uploading a Terraform state for a specified project. This feature was introduced in GitLab 18.5.

Authorizes uploading a Terraform state for a specified project. This feature was introduced in GitLab 18.5.

Authentication

Connected account required

Tags

Terraform
Lock a Terraform stateGITLAB_POST_API_V4_PROJECTS_ID_TERRAFORM_STATE_NAME_LOCKLocks a Terraform state for a specified project.

Locks a Terraform state for a specified project.

Authentication

Connected account required

Tags

Terraform
Create a Terraform state protection rule for a projectGITLAB_POST_API_V4_PROJECTS_ID_TERRAFORM_STATE_PROTECTION_RULESThis feature was introduced in GitLab 19.1.

This feature was introduced in GitLab 19.1.

Authentication

Connected account required

Tags

Projects
Trigger a pipeline with a tokenGITLAB_POST_API_V4_PROJECTS_ID_TRIGGER_PIPELINETriggers a pipeline with a token. With a CI/CD job token, the triggered pipeline is a multi-project pipeline. The job that authenticates the request becomes associated with the upstream pipeline, which is visible on the pipeline graph. If you use a trigger token in a job, the job is not associated with the upstream pipeline.

Triggers a pipeline with a token. With a CI/CD job token, the triggered pipeline is a multi-project pipeline. The job that authenticates the request becomes associated with the upstream pipeline, which is visible on the pipeline graph. If you use a trigger token in a job, the job is not associated with the upstream pipeline.

Authentication

Connected account required

Tags

CI triggers
Create a trigger tokenGITLAB_POST_API_V4_PROJECTS_ID_TRIGGERSCreates a pipeline trigger token for a project.

Creates a pipeline trigger token for a project.

Authentication

Connected account required

Tags

CI triggers
Unarchive a projectGITLAB_POST_API_V4_PROJECTS_ID_UNARCHIVEUnarchives a specified project. You must be an administrator or have the Owner role on the project.

Unarchives a specified project. You must be an administrator or have the Owner role on the project.

Authentication

Connected account required

Tags

Projects
Unstar a projectGITLAB_POST_API_V4_PROJECTS_ID_UNSTARUnstars a specified project.

Unstars a specified project.

Authentication

Connected account required

Tags

Projects
Workhorse authorize the file uploadGITLAB_POST_API_V4_PROJECTS_ID_UPLOADS_AUTHORIZEThis feature was introduced in GitLab 13.11

This feature was introduced in GitLab 13.11

Authentication

Connected account required

Tags

Projects
Create a variableGITLAB_POST_API_V4_PROJECTS_ID_VARIABLESCreates a variable. If a variable with the same `key` already exists, the variable must have a different `environment_scope`. Otherwise, GitLab returns a message similar to: `VARIABLE_NAME has already been taken`.

Creates a variable. If a variable with the same `key` already exists, the variable must have a different `environment_scope`. Otherwise, GitLab returns a message similar to: `VARIABLE_NAME has already been taken`.

Authentication

Connected account required

Tags

CI variables
Create a new vulnerabilityGITLAB_POST_API_V4_PROJECTS_ID_VULNERABILITIESCreates a new vulnerability from a confirmed finding.

Creates a new vulnerability from a confirmed finding.

Authentication

Connected account required

Tags

Vulnerabilities
Create a vulnerability noteGITLAB_POST_API_V4_PROJECTS_ID_VULNERABILITIES_NOTEABLE_ID_NOTESCreates a note for a vulnerability.

Creates a note for a vulnerability.

Authentication

Connected account required

Tags

Notes
Create a wiki page meta noteGITLAB_POST_API_V4_PROJECTS_ID_WIKI_PAGES_NOTEABLE_ID_NOTESCreates a note for a wiki page meta.

Creates a note for a wiki page meta.

Authentication

Connected account required

Tags

Notes
Create a wiki page for a projectGITLAB_POST_API_V4_PROJECTS_ID_WIKISCreates a wiki page for a specified project. Requests can define the title, slug, and content.

Creates a wiki page for a specified project. Requests can define the title, slug, and content.

Authentication

Connected account required

Tags

Wikis
Workhorse authorize the project import uploadGITLAB_POST_API_V4_PROJECTS_IMPORT_AUTHORIZEThis feature was introduced in GitLab 12.9

This feature was introduced in GitLab 12.9

Authentication

Connected account required

Tags

Project import
Authorize project relation importGITLAB_POST_API_V4_PROJECTS_IMPORT_RELATION_AUTHORIZEAuthorizes uploading a project relation import file. This feature was introduced in GitLab 16.11.

Authorizes uploading a project relation import file. This feature was introduced in GitLab 16.11.

Authentication

Connected account required

Tags

Project import
Create a Cube query requestGITLAB_POST_API_V4_PROJECTS_PROJECT_ID_PRODUCT_ANALYTICS_REQUEST_DRY_RUNCreates a query request to the Cube API and generates an access token.

Creates a query request to the Cube API and generates an access token.

Authentication

Connected account required

Tags

AnalyticsInternal operations
Create a Cube query requestGITLAB_POST_API_V4_PROJECTS_PROJECT_ID_PRODUCT_ANALYTICS_REQUEST_LOADCreates a query request to the Cube API for product analytics and generates an access token. Requires the `product_analytics_features` flag to be enabled.

Creates a query request to the Cube API for product analytics and generates an access token. Requires the `product_analytics_features` flag to be enabled.

Authentication

Connected account required

Tags

AnalyticsInternal operations
Get metadata for analytics.GITLAB_POST_API_V4_PROJECTS_PROJECT_ID_PRODUCT_ANALYTICS_REQUEST_METARetrieves metadata for analytics from the cube installation

Retrieves metadata for analytics from the cube installation

Authentication

Connected account required

Tags

AnalyticsInternal operations
Register a runner controllerGITLAB_POST_API_V4_RUNNER_CONTROLLERSRegisters a runner controller.

Registers a runner controller.

Authentication

Connected account required

Tags

Runner controllers
Add instance scopeGITLAB_POST_API_V4_RUNNER_CONTROLLERS_ID_SCOPES_INSTANCEAdds an instance scope to a runner controller. When added, the runner controller evaluates jobs for all runners in the GitLab instance. A runner controller can have only one instance scope. If an instance scope already exists, this operation returns an error.

Adds an instance scope to a runner controller. When added, the runner controller evaluates jobs for all runners in the GitLab instance. A runner controller can have only one instance scope. If an instance scope already exists, this operation returns an error.

Authentication

Connected account required

Tags

Runner controllers
Add runner scopeGITLAB_POST_API_V4_RUNNER_CONTROLLERS_ID_SCOPES_RUNNERS_RUNNER_IDAdds a runner scope to a runner controller. When added, the runner controller evaluates jobs only for a specified runner. A runner controller with an instance scope cannot have runner scopes. Remove the instance scope before adding runner scopes.

Adds a runner scope to a runner controller. When added, the runner controller evaluates jobs only for a specified runner. A runner controller with an instance scope cannot have runner scopes. Remove the instance scope before adding runner scopes.

Authentication

Connected account required

Tags

Runner controllers
Create a runner controller tokenGITLAB_POST_API_V4_RUNNER_CONTROLLERS_RUNNER_CONTROLLER_ID_TOKENSCreates a runner controller token.

Creates a runner controller token.

Authentication

Connected account required

Tags

Runner controller tokens
Rotate a runner controller tokenGITLAB_POST_API_V4_RUNNER_CONTROLLERS_RUNNER_CONTROLLER_ID_TOKENS_ID_ROTATERotates an existing runner controller token.

Rotates an existing runner controller token.

Authentication

Connected account required

Tags

Runner controller tokens
Create a runnerGITLAB_POST_API_V4_RUNNERSCreates a runner.

Creates a runner.

Authentication

Connected account required

Tags

CI runners
Reset an authentication token for a runnerGITLAB_POST_API_V4_RUNNERS_ID_RESET_AUTHENTICATION_TOKENResets the authentication token for a specified runner.

Resets the authentication token for a specified runner.

Authentication

Connected account required

Tags

Runners
Reset a runner authentication token with the current tokenGITLAB_POST_API_V4_RUNNERS_RESET_AUTHENTICATION_TOKENResets a runner authentication token with the token used to authenticate the request.

Resets a runner authentication token with the token used to authenticate the request.

Authentication

Connected account required

Tags

CI runners
Reset the runner registration token for the instanceGITLAB_POST_API_V4_RUNNERS_RESET_REGISTRATION_TOKENResets the runner registration token for the GitLab instance.

Resets the runner registration token for the GitLab instance.

Authentication

Connected account required

Tags

RunnersGroups
Verify authentication for a registered runnerGITLAB_POST_API_V4_RUNNERS_VERIFYVerifies authentication for a registered runner.

Verifies authentication for a registered runner.

Authentication

Connected account required

Tags

CI runners
Create a group-level vulnerability exportGITLAB_POST_API_V4_SECURITY_GROUPS_ID_VULNERABILITY_EXPORTSCreates a vulnerability export for a group. Returns status code `403` if the authenticated user does not have permission to create a vulnerability.

Creates a vulnerability export for a group. Returns status code `403` if the authenticated user does not have permission to create a vulnerability.

Authentication

Connected account required

Tags

Vulnerabilities
Create an export for archived vulnerabilitiesGITLAB_POST_API_V4_SECURITY_PROJECTS_ID_VULNERABILITY_ARCHIVE_EXPORTSCreates an export for archived vulnerabilities in a specified project. If an authenticated user does not have permission to read vulnerabilities, returns a `403 Forbidden` status code.

Creates an export for archived vulnerabilities in a specified project. If an authenticated user does not have permission to read vulnerabilities, returns a `403 Forbidden` status code.

Authentication

Connected account required

Tags

Vulnerabilities
Create a project-level vulnerability exportGITLAB_POST_API_V4_SECURITY_PROJECTS_ID_VULNERABILITY_EXPORTSCreates a vulnerability export for a project. Returns status code `403` if the authenticated user does not have permission to create a vulnerability.

Creates a vulnerability export for a project. Returns status code `403` if the authenticated user does not have permission to create a vulnerability.

Authentication

Connected account required

Tags

Vulnerabilities
Create an instance-level vulnerability exportGITLAB_POST_API_V4_SECURITY_VULNERABILITY_EXPORTSCreates a vulnerability export for the projects of the user selected in the Security Dashboard. The created vulnerability export is automatically deleted at the time specified in the `expires_at` field.

Creates a vulnerability export for the projects of the user selected in the Security Dashboard. The created vulnerability export is automatically deleted at the time specified in the `expires_at` field.

Authentication

Connected account required

Tags

Vulnerabilities
Create an instance service accountGITLAB_POST_API_V4_SERVICE_ACCOUNTSCreates an instance service account.

Creates an instance service account.

Authentication

Connected account required

Tags

Service accounts
Trigger a global slack commandGITLAB_POST_API_V4_SLACK_TRIGGERTriggers a global slack command.

Triggers a global slack command.

Authentication

Connected account required

Tags

Integrations
Schedule repository storage moves for all snippets on a storage shardGITLAB_POST_API_V4_SNIPPET_REPOSITORY_STORAGE_MOVESSchedules repository storage moves for each snippet repository stored on the source storage shard. This endpoint migrates all snippets at once.

Schedules repository storage moves for each snippet repository stored on the source storage shard. This endpoint migrates all snippets at once.

Authentication

Connected account required

Tags

Storage moves
Create a snippetGITLAB_POST_API_V4_SNIPPETSCreates a snippet.

Creates a snippet.

Authentication

Connected account required

Tags

Snippets
Schedule a repository storage move for a snippetGITLAB_POST_API_V4_SNIPPETS_ID_REPOSITORY_STORAGE_MOVESSchedules a repository storage move for a specified snippet.

Schedules a repository storage move for a specified snippet.

Authentication

Connected account required

Tags

Storage moves
Mark a to-do item as doneGITLAB_POST_API_V4_TODOS_ID_MARK_AS_DONEMarks a to-do item for the current user as done.

Marks a to-do item for the current user as done.

Authentication

Connected account required

Tags

To-dos
Mark all to-do items as doneGITLAB_POST_API_V4_TODOS_MARK_AS_DONEMarks all pending to-do items for the current user as done. It returns the HTTP status code `204` with an empty response.

Marks all pending to-do items for the current user as done. It returns the HTTP status code `204` with an empty response.

Authentication

Connected account required

Tags

To-dos
Issue a short-lived JWT for a single modular-service audienceGITLAB_POST_API_V4_TOKEN_EXCHANGEIssues a short-lived RS256 JWT scoped to one modular-service audience (such as the Artifact Registry). Claims include the requesting user id (sub), organization id, and deployment realm (saas / self-managed). Presented to the corresponding backend and verified against the instance JWKS.

Issues a short-lived RS256 JWT scoped to one modular-service audience (such as the Artifact Registry). Claims include the requesting user id (sub), organization id, and deployment realm (saas / self-managed). Presented to the corresponding backend and verified against the instance JWKS.

Authentication

Connected account required

Tags

Token exchange
Merge topicsGITLAB_POST_API_V4_TOPICS_MERGEMerges a source topic into a target topic. This action deletes the source topic and moves all assigned projects to the target topic. Administrators only.

Merges a source topic into a target topic. This action deletes the source topic and moves all assigned projects to the target topic. Administrators only.

Authentication

Connected account required

Tags

Project topics
Track usage data eventGITLAB_POST_API_V4_USAGE_DATA_INCREMENT_COUNTERThis feature was introduced in GitLab 13.4.

This feature was introduced in GitLab 13.4.

Authentication

Connected account required

Tags

Usage data
Track usage data event for the current userGITLAB_POST_API_V4_USAGE_DATA_INCREMENT_UNIQUE_USERSTrack usage data event for the current user

Track usage data event for the current user

Authentication

Connected account required

Tags

Usage data
Track an internal GitLab eventGITLAB_POST_API_V4_USAGE_DATA_TRACK_EVENTTracks a GitLab internal event. This action increments Service Ping counters in Redis and is optionally sent to Snowplow. Introduced in GitLab 16.2.

Tracks a GitLab internal event. This action increments Service Ping counters in Redis and is optionally sent to Snowplow. Introduced in GitLab 16.2.

Authentication

Connected account required

Tags

Usage data
Track multiple internal GitLab eventsGITLAB_POST_API_V4_USAGE_DATA_TRACK_EVENTSTracks one or more GitLab internal events in a single request. Each event increments Service Ping counters in Redis and is optionally sent to Snowplow. This feature was introduced in GitLab 17.3.

Tracks one or more GitLab internal events in a single request. Each event increments Service Ping counters in Redis and is optionally sent to Snowplow. This feature was introduced in GitLab 17.3.

Authentication

Connected account required

Tags

Usage data
Create an applicationGITLAB_POST_API_V4_USER_APPLICATIONSCreates a new OAuth application for the authenticated user. This feature was introduced in GitLab 19.0

Creates a new OAuth application for the authenticated user. This feature was introduced in GitLab 19.0

Authentication

Connected account required

Tags

Applications
Add an email addressGITLAB_POST_API_V4_USER_EMAILSAdds an email address for the currently authenticated user.

Adds an email address for the currently authenticated user.

Authentication

Connected account required

Tags

Users
Add a GPG keyGITLAB_POST_API_V4_USER_GPG_KEYSAdds a GPG key for the currently authenticated user.

Adds a GPG key for the currently authenticated user.

Authentication

Connected account required

Tags

Keys
Revoke a GPG keyGITLAB_POST_API_V4_USER_GPG_KEYS_KEY_ID_REVOKEThis feature was added in GitLab 10.0

This feature was added in GitLab 10.0

Authentication

Connected account required

Tags

Keys
Add an SSH keyGITLAB_POST_API_V4_USER_KEYSAdds an SSH key for the currently authenticated user.

Adds an SSH key for the currently authenticated user.

Authentication

Connected account required

Tags

Keys
Create a personal access tokenGITLAB_POST_API_V4_USER_PERSONAL_ACCESS_TOKENSCreates a personal access token for the currently authenticated user. For security purposes, the token is limited to the `k8s_proxy` and `self_rotate` scope. Token values are included with the response, but cannot be retrieved later. This feature was introduced in GitLab 16.5.

Creates a personal access token for the currently authenticated user. For security purposes, the token is limited to the `k8s_proxy` and `self_rotate` scope. Token values are included with the response, but cannot be retrieved later. This feature was introduced in GitLab 16.5.

Authentication

Connected account required

Tags

Access tokens
Create a runner owned by currently authenticated userGITLAB_POST_API_V4_USER_RUNNERSCreate a new runner

Create a new runner

Authentication

Connected account required

Tags

UsersRunners
Create a Support PINGITLAB_POST_API_V4_USER_SUPPORT_PINCreates a Support PIN. The PIN expires seven days after creation. GitLab Support may ask for this PIN to validate your identity.

Creates a Support PIN. The PIN expires seven days after creation. GitLab Support may ask for this PIN to validate your identity.

Authentication

Connected account required

Tags

Users
Reactivate a userGITLAB_POST_API_V4_USERS_ID_ACTIVATEReactivates a specified user account that was previously deactivated. Administrators only.

Reactivates a specified user account that was previously deactivated. Administrators only.

Authentication

Connected account required

Tags

Users
Approve access to a userGITLAB_POST_API_V4_USERS_ID_APPROVEApproves access to a specified user account that is pending approval. Administrators only.

Approves access to a specified user account that is pending approval. Administrators only.

Authentication

Connected account required

Tags

Users
Ban a userGITLAB_POST_API_V4_USERS_ID_BANBans a specified user account. Administrators only.

Bans a specified user account. Administrators only.

Authentication

Connected account required

Tags

Users
Block access to a userGITLAB_POST_API_V4_USERS_ID_BLOCKBlocks a specified user account. Administrators only.

Blocks a specified user account. Administrators only.

Authentication

Connected account required

Tags

Users
Deactivate a userGITLAB_POST_API_V4_USERS_ID_DEACTIVATEDeactivates a specified user account. Administrators only.

Deactivates a specified user account. Administrators only.

Authentication

Connected account required

Tags

Users
Add an email address for a userGITLAB_POST_API_V4_USERS_ID_EMAILSAdds an email address for a specified user account. Administrators only.

Adds an email address for a specified user account. Administrators only.

Authentication

Connected account required

Tags

Users
Follow a userGITLAB_POST_API_V4_USERS_ID_FOLLOWFollows a specified user account.

Follows a specified user account.

Authentication

Connected account required

Tags

Users
Add a GPG key for a userGITLAB_POST_API_V4_USERS_ID_GPG_KEYSAdds a GPG key for a specified user account. Administrators only.

Adds a GPG key for a specified user account. Administrators only.

Authentication

Connected account required

Tags

Keys
Revoke a GPG key for a user.GITLAB_POST_API_V4_USERS_ID_GPG_KEYS_KEY_ID_REVOKEDeletes a GPG key from a specified user account. Administrators only.

Deletes a GPG key from a specified user account. Administrators only.

Authentication

Connected account required

Tags

Keys
Reject access to a userGITLAB_POST_API_V4_USERS_ID_REJECTRejects access to a specified user account that is pending approval. Administrators only.

Rejects access to a specified user account that is pending approval. Administrators only.

Authentication

Connected account required

Tags

Users
Revoke a Support PIN for a userGITLAB_POST_API_V4_USERS_ID_SUPPORT_PIN_REVOKERevokes a Support PIN for a specified user. This immediately expires and removes the PIN. Administrators only.

Revokes a Support PIN for a specified user. This immediately expires and removes the PIN. Administrators only.

Authentication

Connected account required

Tags

Users
Unban a userGITLAB_POST_API_V4_USERS_ID_UNBANUnbans a specified user account that was previously banned. Administrators only.

Unbans a specified user account that was previously banned. Administrators only.

Authentication

Connected account required

Tags

Users
Unblock access to a userGITLAB_POST_API_V4_USERS_ID_UNBLOCKUnblocks a specified user account that was previously blocked. Administrators only.

Unblocks a specified user account that was previously blocked. Administrators only.

Authentication

Connected account required

Tags

Users
Unfollow a userGITLAB_POST_API_V4_USERS_ID_UNFOLLOWUnfollows a specified user account.

Unfollows a specified user account.

Authentication

Connected account required

Tags

Users
Create an impersonation tokenGITLAB_POST_API_V4_USERS_USER_ID_IMPERSONATION_TOKENSCreates an impersonation token. These tokens are used to act on behalf of a user and can perform API calls as well as Git read and write actions. These tokens are not visible to the associated user on their profile settings page. Token values are included with the response, but cannot be retrieved later. Administrators only.

Creates an impersonation token. These tokens are used to act on behalf of a user and can perform API calls as well as Git read and write actions. These tokens are not visible to the associated user on their profile settings page. Token values are included with the response, but cannot be retrieved later. Administrators only.

Authentication

Connected account required

Tags

Access tokens
Add an SSH key for a userGITLAB_POST_API_V4_USERS_USER_ID_KEYSAdds an SSH key for a specified user account. Administrators only.

Adds an SSH key for a specified user account. Administrators only.

Authentication

Connected account required

Tags

Keys
Create a personal access token for a userGITLAB_POST_API_V4_USERS_USER_ID_PERSONAL_ACCESS_TOKENSCreates a personal access token for a user. Token values are included with the response, but cannot be retrieved later. Administrators only.

Creates a personal access token for a user. Token values are included with the response, but cannot be retrieved later. Administrators only.

Authentication

Connected account required

Tags

Access tokens
Creates or updates a specific settingGITLAB_POST_API_V4_VSCODE_SETTINGS_SYNC_SETTINGS_CONTEXT_HASH_V1_RESOURCE_RESOURCE_NAMECreates or updates a specific setting

Creates or updates a specific setting

Authentication

Connected account required

Tags

VSCode
Creates or updates a specific settingGITLAB_POST_API_V4_VSCODE_SETTINGS_SYNC_V1_RESOURCE_RESOURCE_NAMECreates or updates a specific setting

Creates or updates a specific setting

Authentication

Connected account required

Tags

VSCode
Confirm a vulnerabilityGITLAB_POST_API_V4_VULNERABILITIES_ID_CONFIRMConfirms a specified vulnerability, marking it as genuine and requiring action. Returns status code `304` if the vulnerability is already confirmed. Returns status code `403` if the authenticated user does not have permission to change the vulnerability status.

Confirms a specified vulnerability, marking it as genuine and requiring action. Returns status code `304` if the vulnerability is already confirmed. Returns status code `403` if the authenticated user does not have permission to change the vulnerability status.

Authentication

Connected account required

Tags

Vulnerabilities
Dismiss a vulnerabilityGITLAB_POST_API_V4_VULNERABILITIES_ID_DISMISSDismisses a specified vulnerability. Returns status code `304` if the vulnerability is already dismissed. Returns status code `403` if the authenticated user does not have permission to change the vulnerability status.

Dismisses a specified vulnerability. Returns status code `304` if the vulnerability is already dismissed. Returns status code `403` if the authenticated user does not have permission to change the vulnerability status.

Authentication

Connected account required

Tags

Vulnerabilities
Relate an issue to a vulnerabilityGITLAB_POST_API_V4_VULNERABILITIES_ID_ISSUE_LINKSRelate an issue to a vulnerability

Relate an issue to a vulnerability

Authentication

Connected account required

Tags

Vulnerabilities
Resolve a vulnerabilityGITLAB_POST_API_V4_VULNERABILITIES_ID_RESOLVEResolves a specified vulnerability. Returns status code `304` if the vulnerability is already resolved. Returns status code `403` if the authenticated user does not have permission to change the vulnerability status.

Resolves a specified vulnerability. Returns status code `304` if the vulnerability is already resolved. Returns status code `403` if the authenticated user does not have permission to change the vulnerability status.

Authentication

Connected account required

Tags

Vulnerabilities
Revert a vulnerability to detected stateGITLAB_POST_API_V4_VULNERABILITIES_ID_REVERTReverts a specified vulnerability to detected state. Returns status code `304` if the vulnerability is already in detected state. Returns status code `403` if the authenticated user does not have permission to change vulnerability status.

Reverts a specified vulnerability to detected state. Returns status code `304` if the vulnerability is already in detected state. Returns status code `403` if the authenticated user does not have permission to change vulnerability status.

Authentication

Connected account required

Tags

Vulnerabilities
Update AI False Positive Detection resultsGITLAB_POST_API_V4_VULNERABILITIES_VULNERABILITY_ID_FLAGS_AI_DETECTIONUpdates the confidence score and explanation for AI-based False Positive Detection flows.

Updates the confidence score and explanation for AI-based False Positive Detection flows.

Authentication

Connected account required

Tags

Vulnerabilities
Update enabled namespace stateGITLAB_PUT_API_V4_ADMIN_ACTIVE_CONTEXT_CODE_ENABLED_NAMESPACESUpdate enabled namespace state

Update enabled namespace state

Authentication

Connected account required

Tags

Active context
Update collection optionsGITLAB_PUT_API_V4_ADMIN_ACTIVE_CONTEXT_COLLECTIONS_IDUpdate collection options

Update collection options

Authentication

Connected account required

Tags

Active context
Activate an ActiveContext connectionGITLAB_PUT_API_V4_ADMIN_ACTIVE_CONTEXT_CONNECTIONS_ACTIVATEActivate an ActiveContext connection

Activate an ActiveContext connection

Authentication

Connected account required

Tags

Active context
Deactivate an ActiveContext connectionGITLAB_PUT_API_V4_ADMIN_ACTIVE_CONTEXT_CONNECTIONS_DEACTIVATEDeactivate an ActiveContext connection

Deactivate an ActiveContext connection

Authentication

Connected account required

Tags

Active context
Pause a batched background migrationGITLAB_PUT_API_V4_ADMIN_BATCHED_BACKGROUND_MIGRATIONS_ID_PAUSEPause a batched background migration

Pause a batched background migration

Authentication

Connected account required

Tags

Batched background migrations
Resume a batched background migrationGITLAB_PUT_API_V4_ADMIN_BATCHED_BACKGROUND_MIGRATIONS_ID_RESUMEResume a batched background migration

Resume a batched background migration

Authentication

Connected account required

Tags

Batched background migrations
Restart a batched background operationGITLAB_PUT_API_V4_ADMIN_BATCHED_BACKGROUND_OPERATIONS_ID_RESTARTThis feature was introduced in GitLab 19.2.

This feature was introduced in GitLab 19.2.

Authentication

Connected account required

Tags

Batched background operations
Stop a batched background operationGITLAB_PUT_API_V4_ADMIN_BATCHED_BACKGROUND_OPERATIONS_ID_STOPThis feature was introduced in GitLab 19.2.

This feature was introduced in GitLab 19.2.

Authentication

Connected account required

Tags

Batched background operations
Update an instance variableGITLAB_PUT_API_V4_ADMIN_CI_VARIABLES_KEYUpdates a specified instance variable.

Updates a specified instance variable.

Authentication

Connected account required

Tags

CI variables
Update an instance clusterGITLAB_PUT_API_V4_ADMIN_CLUSTERS_CLUSTER_IDUpdates an existing instance cluster.

Updates an existing instance cluster.

Authentication

Connected account required

Tags

Clusters
Recalculate checksums for model recordsGITLAB_PUT_API_V4_ADMIN_DATA_MANAGEMENT_MODEL_NAME_CHECKSUMRecalculates checksums for selected records of a specified model, filtered by `checksum_state` and `identifiers` parameters if provided. The request enqueues a background job to perform the recalculation. Only available to administrators on primary Geo sites.

Recalculates checksums for selected records of a specified model, filtered by `checksum_state` and `identifiers` parameters if provided. The request enqueues a background job to perform the recalculation. Only available to administrators on primary Geo sites.

Authentication

Connected account required

Tags

Data management
Recalculate the checksum of a model recordGITLAB_PUT_API_V4_ADMIN_DATA_MANAGEMENT_MODEL_NAME_RECORD_IDENTIFIER_CHECKSUMRecalculates the checksum of a specified model record. The checksum value is a representation of the queried model hashed with the md5 or sha256 algorithm. Only available to administrators on primary Geo sites.

Recalculates the checksum of a specified model record. The checksum value is a representation of the queried model hashed with the md5 or sha256 algorithm. Only available to administrators on primary Geo sites.

Authentication

Connected account required

Tags

Data management
Enable a namespace for Knowledge GraphGITLAB_PUT_API_V4_ADMIN_KNOWLEDGE_GRAPH_NAMESPACES_IDThis endpoint enables Knowledge Graph for a specific namespace

This endpoint enables Knowledge Graph for a specific namespace

Authentication

Connected account required

Tags

Knowledge graph
Update security policy settingsGITLAB_PUT_API_V4_ADMIN_SECURITY_COMPLIANCE_POLICY_SETTINGSUpdates the security policy settings for this GitLab instance.

Updates the security policy settings for this GitLab instance.

Authentication

Connected account required

Tags

Compliance policy settings
Triggers indexing for the specified projectGITLAB_PUT_API_V4_ADMIN_ZOEKT_PROJECTS_PROJECT_ID_INDEXTriggers indexing for the specified project

Triggers indexing for the specified project

Authentication

Connected account required

Tags

Code search
Add a namespace to a node for Zoekt indexingGITLAB_PUT_API_V4_ADMIN_ZOEKT_SHARDS_NODE_ID_INDEXED_NAMESPACES_NAMESPACE_IDAdd a namespace to a node for Zoekt indexing

Add a namespace to a node for Zoekt indexing

Authentication

Connected account required

Tags

Code search
Update workflow eventGITLAB_PUT_API_V4_AI_DUO_WORKFLOWS_WORKFLOWS_ID_EVENTS_EVENT_IDUpdate workflow event

Update workflow event

Authentication

Connected account required

Tags

GitLab Duo workflowsInternal operations
Change plan limitsGITLAB_PUT_API_V4_APPLICATION_PLAN_LIMITSModify the limits of a plan on the GitLab instance.

Modify the limits of a plan on the GitLab instance.

Authentication

Connected account required

Tags

Plan limits
Update application settingsGITLAB_PUT_API_V4_APPLICATION_SETTINGSUpdates the current application settings for this GitLab instance.

Updates the current application settings for this GitLab instance.

Authentication

Connected account required

Tags

Instance
Update a broadcast messageGITLAB_PUT_API_V4_BROADCAST_MESSAGES_IDUpdates a specified broadcast message.

Updates a specified broadcast message.

Authentication

Connected account required

Tags

Broadcast messages
Rollback namespaces to be indexed down to n%GITLAB_PUT_API_V4_ELASTICSEARCH_INDEXED_NAMESPACES_ROLLBACKThis feature was introduced in GitLab 12.7. **DEPRECATED**: This endpoint is deprecated and for GitLab.com use only. This will only ever decrease the number of indexed namespaces. Providing a value higher than the current rolled out percentage will have no effect. This percentage is never persisted but is used to calculate the number of namespaces to rollback.

This feature was introduced in GitLab 12.7. **DEPRECATED**: This endpoint is deprecated and for GitLab.com use only. This will only ever decrease the number of indexed namespaces. Providing a value higher than the current rolled out percentage will have no effect. This percentage is never persisted but is used to calculate the number of namespaces to rollback.

Authentication

Connected account required

Tags

Advanced search rollout
Rollout namespaces to be indexed up to n%GITLAB_PUT_API_V4_ELASTICSEARCH_INDEXED_NAMESPACES_ROLLOUTThis feature was introduced in GitLab 12.7. **DEPRECATED**: This endpoint is deprecated and for GitLab.com use only. This will only ever increase the number of indexed namespaces. Providing a value lower than the current rolled out percentage will have no effect. This percentage is never persisted but is used to calculate the number of new namespaces to rollout. If the same percentage is applied again at a later time, due to possible new namespaces being created during the period, some of them will also be indexed. Therefore you may expect that setting this to 10%, then waiting a month and setting to 10% again will trigger new namespaces to be added (i.e. 10% of the number of newly created namespaces in the last month within the given plan).

This feature was introduced in GitLab 12.7. **DEPRECATED**: This endpoint is deprecated and for GitLab.com use only. This will only ever increase the number of indexed namespaces. Providing a value lower than the current rolled out percentage will have no effect. This percentage is never persisted but is used to calculate the number of new namespaces to rollout. If the same percentage is applied again at a later time, due to possible new namespaces being created during the period, some of them will also be indexed. Therefore you may expect that setting this to 10%, then waiting a month and setting to 10% again will trigger new namespaces to be added (i.e. 10% of the number of newly created namespaces in the last month within the given plan).

Authentication

Connected account required

Tags

Advanced search rollout
Update a Geo nodeGITLAB_PUT_API_V4_GEO_NODES_IDUpdates a specified Geo node.

Updates a specified Geo node.

Authentication

Connected account required

Tags

Geo
Update a Geo siteGITLAB_PUT_API_V4_GEO_SITES_IDUpdates a specified Geo site.

Updates a specified Geo site.

Authentication

Connected account required

Tags

Geo
Approve an access requestGITLAB_PUT_API_V4_GROUPS_ID_ACCESS_REQUESTS_USER_ID_APPROVEApproves an access request for a specified user in a group.

Approves an access request for a specified user in a group.

Authentication

Connected account required

Tags

Access requests
Update group approval ruleGITLAB_PUT_API_V4_GROUPS_ID_APPROVAL_RULES_APPROVAL_RULE_IDUpdate group approval rule

Update group approval rule

Authentication

Connected account required

Tags

Approval rules
Update a badge for a groupGITLAB_PUT_API_V4_GROUPS_ID_BADGES_BADGE_IDUpdates a specified badge for a group.

Updates a specified badge for a group.

Authentication

Connected account required

Tags

Badges
Update a group issue boardGITLAB_PUT_API_V4_GROUPS_ID_BOARDS_BOARD_IDUpdates a specified group issue board.

Updates a specified group issue board.

Authentication

Connected account required

Tags

Boards
Update a group issue board listGITLAB_PUT_API_V4_GROUPS_ID_BOARDS_BOARD_ID_LISTS_LIST_IDUpdates a specified group issue board list. This call is used to change list position.

Updates a specified group issue board list. This call is used to change list position.

Authentication

Connected account required

Tags

Boards
Update a group clusterGITLAB_PUT_API_V4_GROUPS_ID_CLUSTERS_CLUSTER_IDUpdates a specified group cluster.

Updates a specified group cluster.

Authentication

Connected account required

Tags

Clusters
Creates or updates a custom attribute for a groupGITLAB_PUT_API_V4_GROUPS_ID_CUSTOM_ATTRIBUTES_KEYCreates or updates a custom attribute for a specified group. If the attribute already exists, it is updated, otherwise a new attribute is created.

Creates or updates a custom attribute for a specified group. If the attribute already exists, it is updated, otherwise a new attribute is created.

Authentication

Connected account required

Tags

Custom attributes
Update a Debian group distributionGITLAB_PUT_API_V4_GROUPS_ID_DASH_DEBIAN_DISTRIBUTIONS_CODENAMEUpdates a specified Debian group distribution for a group.

Updates a specified Debian group distribution for a group.

Authentication

Connected account required

Tags

Packages: Debian
Update an epicGITLAB_PUT_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IIDUpdates an epic

Updates an epic

Authentication

Connected account required

Tags

Epics
Reorder child epicsGITLAB_PUT_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IID_EPICS_CHILD_EPIC_IDReorder child epics

Reorder child epics

Authentication

Connected account required

Tags

Epics
Update a related epic linkGITLAB_PUT_API_V4_GROUPS_ID_DASH_EPICS_EPIC_IID_ISSUES_EPIC_ISSUE_IDUpdates the relation of a specified issue to an epic.

Updates the relation of a specified issue to an epic.

Authentication

Connected account required

Tags

Epics
Resolve or unresolve an epic discussionGITLAB_PUT_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_IDResolves or unresolves a specified epic discussion.

Resolves or unresolves a specified epic discussion.

Authentication

Connected account required

Tags

Discussions
Update a comment in an epic discussionGITLAB_PUT_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDUpdates or changes the status of a specified comment in a epic discussion.

Updates or changes the status of a specified comment in a epic discussion.

Authentication

Connected account required

Tags

Discussions
Update an epic noteGITLAB_PUT_API_V4_GROUPS_ID_EPICS_NOTEABLE_ID_NOTES_NOTE_IDUpdates an existing note for an epic.

Updates an existing note for an epic.

Authentication

Connected account required

Tags

Notes
Update a group hookGITLAB_PUT_API_V4_GROUPS_ID_HOOKS_HOOK_IDUpdates a hook for a specified group.

Updates a hook for a specified group.

Authentication

Connected account required

Tags

Hooks
Update a custom headerGITLAB_PUT_API_V4_GROUPS_ID_HOOKS_HOOK_ID_CUSTOM_HEADERS_KEYUpdates a custom header for a specified webhook.

Updates a custom header for a specified webhook.

Authentication

Connected account required

Tags

Hooks
Update a URL variableGITLAB_PUT_API_V4_GROUPS_ID_HOOKS_HOOK_ID_URL_VARIABLES_KEYUpdates a URL variable for a specified webhook.

Updates a URL variable for a specified webhook.

Authentication

Connected account required

Tags

Hooks
Create or update the Apple App Store integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_APPLE_APP_STORECreates or updates the Apple App Store integration.

Creates or updates the Apple App Store integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Asana integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_ASANACreates or updates the Asana integration.

Creates or updates the Asana integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Assembla integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_ASSEMBLACreates or updates the Assembla integration.

Creates or updates the Assembla integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Bamboo integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_BAMBOOCreates or updates the Bamboo integration.

Creates or updates the Bamboo integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Bugzilla integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_BUGZILLACreates or updates the Bugzilla integration.

Creates or updates the Bugzilla integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Buildkite integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_BUILDKITECreates or updates the Buildkite integration.

Creates or updates the Buildkite integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Campfire integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_CAMPFIRECreates or updates the Campfire integration.

Creates or updates the Campfire integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Clickup integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_CLICKUPCreates or updates the Clickup integration.

Creates or updates the Clickup integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Confluence integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_CONFLUENCECreates or updates the Confluence integration.

Creates or updates the Confluence integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Custom Issue Tracker integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_CUSTOM_ISSUE_TRACKERCreates or updates the Custom Issue Tracker integration.

Creates or updates the Custom Issue Tracker integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Datadog integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_DATADOGCreates or updates the Datadog integration.

Creates or updates the Datadog integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Diffblue Cover integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_DIFFBLUE_COVERCreates or updates the Diffblue Cover integration.

Creates or updates the Diffblue Cover integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Discord integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_DISCORDCreates or updates the Discord integration.

Creates or updates the Discord integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Drone Ci integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_DRONE_CICreates or updates the Drone Ci integration.

Creates or updates the Drone Ci integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Emails On Push integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_EMAILS_ON_PUSHCreates or updates the Emails On Push integration.

Creates or updates the Emails On Push integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Ewm integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_EWMCreates or updates the Ewm integration.

Creates or updates the Ewm integration.

Authentication

Connected account required

Tags

Integrations
Create or update the External Wiki integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_EXTERNAL_WIKICreates or updates the External Wiki integration.

Creates or updates the External Wiki integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Git Guardian integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_GIT_GUARDIANCreates or updates the Git Guardian integration.

Creates or updates the Git Guardian integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Github integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_GITHUBCreates or updates the Github integration.

Creates or updates the Github integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Gitlab Slack Application integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_GITLAB_SLACK_APPLICATIONCreates or updates the Gitlab Slack Application integration.

Creates or updates the Gitlab Slack Application integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Google Cloud Platform Artifact Registry integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_GOOGLE_CLOUD_PLATFORM_ARTIFACT_REGISTRYCreates or updates the Google Cloud Platform Artifact Registry integration.

Creates or updates the Google Cloud Platform Artifact Registry integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Google Cloud Platform Workload Identity Federation integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_GOOGLE_CLOUD_PLATFORM_WORKLOAD_IDENTITY_FEDERATIONCreates or updates the Google Cloud Platform Workload Identity Federation integration.

Creates or updates the Google Cloud Platform Workload Identity Federation integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Google Play integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_GOOGLE_PLAYCreates or updates the Google Play integration.

Creates or updates the Google Play integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Hangouts Chat integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_HANGOUTS_CHATCreates or updates the Hangouts Chat integration.

Creates or updates the Hangouts Chat integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Harbor integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_HARBORCreates or updates the Harbor integration.

Creates or updates the Harbor integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Irker integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_IRKERCreates or updates the Irker integration.

Creates or updates the Irker integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Jenkins integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_JENKINSCreates or updates the Jenkins integration.

Creates or updates the Jenkins integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Jira integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_JIRACreates or updates the Jira integration.

Creates or updates the Jira integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Jira Cloud App integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_JIRA_CLOUD_APPCreates or updates the Jira Cloud App integration.

Creates or updates the Jira Cloud App integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Linear integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_LINEARCreates or updates the Linear integration.

Creates or updates the Linear integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Matrix integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_MATRIXCreates or updates the Matrix integration.

Creates or updates the Matrix integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mattermost integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_MATTERMOSTCreates or updates the Mattermost integration.

Creates or updates the Mattermost integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mattermost Slash Commands integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_MATTERMOST_SLASH_COMMANDSCreates or updates the Mattermost Slash Commands integration.

Creates or updates the Mattermost Slash Commands integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Microsoft Teams integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_MICROSOFT_TEAMSCreates or updates the Microsoft Teams integration.

Creates or updates the Microsoft Teams integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mock Ci integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_MOCK_CICreates or updates the Mock Ci integration.

Creates or updates the Mock Ci integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mock Monitoring integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_MOCK_MONITORINGCreates or updates the Mock Monitoring integration.

Creates or updates the Mock Monitoring integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Packagist integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_PACKAGISTCreates or updates the Packagist integration.

Creates or updates the Packagist integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Phorge integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_PHORGECreates or updates the Phorge integration.

Creates or updates the Phorge integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pipelines Email integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_PIPELINES_EMAILCreates or updates the Pipelines Email integration.

Creates or updates the Pipelines Email integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pivotaltracker integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_PIVOTALTRACKERCreates or updates the Pivotaltracker integration.

Creates or updates the Pivotaltracker integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pumble integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_PUMBLECreates or updates the Pumble integration.

Creates or updates the Pumble integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pushover integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_PUSHOVERCreates or updates the Pushover integration.

Creates or updates the Pushover integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Redmine integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_REDMINECreates or updates the Redmine integration.

Creates or updates the Redmine integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Slack integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_SLACKCreates or updates the Slack integration.

Creates or updates the Slack integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Squash Tm integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_SQUASH_TMCreates or updates the Squash Tm integration.

Creates or updates the Squash Tm integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Teamcity integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_TEAMCITYCreates or updates the Teamcity integration.

Creates or updates the Teamcity integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Telegram integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_TELEGRAMCreates or updates the Telegram integration.

Creates or updates the Telegram integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Unify Circuit integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_UNIFY_CIRCUITCreates or updates the Unify Circuit integration.

Creates or updates the Unify Circuit integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Webex Teams integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_WEBEX_TEAMSCreates or updates the Webex Teams integration.

Creates or updates the Webex Teams integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Youtrack integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_YOUTRACKCreates or updates the Youtrack integration.

Creates or updates the Youtrack integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Zentao integrationGITLAB_PUT_API_V4_GROUPS_ID_INTEGRATIONS_ZENTAOCreates or updates the Zentao integration.

Creates or updates the Zentao integration.

Authentication

Connected account required

Tags

Integrations
Update an invitation to a groupGITLAB_PUT_API_V4_GROUPS_ID_INVITATIONS_EMAILUpdates a pending invitation to a group.

Updates a pending invitation to a group.

Authentication

Connected account required

Tags

Invitations
Update a group labelGITLAB_PUT_API_V4_GROUPS_ID_LABELSUpdates an existing group label. At least one parameter is required to update the group label.

Updates an existing group label. At least one parameter is required to update the group label.

Authentication

Connected account required

Tags

Labels
Update a group labelGITLAB_PUT_API_V4_GROUPS_ID_LABELS_NAMEUpdates a specified group label. At least one parameter is required to update the group label.

Updates a specified group label. At least one parameter is required to update the group label.

Authentication

Connected account required

Tags

Labels
Approve a group memberGITLAB_PUT_API_V4_GROUPS_ID_MEMBERS_MEMBER_ID_APPROVEApproves a specified pending user for a top-level group and any subgroups or projects.

Approves a specified pending user for a top-level group and any subgroups or projects.

Authentication

Connected account required

Tags

Members
Update a group memberGITLAB_PUT_API_V4_GROUPS_ID_MEMBERS_USER_IDUpdates a specified member of a group.

Updates a specified member of a group.

Authentication

Connected account required

Tags

Members
Update group membership state for a userGITLAB_PUT_API_V4_GROUPS_ID_MEMBERS_USER_ID_STATEUpdates the membership state for a specified user in a group.

Updates the membership state for a specified user in a group.

Authentication

Connected account required

Tags

Members
Update MR approval settings for a groupGITLAB_PUT_API_V4_GROUPS_ID_MERGE_REQUEST_APPROVAL_SETTINGUpdates the merge request approval settings for a specified group.

Updates the merge request approval settings for a specified group.

Authentication

Connected account required

Tags

Merge request approvals
Update a group milestoneGITLAB_PUT_API_V4_GROUPS_ID_MILESTONES_MILESTONE_IDUpdates the specified group milestone.

Updates the specified group milestone.

Authentication

Connected account required

Tags

Milestones
Update notification settings for a groupGITLAB_PUT_API_V4_GROUPS_ID_NOTIFICATION_SETTINGSUpdates the notification settings for a specified group.

Updates the notification settings for a specified group.

Authentication

Connected account required

Tags

Notification settings
Update a protected environment for a groupGITLAB_PUT_API_V4_GROUPS_ID_PROTECTED_ENVIRONMENTS_NAMEUpdates a specified protected environment for a group.

Updates a specified protected environment for a group.

Authentication

Connected account required

Tags

Protected environments
Update push rules of a groupGITLAB_PUT_API_V4_GROUPS_ID_PUSH_RULEUpdates the push rules for a specified group.

Updates the push rules for a specified group.

Authentication

Connected account required

Tags

Push rules
Update group security settingsGITLAB_PUT_API_V4_GROUPS_ID_SECURITY_SETTINGSUpdates group security settings for a specified group. You must have the Security Manager, Maintainer, or Owner role for the group.

Updates group security settings for a specified group. You must have the Security Manager, Maintainer, or Owner role for the group.

Authentication

Connected account required

Tags

Groups
Update a group variableGITLAB_PUT_API_V4_GROUPS_ID_VARIABLES_KEYUpdates a specified group variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Updates a specified group variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Authentication

Connected account required

Tags

CI variables
Update a wiki page meta noteGITLAB_PUT_API_V4_GROUPS_ID_WIKI_PAGES_NOTEABLE_ID_NOTES_NOTE_IDUpdates an existing note for a wiki page meta.

Updates an existing note for a wiki page meta.

Authentication

Connected account required

Tags

Notes
Update a wiki page for a groupGITLAB_PUT_API_V4_GROUPS_ID_WIKIS_SLUGUpdates a specified wiki page for a group.

Updates a specified wiki page for a group.

Authentication

Connected account required

Tags

Wikis
Update a system hookGITLAB_PUT_API_V4_HOOKS_HOOK_IDUpdates a specified system hook.

Updates a specified system hook.

Authentication

Connected account required

Tags

Hooks
Update a custom headerGITLAB_PUT_API_V4_HOOKS_HOOK_ID_CUSTOM_HEADERS_KEYUpdates a custom header for a specified webhook.

Updates a custom header for a specified webhook.

Authentication

Connected account required

Tags

Hooks
Update a URL variableGITLAB_PUT_API_V4_HOOKS_HOOK_ID_URL_VARIABLES_KEYUpdates a URL variable for a specified webhook.

Updates a URL variable for a specified webhook.

Authentication

Connected account required

Tags

Hooks
Update the GitLab for Jira (Forge) installation instance URLGITLAB_PUT_API_V4_INTEGRATIONS_JIRA_FORGE_INSTALLATIONSets the GitLab instance the installation points at. Omit instance_url (or send null) for GitLab.com. Requires a Jira site or organization admin.

Sets the GitLab instance the installation points at. Omit instance_url (or send null) for GitLab.com. Requires a Jira site or organization admin.

Authentication

Connected account required

Tags

Jira forge installation
Update a jobGITLAB_PUT_API_V4_JOBS_IDUpdate a job

Update a job

Authentication

Connected account required

Tags

Jobs
Trigger recalculation of billable usersGITLAB_PUT_API_V4_LICENSE_ID_REFRESH_BILLABLE_USERSTriggers recalculation of billable users for a specified license.

Triggers recalculation of billable users for a specified license.

Authentication

Connected account required

Tags

Licenses
Update a namespaceGITLAB_PUT_API_V4_NAMESPACES_IDDeprecated in 17.8

Deprecated in 17.8

Authentication

Connected account required

Tags

Namespaces
Update the subscription for the namespaceGITLAB_PUT_API_V4_NAMESPACES_ID_GITLAB_SUBSCRIPTIONDeprecated in GitLab 17.7

Deprecated in GitLab 17.7

Authentication

Connected account required

Tags

GitLab subscriptions
Update the add-on purchase for the namespaceGITLAB_PUT_API_V4_NAMESPACES_ID_SUBSCRIPTION_ADD_ON_PURCHASE_ADD_ON_NAMEDeprecated in GitLab 17.7

Deprecated in GitLab 17.7

Authentication

Connected account required

Tags

Add on purchases
Update global notification settingsGITLAB_PUT_API_V4_NOTIFICATION_SETTINGSUpdates notification settings and email address.

Updates notification settings and email address.

Authentication

Connected account required

Tags

Notification settings
Workhorse authorize the Conan recipe fileGITLAB_PUT_API_V4_PACKAGES_CONAN_V1_FILES_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_RECIPE_REVISION_EXPORT_FILE_NAME_AUTHORIZEAuthorizes the Conan recipe file.

Authorizes the Conan recipe file.

Authentication

Connected account required

Tags

Packages: Conan
Workhorse authorize the Conan package fileGITLAB_PUT_API_V4_PACKAGES_CONAN_V1_FILES_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_RECIPE_REVISION_PACKAGE_CONAN_PACKAGE_REFERENCE_PACKAGE_REVISION_FILE_NAME_AUTHORIZEAuthorizes the Conan package file.

Authorizes the Conan package file.

Authentication

Connected account required

Tags

Packages: Conan
Approve an access requestGITLAB_PUT_API_V4_PROJECTS_ID_ACCESS_REQUESTS_USER_ID_APPROVEApproves an access request for a specified user in a project.

Approves an access request for a specified user in a project.

Authentication

Connected account required

Tags

Access requests
Update an approval rule for a projectGITLAB_PUT_API_V4_PROJECTS_ID_APPROVAL_RULES_APPROVAL_RULE_IDUpdates a specified approval rule for a project. This endpoint removes any approvers and groups not defined in the `group_ids`, `user_ids`, or `usernames` attributes. Hidden groups (private groups the user does not have permission to view) that are not in the `users` or `groups` parameters are preserved by default. To remove them, set `remove_hidden_groups` to `true`. This ensures hidden groups are not removed unintentionally when a user updates an approval rule.

Updates a specified approval rule for a project. This endpoint removes any approvers and groups not defined in the `group_ids`, `user_ids`, or `usernames` attributes. Hidden groups (private groups the user does not have permission to view) that are not in the `users` or `groups` parameters are preserved by default. To remove them, set `remove_hidden_groups` to `true`. This ensures hidden groups are not removed unintentionally when a user updates an approval rule.

Authentication

Connected account required

Tags

Approval rules
Update approval ruleGITLAB_PUT_API_V4_PROJECTS_ID_APPROVAL_SETTINGS_RULES_APPROVAL_RULE_IDPrivate API subject to change

Private API subject to change

Authentication

Connected account required

Tags

Approval rules
Update a badge for a projectGITLAB_PUT_API_V4_PROJECTS_ID_BADGES_BADGE_IDUpdates a specified badge for a project.

Updates a specified badge for a project.

Authentication

Connected account required

Tags

Badges
Update an issue boardGITLAB_PUT_API_V4_PROJECTS_ID_BOARDS_BOARD_IDUpdates a specified issue board in a project.

Updates a specified issue board in a project.

Authentication

Connected account required

Tags

Boards
Update position of a board listGITLAB_PUT_API_V4_PROJECTS_ID_BOARDS_BOARD_ID_LISTS_LIST_IDUpdates the position of a specified list from an issue board.

Updates the position of a specified list from an issue board.

Authentication

Connected account required

Tags

Boards
Update a cluster in a projectGITLAB_PUT_API_V4_PROJECTS_ID_CLUSTERS_CLUSTER_IDUpdates a cluster in a specified project.

Updates a cluster in a specified project.

Authentication

Connected account required

Tags

Clusters
Creates or updates a custom attribute for a projectGITLAB_PUT_API_V4_PROJECTS_ID_CUSTOM_ATTRIBUTES_KEYCreates or updates a custom attribute for a specified project. If the attribute already exists, it is updated, otherwise a new attribute is created.

Creates or updates a custom attribute for a specified project. If the attribute already exists, it is updated, otherwise a new attribute is created.

Authentication

Connected account required

Tags

Custom attributes
Update a Debian project distributionGITLAB_PUT_API_V4_PROJECTS_ID_DEBIAN_DISTRIBUTIONS_CODENAMEUpdates a specified Debian project distribution for a project.

Updates a specified Debian project distribution for a project.

Authentication

Connected account required

Tags

Packages: Debian
Update a deploy keyGITLAB_PUT_API_V4_PROJECTS_ID_DEPLOY_KEYS_KEY_IDUpdates a deploy key for a project.

Updates a deploy key for a project.

Authentication

Connected account required

Tags

Deploy resources
Update a deploymentGITLAB_PUT_API_V4_PROJECTS_ID_DEPLOYMENTS_DEPLOYMENT_IDUpdates a specified deployment.

Updates a specified deployment.

Authentication

Connected account required

Tags

Deploy resources
Update an existing environmentGITLAB_PUT_API_V4_PROJECTS_ID_ENVIRONMENTS_ENVIRONMENT_IDUpdates an existing environment for a project.

Updates an existing environment for a project.

Authentication

Connected account required

Tags

Environments
Create Error Tracking settings for a projectGITLAB_PUT_API_V4_PROJECTS_ID_ERROR_TRACKING_SETTINGSCreates Error Tracking settings for a specified project. You must have the Maintainer or Owner role for the project.

Creates Error Tracking settings for a specified project. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Error tracking
Update external status check serviceGITLAB_PUT_API_V4_PROJECTS_ID_EXTERNAL_STATUS_CHECKS_CHECK_IDUpdates an existing external status check for a project.

Updates an existing external status check for a project.

Authentication

Connected account required

Tags

External status checks
Update a feature flagGITLAB_PUT_API_V4_PROJECTS_ID_FEATURE_FLAGS_FEATURE_FLAG_NAMEUpdates a specified feature flag.

Updates a specified feature flag.

Authentication

Connected account required

Tags

Feature flags
Update a feature flag user listGITLAB_PUT_API_V4_PROJECTS_ID_FEATURE_FLAGS_USER_LISTS_IIDUpdates a specified feature flag user list.

Updates a specified feature flag user list.

Authentication

Connected account required

Tags

Feature flags
Update a freeze periodGITLAB_PUT_API_V4_PROJECTS_ID_FREEZE_PERIODS_FREEZE_PERIOD_IDUpdates a freeze period for a specified `freeze_period_id`. You must have the Maintainer or Owner role for the project.

Updates a freeze period for a specified `freeze_period_id`. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Freeze periods
Update a project webhookGITLAB_PUT_API_V4_PROJECTS_ID_HOOKS_HOOK_IDUpdates a specified webhook for a project.

Updates a specified webhook for a project.

Authentication

Connected account required

Tags

Hooks
Update a custom headerGITLAB_PUT_API_V4_PROJECTS_ID_HOOKS_HOOK_ID_CUSTOM_HEADERS_KEYUpdates a custom header for a specified webhook.

Updates a custom header for a specified webhook.

Authentication

Connected account required

Tags

Hooks
Update a URL variableGITLAB_PUT_API_V4_PROJECTS_ID_HOOKS_HOOK_ID_URL_VARIABLES_KEYUpdates a URL variable for a specified webhook.

Updates a URL variable for a specified webhook.

Authentication

Connected account required

Tags

Hooks
Create or update the Apple App Store integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_APPLE_APP_STORECreates or updates the Apple App Store integration.

Creates or updates the Apple App Store integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Asana integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_ASANACreates or updates the Asana integration.

Creates or updates the Asana integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Assembla integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_ASSEMBLACreates or updates the Assembla integration.

Creates or updates the Assembla integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Bamboo integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_BAMBOOCreates or updates the Bamboo integration.

Creates or updates the Bamboo integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Bugzilla integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_BUGZILLACreates or updates the Bugzilla integration.

Creates or updates the Bugzilla integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Buildkite integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_BUILDKITECreates or updates the Buildkite integration.

Creates or updates the Buildkite integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Campfire integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_CAMPFIRECreates or updates the Campfire integration.

Creates or updates the Campfire integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Clickup integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_CLICKUPCreates or updates the Clickup integration.

Creates or updates the Clickup integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Confluence integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_CONFLUENCECreates or updates the Confluence integration.

Creates or updates the Confluence integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Custom Issue Tracker integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_CUSTOM_ISSUE_TRACKERCreates or updates the Custom Issue Tracker integration.

Creates or updates the Custom Issue Tracker integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Datadog integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_DATADOGCreates or updates the Datadog integration.

Creates or updates the Datadog integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Diffblue Cover integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_DIFFBLUE_COVERCreates or updates the Diffblue Cover integration.

Creates or updates the Diffblue Cover integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Discord integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_DISCORDCreates or updates the Discord integration.

Creates or updates the Discord integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Drone Ci integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_DRONE_CICreates or updates the Drone Ci integration.

Creates or updates the Drone Ci integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Emails On Push integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_EMAILS_ON_PUSHCreates or updates the Emails On Push integration.

Creates or updates the Emails On Push integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Ewm integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_EWMCreates or updates the Ewm integration.

Creates or updates the Ewm integration.

Authentication

Connected account required

Tags

Integrations
Create or update the External Wiki integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_EXTERNAL_WIKICreates or updates the External Wiki integration.

Creates or updates the External Wiki integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Git Guardian integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_GIT_GUARDIANCreates or updates the Git Guardian integration.

Creates or updates the Git Guardian integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Github integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_GITHUBCreates or updates the Github integration.

Creates or updates the Github integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Gitlab Slack Application integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_GITLAB_SLACK_APPLICATIONCreates or updates the Gitlab Slack Application integration.

Creates or updates the Gitlab Slack Application integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Google Cloud Platform Artifact Registry integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_GOOGLE_CLOUD_PLATFORM_ARTIFACT_REGISTRYCreates or updates the Google Cloud Platform Artifact Registry integration.

Creates or updates the Google Cloud Platform Artifact Registry integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Google Cloud Platform Workload Identity Federation integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_GOOGLE_CLOUD_PLATFORM_WORKLOAD_IDENTITY_FEDERATIONCreates or updates the Google Cloud Platform Workload Identity Federation integration.

Creates or updates the Google Cloud Platform Workload Identity Federation integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Google Play integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_GOOGLE_PLAYCreates or updates the Google Play integration.

Creates or updates the Google Play integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Hangouts Chat integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_HANGOUTS_CHATCreates or updates the Hangouts Chat integration.

Creates or updates the Hangouts Chat integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Harbor integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_HARBORCreates or updates the Harbor integration.

Creates or updates the Harbor integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Irker integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_IRKERCreates or updates the Irker integration.

Creates or updates the Irker integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Jenkins integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_JENKINSCreates or updates the Jenkins integration.

Creates or updates the Jenkins integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Jira integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_JIRACreates or updates the Jira integration.

Creates or updates the Jira integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Jira Cloud App integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_JIRA_CLOUD_APPCreates or updates the Jira Cloud App integration.

Creates or updates the Jira Cloud App integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Linear integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_LINEARCreates or updates the Linear integration.

Creates or updates the Linear integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Matrix integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_MATRIXCreates or updates the Matrix integration.

Creates or updates the Matrix integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mattermost integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_MATTERMOSTCreates or updates the Mattermost integration.

Creates or updates the Mattermost integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mattermost Slash Commands integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_MATTERMOST_SLASH_COMMANDSCreates or updates the Mattermost Slash Commands integration.

Creates or updates the Mattermost Slash Commands integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Microsoft Teams integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_MICROSOFT_TEAMSCreates or updates the Microsoft Teams integration.

Creates or updates the Microsoft Teams integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mock Ci integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_MOCK_CICreates or updates the Mock Ci integration.

Creates or updates the Mock Ci integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mock Monitoring integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_MOCK_MONITORINGCreates or updates the Mock Monitoring integration.

Creates or updates the Mock Monitoring integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Packagist integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_PACKAGISTCreates or updates the Packagist integration.

Creates or updates the Packagist integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Phorge integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_PHORGECreates or updates the Phorge integration.

Creates or updates the Phorge integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pipelines Email integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_PIPELINES_EMAILCreates or updates the Pipelines Email integration.

Creates or updates the Pipelines Email integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pivotaltracker integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_PIVOTALTRACKERCreates or updates the Pivotaltracker integration.

Creates or updates the Pivotaltracker integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pumble integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_PUMBLECreates or updates the Pumble integration.

Creates or updates the Pumble integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pushover integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_PUSHOVERCreates or updates the Pushover integration.

Creates or updates the Pushover integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Redmine integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_REDMINECreates or updates the Redmine integration.

Creates or updates the Redmine integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Slack integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_SLACKCreates or updates the Slack integration.

Creates or updates the Slack integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Squash Tm integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_SQUASH_TMCreates or updates the Squash Tm integration.

Creates or updates the Squash Tm integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Teamcity integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_TEAMCITYCreates or updates the Teamcity integration.

Creates or updates the Teamcity integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Telegram integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_TELEGRAMCreates or updates the Telegram integration.

Creates or updates the Telegram integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Unify Circuit integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_UNIFY_CIRCUITCreates or updates the Unify Circuit integration.

Creates or updates the Unify Circuit integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Webex Teams integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_WEBEX_TEAMSCreates or updates the Webex Teams integration.

Creates or updates the Webex Teams integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Youtrack integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_YOUTRACKCreates or updates the Youtrack integration.

Creates or updates the Youtrack integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Zentao integrationGITLAB_PUT_API_V4_PROJECTS_ID_INTEGRATIONS_ZENTAOCreates or updates the Zentao integration.

Creates or updates the Zentao integration.

Authentication

Connected account required

Tags

Integrations
Update an invitation to a projectGITLAB_PUT_API_V4_PROJECTS_ID_INVITATIONS_EMAILUpdates a pending invitation to a project.

Updates a pending invitation to a project.

Authentication

Connected account required

Tags

Invitations
Update an issueGITLAB_PUT_API_V4_PROJECTS_ID_ISSUES_ISSUE_IIDUpdates a specified issue for a project. This request is also used to close or reopen an issue using the `state_event` parameter. At least one of the following parameters is required for the request to be successful: `assignee_id`, `assignee_ids`, `confidential`, `created_at`, `description`, `discussion_locked`, `due_date`, `issue_type`, `labels`, `milestone_id`, `state_event`, `title`.

Updates a specified issue for a project. This request is also used to close or reopen an issue using the `state_event` parameter. At least one of the following parameters is required for the request to be successful: `assignee_id`, `assignee_ids`, `confidential`, `created_at`, `description`, `discussion_locked`, `due_date`, `issue_type`, `labels`, `milestone_id`, `state_event`, `title`.

Authentication

Connected account required

Tags

Projects
Update a metric image for an incidentGITLAB_PUT_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_METRIC_IMAGES_METRIC_IMAGE_IDUpdates a metric image for an incident.

Updates a metric image for an incident.

Authentication

Connected account required

Tags

Metric images
Update the order of an issueGITLAB_PUT_API_V4_PROJECTS_ID_ISSUES_ISSUE_IID_REORDERUpdates the order of a specified issue in a project. You can see the results when sorting issues manually.

Updates the order of a specified issue in a project. You can see the results when sorting issues manually.

Authentication

Connected account required

Tags

Projects
Resolve or unresolve an issue discussionGITLAB_PUT_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_IDResolves or unresolves a specified issue discussion.

Resolves or unresolves a specified issue discussion.

Authentication

Connected account required

Tags

Discussions
Update a comment in an issue discussionGITLAB_PUT_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDUpdates or changes the status of a specified comment in a issue discussion.

Updates or changes the status of a specified comment in a issue discussion.

Authentication

Connected account required

Tags

Discussions
Update an issue noteGITLAB_PUT_API_V4_PROJECTS_ID_ISSUES_NOTEABLE_ID_NOTES_NOTE_IDUpdates an existing note for an issue.

Updates an existing note for an issue.

Authentication

Connected account required

Tags

Notes
Update an existing label. At least one optional parameter is required.GITLAB_PUT_API_V4_PROJECTS_ID_LABELSDeprecated in GitLab 12.4. Use PUT /projects/:id/labels/:name instead.

Deprecated in GitLab 12.4. Use PUT /projects/:id/labels/:name instead.

Authentication

Connected account required

Tags

Labels
Update a project labelGITLAB_PUT_API_V4_PROJECTS_ID_LABELS_NAMEUpdates a specified label for a project with a different name or color. At least one parameter is required to update the label.

Updates a specified label for a project with a different name or color. At least one parameter is required to update the label.

Authentication

Connected account required

Tags

Labels
Promote a project label to a group labelGITLAB_PUT_API_V4_PROJECTS_ID_LABELS_NAME_PROMOTEPromotes a specified project label to a group label. The label keeps its ID.

Promotes a specified project label to a group label. The label keeps its ID.

Authentication

Connected account required

Tags

Labels
Promote a label to a group labelGITLAB_PUT_API_V4_PROJECTS_ID_LABELS_PROMOTEAdded in GitLab 12.3 and deprecated in GitLab 12.4. Use PUT /projects/:id/labels/:name/promote instead.

Added in GitLab 12.3 and deprecated in GitLab 12.4. Use PUT /projects/:id/labels/:name/promote instead.

Authentication

Connected account required

Tags

Labels
Update a project memberGITLAB_PUT_API_V4_PROJECTS_ID_MEMBERS_USER_IDUpdates a specified member of a project.

Updates a specified member of a project.

Authentication

Connected account required

Tags

Members
Update MR approval settings for a projectGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUEST_APPROVAL_SETTINGUpdates the merge request approval settings for a specified project.

Updates the merge request approval settings for a specified project.

Authentication

Connected account required

Tags

Merge request approvals
Update a merge requestGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IIDUpdates a merge request for a specified project.

Updates a merge request for a specified project.

Authentication

Connected account required

Tags

Merge requests
Update an approval rule for a merge requestGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_APPROVAL_RULES_APPROVAL_RULE_IDUpdates a specified approval rule for a merge request. This endpoint removes any approvers and groups not included in the `group_ids`, `user_ids`, or `usernames` attributes. The `report_approver` or `code_owner` rules are system-generated, and you cannot edit them.

Updates a specified approval rule for a merge request. This endpoint removes any approvers and groups not included in the `group_ids`, `user_ids`, or `usernames` attributes. The `report_approver` or `code_owner` rules are system-generated, and you cannot edit them.

Authentication

Connected account required

Tags

Merge request approvals
Update a draft noteGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_DRAFT_NOTES_DRAFT_NOTE_IDUpdates a draft note for a specified merge request.

Updates a draft note for a specified merge request.

Authentication

Connected account required

Tags

Draft notes
Publish a draft noteGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_DRAFT_NOTES_DRAFT_NOTE_ID_PUBLISHPublishes a draft note for a specified merge request.

Publishes a draft note for a specified merge request.

Authentication

Connected account required

Tags

Draft notes
Merge a merge requestGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_MERGEMerges a merge request. Accepts and merges changes submitted with the merge request.

Merges a merge request. Accepts and merges changes submitted with the merge request.

Authentication

Connected account required

Tags

Merge requests
Rebase a merge requestGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_REBASERebases a merge request. Automatically rebases the `source_branch` of the merge request against its `target_branch`.

Rebases a merge request. Automatically rebases the `source_branch` of the merge request against its `target_branch`.

Authentication

Connected account required

Tags

Merge requests
Reset approvals for a merge requestGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_MERGE_REQUEST_IID_RESET_APPROVALSResets all approvals for a specified merge request. Available only to bot users with a valid project or group token. Human users receive a `401 Unauthorized` response.

Resets all approvals for a specified merge request. Available only to bot users with a valid project or group token. Human users receive a `401 Unauthorized` response.

Authentication

Connected account required

Tags

Merge request approvals
Resolve or unresolve a merge request discussionGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_IDResolves or unresolves a specified merge request discussion.

Resolves or unresolves a specified merge request discussion.

Authentication

Connected account required

Tags

Discussions
Update a comment in a merge request discussionGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDUpdates or changes the status of a specified comment in a merge request discussion.

Updates or changes the status of a specified comment in a merge request discussion.

Authentication

Connected account required

Tags

Discussions
Update a merge request noteGITLAB_PUT_API_V4_PROJECTS_ID_MERGE_REQUESTS_NOTEABLE_ID_NOTES_NOTE_IDUpdates an existing note for a merge request.

Updates an existing note for a merge request.

Authentication

Connected account required

Tags

Notes
Update a project milestoneGITLAB_PUT_API_V4_PROJECTS_ID_MILESTONES_MILESTONE_IDUpdates a specified project milestone.

Updates a specified project milestone.

Authentication

Connected account required

Tags

Milestones
Update project pull mirroring settingsGITLAB_PUT_API_V4_PROJECTS_ID_MIRROR_PULLUpdates pull mirroring settings for a specified project. This feature was introduced in GitLab 17.5.

Updates pull mirroring settings for a specified project. This feature was introduced in GitLab 17.5.

Authentication

Connected account required

Tags

Project mirrors
Update notification settings for a projectGITLAB_PUT_API_V4_PROJECTS_ID_NOTIFICATION_SETTINGSUpdates the notification settings for a specified project.

Updates the notification settings for a specified project.

Authentication

Connected account required

Tags

Notification settings
Workhorse authorize the Conan recipe fileGITLAB_PUT_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_FILES_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_RECIPE_REVISION_EXPORT_FILE_NAME_AUTHORIZEAuthorizes the Conan recipe file.

Authorizes the Conan recipe file.

Authentication

Connected account required

Tags

Packages: Conan
Workhorse authorize the Conan package fileGITLAB_PUT_API_V4_PROJECTS_ID_PACKAGES_CONAN_V1_FILES_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_RECIPE_REVISION_PACKAGE_CONAN_PACKAGE_REFERENCE_PACKAGE_REVISION_FILE_NAME_AUTHORIZEAuthorizes the Conan package file.

Authorizes the Conan package file.

Authentication

Connected account required

Tags

Packages: Conan
Workhorse authorize the Conan recipe fileGITLAB_PUT_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_FILES_FILE_NAME_AUTHORIZEAuthorizes the Conan recipe file. This feature was introduced in GitLab 17.10.

Authorizes the Conan recipe file. This feature was introduced in GitLab 17.10.

Authentication

Connected account required

Tags

Packages: Conan
Workhorse authorize the Conan package fileGITLAB_PUT_API_V4_PROJECTS_ID_PACKAGES_CONAN_V2_CONANS_PACKAGE_NAME_PACKAGE_VERSION_PACKAGE_USERNAME_PACKAGE_CHANNEL_REVISIONS_RECIPE_REVISION_PACKAGES_CONAN_PACKAGE_REFERENCE_REVISIONS_PACKAGE_REVISION_FILES_FILE_NAME_AUTHORIZEAuthorizes the Conan package file. This feature was introduced in GitLab 17.11.

Authorizes the Conan package file. This feature was introduced in GitLab 17.11.

Authentication

Connected account required

Tags

Packages: Conan
Authorize Debian package uploadGITLAB_PUT_API_V4_PROJECTS_ID_PACKAGES_DEBIAN_FILE_NAME_AUTHORIZEThis feature was introduced in GitLab 13.5

This feature was introduced in GitLab 13.5

Authentication

Connected account required

Tags

Packages: Debian
The NuGet Package Authorize endpointGITLAB_PUT_API_V4_PROJECTS_ID_PACKAGES_NUGET_AUTHORIZEThis feature was introduced in GitLab 14.1

This feature was introduced in GitLab 14.1

Authentication

Connected account required

Tags

Packages: NuGet
The NuGet Symbol Package Authorize endpointGITLAB_PUT_API_V4_PROJECTS_ID_PACKAGES_NUGET_SYMBOLPACKAGE_AUTHORIZEThis feature was introduced in GitLab 14.1

This feature was introduced in GitLab 14.1

Authentication

Connected account required

Tags

Packages: NuGet
The NuGet V2 Feed Package Authorize endpointGITLAB_PUT_API_V4_PROJECTS_ID_PACKAGES_NUGET_V2_AUTHORIZEThis feature was introduced in GitLab 16.2

This feature was introduced in GitLab 16.2

Authentication

Connected account required

Tags

Packages: NuGet
Update Pages domainGITLAB_PUT_API_V4_PROJECTS_ID_PAGES_DOMAINS_DOMAINUpdates a specified Pages domain in a project. You must have permissions to change an existing Pages domain.

Updates a specified Pages domain in a project. You must have permissions to change an existing Pages domain.

Authentication

Connected account required

Tags

GitLab Pages
Verify Pages domainGITLAB_PUT_API_V4_PROJECTS_ID_PAGES_DOMAINS_DOMAIN_VERIFYVerifies a specified Pages domain in a project. You must have permissions to update Pages domains.

Verifies a specified Pages domain in a project. You must have permissions to update Pages domains.

Authentication

Connected account required

Tags

GitLab Pages
Update a pipeline scheduleGITLAB_PUT_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_IDUpdates a pipeline schedule for a project. After the update is done, it is rescheduled automatically.

Updates a pipeline schedule for a project. After the update is done, it is rescheduled automatically.

Authentication

Connected account required

Tags

Pipeline schedules
Update a variable for a pipeline scheduleGITLAB_PUT_API_V4_PROJECTS_ID_PIPELINE_SCHEDULES_PIPELINE_SCHEDULE_ID_VARIABLES_KEYUpdates a variable for a pipeline schedule.

Updates a variable for a pipeline schedule.

Authentication

Connected account required

Tags

Pipeline schedules
Update pipeline metadataGITLAB_PUT_API_V4_PROJECTS_ID_PIPELINES_PIPELINE_ID_METADATAUpdates pipeline metadata. The metadata contains the name of the pipeline. This feature was introduced in GitLab 16.6.

Updates pipeline metadata. The metadata contains the name of the pipeline. This feature was introduced in GitLab 16.6.

Authentication

Connected account required

Tags

Pipelines
Update a protected environment for a projectGITLAB_PUT_API_V4_PROJECTS_ID_PROTECTED_ENVIRONMENTS_NAMEUpdates a specified protected environment for a project.

Updates a specified protected environment for a project.

Authentication

Connected account required

Tags

Protected environments
Update push rules of a projectGITLAB_PUT_API_V4_PROJECTS_ID_PUSH_RULEUpdates the push rules for a specified project.

Updates the push rules for a specified project.

Authentication

Connected account required

Tags

Push rules
Update a releaseGITLAB_PUT_API_V4_PROJECTS_ID_RELEASES_TAG_NAMEUpdates a release. Developer level access to the project is required to update a release.

Updates a release. Developer level access to the project is required to update a release.

Authentication

Connected account required

Tags

Releases
Update a release linkGITLAB_PUT_API_V4_PROJECTS_ID_RELEASES_TAG_NAME_ASSETS_LINKS_LINK_IDUpdates a specified asset link for a release.

Updates a specified asset link for a release.

Authentication

Connected account required

Tags

Releases
Update a remote mirror in a projectGITLAB_PUT_API_V4_PROJECTS_ID_REMOTE_MIRRORS_MIRROR_IDUpdates the configuration or operational status of a specified remote mirror.

Updates the configuration or operational status of a specified remote mirror.

Authentication

Connected account required

Tags

Remote mirrors
Protect a single branchGITLAB_PUT_API_V4_PROJECTS_ID_REPOSITORY_BRANCHES_BRANCH_PROTECTProtect a single branch

Protect a single branch

Authentication

Connected account required

Tags

Branches
Unprotect a single branchGITLAB_PUT_API_V4_PROJECTS_ID_REPOSITORY_BRANCHES_BRANCH_UNPROTECTUnprotect a single branch

Unprotect a single branch

Authentication

Connected account required

Tags

Branches
Update a comment in a commit discussionGITLAB_PUT_API_V4_PROJECTS_ID_REPOSITORY_COMMITS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDUpdates or changes the status of a specified comment in a commit discussion.

Updates or changes the status of a specified comment in a commit discussion.

Authentication

Connected account required

Tags

Discussions
Update a submodule referenceGITLAB_PUT_API_V4_PROJECTS_ID_REPOSITORY_SUBMODULES_SUBMODULEUpdates a reference for a specified submodule.

Updates a reference for a specified submodule.

Authentication

Connected account required

Tags

Submodules
Update a resource groupGITLAB_PUT_API_V4_PROJECTS_ID_RESOURCE_GROUPS_KEYUpdates the properties for a specified resource group. It returns `200` if the resource group was successfully updated. In case of an error, a status code `400` is returned.

Updates the properties for a specified resource group. It returns `200` if the resource group was successfully updated. In case of an error, a status code `400` is returned.

Authentication

Connected account required

Tags

CI resource groups
Update project security settingsGITLAB_PUT_API_V4_PROJECTS_ID_SECURITY_SETTINGSUpdates project security settings for a specified project. You must have the Maintainer or Owner role for the project.

Updates project security settings for a specified project. You must have the Maintainer or Owner role for the project.

Authentication

Connected account required

Tags

Projects
Create or update the Apple App Store integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_APPLE_APP_STORECreates or updates the Apple App Store integration.

Creates or updates the Apple App Store integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Asana integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_ASANACreates or updates the Asana integration.

Creates or updates the Asana integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Assembla integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_ASSEMBLACreates or updates the Assembla integration.

Creates or updates the Assembla integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Bamboo integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_BAMBOOCreates or updates the Bamboo integration.

Creates or updates the Bamboo integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Bugzilla integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_BUGZILLACreates or updates the Bugzilla integration.

Creates or updates the Bugzilla integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Buildkite integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_BUILDKITECreates or updates the Buildkite integration.

Creates or updates the Buildkite integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Campfire integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_CAMPFIRECreates or updates the Campfire integration.

Creates or updates the Campfire integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Clickup integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_CLICKUPCreates or updates the Clickup integration.

Creates or updates the Clickup integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Confluence integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_CONFLUENCECreates or updates the Confluence integration.

Creates or updates the Confluence integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Custom Issue Tracker integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_CUSTOM_ISSUE_TRACKERCreates or updates the Custom Issue Tracker integration.

Creates or updates the Custom Issue Tracker integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Datadog integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_DATADOGCreates or updates the Datadog integration.

Creates or updates the Datadog integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Diffblue Cover integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_DIFFBLUE_COVERCreates or updates the Diffblue Cover integration.

Creates or updates the Diffblue Cover integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Discord integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_DISCORDCreates or updates the Discord integration.

Creates or updates the Discord integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Drone Ci integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_DRONE_CICreates or updates the Drone Ci integration.

Creates or updates the Drone Ci integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Emails On Push integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_EMAILS_ON_PUSHCreates or updates the Emails On Push integration.

Creates or updates the Emails On Push integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Ewm integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_EWMCreates or updates the Ewm integration.

Creates or updates the Ewm integration.

Authentication

Connected account required

Tags

Integrations
Create or update the External Wiki integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_EXTERNAL_WIKICreates or updates the External Wiki integration.

Creates or updates the External Wiki integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Git Guardian integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_GIT_GUARDIANCreates or updates the Git Guardian integration.

Creates or updates the Git Guardian integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Github integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_GITHUBCreates or updates the Github integration.

Creates or updates the Github integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Gitlab Slack Application integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_GITLAB_SLACK_APPLICATIONCreates or updates the Gitlab Slack Application integration.

Creates or updates the Gitlab Slack Application integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Google Cloud Platform Artifact Registry integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_GOOGLE_CLOUD_PLATFORM_ARTIFACT_REGISTRYCreates or updates the Google Cloud Platform Artifact Registry integration.

Creates or updates the Google Cloud Platform Artifact Registry integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Google Cloud Platform Workload Identity Federation integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_GOOGLE_CLOUD_PLATFORM_WORKLOAD_IDENTITY_FEDERATIONCreates or updates the Google Cloud Platform Workload Identity Federation integration.

Creates or updates the Google Cloud Platform Workload Identity Federation integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Google Play integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_GOOGLE_PLAYCreates or updates the Google Play integration.

Creates or updates the Google Play integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Hangouts Chat integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_HANGOUTS_CHATCreates or updates the Hangouts Chat integration.

Creates or updates the Hangouts Chat integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Harbor integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_HARBORCreates or updates the Harbor integration.

Creates or updates the Harbor integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Irker integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_IRKERCreates or updates the Irker integration.

Creates or updates the Irker integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Jenkins integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_JENKINSCreates or updates the Jenkins integration.

Creates or updates the Jenkins integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Jira integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_JIRACreates or updates the Jira integration.

Creates or updates the Jira integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Jira Cloud App integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_JIRA_CLOUD_APPCreates or updates the Jira Cloud App integration.

Creates or updates the Jira Cloud App integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Linear integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_LINEARCreates or updates the Linear integration.

Creates or updates the Linear integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Matrix integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_MATRIXCreates or updates the Matrix integration.

Creates or updates the Matrix integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mattermost integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_MATTERMOSTCreates or updates the Mattermost integration.

Creates or updates the Mattermost integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mattermost Slash Commands integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_MATTERMOST_SLASH_COMMANDSCreates or updates the Mattermost Slash Commands integration.

Creates or updates the Mattermost Slash Commands integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Microsoft Teams integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_MICROSOFT_TEAMSCreates or updates the Microsoft Teams integration.

Creates or updates the Microsoft Teams integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mock Ci integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_MOCK_CICreates or updates the Mock Ci integration.

Creates or updates the Mock Ci integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Mock Monitoring integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_MOCK_MONITORINGCreates or updates the Mock Monitoring integration.

Creates or updates the Mock Monitoring integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Packagist integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_PACKAGISTCreates or updates the Packagist integration.

Creates or updates the Packagist integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Phorge integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_PHORGECreates or updates the Phorge integration.

Creates or updates the Phorge integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pipelines Email integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_PIPELINES_EMAILCreates or updates the Pipelines Email integration.

Creates or updates the Pipelines Email integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pivotaltracker integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_PIVOTALTRACKERCreates or updates the Pivotaltracker integration.

Creates or updates the Pivotaltracker integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pumble integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_PUMBLECreates or updates the Pumble integration.

Creates or updates the Pumble integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Pushover integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_PUSHOVERCreates or updates the Pushover integration.

Creates or updates the Pushover integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Redmine integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_REDMINECreates or updates the Redmine integration.

Creates or updates the Redmine integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Slack integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_SLACKCreates or updates the Slack integration.

Creates or updates the Slack integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Squash Tm integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_SQUASH_TMCreates or updates the Squash Tm integration.

Creates or updates the Squash Tm integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Teamcity integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_TEAMCITYCreates or updates the Teamcity integration.

Creates or updates the Teamcity integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Telegram integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_TELEGRAMCreates or updates the Telegram integration.

Creates or updates the Telegram integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Unify Circuit integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_UNIFY_CIRCUITCreates or updates the Unify Circuit integration.

Creates or updates the Unify Circuit integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Webex Teams integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_WEBEX_TEAMSCreates or updates the Webex Teams integration.

Creates or updates the Webex Teams integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Youtrack integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_YOUTRACKCreates or updates the Youtrack integration.

Creates or updates the Youtrack integration.

Authentication

Connected account required

Tags

Integrations
Create or update the Zentao integrationGITLAB_PUT_API_V4_PROJECTS_ID_SERVICES_ZENTAOCreates or updates the Zentao integration.

Creates or updates the Zentao integration.

Authentication

Connected account required

Tags

Integrations
Update a comment in a snippet discussionGITLAB_PUT_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_DISCUSSIONS_DISCUSSION_ID_NOTES_NOTE_IDUpdates or changes the status of a specified comment in a snippet discussion.

Updates or changes the status of a specified comment in a snippet discussion.

Authentication

Connected account required

Tags

Discussions
Update a snippet noteGITLAB_PUT_API_V4_PROJECTS_ID_SNIPPETS_NOTEABLE_ID_NOTES_NOTE_IDUpdates an existing note for a snippet.

Updates an existing note for a snippet.

Authentication

Connected account required

Tags

Notes
Update a project snippetGITLAB_PUT_API_V4_PROJECTS_ID_SNIPPETS_SNIPPET_IDUpdates a specified project snippet. The user must have permission to modify snippets. Updates to snippets with multiple files must use the `files` attribute.

Updates a specified project snippet. The user must have permission to modify snippets. Updates to snippets with multiple files must use the `files` attribute.

Authentication

Connected account required

Tags

Snippets
Transfer a project to another namespaceGITLAB_PUT_API_V4_PROJECTS_ID_TRANSFERTransfers a project to another namespace.

Transfers a project to another namespace.

Authentication

Connected account required

Tags

Projects
Update a pipeline trigger tokenGITLAB_PUT_API_V4_PROJECTS_ID_TRIGGERS_TRIGGER_IDUpdates a pipeline trigger token for a project.

Updates a pipeline trigger token for a project.

Authentication

Connected account required

Tags

CI triggers
Update a variableGITLAB_PUT_API_V4_PROJECTS_ID_VARIABLES_KEYUpdates a project variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Updates a project variable. If there are multiple variables with the same key, use `filter` to select the correct `environment_scope`.

Authentication

Connected account required

Tags

CI variables
Update a vulnerability noteGITLAB_PUT_API_V4_PROJECTS_ID_VULNERABILITIES_NOTEABLE_ID_NOTES_NOTE_IDUpdates an existing note for a vulnerability.

Updates an existing note for a vulnerability.

Authentication

Connected account required

Tags

Notes
Update a wiki page meta noteGITLAB_PUT_API_V4_PROJECTS_ID_WIKI_PAGES_NOTEABLE_ID_NOTES_NOTE_IDUpdates an existing note for a wiki page meta.

Updates an existing note for a wiki page meta.

Authentication

Connected account required

Tags

Notes
Update a wiki page for a projectGITLAB_PUT_API_V4_PROJECTS_ID_WIKIS_SLUGUpdates a specified wiki page for a project.

Updates a specified wiki page for a project.

Authentication

Connected account required

Tags

Wikis
Update a runner controllerGITLAB_PUT_API_V4_RUNNER_CONTROLLERS_IDUpdates the details of an existing runner controller by its ID.

Updates the details of an existing runner controller by its ID.

Authentication

Connected account required

Tags

Runner controllers
Update a runnerGITLAB_PUT_API_V4_RUNNERS_IDUpdates a specified runner.

Updates a specified runner.

Authentication

Connected account required

Tags

Runners
Update snippetGITLAB_PUT_API_V4_SNIPPETS_IDUpdates a specified snippet.

Updates a specified snippet.

Authentication

Connected account required

Tags

Snippets
Apply multiple suggestions to a merge requestGITLAB_PUT_API_V4_SUGGESTIONS_BATCH_APPLYApplies multiple suggested patches in a merge request. You must have the Developer, Maintainer, or Owner role.

Applies multiple suggested patches in a merge request. You must have the Developer, Maintainer, or Owner role.

Authentication

Connected account required

Tags

Suggestions
Apply a suggestion to a merge requestGITLAB_PUT_API_V4_SUGGESTIONS_ID_APPLYApplies a suggested patch in a merge request. You must have the Developer, Maintainer, or Owner role.

Applies a suggested patch in a merge request. You must have the Developer, Maintainer, or Owner role.

Authentication

Connected account required

Tags

Suggestions
Update an applicationGITLAB_PUT_API_V4_USER_APPLICATIONS_IDUpdates an existing application owned by the authenticated user.

Updates an existing application owned by the authenticated user.

Authentication

Connected account required

Tags

Applications
Update your user preferencesGITLAB_PUT_API_V4_USER_PREFERENCESUpdates your user preferences.

Updates your user preferences.

Authentication

Connected account required

Tags

Users
Set a user statusGITLAB_PUT_API_V4_USER_STATUSSets the status of the currently authenticated user. Any parameters that are not passed are nullified. This operation is similar but distinct from the Update a user status operation.

Sets the status of the currently authenticated user. Any parameters that are not passed are nullified. This operation is similar but distinct from the Update a user status operation.

Authentication

Connected account required

Tags

Users
Update a user's credit_card_validationGITLAB_PUT_API_V4_USER_USER_ID_CREDIT_CARD_VALIDATIONDeprecated in 17.7

Deprecated in 17.7

Authentication

Connected account required

Tags

Users
Creates or updates a custom attribute for a userGITLAB_PUT_API_V4_USERS_ID_CUSTOM_ATTRIBUTES_KEYCreates or updates a custom attribute for a specified user. If the attribute already exists, it is updated, otherwise a new attribute is created.

Creates or updates a custom attribute for a specified user. If the attribute already exists, it is updated, otherwise a new attribute is created.

Authentication

Connected account required

Tags

Custom attributes

Provider resources