GitLab API

GitlabTool
Join our community

Actions905

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 by ownership, or limit results to top-level namespaces. Practical examples include automating project organization, managing user permissions, or integrating GitLab namespace data into other workflows.

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 for organizational overview.

Properties

Name Meaning
Skip Authentication If set to true, the node will skip using authentication for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the API requests are sent.
Method The HTTP method used for the API request, defaulting to 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 nested.
  • avatar_url - URL to the avatar image of the namespace.
  • web_url - Web URL to access the namespace in GitLab.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the GitLab API key credential is correctly configured and has sufficient permissions to access namespaces.
  • Verify the baseUrl is correct and accessible from the network where the node runs.
  • Check query parameters for correct types and valid values to avoid API errors.
  • Common error messages include authentication failures (401 Unauthorized) and invalid parameter errors (400 Bad Request). Resolving these involves verifying credentials and parameter formats.

Links

Discussion