GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation retrieves projects within a specified GitLab group using the GitLab API v4. It is useful for scenarios where users want to list or filter projects belonging to a particular group, such as managing group projects, auditing, or integrating project data into workflows. For example, a user can fetch all public projects in a group or filter projects by ownership or activity status.

Use Case Examples

  1. Fetch all projects in a GitLab group by group ID.
  2. Retrieve only public projects within a group.
  3. Get projects filtered by archived status or with specific features enabled.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
baseUrl Base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request (GET, POST, PUT, DELETE, HEAD, PATCH).
Query Parameters Collection of optional query parameters to filter and customize the projects list, such as archived status, visibility, search term, ordering, pagination, and feature flags.
Path Parameters Path parameter specifying the group ID to retrieve projects from.

Output

JSON

  • id - Project ID.
  • name - Project name.
  • path - Project path.
  • visibility - Project visibility level (private, internal, public).
  • archived - Whether the project is archived.
  • created_at - Project creation timestamp.
  • last_activity_at - Timestamp of the last activity in the project.
  • star_count - Number of stars the project has received.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the group ID path parameter is correctly provided; missing or incorrect ID will cause request failures.
  • Verify that the authentication token has sufficient permissions to access group projects.
  • Check the base URL if using a self-hosted GitLab instance to avoid connection errors.
  • Invalid query parameter values may result in API errors; use valid enums and types as specified.

Links

Discussion