GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation retrieves the transfer locations available for a specific project in GitLab via the GitLab API v4. It is useful for users who want to find out where a project can be transferred within GitLab namespaces. For example, a user managing multiple projects can use this operation to programmatically get possible transfer destinations for a project before initiating a transfer.

Use Case Examples

  1. Retrieve transfer locations for a project with ID '123' to see available namespaces for project transfer.
  2. Search transfer locations with a specific search term to filter namespaces.

Properties

Name Meaning
Skip Authentication If set to true, the node will skip 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, default is https://gitlab.com.
Method The HTTP method used for the request, default is GET.
Query Parameters Optional query parameters to filter and paginate the results, including search term, page number, and items per page.
Path Parameters Path parameters required for the request, specifically the project ID or URL-encoded path.

Output

JSON

  • id - The unique identifier of the transfer location namespace.
  • name - The name of the transfer location namespace.
  • path - The path of the transfer location namespace.
  • kind - The type of namespace (e.g., user or group).
  • full_path - The full path of the namespace.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the project ID provided in the path parameters is correct and accessible with the authenticated user.
  • Check that the GitLab API key credential is valid and has sufficient permissions to access project transfer locations.
  • If pagination parameters are used, verify that page and per_page values are within acceptable ranges to avoid empty or incomplete results.
  • Common error messages include 404 Not Found if the project ID does not exist or is not accessible, and 401 Unauthorized if authentication fails.

Links

Discussion