GitLab
API integration

list_all_git_lab_repositories

List all files and directories in a GitLab project repository tree, like git ls-tree. Returns tree entries with id (object ID) and, when with_last_commit is set, the last_commit that changed each entry. Required: project_id. with_last_commit cannot be combined with recursive. Required: project_id.

git_lab_repositories_download

Download a GitLab project repository as a zip archive. Required: project_id. Returns the raw zip archive (binary), not a JSON body. Required: project_id.

list_all_git_lab_users

List all users on the GitLab instance. Returns: id, username, public_email, name, state, locked, avatar_url, avatar_path, custom_attributes, web_url.

get_single_git_lab_user_by_id

Get a single GitLab user by id. Returns: id, username, public_email, name, state, locked, avatar_url, avatar_path, custom_attributes, web_url, created_at, bio, location, linkedin, twitter, discord, website_url, github, job_title, pronouns, organization, bot, work_information, followers, following, is_followed, local_time, bio_html. Required: id.

list_all_git_lab_project_members

List the direct members of a GitLab project, excluding members inherited from ancestor groups or invited groups. Returns member objects with id, username, name, state, created_at, and access_level. Required: project_id.

get_single_git_lab_project_member_by_id

Get a single direct member of a GitLab project by id (the member's user ID). Returns the member object including id, username, name, state, created_at, and access_level. Inherited members from ancestor groups are not returned. Required: project_id, id.

update_a_git_lab_project_member_by_id

Update a direct member of a GitLab project by id (the member's user ID). Returns the updated member object including id, username, name, state, created_at, and access_level. Requires a JSON request body. Required: project_id, id, access_level.

delete_a_git_lab_project_member_by_id

Remove a member from a GitLab project. The user must be a direct member. Returns an empty 204 response on success. Required: project_id and the member id (the user's ID).

create_a_git_lab_project_member

Add a member to a GitLab project. Returns the created member object including id, username, name, state, created_at, and access_level. Required: project_id, access_level.

list_all_git_lab_project_issues

List issues in a GitLab project. Returns: id, iid, project_id, title, description, state, created_at, updated_at, closed_at, closed_by, labels, milestone, assignees, author, type, assignee, user_notes_count, merge_requests_count, upvotes, downvotes, start_date, due_date, confidential, discussion_locked, and 21 more. Required: project_id.

get_single_git_lab_project_issue_by_id

Get a single issue in a GitLab project by id (the issue's internal ID, its iid). Returns: id, iid, project_id, title, description, state, created_at, updated_at, closed_at, closed_by, labels, milestone, assignees, author, type, assignee, user_notes_count, merge_requests_count, upvotes, downvotes, due_date, and 24 more. Required: project_id and id.

create_a_git_lab_project_issue

Create an issue in a GitLab project. Returns the created issue with id, iid, title, description, labels, due_date, created_at, and updated_at. Required: project_id, title.

list_all_git_lab_project_labels

List all GitLab labels for a project, including labels inherited from ancestor groups by default. Returns label records with their id; pass with_counts to include issue and merge request counts. Required: project_id.

list_all_git_lab_group_members

List all direct members of a GitLab group. Returns each member's id, username, name, state, created_at, and access_level. Only direct members are returned — inherited members from ancestor or invited groups are excluded. Required: group_id.

get_single_git_lab_group_member_by_id

Get a single direct member of a GitLab group by id (the member's user ID). Returns: id, username, public_email, name, state, locked, avatar_url, avatar_path, custom_attributes, web_url, access_level, created_at, created_by, expires_at, and 9 more. Inherited members from ancestor groups are not returned. Required: group_id and id.

update_a_git_lab_group_member_by_id

Update a direct member of a GitLab group, identified by id (the member's user ID). Returns the updated member object with id, username, name, state, created_at, and access_level. Send a JSON request body; see GitLab's Members API documentation for its accepted fields. Required: group_id and id, access_level.

delete_a_git_lab_group_member_by_id

Remove a direct member from a GitLab group. Returns an empty 204 response on success. Required: group_id and id (the member's user ID).

create_a_git_lab_group_member

Add a member to a GitLab group. Returns the created member object with id, username, name, state, access_level, and created_at. Send a JSON request body; see GitLab's Members API documentation for its accepted fields. Required: group_id, access_level.

list_all_git_lab_groups

List GitLab groups visible to the authenticated user. Returns group records with id, custom_attributes, and statistics when requested. Supports search, visibility, and min_access_level filters; results are sorted by name ascending by default.

get_single_git_lab_group_by_id

Get a single GitLab group by id (the group's ID or URL-encoded path). Returns: id, web_url, name, path, description, visibility, share_with_group_lock, require_two_factor_authentication, two_factor_grace_period, custom_attributes, statistics, and 71 more. Required: id. The with_projects parameter is deprecated and scheduled for removal in API v5.

list_all_git_lab_group_projects

List all projects in a GitLab group that are accessible to the authenticated user. Returns project records including id, name, path, created_at, last_activity_at, and star_count; the attribute set returned varies with authentication. Required: group_id.

list_all_git_lab_projects

List GitLab projects, scoped to projects the account is a member of (membership=true is always sent). Returns: id, description, name, name_with_namespace, path, created_at, star_count, visibility, custom_attributes, and 15 more. Filter by search, visibility, topics, owner, or activity dates; updated_after/updated_before require order_by=updated_at.

get_single_git_lab_project_by_id

Get a GitLab project by id, either the numeric ID or the URL-encoded path of the project. Returns the project object including its id, statistics, custom_attributes, and license data (the latter three included when their query flags are set). Required: id.

get_single_git_lab_issue_by_id

Get a single GitLab issue by id. Returns: id, iid, project_id, title, description, state, created_at, updated_at, closed_at, closed_by, labels, milestone, assignees, author, type, assignee, user_notes_count, merge_requests_count, upvotes, downvotes, start_date, due_date, confidential, discussion_locked, issue_type, and 19 more. Required: id.

list_all_git_lab_issue_notes

List all notes (comments and system records) on a GitLab issue. Returns: id, type, body, author, created_at, updated_at, system, noteable_id, noteable_type, project_id, commit_id, position, resolvable, resolved, resolved_by, resolved_at, suggestions, confidential, internal, imported, imported_from, and 3 more. Required: project_id, issue_iid.

get_single_git_lab_issue_note_by_id

Get a single note (comment or system record) on a GitLab issue by id. Returns: id, type, body, author, created_at, updated_at, system, noteable_id, noteable_type, project_id, commit_id, position, resolvable, resolved, resolved_by, resolved_at, suggestions, confidential, internal, imported, and 4 more. Required: project_id, issue_iid, id.

create_a_git_lab_issue_note

Create a note (comment) on a GitLab issue. Returns the created note with id, body, system, confidential, internal, created_at, and updated_at. Required: project_id, issue_iid, and a JSON request payload with the note content, body.

list_all_git_lab_merge_requests

List all merge requests in a GitLab project. Returns: id, iid, project_id, title, description, state, created_at, updated_at, merged_by, merge_user, merged_at, closed_by, closed_at, title_html, description_html, target_branch, source_branch, user_notes_count, upvotes, downvotes, author, labels, merge_status, and 33 more. Required: project_id.

get_single_git_lab_merge_request_by_id

Get a single merge request in a GitLab project by id. Returns: id, iid, project_id, title, description, state, created_at, updated_at, merged_by, merge_user, merged_at, closed_by, closed_at, title_html, description_html, target_branch, source_branch, labels, merge_status, and 50 more. Required: id (the merge request's internal iid) and project_id, project_id.

list_all_git_lab_branches

List GitLab repository branches for a project, sorted alphabetically by name. Returns the branch record including its protection status, merge status, and commit details. Required: project_id. regex cannot be used together with search. Required: project_id.

get_single_git_lab_branch_by_id

Get a single GitLab repository branch by name. Returns the branch record including its protection status, merge status, and commit details. Required: id (the branch name) and project_id. Branch names containing / must be URL-encoded. Required: project_id.

list_all_git_lab_group_users

List users that belong to a specified GitLab group. Returns an array of user records including id, username, and name. Required: group_id (the group's ID or URL-encoded path).

list_all_git_lab_audit_events

List the audit events recorded for a GitLab group. Returns audit event records with their id and created_at. Required: group_id. Results are ordered by id (sort=desc only). Required: group_id.

list_all_git_lab_user_email

List all email addresses for a specified GitLab user account. Returns an array of email records, each with its id and schema-specific attribute fields. Required: user_id. Administrators only. Required: user_id.

list_all_git_lab_current_license

Retrieve the license that currently activates GitLab Enterprise Edition on this GitLab instance. Returns the current license record, including its id.

list_all_git_lab_me

Get the details of the authenticated user's own GitLab account. Returns: id, username, public_email, name, state, locked, avatar_url, avatar_path, custom_attributes, web_url, created_at, bio, location, linkedin, twitter, discord, website_url, github, job_title, pronouns, organization, bot, work_information, and 24 more. Takes no parameters.

list_all_git_lab_licenses

List all GitLab licenses that activate the instance. Returns each license record with its id and remaining license attributes.

get_single_git_lab_license_by_id

Get a single GitLab license by id. Returns the license record with its id and remaining license attributes. Required: id.

list_all_git_lab_member_roles

List all member roles for this GitLab instance. Returns member role records, each identified by an id. Available on GitLab Ultimate.

list_all_git_lab_group_subgroups

List all subgroups of a GitLab group. Returns each subgroup with its id, created_at, and optional statistics and custom_attributes. Required: group_id (ID or URL-encoded path of the parent group).

list_all_git_lab_group_descendant_groups

List all descendant groups of a GitLab group, recursively. Returns: id, web_url, name, path, description, visibility, share_with_group_lock, require_two_factor_authentication, two_factor_grace_period, project_creation_level, auto_devops_enabled, subgroup_creation_level, archived, statistics, marked_for_deletion_on, and 42 more. Required: group_id.

list_all_git_lab_group_members_all

List all members of a GitLab group, including members inherited from ancestor groups or invited groups; if a user is a member of the group and one or more ancestor groups, only the highest access_level is returned. Returns: id, username, public_email, name, state, locked, avatar_url, access_level, created_at, and 14 more. Required: group_id.