> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> How to set up the GitLab connector, plus the actions and events that are available.

![GitLab](https://stackone-logos.com/api/gitlab/filled/svg)

Previewv2.0.0[See changelog](https://docs.stackone.com/connectors/gitlab/changelog.md)

[201 actions](#actions) · [49 events](#events) · 4 auth methods

Developer Tools
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [MCP (OAuth) · Connector Profile](https://docs.stackone.com/connectors/gitlab/guides/connector-profile/mcp-oauth.md)
>
> Authorize through the MCP server. Endpoints and client registration are discovered at connect time.

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/gitlab/guides/connector-profile/oauth-2-0.md)
>
> Create a GitLab OAuth application to connect: • Navigate to User Settings > Applications (or Admin Area > Applications f...

> [card] [OAuth 2.0 (Self-Managed) · Connector Profile](https://docs.stackone.com/connectors/gitlab/guides/connector-profile/oauth-2-0-self-managed.md)
>
> For GitLab Self-Managed and GitLab Dedicated. Requires registering an OAuth application on your own GitLab instance; acc...

> [card] [Personal Access Token · Connector Profile](https://docs.stackone.com/connectors/gitlab/guides/connector-profile/personal-access-token.md)
>
> Works on GitLab.com, GitLab Self-Managed and GitLab Dedicated. No app registration required; the token inherits the perm...

Optionally, configure receiving Events for GitLab into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/gitlab/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [MCP (OAuth) · Link Account](https://docs.stackone.com/connectors/gitlab/guides/link-account/mcp-oauth.md)

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/gitlab/guides/link-account/oauth-2-0.md)

> [card] [OAuth 2.0 (Self-Managed) · Link Account](https://docs.stackone.com/connectors/gitlab/guides/link-account/oauth-2-0-self-managed.md)

> [card] [Personal Access Token · Link Account](https://docs.stackone.com/connectors/gitlab/guides/link-account/personal-access-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

MCP (OAuth)

OAuth 2.0

OAuth 2.0 (Self-Managed)

Personal Access Token

No auth methods found

Scopes

Select all
|
Clear

api

read\_api

read\_repository

read\_user

write\_repository

No scopes found

201 actions

ActionDescriptionRequired scopes

List Branches`gitlab_list_branches`

List all branches in a GitLab project repository, sorted alphabetically

`read_repository`

Get Branch`gitlab_get_branch`

Retrieve details of a specific branch in a GitLab project

`read_repository`

Create Branch`gitlab_create_branch`

Create a new branch in a GitLab project repository

`write_repository`

Delete Branch`gitlab_delete_branch`

Delete a branch from a GitLab project repository

`write_repository`

List Protected Branches`gitlab_list_protected_branches`

List the protected branch rules of a GitLab project

`read_api`

List Group Branch Rules`gitlab_list_group_branch_rules`

List the branch rules, visibility and pipeline gate of every project in a GitLab group in one call

`read_api`

Get Protected Branch`gitlab_get_protected_branch`

Retrieve the protection rule for one branch or wildcard in a GitLab project

`read_api`

Protect Branch`gitlab_protect_branch`

Add branch protection rules to a GitLab project branch

`api`

Unprotect Branch`gitlab_unprotect_branch`

Remove branch protection rules from a GitLab project branch

`api`

List Commits`gitlab_list_commits`

List commits in a GitLab project repository

`read_repository`

Get Commit`gitlab_get_commit`

Retrieve details of a specific commit in a GitLab project

`read_repository`

List Merge Requests For Commit`gitlab_list_merge_requests_for_commit`

List the merge requests that brought a commit into a GitLab project

`read_api`

Create Commit`gitlab_create_commit`

Create a commit with multiple file actions in a GitLab project

`write_repository`

Get Commit Diff`gitlab_get_commit_diff`

Get the diff of changes introduced by a specific commit

`read_repository`

Cherry-Pick Commit`gitlab_cherry_pick_commit`

Cherry-pick a commit onto a target branch in a GitLab project

`write_repository`

Revert Commit`gitlab_revert_commit`

Revert a commit in a GitLab project branch

`write_repository`

List Project Deploy Keys`gitlab_list_project_deploy_keys`

List all deploy keys for a GitLab project

`read_api`

Add Project Deploy Key`gitlab_add_project_deploy_key`

Add a deploy key to a GitLab project

`api`

Delete Project Deploy Key`gitlab_delete_project_deploy_key`

Remove a deploy key from a GitLab project

`api`

Enable Project Deploy Key`gitlab_enable_project_deploy_key`

Enable an existing deploy key for a GitLab project

`api`

List Environments`gitlab_list_environments`

List all deployment environments for a GitLab project

`read_api`

Get Environment`gitlab_get_environment`

Retrieve details of a specific deployment environment in a GitLab project

`read_api`

Create Environment`gitlab_create_environment`

Create a new deployment environment for a GitLab project

`api`

Update Environment`gitlab_update_environment`

Update a deployment environment in a GitLab project

`api`

Stop Environment`gitlab_stop_environment`

Stop a running deployment environment in a GitLab project

`api`

List Groups`gitlab_list_groups`

List all GitLab groups accessible to the authenticated user

`read_api`

Get Group`gitlab_get_group`

Retrieve details of a specific GitLab group

`read_api`

Create Group`gitlab_create_group`

Create a new GitLab group

`api`

Update Group`gitlab_update_group`

Update settings and configuration of a GitLab group

`api`

Delete Group`gitlab_delete_group`

Schedule a GitLab group for deletion or permanently delete a subgroup

`api`

List Group Projects`gitlab_list_group_projects`

List all projects belonging to a GitLab group

`read_api`

List Group Subgroups`gitlab_list_group_subgroups`

List visible direct subgroups of a GitLab group

`read_api`

List Group Members`gitlab_list_group_members`

List all members of a GitLab group

`read_api`

List All Group Members`gitlab_list_all_group_members`

List everyone with access to a GitLab group, including inherited and invited members

`read_api`

List Billable Group Members`gitlab_list_billable_group_members`

List everyone who uses a seat in a GitLab top-level group, including members of its subgroups and projects

`read_api`

List Billable Member Memberships`gitlab_list_billable_member_memberships`

List the subgroups and projects where one billable member of a GitLab top-level group holds a direct membership

`read_api`

List Pending Group Members`gitlab_list_pending_group_members`

List the pending invitations and members awaiting approval across a GitLab top-level group, its subgroups and its projec...

`read_api`

List Group Descendant Members`gitlab_list_group_descendant_members`

List the members of a GitLab group's subgroups, filtered by role, in one call

`read_api`

List Group Project Members`gitlab_list_group_project_members`

List the direct members of every project in a GitLab group, filtered by role, in one call

`read_api`

List Enterprise Users`gitlab_list_enterprise_users`

List the enterprise users of a GitLab.com top-level group, the accounts its verified domains own

`read_api`

Add Group Member`gitlab_add_group_member`

Add a user as a member of a GitLab group

`api`

Remove Group Member`gitlab_remove_group_member`

Remove a user from a GitLab group

`api`

Get Unified Credentials`gitlab_unified_get_me`

Get the current GitLab connection's unified credentials and identity.

`read_user`

List Unified Groups`gitlab_unified_list_groups`

List unified groups in GitLab (all levels).

`read_api`

Get Unified Group`gitlab_unified_get_group`

Get a unified GitLab group by ID.

`read_api`

List Unified Organizations`gitlab_unified_list_organizations`

List unified organizations (top-level groups) in GitLab.

`read_api`

Get Unified Organization`gitlab_unified_get_organization`

Get a unified GitLab organization (top-level group) by ID.

`read_api`

List Unified Resource Types`gitlab_unified_list_resource_types`

List unified resource types in GitLab.

`read_user`

List Unified Resource Users`gitlab_unified_list_resource_users`

List unified resource users for a GitLab group or project.

`read_api`

List Unified Roles`gitlab_unified_list_roles`

List unified roles in GitLab.

`read_user`

Get Unified Role`gitlab_unified_get_role`

Get a unified GitLab role by ID.

`read_user`

List Unified Users`gitlab_unified_list_users`

List the members of a GitLab top-level group, its pending invitations and the people with access only through its subgro...

`read_api`

Get Unified User`gitlab_unified_get_user`

Get a member of the connection's GitLab top-level group, its subgroups or projects by ID, or one of its pending invitati...

`read_api`

Get Instance Metadata`gitlab_get_metadata`

Retrieve the GitLab version and edition of the connected instance

`read_user`

List Project Issues`gitlab_list_project_issues`

List all issues in a specific GitLab project

`read_api`

Get Issue`gitlab_get_issue`

Retrieve details of a specific issue in a GitLab project

`read_api`

Create Issue`gitlab_create_issue`

Create a new issue in a GitLab project

`api`

Update Issue`gitlab_update_issue`

Update an existing issue in a GitLab project

`api`

Delete Issue`gitlab_delete_issue`

Delete an issue from a GitLab project

`api`

Move Issue`gitlab_move_issue`

Move an issue to a different GitLab project

`api`

List Issue Notes`gitlab_list_issue_notes`

List all comments (notes) on a GitLab issue

`read_api`

Create Issue Note`gitlab_create_issue_note`

Add a comment (note) to a GitLab issue

`api`

List Issue Participants`gitlab_list_issue_participants`

List all users participating in a GitLab issue

`read_api`

List Related Merge Requests`gitlab_list_related_merge_requests`

List all merge requests related to a GitLab issue

`read_api`

List Project Labels`gitlab_list_project_labels`

List all labels in a GitLab project

`read_api`

Get Project Label`gitlab_get_project_label`

Retrieve details of a specific label in a GitLab project

`read_api`

Create Project Label`gitlab_create_project_label`

Create a new label in a GitLab project

`api`

Update Project Label`gitlab_update_project_label`

Update an existing label in a GitLab project

`api`

Delete Project Label`gitlab_delete_project_label`

Delete a label from a GitLab project

`api`

Get Job Artifact File`gitlab_get_artifact_file`

Read a file from the artifacts of a CI/CD job as text: a file inside the artifacts archive, or a report artifact such as...

Get Job`gitlab_mcp_get_job`

Get a CI/CD job in a GitLab project. Add include: log to also get the job's trace/log, which you can page through with b...

Get MCP Server Version`gitlab_get_mcp_server_version`

Get the current version of MCP server.

Get Pages Content`gitlab_get_pages_content`

Read the content published at a GitLab Pages URL as text, including private Pages sites the authenticated user may view\....

List Releases`gitlab_mcp_list_releases`

List releases in a GitLab project, most recently released first. Identify the project with exactly one of url or project...

List Tags`gitlab_mcp_list_tags`

List tags in a GitLab project, most recently updated first. Identify the project with exactly one of url or project\_id....

Merge Merge Request`gitlab_accept_merge_request`

Merge a merge request, or schedule it to merge automatically. Without strategy the merge starts immediately and complete...

Create Branch`gitlab_add_branch`

Add a branch to a GitLab project from a source ref. Examples: - Use branch and ref to create a new branch from an existi...

Create Commit`gitlab_add_commit`

Add a commit with one or more file actions to a project branch.

Get Commit`gitlab_mcp_get_commit`

Get a single commit's metadata, optionally including its diff or notes. Identify the commit with either url, or project\_...

Get Group`gitlab_mcp_get_group`

Get metadata for a single GitLab group: numeric ID, full path, name, visibility, parent, and web URL. Identify the group...

Get Merge Request`gitlab_mcp_get_merge_request`

Get a merge request and optionally its diffs, commits, notes, pipelines, discussions, approvals, or conflicts. Without \`...

Get Repository File`gitlab_get_repository_file`

Read a file from a GitLab repository at a given ref. Reads from GitLab, not the local filesystem: use it for a project y...

Get Pipeline`gitlab_mcp_get_pipeline`

Get a CI/CD pipeline in a GitLab project, and optionally its jobs, downstream pipelines, bridge (trigger) jobs, or the a...

Get Project`gitlab_mcp_get_project`

Get metadata for a single GitLab project: numeric ID, full path, default branch, visibility, and web URL. Identify the p...

Get Work Items In Saved View`gitlab_get_saved_view_work_items`

Fetch a saved view and its work items list from a namespace

Get User`gitlab_mcp_get_user`

Get a single GitLab user. Use me: true to look up the authenticated user, for example to find your own user id before se...

Get Work Item`gitlab_get_work_item`

Get a single work item (issue, epic, task, incident, objective, key result) with its type, dates, assignees, labels, mil...

Get Work Item Types`gitlab_get_work_item_types`

List the work item types available in a namespace (group or project), including system-defined types (Issue, Epic, Task,...

Link Work Items`gitlab_link_work_items`

Link a work item to other work items with a relationship type (relates\_to, blocks, blocked\_by)

List Commits`gitlab_mcp_list_commits`

List commits in a GitLab project, filtered by ref, author, path, or date. Identify the project with exactly one of url o...

List Groups`gitlab_mcp_list_groups`

List GitLab groups. Without group\_id, lists top-level groups where you are a member. With group\_id, lists the direct sub...

List Merge Requests`gitlab_list_merge_requests`

List or search merge requests in a GitLab project or group by author, assignee, reviewer, state, milestone, labels, or t...

List Milestones`gitlab_list_milestones`

List milestones in a GitLab project or group. Identify the project or group with exactly one of url, project\_id, or grou...

List Projects`gitlab_mcp_list_projects`

List GitLab projects. Without group\_id, lists projects you have at least guest access to; pass min\_access\_level to raise...

List Repository Tree`gitlab_mcp_list_repository_tree`

List files and directories in a GitLab repository at a given path and ref. Identify the project with exactly one of url...

List Project Members`gitlab_mcp_list_project_members`

List the members of a GitLab project with their role and access level. Direct members only, unless include\_inherited is...

List To-do Items`gitlab_list_todos`

List the to-do items of the authenticated user, such as review requests, assignments, and mentions. Returns pending to-d...

List Work Item Saved Views`gitlab_list_work_item_saved_views`

List the work item saved views in a project or group. Provide exactly one of url, project\_id, or group\_id. Each row carr...

List Work Items`gitlab_list_work_items`

List or search work items (ISSUE, INCIDENT, TEST\_CASE, REQUIREMENT, TASK, TICKET, OBJECTIVE, KEY\_RESULT, EPIC) in a grou...

Comment On Or Review Merge Request`gitlab_save_merge_request_review`

Write merge request review artifacts as the authenticated user. Exactly one method per call: create\_note adds a top-leve...

Add Comment`gitlab_save_note`

Add a comment to a GitLab merge request or work item, reply to an existing discussion thread, or resolve or unresolve a...

Run Or Update Pipeline`gitlab_save_pipeline`

Run, retry, cancel, or rename a CI/CD pipeline in a GitLab project. Omit pipeline\_id and pass ref to run a new pipeline,...

Play Job`gitlab_save_pipeline_job`

Play a manual CI/CD job in a GitLab project, optionally with variables. Provide url, or project\_id and job\_id. If both a...

Create Or Update Work Item`gitlab_save_work_item`

Create or update a GitLab work item, such as an issue, task, or epic. Omit work\_item\_iid to create a new work item; prov...

Search Labels`gitlab_search_labels`

Search labels in a GitLab project or group by multiple terms

Fork Project`gitlab_fork_repository`

Create a fork of a project

List User Events`gitlab_list_user_events`

Retrieve contribution events for a user

List Pipeline Schedules`gitlab_list_pipeline_schedules`

List all pipeline schedules

List Pipelines`gitlab_mcp_list_pipelines`

List all project pipelines

List Branches`gitlab_mcp_list_branches`

List all repository branches

Semantic Search`gitlab_semantic_search`

Semantic (meaning-based) search over different types of content. Searches indexed project content using embedding-based...

Search GitLab`gitlab_search`

Search across GitLab with automatic selection of the best available search method. Requires `scope` and `search` (for ex...

Create Project`gitlab_save_project`

Create a new GitLab project. Creates a project in the specified namespace (group or user). If no namespace is provided,...

Create Or Update Merge Request`gitlab_save_merge_request`

Create or update a merge request in a GitLab project. merge\_request\_iid alone decides the operation. Omitting it always...

List Project Merge Requests`gitlab_list_project_merge_requests`

List all merge requests for a specific GitLab project

`read_api`

List Group Merge Requests`gitlab_list_group_merge_requests`

List merge requests across all projects in a GitLab group and its subgroups

`read_api`

Get Merge Request`gitlab_get_merge_request`

Retrieve details of a specific merge request in a GitLab project

`read_api`

Create Merge Request`gitlab_create_merge_request`

Create a new merge request in a GitLab project

`api`

Update Merge Request`gitlab_update_merge_request`

Update an existing merge request in a GitLab project

`api`

Merge Merge Request`gitlab_merge_merge_request`

Accept and merge a GitLab merge request

`api`

Rebase Merge Request`gitlab_rebase_merge_request`

Automatically rebase the source branch of a merge request against its target branch

`api`

List Merge Request Commits`gitlab_list_merge_request_commits`

List all commits in a GitLab merge request

`read_api`

List Merge Request Diffs`gitlab_list_merge_request_diffs`

List diffs of files changed in a GitLab merge request

`read_api`

Approve Merge Request`gitlab_approve_merge_request`

Approve a GitLab merge request

`api`

Get Merge Request Approvals`gitlab_get_merge_request_approvals`

Retrieve who approved a GitLab merge request and whether it meets its approval requirements

`read_api`

Get Merge Request Approval State`gitlab_get_merge_request_approval_state`

Retrieve the approval rules of a GitLab merge request and whether each is satisfied

`read_api`

List Project Approval Rules`gitlab_list_project_approval_rules`

List the merge request approval rules configured on a GitLab project

`read_api`

Get Project Approval Configuration`gitlab_get_project_approval_configuration`

Retrieve the merge request approval settings of a GitLab project

`read_api`

Get Group Merge Request Approval Settings`gitlab_get_group_merge_request_approval_setting`

Retrieve the merge request approval settings a GitLab group sets for all of its projects

`read_api`

List Group Merge Requests With Approvals`gitlab_list_group_merge_requests_with_approvals`

List the merge requests of a GitLab group and its subgroups with their author, merger, approvers and committers in one c...

`read_api`

List Merge Request Notes`gitlab_list_merge_request_notes`

List all comments on a GitLab merge request

`read_api`

Create Merge Request Note`gitlab_create_merge_request_note`

Add a comment to a GitLab merge request

`api`

Cancel Auto-Merge`gitlab_cancel_merge_when_pipeline_succeeds`

Cancel the auto-merge setting on a GitLab merge request

`api`

Get Merge Request Participants`gitlab_get_merge_request_participants`

Retrieve all participants in a GitLab merge request

`read_api`

List Project Milestones`gitlab_list_project_milestones`

List all milestones in a GitLab project

`read_api`

Get Project Milestone`gitlab_get_project_milestone`

Retrieve details of a specific milestone in a GitLab project

`read_api`

Create Project Milestone`gitlab_create_project_milestone`

Create a new milestone in a GitLab project

`api`

Update Project Milestone`gitlab_update_project_milestone`

Update an existing milestone in a GitLab project

`api`

Delete Project Milestone`gitlab_delete_project_milestone`

Delete a milestone from a GitLab project

`api`

List Namespaces`gitlab_list_namespaces`

List all namespaces accessible to the authenticated GitLab user

`read_api`

Get Namespace`gitlab_get_namespace`

Retrieve details of a specific GitLab namespace

`read_api`

List Pipelines`gitlab_list_pipelines`

List all pipelines for a GitLab project

`read_api`

Get Pipeline`gitlab_get_pipeline`

Retrieve details of a specific pipeline in a GitLab project

`read_api`

Create Pipeline`gitlab_create_pipeline`

Trigger a new pipeline for a GitLab project

`api`

Retry Pipeline`gitlab_retry_pipeline`

Retry failed or canceled jobs in a GitLab pipeline

`api`

Cancel Pipeline`gitlab_cancel_pipeline`

Cancel all jobs for a running pipeline in a GitLab project

`api`

Delete Pipeline`gitlab_delete_pipeline`

Delete a pipeline from a GitLab project

`api`

Get Pipeline Variables`gitlab_get_pipeline_variables`

Retrieve variables of a specific pipeline in a GitLab project

`read_api`

List Pipeline Jobs`gitlab_list_pipeline_jobs`

List all jobs in a specific GitLab pipeline

`read_api`

Get Job`gitlab_get_job`

Retrieve details of a specific CI/CD job in a GitLab project

`read_api`

Get Job Log`gitlab_get_job_log`

Retrieve the log output of a CI/CD job in a GitLab project

`read_api`

Retry Job`gitlab_retry_job`

Retry a CI/CD job in a GitLab project

`api`

List Projects`gitlab_list_projects`

List all GitLab projects accessible to the authenticated user

`read_api`

Get Project`gitlab_get_project`

Retrieve details of a specific GitLab project

`read_api`

Create Project`gitlab_create_project`

Create a new GitLab project

`api`

Update Project`gitlab_update_project`

Update settings and configuration of a GitLab project

`api`

Delete Project`gitlab_delete_project`

Delete a GitLab project

`api`

Fork Project`gitlab_fork_project`

Fork a GitLab project into a namespace

`api`

Archive Project`gitlab_archive_project`

Archive a GitLab project to make it read-only

`api`

Unarchive Project`gitlab_unarchive_project`

Unarchive a GitLab project to restore full access

`api`

List Project Members`gitlab_list_project_members`

List all members of a GitLab project

`read_api`

List All Project Members`gitlab_list_all_project_members`

List everyone with access to a GitLab project, including inherited and invited members

`read_api`

Add Project Member`gitlab_add_project_member`

Add a user as a member of a GitLab project

`api`

Update Project Member`gitlab_update_project_member`

Update a project member's access level or expiration

`api`

Remove Project Member`gitlab_remove_project_member`

Remove a user from a GitLab project

`api`

List Releases`gitlab_list_releases`

List all releases for a GitLab project

`read_api`

Get Release`gitlab_get_release`

Retrieve details of a specific release in a GitLab project

`read_api`

Create Release`gitlab_create_release`

Create a new release for a GitLab project

`api`

Update Release`gitlab_update_release`

Update an existing release in a GitLab project

`api`

Delete Release`gitlab_delete_release`

Delete a release from a GitLab project

`api`

List Repository Tree`gitlab_list_repository_tree`

List files and directories in a GitLab project repository

`read_repository`

Get File`gitlab_get_file`

Retrieve a file from a GitLab project repository

`read_repository`

Create File`gitlab_create_file`

Create a new file in a GitLab project repository

`write_repository`

Update File`gitlab_update_file`

Update an existing file in a GitLab project repository

`write_repository`

Delete File`gitlab_delete_file`

Delete a file from a GitLab project repository

`write_repository`

List Tags`gitlab_list_tags`

List all tags in a GitLab project repository

`read_repository`

Create Tag`gitlab_create_tag`

Create a new tag in a GitLab project repository

`write_repository`

Delete Tag`gitlab_delete_tag`

Delete a tag from a GitLab project repository

`write_repository`

Get Repository Contributors`gitlab_get_repository_contributors`

Retrieve the list of contributors for a GitLab project repository

`read_repository`

Compare Branches`gitlab_compare_branches`

Compare two branches, tags, or commits in a GitLab project

`read_repository`

Search Globally`gitlab_search_globally`

Search across all accessible GitLab resources

`read_api`

Search In Group`gitlab_search_in_group`

Search within a specific GitLab group and its subgroups

`read_api`

Search In Project`gitlab_search_in_project`

Search within a specific GitLab project

`read_api`

List Snippets`gitlab_list_snippets`

List all snippets for the authenticated GitLab user

`read_api`

Get Snippet`gitlab_get_snippet`

Retrieve details of a specific GitLab snippet

`read_api`

Create Snippet`gitlab_create_snippet`

Create a new GitLab snippet

`api`

Update Snippet`gitlab_update_snippet`

Update an existing GitLab snippet

`api`

Delete Snippet`gitlab_delete_snippet`

Delete a GitLab snippet permanently

`api`

List Users`gitlab_list_users`

List all GitLab users accessible to the authenticated user

`read_api`

Get User`gitlab_get_user`

Retrieve details of a specific GitLab user by ID

`read_api`

Get Current User`gitlab_get_current_user`

Retrieve the authenticated user's profile information

`read_user`

Create User`gitlab_create_user`

Create a new GitLab user account (admin only)

`api`

Update User`gitlab_update_user`

Update an existing GitLab user account (admin only)

`api`

Delete User`gitlab_delete_user`

Delete a GitLab user account (admin only)

`api`

Get Current User Status`gitlab_get_current_user_status`

Retrieve the status of the authenticated user

`read_user`

Get User Status`gitlab_get_user_status`

Retrieve the status of a specific GitLab user

`read_api`

List Project CI/CD Variables`gitlab_list_project_variables`

List all CI/CD variables for a GitLab project

`read_api`

Get Project CI/CD Variable`gitlab_get_project_variable`

Retrieve a specific CI/CD variable from a GitLab project

`read_api`

Create Project CI/CD Variable`gitlab_create_project_variable`

Create a new CI/CD variable for a GitLab project

`api`

Update Project CI/CD Variable`gitlab_update_project_variable`

Update an existing CI/CD variable in a GitLab project

`api`

Delete Project CI/CD Variable`gitlab_delete_project_variable`

Delete a CI/CD variable from a GitLab project

`api`

## Events

Tags

Select all
|
Clear

Commits

Credentials

Environments

Groups

Issues

Jobs

Members

Merge Requests

Milestones

Notes

Pipelines

Projects

Releases

Security

Tags

Webhooks

Wikis

No tags found

49 events

EventDescriptionTags

Active Check`gitlab_active_check`Manual setup

Responds with 200 OK to any GitLab delivery that does not match a known event.

Webhooks

Push`gitlab_webhook_push`Manual setup

Fired when commits are pushed to a branch of a project (push).

CommitsWebhooks

Tag Push`gitlab_webhook_tag_push`Manual setup

Fired when a tag is created or deleted in a project (tag\_push).

TagsWebhooks

Issue Opened`gitlab_webhook_issue_opened`Manual setup

Fired when an issue is opened in a project (issue, action open).

IssuesWebhooks

Issue Closed`gitlab_webhook_issue_closed`Manual setup

Fired when an issue is closed in a project (issue, action close).

IssuesWebhooks

Issue Reopened`gitlab_webhook_issue_reopened`Manual setup

Fired when an issue is reopened in a project (issue, action reopen).

IssuesWebhooks

Issue Updated`gitlab_webhook_issue_updated`Manual setup

Fired when an issue is edited in a project (issue, action update).

IssuesWebhooks

Work Item Opened`gitlab_webhook_work_item_opened`Manual setup

Fired when a work item such as a task or epic is opened (work\_item, action open).

IssuesWebhooks

Work Item Closed`gitlab_webhook_work_item_closed`Manual setup

Fired when a work item such as a task or epic is closed (work\_item, action close).

IssuesWebhooks

Work Item Reopened`gitlab_webhook_work_item_reopened`Manual setup

Fired when a work item such as a task or epic is reopened (work\_item, action reopen).

IssuesWebhooks

Work Item Updated`gitlab_webhook_work_item_updated`Manual setup

Fired when a work item such as a task or epic is edited (work\_item, action update).

IssuesWebhooks

Merge Request Opened`gitlab_webhook_merge_request_opened`Manual setup

Fired when a merge request is opened (merge\_request, action open).

Merge RequestsWebhooks

Merge Request Closed`gitlab_webhook_merge_request_closed`Manual setup

Fired when a merge request is closed without merging (merge\_request, action close).

Merge RequestsWebhooks

Merge Request Reopened`gitlab_webhook_merge_request_reopened`Manual setup

Fired when a merge request is reopened (merge\_request, action reopen).

Merge RequestsWebhooks

Merge Request Updated`gitlab_webhook_merge_request_updated`Manual setup

Fired when a merge request is updated (merge\_request, action update).

Merge RequestsWebhooks

Merge Request Merged`gitlab_webhook_merge_request_merged`Manual setup

Fired when a merge request is merged (merge\_request, action merge).

Merge RequestsWebhooks

Merge Request Approval Added`gitlab_webhook_merge_request_approval_added`Manual setup

Fired when a merge request is approved by one approver (merge\_request, action approval).

Merge RequestsWebhooks

Merge Request Approved`gitlab_webhook_merge_request_approved`Manual setup

Fired when a merge request is fully approved (merge\_request, action approved).

Merge RequestsWebhooks

Merge Request Approval Removed`gitlab_webhook_merge_request_approval_removed`Manual setup

Fired when a merge request is unapproved by one approver (merge\_request, action unapproval).

Merge RequestsWebhooks

Merge Request Unapproved`gitlab_webhook_merge_request_unapproved`Manual setup

Fired when a merge request is no longer fully approved (merge\_request, action unapproved).

Merge RequestsWebhooks

Comment Created`gitlab_webhook_note_created`Manual setup

Fired when a comment is created on a commit, merge request, issue or snippet (note, action create).

NotesWebhooks

Comment Updated`gitlab_webhook_note_updated`Manual setup

Fired when a comment is updated on a commit, merge request, issue or snippet (note, action update).

NotesWebhooks

Pipeline Status Changed`gitlab_webhook_pipeline_status_changed`Manual setup

Fired when a pipeline is created or its status changes (pipeline).

PipelinesWebhooks

Job Status Changed`gitlab_webhook_job_status_changed`Manual setup

Fired when a CI/CD job is created or its status changes (build).

JobsWebhooks

Deployment Status Changed`gitlab_webhook_deployment_status_changed`Manual setup

Fired when a deployment starts, succeeds, fails, is canceled or is approved or rejected (deployment).

EnvironmentsWebhooks

Feature Flag Toggled`gitlab_webhook_feature_flag_toggled`Manual setup

Fired when a feature flag is turned on or off (feature\_flag).

EnvironmentsWebhooks

Release Created`gitlab_webhook_release_created`Manual setup

Fired when a release is created in a project (release, action create).

ReleasesWebhooks

Release Updated`gitlab_webhook_release_updated`Manual setup

Fired when a release is updated in a project (release, action update).

ReleasesWebhooks

Release Deleted`gitlab_webhook_release_deleted`Manual setup

Fired when a release is deleted in a project (release, action delete).

ReleasesWebhooks

Milestone Created`gitlab_webhook_milestone_created`Manual setup

Fired when a project milestone is created (milestone, action create).

MilestonesWebhooks

Milestone Closed`gitlab_webhook_milestone_closed`Manual setup

Fired when a project milestone is closed (milestone, action close).

MilestonesWebhooks

Milestone Reopened`gitlab_webhook_milestone_reopened`Manual setup

Fired when a project milestone is reopened (milestone, action reopen).

MilestonesWebhooks

Milestone Deleted`gitlab_webhook_milestone_deleted`Manual setup

Fired when a project milestone is deleted (milestone, action delete).

MilestonesWebhooks

Wiki Page Created`gitlab_webhook_wiki_page_created`Manual setup

Fired when a project wiki page is created (wiki\_page, action create).

WikisWebhooks

Wiki Page Updated`gitlab_webhook_wiki_page_updated`Manual setup

Fired when a project wiki page is updated (wiki\_page, action update).

WikisWebhooks

Wiki Page Deleted`gitlab_webhook_wiki_page_deleted`Manual setup

Fired when a project wiki page is deleted (wiki\_page, action delete).

WikisWebhooks

Emoji Reaction Awarded`gitlab_webhook_emoji_awarded`Manual setup

Fired when an emoji reaction is added to an issue, merge request, snippet or comment (emoji, award).

NotesWebhooks

Emoji Reaction Revoked`gitlab_webhook_emoji_revoked`Manual setup

Fired when an emoji reaction is removed from an issue, merge request, snippet or comment (emoji, revoke).

NotesWebhooks

Access Token Expiring`gitlab_webhook_access_token_expiring`Manual setup

Fired when a project or group access token is about to expire (access\_token).

CredentialsWebhooks

Vulnerability Created or Updated`gitlab_webhook_vulnerability_changed`Manual setup

Fired when a vulnerability is created or its state or details change (vulnerability, Ultimate only).

SecurityWebhooks

Group Member Added`gitlab_webhook_group_member_added`Manual setup

Fired when a user is added to the group (user\_add\_to\_group, group webhooks only).

MembersWebhooks

Group Member Updated`gitlab_webhook_group_member_updated`Manual setup

Fired when a group member access level or expiry changes (user\_update\_for\_group, group webhooks only).

MembersWebhooks

Group Member Removed`gitlab_webhook_group_member_removed`Manual setup

Fired when a user is removed from the group (user\_remove\_from\_group, group webhooks only).

MembersWebhooks

Group Access Requested`gitlab_webhook_group_access_requested`Manual setup

Fired when a user requests access to the group (user\_access\_request\_to\_group, group webhooks only).

MembersWebhooks

Group Access Request Denied`gitlab_webhook_group_access_request_denied`Manual setup

Fired when a group access request is denied (user\_access\_request\_denied\_for\_group, group webhooks only).

MembersWebhooks

Group Project Created`gitlab_webhook_group_project_created`Manual setup

Fired when a project is created in the group (project\_create, group webhooks only).

ProjectsWebhooks

Group Project Deleted`gitlab_webhook_group_project_deleted`Manual setup

Fired when a project is deleted in the group (project\_destroy, group webhooks only).

ProjectsWebhooks

Subgroup Created`gitlab_webhook_subgroup_created`Manual setup

Fired when a subgroup is created in the group (subgroup\_create, group webhooks only).

GroupsWebhooks

Subgroup Deleted`gitlab_webhook_subgroup_deleted`Manual setup

Fired when a subgroup is deleted in the group (subgroup\_destroy, group webhooks only).

GroupsWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.