GitLab API icon

GitLab API

Gitlab

Actions1062

Projects → deleteApiV4ProjectsIdShareGroupId

AI-generated

Summary

Remove a shared group from a GitLab project by specifying the project ID (or URL-encoded path) and the group ID to unshare from the project.

Inputs

  • id (required) — The ID or URL-encoded path of the GitLab project from which to remove the shared group.
  • group_id (required) — The ID of the group to be unshared from the specified project.
  • skipAuthentication — Optional boolean to skip authentication; defaults to false.
  • baseUrl — The base URL of the GitLab instance; defaults to https://gitlab.com.

Output shape

a response confirming deletion status, typically no body content assuming success

This operation issues a DELETE request to the /api/v4/projects/{id}/share/{group_id} endpoint. The response shape follows GitLab API conventions for DELETE operations, usually with no response body on success. Errors will follow standard API error handling.

Examples

Example 1: To unshare a group with ID 42 from project 'my-group/my-project', set `id` to 'my-group%2Fmy-project' and `group_id` to '42'. Execute this operation to remove the group's access to the project.

Set required path parameters 'id' and 'group_id'. Optionally adjust 'baseUrl' to target a self-hosted GitLab instance. Ensure authentication unless 'skipAuthentication' is enabled.

Links

Discussion