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 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 catalogues 1,006 actions across 162 domains, and 851 on the Free/CE surface, while this deployment publishes 747 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.

Back to the server card

1. group.archive

   Group 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)

2. group.badge_add

   Add 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)

3. group.badge_delete

   Delete 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)

4. group.badge_edit

   Edit 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)

5. group.badge_get

   Get 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)

6. group.badge_list

   List 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)

7. group.badge_preview

   Preview 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)

8. group.create

   Group 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)

9. group.delete

   Group 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)

10. group.get

    Group 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)

11. group.group_board_create_list

    Group 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)

12. group.group_board_delete

    Group 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)

13. group.group_board_delete_list

    Group 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)

14. group.group_board_get

    Group 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)

15. group.group_board_get_list

    Group 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)

16. group.group_board_list

    Group 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)

17. group.group_board_list_lists

    Group 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)

18. group.group_board_update

    Group 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)

19. group.group_board_update_list

    Group 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)

20. group.group_export_download

    Download 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)

21. group.group_export_schedule

    Schedule 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)

22. group.group_import_file

    Import 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)

23. group.group_label_create

    Group 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)

24. group.group_label_delete

    Group 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)

25. group.group_label_get

    Group 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)

26. group.group_label_list

    Group 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)

27. group.group_label_subscribe

    Group 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)

28. group.group_label_unsubscribe

    Group 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)

29. group.group_label_update

    Group 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)

30. group.group_member_add

    Group 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)

31. group.group_member_edit

    Group 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)

32. group.group_member_get

    Group 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)

33. group.group_member_get_inherited

    Group 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)

34. group.group_member_remove

    Group 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)

35. group.group_member_share

    Group 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)

36. group.group_member_unshare

    Group 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)

37. group.group_milestone_create

    Group 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)

38. group.group_milestone_delete

    Group 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)

39. group.group_milestone_get

    Group 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)

40. group.group_milestone_issues

    Group 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)

41. group.group_milestone_list

    Group 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)

42. group.group_milestone_merge_requests

    Group 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)

43. group.group_milestone_update

    Group 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)

44. group.group_relations_list_status

    List 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)

45. group.group_relations_schedule

    Schedule 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)

46. group.group_upload_delete_by_id

    Delete 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)

47. group.group_upload_delete_by_secret

    Delete 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)

48. group.group_upload_list

    List 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)

49. group.invited_groups

    Group 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)

50. group.issues

    Issue 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)

51. group.list

    Group 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

52. group.members

    Group 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)

53. group.projects

    Group 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)

54. group.release_list

    Group 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)

55. group.restore

    Group 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)

56. group.search

    Group 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)

57. group.service_account_create

    Group 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)

58. group.service_account_delete

    Group 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)

59. group.service_account_list

    Group 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)

60. group.service_account_pat_create

    Group 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)

61. group.service_account_pat_list

    Group 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)

62. group.service_account_pat_revoke

    Group 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)

63. group.service_account_pat_rotate

    Group 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)

64. group.service_account_update

    Group 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)

65. group.share_with_group

    Group 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)

66. group.shared_projects

    Group 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)

67. group.shared_with

    Group 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)

68. group.subgroups

    Subgroups 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)

69. group.transfer

    Group 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)

70. group.transfer_locations

    Group 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)

71. group.transfer_project

    Group 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)

72. group.unarchive

    Group 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)

73. group.unshare_from_group

    Group 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)

74. group.update

    Group 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)

75. group.upload_avatar

    Group 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)