GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation fetches a list of namespaces from the GitLab API (v4). It is useful for retrieving namespaces that a user is authorized to view, with options to filter by ownership, top-level status, and search criteria. Practical applications include managing GitLab projects, organizing resources by namespace, or integrating namespace data into workflows.

Use Case Examples

  1. Retrieve all namespaces accessible to the authenticated user.
  2. Filter namespaces to only those owned by the user.
  3. Search namespaces by name or other criteria.

Properties

Name Meaning
Skip Authentication If true, the node will skip using authentication for the request.
Authentication The authentication method used for the API request, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request, defaulting to GET.
Query Parameters Optional filters and pagination parameters for the namespaces request.

Output

JSON

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

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the GitLab API key credential is correctly configured and has sufficient permissions to access namespaces.
  • Verify the baseUrl is correct and reachable.
  • 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