GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation allows importing a group into GitLab using the GitLab API. It is useful for automating the process of importing group data from an export file into a GitLab instance, which can be beneficial for migrating groups or restoring backups. For example, a user can upload a group export file and specify the group path and name to import the group into their GitLab namespace or a specified parent group.

Use Case Examples

  1. Import a group export file to restore a group in GitLab.
  2. Migrate a group from one GitLab instance to another by importing the export file.

Properties

Name Meaning
Skip Authentication Determines whether to skip 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 request is sent.
Method The HTTP method used for the API request, defaulting to GET but can be set to POST for this operation.
Parameter Schema Defines the parameters required for the group import operation, including group path, name, export file, optional parent group ID, and optional organization ID.

Output

JSON

  • id - The unique identifier of the imported group.
  • name - The name of the imported group.
  • path - The path of the imported group.
  • parent_id - The ID of the parent group if specified.
  • organization_id - The ID of the organization the group belongs to, if specified.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the export file is correctly formatted and valid for import to avoid errors.
  • Verify that the specified parent group ID exists and the user has permission to import into it.
  • Check that the base URL is correct and accessible.
  • Authentication errors may occur if the API key is invalid or missing.

Links

Discussion