GitLab API icon

GitLab API

Gitlab

Actions880

Overview

This node operation retrieves a list of namespaces from the GitLab API (v4). It is useful for scenarios where you need to fetch namespaces that a user is authorized to view, filter namespaces based on ownership, or paginate through namespaces. For example, it can be used to display namespaces in a user interface or to automate workflows involving GitLab namespaces.

Use Case Examples

  1. Fetch all namespaces accessible to the authenticated user.
  2. Retrieve only namespaces owned by the user.
  3. Get top-level namespaces with pagination support.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the request.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance to send the request to.
Method HTTP method to use for the request, default is GET.
Query Parameters Collection of optional query parameters to filter and paginate the namespaces list.

Output

JSON

  • id - Unique identifier of the namespace.
  • name - Name of the namespace.
  • path - Path of the namespace.
  • kind - Type of namespace (e.g., user, group).
  • full_path - Full path of the namespace.
  • parent_id - ID of the parent namespace if applicable.
  • avatar_url - URL of the namespace avatar image.
  • web_url - Web URL to access the namespace.

Dependencies

  • GitLab API authentication

Troubleshooting

  • Ensure the GitLab API credentials are correctly configured and have the necessary permissions to access namespaces.
  • Verify the baseUrl is correct and accessible from the environment where the node runs.
  • Check query parameters for correct data types and valid values to avoid API errors.

Links

Discussion