GitLab API

GitlabTool

Actions1095

Groups → getApiV4GroupsIdProjects

AI-generated

Summary

Retrieves a paginated list of projects belonging to a specific GitLab group using the GitLab API V4.

Inputs

  • id (required) — The ID of the target GitLab group.
  • archived — Limit results to archived status.
  • visibility — Limit by visibility: private, internal, or public.
  • search — Return projects matching the search criteria.
  • order_by — Sort results by a field (default: created_at).
  • sort — Sort direction: asc or desc (default: desc).
  • simple — Return only ID, URL, name, and path.
  • owned — Limit to projects owned by the authenticated user.
  • starred — Limit to projects starred by the authenticated user.
  • with_issues_enabled — Limit by enabled issues feature.
  • with_merge_requests_enabled — Limit by enabled merge requests feature.
  • with_shared — Include projects shared to this group (default: true).
  • include_subgroups — Include projects in subgroups of the group.
  • include_ancestor_groups — Include projects in ancestors of the group.
  • min_access_level — Limit by minimum access level of the authenticated user.
  • page — Current page number for pagination (default: 1).
  • per_page — Number of items per page (default: 20).
  • with_custom_attributes — Include custom attributes in the response.
  • with_security_reports — Return only projects having security report artifacts present.

Output shape

a list of items

The response follows the GitLab API V4 specification; pagination is handled by the node, but additional fields depend on the 'simple' and visibility filters.

Examples

Example 1: List all public projects in a group and its subgroups

Set 'id' to the group ID, 'visibility' to 'public', 'include_subgroups' to true, and 'simple' to false.

Example 2: Search for owned projects within a specific group

Set 'id' to the group ID, 'owned' to true, and 'search' to a keyword.

Links

Discussion