GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation fetches a list of projects from the GitLab API (version 4). It allows users to retrieve projects with various filtering and sorting options, such as ordering by creation date, filtering by visibility, archived status, ownership, and more. This is useful for scenarios where you want to programmatically access project data from GitLab for reporting, automation, or integration purposes.

Use Case Examples

  1. Retrieve all public projects sorted by creation date descending.
  2. Fetch projects owned by the authenticated user that have issues enabled.
  3. Get projects filtered by a specific programming language and with merge requests enabled.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request.
baseUrl The base URL of the GitLab instance to connect to, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Query Parameters Collection of optional query parameters to filter and sort the projects list, such as order_by, sort, archived, visibility, search, owned, starred, membership, and pagination options.

Output

JSON

  • projects - Array of project objects returned from the GitLab API, each containing project details as per the API response.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the GitLab API credential is correctly configured and has sufficient permissions to access the projects.
  • Verify the baseUrl is correct and accessible from the n8n instance.
  • Check that query parameters are valid and conform to the expected types and values to avoid API errors.
  • If skipping authentication, ensure the GitLab instance allows unauthenticated access to the requested projects.

Links

Discussion