Action domain
group
Every action this domain exposes through gitlab_execute_action, from the gitlab://tools manifest. Each entry folds out to its full upstream description and required parameters.
75 · actions12 · destructive33 · read-only
Counted with a Free-tier token against gitlab.com, which is the only host this endpoint talks to: to use it against a self-managed instance, run the server yourself — its documentation covers that. The catalog is scoped to the token that asks, so the count moves with both its tier and its permissions: higher tiers expose more actions, and administration domains only appear to tokens allowed to use them. That is why the figures differ elsewhere: the upstream project counts 868 operations on Community Edition and up to 1,094 on GitLab.com's top tier, while this deployment publishes 768 because it is OAuth-only and acts with your token, so the administration domains a non-admin account cannot call never appear. All three describe the same catalog, counted from three vantage points.
Each entry also says what a GitLab fine-grained personal access token needs to run it, as GitLab 19.4.1 declares it: every permission of one line, at one of the boundaries named. Where there are alternatives, any one is enough.
Group Archivegroup.archiveArchive a GitLab group, making it and its projects read-only in GitLab. Returns: a success confirmation. See also:
group.unarchive,group.get,group.update.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Archiveat group
Add Group Badgegroup.badge_addAdd a badge to a group. Returns: the created badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also:
group.badge_list,group.badge_get.Required parameters:
group_id (string|integer),image_url (string),link_url (string)Fine-grained token:
Badge: Createat group
Delete Group Badgedestructivegroup.badge_deleteDelete a group badge by badge_id. Returns: a success confirmation. See also:
group.badge_list,group.badge_get.Required parameters:
badge_id (integer),group_id (string|integer)Fine-grained token:
Badge: Deleteat group
Edit Group Badgegroup.badge_editEdit a group badge's name, link_url, or image_url. Returns: the updated badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also:
group.badge_list,group.badge_get.Required parameters:
badge_id (integer),group_id (string|integer)Fine-grained token:
Badge: Updateat group
Get Group Badgeread-onlygroup.badge_getGet a single group badge by badge_id. Returns: the badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also:
group.badge_list,group.badge_edit.Required parameters:
badge_id (integer),group_id (string|integer)Fine-grained token:
Badge: Readat group
List Group Badgesread-onlygroup.badge_listList badges for a group, including inherited group badges. Returns: badges (id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind) plus pagination metadata. See also:
group.badge_get,group.badge_add.Required parameters:
group_id (string|integer)Fine-grained token:
Badge: Readat group
Preview Group Badgeread-onlygroup.badge_previewPreview how a group badge's link_url and image_url resolve after placeholder interpolation, without persisting it. Returns: the rendered badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also:
group.badge_add,group.badge_list.Required parameters:
group_id (string|integer),image_url (string),link_url (string)Fine-grained token:
Badge: Readat group
Group Creategroup.createCreate a GitLab group or subgroup. Returns: created group metadata including ID, full path, and visibility. See also:
group.get,group.update,group.delete.Required parameters:
name (string)Fine-grained token:
Group: Createat user
Group Deletedestructivegroup.deleteDelete a GitLab group and its projects. Returns: a success confirmation. See also:
group.restore,group.get,group.update.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Deleteat group
Group Getread-onlygroup.getGet one GitLab group by ID or path. Returns: group metadata, visibility, parent information, and web URL. See also:
group.list,group.members,group.projects,group.update.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Readat group
Group Board List Creategroup.group_board_create_listCreate a new list (column) on a group issue board from a group label. Returns: the created list with its label and scope. See also:
group.group_board_get_list,group.group_board_update_list,group.group_board_delete_list.Required parameters:
board_id (integer),group_id (string|integer),label_id (integer)Fine-grained token:
Work Item: Createat group
Group Board List Deletedestructivegroup.group_board_delete_listDelete a list (column) from a group issue board. Returns: a success confirmation. See also:
group.group_board_get_list,group.group_board_list_lists.Required parameters:
board_id (integer),group_id (string|integer),list_id (integer)Fine-grained token:
Work Item: Deleteat group
Group Board Getread-onlygroup.group_board_getGet a single group issue board by ID. Returns: the board with its group, milestone, scope labels, and lists. See also:
group.group_board_list,group.group_board_update,group.group_board_list_lists.Required parameters:
board_id (integer),group_id (string|integer)Fine-grained token:
Work Item: Readat group
Group Board List Getread-onlygroup.group_board_get_listGet a single list (column) of a group issue board. Returns: the list with its assignee, label, iteration, and milestone scope. See also:
group.group_board_list_lists,group.group_board_update_list,group.group_board_delete_list.Required parameters:
board_id (integer),group_id (string|integer),list_id (integer)Fine-grained token:
Work Item: Readat group
Group Board Listread-onlygroup.group_board_listList all issue boards in a group with pagination. Returns: each board with its group, milestone, scope labels, lists, and pagination metadata. See also:
group.group_board_get,group.group_board_list_lists.Required parameters:
group_id (string|integer)Fine-grained token:
Work Item: Readat group
Group Board List Listsread-onlygroup.group_board_list_listsList the lists (columns) of a group issue board with pagination. Returns: each list with its assignee, label, iteration, and milestone scope plus pagination metadata. See also:
group.group_board_get_list,group.group_board_create_list,group.group_board_get.Required parameters:
board_id (integer),group_id (string|integer)Fine-grained token:
Work Item: Readat group
Group Board Updategroup.group_board_updateUpdate a group issue board's name, and on Premium and Ultimate its scope (assignee, milestone, labels, weight). Returns: the updated board with its group, milestone, labels, and lists. See also:
group.group_board_get,group.group_board_list.Required parameters:
board_id (integer),group_id (string|integer)Fine-grained token:
Work Item: Updateat group
Group Board List Updategroup.group_board_update_listReorder a list (column) within a group issue board. Returns: the repositioned list with its scope. See also:
group.group_board_get_list,group.group_board_list_lists.Required parameters:
board_id (integer),group_id (string|integer),list_id (integer),position (integer)Fine-grained token:
Work Item: Updateat group
Download Group Exportread-onlygroup.group_export_downloadDownload a group's finished export archive. Returns: the export archive as base64 content plus its size in bytes. See also:
group.group_export_schedule,group.group_import_file,group.get.Required parameters:
group_id (string|integer)Fine-grained token:
Export: Downloadat group
Schedule Group Exportgroup.group_export_scheduleSchedule an asynchronous export of a GitLab group. Returns: a confirmation that the export was scheduled (the archive is built in the background). See also:
group.group_export_download,group.group_import_file,group.get.Required parameters:
group_id (string|integer)Fine-grained token:
Export: Createat group
Import Group From Filegroup.group_import_fileImport a group from a local export archive. Returns: a confirmation that the import started (GitLab builds the group asynchronously). See also:
group.group_export_schedule,group.group_export_download,group.list.Required parameters:
file (string),name (string),path (string)Fine-grained token:
Import: Createat instance
Group Label Creategroup.group_label_createCreate a new group label. Returns: the created label with id, name, color, text color, description, and subscription state. See also:
group.group_label_list,group.group_label_get,group.group_label_update.Required parameters:
color (string),group_id (string|integer),name (string)Fine-grained token:
Label: Createat group
Group Label Deletedestructivegroup.group_label_deleteDelete a group label permanently. Returns: a success confirmation. See also:
group.group_label_get,group.group_label_list.Required parameters:
group_id (string|integer),label_id (string|integer)Fine-grained token:
Label: Deleteat group
Group Label Getread-onlygroup.group_label_getGet a single group label by ID or name. Returns: the label with color, text color, description, and subscription state. GitLab sends a label's usage counts only to
group.group_label_listwith with_counts. See also:group.group_label_list,group.group_label_update,group.group_label_delete.Required parameters:
group_id (string|integer),label_id (string|integer)Fine-grained token:
Label: Readat group
Group Label Listread-onlygroup.group_label_listList labels in a group with filtering and pagination. Returns: matching labels with color, text color, description, subscription state, the issue and merge request counts when with_counts is true, and pagination metadata. See also:
group.group_label_get,group.group_label_create,group.get.Required parameters:
group_id (string|integer)Fine-grained token:
Label: Readat group
Group Label Subscribegroup.group_label_subscribeSubscribe to a group label's notifications. Returns: the label with the updated subscription state. See also:
group.group_label_get,group.group_label_unsubscribe.Required parameters:
group_id (string|integer),label_id (string|integer)Fine-grained token:
Label: Subscribeat group
Group Label Unsubscribegroup.group_label_unsubscribeUnsubscribe from a group label's notifications. Returns: a success confirmation. See also:
group.group_label_get,group.group_label_subscribe.Required parameters:
group_id (string|integer),label_id (string|integer)Fine-grained token:
Label: Subscribeat group
Group Label Updategroup.group_label_updateUpdate a group label. Returns: the updated label with id, name, color, text color, description, and subscription state. See also:
group.group_label_get,group.group_label_list,group.group_label_delete.Required parameters:
group_id (string|integer),label_id (string|integer)Fine-grained token:
Label: Updateat group
Group Member Addgroup.group_member_addAdd a user as a direct member of a group. Returns: the created membership with access level, custom member role, expiry, and seat usage. See also:
group.members,group.group_member_edit,group.group_member_get.Required parameters:
group_id (string|integer),user_id (integer)Fine-grained token:
Member: Createat group
Group Member Editgroup.group_member_editEdit a direct group member's access level, expiry, or custom member role. Returns: the updated membership. See also:
group.members,group.group_member_get,group.group_member_remove.Required parameters:
group_id (string|integer),user_id (integer)Fine-grained token:
Member: Updateat group
Group Member Getread-onlygroup.group_member_getGet a single direct member of a group by user ID. Returns: access level, custom member role, created_by, expiry, public email, SAML identity, and seat usage. See also:
group.members,group.group_member_get_inherited,group.group_member_edit.Required parameters:
group_id (string|integer),user_id (integer)Fine-grained token:
Member: Readat group
Group Member Get Inheritedread-onlygroup.group_member_get_inheritedGet a single member of a group including inherited memberships from ancestor groups. Returns: effective access level, custom member role, created_by, expiry, public email, SAML identity, and seat usage. See also:
group.group_member_get,group.members,group.group_member_edit.Required parameters:
group_id (string|integer),user_id (integer)Fine-grained token:
Member: Readat group
Group Member Removedestructivegroup.group_member_removeRemove a direct member from a group (destructive, requires confirmation). Returns: a delete confirmation. See also:
group.members,group.group_member_get,group.group_member_edit.Required parameters:
group_id (string|integer),user_id (integer)Fine-grained token:
Member: Deleteat group
Group Milestone Creategroup.group_milestone_createCreate a new group milestone. Returns: the created milestone with ID, IID, state, start and due dates. See also:
group.group_milestone_get,group.group_milestone_list,group.group_milestone_update.Required parameters:
group_id (string|integer),title (string)Fine-grained token:
Work Item: Createat group
Group Milestone Deletedestructivegroup.group_milestone_deleteDelete a group milestone permanently. Returns: a success confirmation. See also:
group.group_milestone_get,group.group_milestone_update.Required parameters:
group_id (string|integer),milestone_iid (integer)Fine-grained token:
Work Item: ReadandWork Item: Deleteat group
Group Milestone Getread-onlygroup.group_milestone_getGet a single group milestone by IID. Returns: milestone metadata, state, start and due dates, expiry, and timestamps. See also:
group.group_milestone_list,group.group_milestone_update,group.group_milestone_issues.Required parameters:
group_id (string|integer),milestone_iid (integer)Fine-grained token:
Work Item: Readat group
Group Milestone Issuesread-onlygroup.group_milestone_issuesList issues assigned to a group milestone. Returns: assigned issues with IID, project, title, state, labels, author, assignees, confidentiality, weight, due date, web URL, timestamps, and pagination metadata. See also:
group.group_milestone_get,group.group_milestone_merge_requests,issue.list_group.Required parameters:
group_id (string|integer),milestone_iid (integer)Fine-grained token:
Work Item: Readat group
Group Milestone Listread-onlygroup.group_milestone_listList milestones in a group with filtering and pagination. Returns: matching group milestones with state, dates, expiry, and pagination metadata. See also:
group.group_milestone_get,group.group_milestone_create,project.milestone_list.Required parameters:
group_id (string|integer)Fine-grained token:
Work Item: Readat group
Group Milestone Merge Requestsread-onlygroup.group_milestone_merge_requestsList merge requests assigned to a group milestone. Returns: assigned merge requests with IID, project, title, state, draft flag, merge status, source and target branches, labels, author, assignees, reviewers, web URL, timestamps, and pagination metadata. See also:
group.group_milestone_get,group.group_milestone_issues.Required parameters:
group_id (string|integer),milestone_iid (integer)Fine-grained token:
Work Item: Readat group
Group Milestone Updategroup.group_milestone_updateUpdate an existing group milestone. Returns: the updated milestone with state, dates, and expiry. See also:
group.group_milestone_get,group.group_milestone_list,group.group_milestone_delete.Required parameters:
group_id (string|integer),milestone_iid (integer)Fine-grained token:
Work Item: ReadandWork Item: Updateat group
List Group Relations Export Statusread-onlygroup.group_relations_list_statusList the status of a group's relations export, optionally filtered by relation. Returns: per-relation export status, error detail, batched flag, batch count, per-batch progress, and pagination metadata. See also:
group.group_relations_schedule,group.get.Required parameters:
group_id (string|integer)Fine-grained token:
Export: Readat group
Schedule Group Relations Exportgroup.group_relations_scheduleSchedule a new export of a group's relations (issues, labels, milestones, and more). Returns: a confirmation that the asynchronous export was scheduled. See also:
group.group_relations_list_status,group.get.Required parameters:
group_id (string|integer)Fine-grained token:
Export: Createat group
Delete Group Markdown Upload By IDdestructivegroup.group_upload_delete_by_idDelete a group Markdown upload by its numeric upload ID. Returns: a success confirmation. See also:
group.group_upload_list,group.group_upload_delete_by_secret.Required parameters:
group_id (string|integer),upload_id (integer)Fine-grained token:
Markdown Upload: Deleteat group
Delete Group Markdown Upload By Secretdestructivegroup.group_upload_delete_by_secretDelete a group Markdown upload by its 32-character secret and filename. Returns: a success confirmation. See also:
group.group_upload_list,group.group_upload_delete_by_id.Required parameters:
filename (string),group_id (string|integer),secret (string)Fine-grained token:
Markdown Upload: Deleteat group
List Group Markdown Uploadsread-onlygroup.group_upload_listList all Markdown uploads in a group. Returns: each upload's id, filename, size, creation time, and uploader (id, username, name, state, avatar, web URL), plus pagination metadata. See also:
group.group_upload_delete_by_id,group.group_upload_delete_by_secret,group.get.Required parameters:
group_id (string|integer)Fine-grained token:
Markdown Upload: Readat group
Group Invited Listread-onlygroup.invited_groupsList groups invited to a GitLab group. Returns: the invited groups with path and access metadata. See also:
group.shared_with,group.members,group.get.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Readat group
Issue List Groupread-onlygroup.issuesList issues across a group. Returns: matching issues from projects in the group with pagination metadata. See also:
issue.list,group.get,search.issues.Required parameters:
group_id (string|integer)Fine-grained token:
Work Item: Readat group
Group Listread-onlygroup.listList accessible GitLab groups with filtering and pagination. Returns: matching groups including path, name, and visibility metadata. See also:
group.get,group.search,group.create.Required parameters: No required parameters
Fine-grained token:
Group: Readat user
Group Members Listread-onlygroup.membersList the members of a GitLab group (direct and inherited). Returns: members with username, access level, and seat/role metadata. See also:
group.get,group.projects,group.group_member_add.Required parameters:
group_id (string|integer)Fine-grained token:
Member: Readat group
Group Projectsread-onlygroup.projectsList the projects in a GitLab group. Returns: compact project rows with names and paths, web and clone URLs, visibility, default branch, topics, star and fork counts, archived status, and created and last-activity times. See also:
group.get,group.subgroups,group.transfer_project.Required parameters:
group_id (string|integer)Fine-grained token:
Project: Readat group
Group Release Listread-onlygroup.release_listList releases across all projects in a group with pagination, ordering, and keyset support. Returns: tag names, release names, dates, author, commit, assets, milestones, evidences, and _links per release. See also:
group.get,release.list,release.get.Required parameters:
group_id (string|integer)Fine-grained token:
Release: Readat group
Group Restoregroup.restoreRestore a GitLab group marked for deletion. Returns: the restored group metadata. See also:
group.delete,group.get,group.list.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Updateat group
Group Searchread-onlygroup.searchSearch GitLab groups by name or path. Returns: matching groups with path, name, and visibility. See also:
group.list,group.get,group.create.Required parameters:
query (string)Fine-grained token:
Group: Readat user
Group Service Account Creategroup.service_account_createCreate a service account user in a group. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions. Omit email unless the task gives an explicit valid email address.
Required parameters:
group_id (string)Fine-grained token:
Service Account: Createat group
Group Service Account Deletedestructivegroup.service_account_deleteDelete a group service account user, optionally hard-deleting owned resources. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions.
Required parameters:
group_id (string),service_account_id (integer)Fine-grained token:
Service Account: Deleteat group
Group Service Account Getread-onlygroup.service_account_getGet one service account of a GitLab group by its user ID (GitLab 19.4 or later).
Returns: the service account with ID, name, username, email, public email, and the unconfirmed email when a change is pending. See also:
group.service_account_list,group.service_account_update,group.service_account_pat_list.Required parameters:
group_id (string),service_account_id (integer)Fine-grained token:
Service Account: Readat group
Group Service Account Listread-onlygroup.service_account_listList a group's service account users. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions.
Required parameters:
group_id (string)Fine-grained token:
Service Account: Readat group
Group Service Account Pat Creategroup.service_account_pat_createCreate a personal access token for a group service account. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions. Omit expires_at unless the task gives an explicit expiry date. If provided, use YYYY-MM-DD within the instance maximum token lifetime.
Required parameters:
group_id (string),name (string),scopes (array),service_account_id (integer)Fine-grained token:
Service Account Personal Access Token: Createat group
Group Service Account Pat Listread-onlygroup.service_account_pat_listList the personal access tokens of one group service account. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions.
Required parameters:
group_id (string),service_account_id (integer)Fine-grained token:
Service Account Personal Access Token: Readat group
Group Service Account Pat Revokedestructivegroup.service_account_pat_revokeRevoke one of a group service account's personal access tokens. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions.
Required parameters:
group_id (string),service_account_id (integer),token_id (integer)Fine-grained token:
Service Account Personal Access Token: Revokeat group
Group Service Account Pat Rotategroup.service_account_pat_rotateRotate a group service account's personal access token: revokes the supplied token_id and issues a replacement in one step (all tiers, Owner role).
Returns: the new personal access token object (id, name, scopes, active, revoked, created_at, expires_at, and the one-time token value, which must be captured immediately because it is not retrievable later).
See also:group.service_account_pat_create,group.service_account_pat_revoke,group.service_account_pat_list.Required parameters:
group_id (string),service_account_id (integer),token_id (integer)Fine-grained token:
Service Account Personal Access Token: Rotateat group
Group Service Account Updategroup.service_account_updateUpdate a group service account's name or username. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions. Omit email unless the task gives an explicit valid email address.
Required parameters:
group_id (string),service_account_id (integer)Fine-grained token:
Service Account: Updateat group
Subgroups Listread-onlygroup.subgroupsList the subgroups (descendant groups) of a GitLab group. Returns: descendant groups with path, name, and visibility. See also:
group.get,group.projects,group.transfer_locations.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Readat group
Group Transfergroup.transferTransfer a GitLab group under a new parent (or to top level), waiting up to 45 seconds for GitLab to apply the move. Returns: the group under its new parent, or with transfer_queued set and its current parent when GitLab has not applied the move yet, or an error when GitLab reports the move failed. See also:
group.transfer_locations,group.get,group.subgroups.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Transferat group
Group Transfer Locationsread-onlygroup.transfer_locationsList candidate parent groups for transferring a GitLab group. Returns: eligible destination groups with id, name, and full path. See also:
group.transfer_project,group.get,group.subgroups.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Readat group
Group Transfer Projectgroup.transfer_projectTransfer a project into a GitLab group namespace (administrators only). Returns: the destination group's metadata, not the project's. See also:
group.transfer_locations,group.get,group.projects.Required parameters:
group_id (string|integer),project_id (string|integer)Fine-grained token:
Project: Transferat instance
Group Unarchivegroup.unarchiveUnarchive a GitLab group (restore write access). Returns: a success confirmation. See also:
group.archive,group.get,group.update.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Archiveat group
Group Updategroup.updateUpdate a GitLab group's settings. Returns: the updated group metadata. See also:
group.get,group.create,group.delete.Required parameters:
group_id (string|integer)Fine-grained token:
Group: Updateat group
Group Upload Avatargroup.upload_avatarUpload or replace a GitLab group's avatar image. Returns: the updated group metadata. See also:
group.update,group.get,group.create.Required parameters:
filename (string),group_id (string|integer)Fine-grained token:
Group: Updateat group