GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation performs a PUT request to transfer a GitLab project to a new namespace. It is useful for automating project management tasks within GitLab, such as reorganizing projects by moving them between groups or namespaces. For example, a user can automate transferring a project to a different team or department namespace without manual intervention via the GitLab web interface.

Use Case Examples

  1. Automate transferring a project to a new namespace when organizational changes occur.
  2. Batch transfer multiple projects to a new group using workflow automation.

Properties

Name Meaning
Skip Authentication If true, the node skips authentication for the request.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, defaulting to GET but here it is PUT for the transfer operation.
Path Parameters Parameters included in the request path, specifically the project ID or URL-encoded path to identify the project to transfer.

Output

JSON

  • id - The ID or URL-encoded path of the project being transferred.
  • transferStatus - Status or result of the transfer operation returned by the GitLab API.

Dependencies

  • GitLab API authentication token

Troubleshooting

  • Ensure the project ID provided in the path parameters is correct and URL-encoded if necessary.
  • Verify that the authentication token has sufficient permissions to transfer projects in GitLab.
  • Check the baseUrl if using a self-hosted GitLab instance to ensure it is correct.
  • Common error messages may include authorization errors if the token lacks permissions, or 404 errors if the project ID is invalid or the project does not exist.

Links

Discussion