# group — gitlab > 75 acciones > Esta página en markdown. Índice: https://mcp.jmrp.io/llms.txt Canonical: https://mcp.jmrp.io/es/servers/gitlab/actions/group/ Language: es Alternate: https://mcp.jmrp.io/servers/gitlab/actions/group/index.md Updated: 2026-09-11T09:56:41+02:00 License: https://mcp.jmrp.io/es/license/ Contado con un token Free contra gitlab.com, que es el único host con el que habla este endpoint: para usarlo contra una instancia self-managed, levanta tú el servidor — su documentación lo cubre. El catálogo depende del token que pregunta, así que el recuento se mueve con su tier y con sus permisos: los tiers superiores exponen más acciones, y los dominios de administración solo aparecen a tokens autorizados a usarlos. Por eso las cifras difieren en otros sitios: el proyecto upstream cataloga 1.006 acciones en 162 dominios, y 851 en la superficie Free/CE, mientras que este despliegue publica 747 porque es solo-OAuth y actúa con tu token, así que los dominios de administración que una cuenta sin admin no puede llamar no aparecen nunca. Las tres describen el mismo catálogo, contado desde tres sitios distintos. ## Acciones ### `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. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `image_url (string)`, `link_url (string)` ### `group.badge_delete` — Delete Group Badge _destructiva_ Delete a group badge by badge_id. Returns: a success confirmation. See also: group.badge_list, group.badge_get. **Parámetros obligatorios:** `badge_id (integer)`, `group_id (string)` ### `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. **Parámetros obligatorios:** `badge_id (integer)`, `group_id (string)` ### `group.badge_get` — Get Group Badge _solo lectura_ 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. **Parámetros obligatorios:** `badge_id (integer)`, `group_id (string)` ### `group.badge_list` — List Group Badges _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `group.badge_preview` — Preview Group Badge _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)`, `image_url (string)`, `link_url (string)` ### `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. **Parámetros obligatorios:** `name (string)` ### `group.delete` — Group Delete _destructiva_ Delete a GitLab group and its projects. Returns: a success confirmation. See also: group.restore, group.get, group.update. **Parámetros obligatorios:** `group_id (string)` ### `group.get` — Group Get _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `board_id (integer)`, `group_id (string)`, `label_id (integer)` ### `group.group_board_delete` — Group Board Delete _destructiva_ Delete a group issue board permanently. Returns: a success confirmation. See also: group.group_board_get, group.group_board_list. **Parámetros obligatorios:** `board_id (integer)`, `group_id (string)` ### `group.group_board_delete_list` — Group Board List Delete _destructiva_ 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. **Parámetros obligatorios:** `board_id (integer)`, `group_id (string)`, `list_id (integer)` ### `group.group_board_get` — Group Board Get _solo lectura_ 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. **Parámetros obligatorios:** `board_id (integer)`, `group_id (string)` ### `group.group_board_get_list` — Group Board List Get _solo lectura_ 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. **Parámetros obligatorios:** `board_id (integer)`, `group_id (string)`, `list_id (integer)` ### `group.group_board_list` — Group Board List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `group.group_board_list_lists` — Group Board List Lists _solo lectura_ 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. **Parámetros obligatorios:** `board_id (integer)`, `group_id (string)` ### `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. **Parámetros obligatorios:** `board_id (integer)`, `group_id (string)` ### `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. **Parámetros obligatorios:** `board_id (integer)`, `group_id (string)`, `list_id (integer)`, `position (integer)` ### `group.group_export_download` — Download Group Export _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `file (string)`, `name (string)`, `path (string)` ### `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. **Parámetros obligatorios:** `color (string)`, `group_id (string)`, `name (string)` ### `group.group_label_delete` — Group Label Delete _destructiva_ Delete a group label permanently. Returns: a success confirmation. See also: group.group_label_get, group.group_label_list. **Parámetros obligatorios:** `group_id (string)`, `label_id (string)` ### `group.group_label_get` — Group Label Get _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)`, `label_id (string)` ### `group.group_label_list` — Group Label List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `label_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `label_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `label_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `user_id (integer)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `user_id (integer)` ### `group.group_member_get` — Group Member Get _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)`, `user_id (integer)` ### `group.group_member_get_inherited` — Group Member Get Inherited _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)`, `user_id (integer)` ### `group.group_member_remove` — Group Member Remove _destructiva_ 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. **Parámetros obligatorios:** `group_id (string)`, `user_id (integer)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `share_group_id (integer)` ### `group.group_member_unshare` — Group Unshare _destructiva_ Revoke an existing group-to-group share (destructive, requires confirmation). Returns: a delete confirmation. See also: group.group_member_share, group.get, group.members. **Parámetros obligatorios:** `group_id (string)`, `share_group_id (integer)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `title (string)` ### `group.group_milestone_delete` — Group Milestone Delete _destructiva_ Delete a group milestone permanently. Returns: a success confirmation. See also: group.group_milestone_get, group.group_milestone_update. **Parámetros obligatorios:** `group_id (string)`, `milestone_iid (integer)` ### `group.group_milestone_get` — Group Milestone Get _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)`, `milestone_iid (integer)` ### `group.group_milestone_issues` — Group Milestone Issues _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)`, `milestone_iid (integer)` ### `group.group_milestone_list` — Group Milestone List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `group.group_milestone_merge_requests` — Group Milestone Merge Requests _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)`, `milestone_iid (integer)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `milestone_iid (integer)` ### `group.group_relations_list_status` — List Group Relations Export Status _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)` ### `group.group_upload_delete_by_id` — Delete Group Markdown Upload By ID _destructiva_ 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. **Parámetros obligatorios:** `group_id (string)`, `upload_id (integer)` ### `group.group_upload_delete_by_secret` — Delete Group Markdown Upload By Secret _destructiva_ 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. **Parámetros obligatorios:** `filename (string)`, `group_id (string)`, `secret (string)` ### `group.group_upload_list` — List Group Markdown Uploads _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `group.invited_groups` — Group Invited List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `group.issues` — Issue List Group _solo lectura_ List issues across a group. Returns: matching issues from projects in the group with pagination metadata. See also: issue.list, group.get, search.issues. **Parámetros obligatorios:** `group_id (string)` ### `group.list` — Group List _solo lectura_ 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. ### `group.members` — Group Members List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `group.projects` — Group Projects _solo lectura_ List the projects in a GitLab group. Returns: projects with path, visibility, and archived status. See also: group.get, group.subgroups, group.transfer_project. **Parámetros obligatorios:** `group_id (string)` ### `group.release_list` — Group Release List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `group.restore` — Group Restore Restore a GitLab group marked for deletion. Returns: the restored group metadata. See also: group.delete, group.get, group.list. **Parámetros obligatorios:** `group_id (string)` ### `group.search` — Group Search _solo lectura_ Search GitLab groups by name or path. Returns: matching groups with path, name, and visibility. See also: group.list, group.get, group.create. **Parámetros obligatorios:** `query (string)` ### `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. **Parámetros obligatorios:** `group_id (string)` ### `group.service_account_delete` — Group Service Account Delete _destructiva_ 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. **Parámetros obligatorios:** `group_id (string)`, `service_account_id (integer)` ### `group.service_account_list` — Group Service Account List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `name (string)`, `scopes (array)`, `service_account_id (integer)` ### `group.service_account_pat_list` — Group Service Account Pat List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)`, `service_account_id (integer)` ### `group.service_account_pat_revoke` — Group Service Account Pat Revoke _destructiva_ 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. **Parámetros obligatorios:** `group_id (string)`, `service_account_id (integer)`, `token_id (integer)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `service_account_id (integer)`, `token_id (integer)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `service_account_id (integer)` ### `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. **Parámetros obligatorios:** `group_access (integer)`, `group_id (string)`, `shared_group_id (integer)` ### `group.shared_projects` — Group Shared Projects List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `group.shared_with` — Group Shared With List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `group.subgroups` — Subgroups List _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)` ### `group.transfer_locations` — Group Transfer Locations _solo lectura_ 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. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `group_id (string)`, `project_id (string)` ### `group.unarchive` — Group Unarchive Unarchive a GitLab group (restore write access). Returns: a success confirmation. See also: group.archive, group.get, group.update. **Parámetros obligatorios:** `group_id (string)` ### `group.unshare_from_group` — Group Unshare From Group _destructiva_ Revoke a group-to-group share (Groups API). Returns: a success confirmation. See also: group.share_with_group, group.shared_with, group.get. **Parámetros obligatorios:** `group_id (string)`, `shared_group_id (integer)` ### `group.update` — Group Update Update a GitLab group's settings. Returns: the updated group metadata. See also: group.get, group.create, group.delete. **Parámetros obligatorios:** `group_id (string)` ### `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. **Parámetros obligatorios:** `filename (string)`, `group_id (string)`