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 · actions13 · destructive32 · read-only

Counted with a Free-tier GitLab token. 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.

Back to the server card

group.archiveGroup Archive
Archive 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)
group.badge_addAdd Group Badge
Add 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), image_url (string), link_url (string)
group.badge_deleteDelete Group Badgedestructive
Delete 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)
group.badge_editEdit Group Badge
Edit 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)
group.badge_getGet Group Badgeread-only
Get 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)
group.badge_listList Group Badgesread-only
List 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)
group.badge_previewPreview Group Badgeread-only
Preview 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), image_url (string), link_url (string)
group.createGroup Create
Create 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)
group.deleteGroup Deletedestructive
Delete a GitLab group and its projects. Returns: a success confirmation. See also: group.restore, group.get, group.update.
Required parameters: group_id (string)
group.getGroup Getread-only
Get 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)
group.group_board_create_listGroup Board List Create
Create 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), label_id (integer)
group.group_board_deleteGroup Board Deletedestructive
Delete a group issue board permanently. Returns: a success confirmation. See also: group.group_board_get, group.group_board_list.
Required parameters: board_id (integer), group_id (string)
group.group_board_delete_listGroup Board List Deletedestructive
Delete 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), list_id (integer)
group.group_board_getGroup Board Getread-only
Get 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)
group.group_board_get_listGroup Board List Getread-only
Get 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), list_id (integer)
group.group_board_listGroup Board Listread-only
List 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)
group.group_board_list_listsGroup Board List Listsread-only
List 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)
group.group_board_updateGroup Board Update
Update a group issue board's name and 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)
group.group_board_update_listGroup Board List Update
Reorder 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), list_id (integer), position (integer)
group.group_export_downloadDownload Group Exportread-only
Download 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)
group.group_export_scheduleSchedule Group Export
Schedule 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)
group.group_import_fileImport Group From File
Import 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)
group.group_label_createGroup Label Create
Create a new group label. Returns: the created label with id, name, color, text color, description, counts, priority, and subscription state. See also: group.group_label_list, group.group_label_get, group.group_label_update.
Required parameters: color (string), group_id (string), name (string)
group.group_label_deleteGroup Label Deletedestructive
Delete a group label permanently. Returns: a success confirmation. See also: group.group_label_get, group.group_label_list.
Required parameters: group_id (string), label_id (string)
group.group_label_getGroup Label Getread-only
Get a single group label by ID or name. Returns: the label with color, text color, description, issue and merge request counts, priority, and subscription state. See also: group.group_label_list, group.group_label_update, group.group_label_delete.
Required parameters: group_id (string), label_id (string)
group.group_label_listGroup Label Listread-only
List labels in a group with filtering and pagination. Returns: matching labels with color, text color, description, issue and merge request counts, priority, subscription state, and pagination metadata. See also: group.group_label_get, group.group_label_create, group.get.
Required parameters: group_id (string)
group.group_label_subscribeGroup Label Subscribe
Subscribe 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), label_id (string)
group.group_label_unsubscribeGroup Label Unsubscribe
Unsubscribe 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), label_id (string)
group.group_label_updateGroup Label Update
Update a group label. Returns: the updated label with id, name, color, text color, description, counts, priority, and subscription state. See also: group.group_label_get, group.group_label_list, group.group_label_delete.
Required parameters: group_id (string), label_id (string)
group.group_member_addGroup Member Add
Add 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), user_id (integer)
group.group_member_editGroup Member Edit
Edit 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), user_id (integer)
group.group_member_getGroup Member Getread-only
Get 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), user_id (integer)
group.group_member_get_inheritedGroup Member Get Inheritedread-only
Get 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), user_id (integer)
group.group_member_removeGroup Member Removedestructive
Remove 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), user_id (integer)
group.group_member_shareGroup Share
Share a group with another group at a chosen access level. Returns: the shared group's id, name, path, and web URL. See also: group.group_member_unshare, group.get, group.members.
Required parameters: group_id (string), share_group_id (integer)
group.group_member_unshareGroup Unsharedestructive
Revoke an existing group-to-group share (destructive, requires confirmation). Returns: a delete confirmation. See also: group.group_member_share, group.get, group.members.
Required parameters: group_id (string), share_group_id (integer)
group.group_milestone_createGroup Milestone Create
Create 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), title (string)
group.group_milestone_deleteGroup Milestone Deletedestructive
Delete a group milestone permanently. Returns: a success confirmation. See also: group.group_milestone_get, group.group_milestone_update.
Required parameters: group_id (string), milestone_iid (integer)
group.group_milestone_getGroup Milestone Getread-only
Get 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), milestone_iid (integer)
group.group_milestone_issuesGroup Milestone Issuesread-only
List issues assigned to a group milestone. Returns: assigned issues with state, web URL, and pagination metadata. See also: group.group_milestone_get, group.group_milestone_merge_requests, issue.list_group.
Required parameters: group_id (string), milestone_iid (integer)
group.group_milestone_listGroup Milestone Listread-only
List 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)
group.group_milestone_merge_requestsGroup Milestone Merge Requestsread-only
List merge requests assigned to a group milestone. Returns: assigned merge requests with state, source and target branches, and pagination metadata. See also: group.group_milestone_get, group.group_milestone_issues.
Required parameters: group_id (string), milestone_iid (integer)
group.group_milestone_updateGroup Milestone Update
Update 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), milestone_iid (integer)
group.group_relations_list_statusList Group Relations Export Statusread-only
List 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)
group.group_relations_scheduleSchedule Group Relations Export
Schedule 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)
group.group_upload_delete_by_idDelete Group Markdown Upload By IDdestructive
Delete 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), upload_id (integer)
group.group_upload_delete_by_secretDelete Group Markdown Upload By Secretdestructive
Delete 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), secret (string)
group.group_upload_listList Group Markdown Uploadsread-only
List 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)
group.invited_groupsGroup Invited Listread-only
List 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)
group.issuesIssue List Groupread-only
List 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)
group.listGroup Listread-only
List 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
group.membersGroup Members Listread-only
List 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)
group.projectsGroup Projectsread-only
List the projects in a GitLab group. Returns: projects with path, visibility, and archived status. See also: group.get, group.subgroups, group.transfer_project.
Required parameters: group_id (string)
group.release_listGroup Release Listread-only
List 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)
group.restoreGroup Restore
Restore a GitLab group marked for deletion. Returns: the restored group metadata. See also: group.delete, group.get, group.list.
Required parameters: group_id (string)
group.searchGroup Searchread-only
Search 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)
group.service_account_createGroup Service Account Create
Create 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)
group.service_account_deleteGroup Service Account Deletedestructive
Delete 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)
group.service_account_listGroup Service Account Listread-only
List 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)
group.service_account_pat_createGroup Service Account Pat Create
Create 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)
group.service_account_pat_listGroup Service Account Pat Listread-only
List 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)
group.service_account_pat_revokeGroup Service Account Pat Revokedestructive
Revoke 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)
group.service_account_pat_rotateGroup Service Account Pat Rotate
Rotate 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)
group.service_account_updateGroup Service Account Update
Update 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)
group.share_with_groupGroup Share With Group
Share a GitLab group with another group (Groups API). Returns: a confirmation with the granted access role. See also: group.shared_with, group.unshare_from_group, group.get.
Required parameters: group_access (integer), group_id (string), shared_group_id (integer)
group.shared_projectsGroup Shared Projects Listread-only
List projects shared with a GitLab group. Returns: shared projects with path, visibility, and archived status. See also: group.projects, group.shared_with, group.get.
Required parameters: group_id (string)
group.shared_withGroup Shared With Listread-only
List groups shared with a GitLab group (group-to-group shares). Returns: the shared groups with path, visibility, and access metadata. See also: group.invited_groups, group.members, group.subgroups.
Required parameters: group_id (string)
group.subgroupsSubgroups Listread-only
List 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)
group.transferGroup Transfer
Transfer a GitLab group under a new parent (or to top level). Returns: the updated group metadata. See also: group.transfer_locations, group.get, group.subgroups.
Required parameters: group_id (string)
group.transfer_locationsGroup Transfer Locationsread-only
List 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)
group.transfer_projectGroup Transfer Project
Transfer a project into a GitLab group namespace. Returns: the updated project metadata. See also: group.transfer_locations, group.get, group.projects.
Required parameters: group_id (string), project_id (string)
group.unarchiveGroup Unarchive
Unarchive a GitLab group (restore write access). Returns: a success confirmation. See also: group.archive, group.get, group.update.
Required parameters: group_id (string)
group.unshare_from_groupGroup Unshare From Groupdestructive
Revoke a group-to-group share (Groups API). Returns: a success confirmation. See also: group.share_with_group, group.shared_with, group.get.
Required parameters: group_id (string), shared_group_id (integer)
group.updateGroup Update
Update a GitLab group's settings. Returns: the updated group metadata. See also: group.get, group.create, group.delete.
Required parameters: group_id (string)
group.upload_avatarGroup Upload Avatar
Upload 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)