GitLab API icon

GitLab API

Gitlab

Actions1062

Groups → getApiV4GroupsIdProjectsShared

AI-generated

Summary

Retrieve the list of projects shared with a GitLab group by specifying the group's ID and optional filtering, sorting, and pagination parameters.

Inputs

  • id (required) — The ID of the GitLab group whose shared projects are to be fetched.
  • archived — Filter projects by archived status (true or false).
  • visibility — Filter projects by visibility: private, internal, or public.
  • search — Search query to return only authorized projects matching the criteria.
  • order_by — Field to order the projects by, such as created_at, id, name, etc. Defaults to created_at.
  • sort — Sort order of the returned projects: ascending (asc) or descending (desc). Defaults to desc.
  • simple — If true, returns only id, URL, name, and path of each project.
  • starred — Filter projects by starred status (true or false).
  • with_issues_enabled — Filter projects that have the issues feature enabled.
  • with_merge_requests_enabled — Filter projects that have the merge requests feature enabled.
  • min_access_level — Minimum access level of the authenticated user on the projects. One of 10, 15, 20, 30, 40, or 50.
  • page — Page number for pagination; defaults to 1.
  • per_page — Number of projects per page; defaults to 20.
  • with_custom_attributes — Include custom attributes in the response if true.

Output shape

a list of project objects shared with the specified group

Supports pagination with 'page' and 'per_page' query parameters; returned projects can be filtered and sorted according to provided query parameters. The response shape varies if 'simple' is true, limiting fields to id, URL, name, and path.

Examples

Example 1: Retrieve all public projects shared with group ID '12345', sorted by last activity descending.

Set 'id' to '12345', 'visibility' to 'public', 'order_by' to 'last_activity_at', and 'sort' to 'desc'.

Links

Discussion