GitLab API icon

GitLab API

Gitlab

Actions1062

Groups → getApiV4GroupsIdProjects

AI-generated

Summary

Retrieve a list of projects within a specified GitLab group by its ID, applying optional filters and sorting parameters.

Inputs

  • id (required) — The ID of the GitLab group whose projects are to be retrieved.
  • archived — Filter projects by archived status (true or false).
  • visibility — Filter projects by visibility level (private, internal, or public).
  • search — Search projects by name matching the given string.
  • order_by — Field to order the projects by (e.g., created_at, name). Defaults to 'created_at'.
  • sort — Sort order direction (asc for ascending, desc for descending). Defaults to 'desc'.
  • simple — If true, returns a simplified response containing only ID, URL, name, and path for each project.
  • owned — If true, limits projects to those owned by the authenticated user.
  • starred — If true, limits to projects starred by the authenticated user.
  • with_issues_enabled — If true, only include projects with the issues feature enabled.
  • with_merge_requests_enabled — If true, only include projects with merge requests feature enabled.
  • with_shared — If true, include projects shared with this group. Defaults to true.
  • include_subgroups — If true, includes projects in subgroups of this group.
  • include_ancestor_groups — If true, includes projects in ancestor groups of this group.
  • min_access_level — Minimum access level required for the authenticated user on projects (e.g., 10, 15, 20, 30, 40, 50).
  • page — Page number for paginated results, default is 1.
  • per_page — Number of projects per page in paginated results, default is 20.
  • with_custom_attributes — If true, includes custom attributes in the projects response.
  • with_security_reports — If true, limits projects to those having security report artifacts present.

Output shape

a list of project objects

The operation returns a paginated list of projects under the specified group ID, filtered and sorted according to the provided query parameters. Each project object structure varies based on the 'simple' parameter and other filters applied.

Links

Discussion