GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation allows users to perform bulk imports in GitLab by sending a POST request to the /api/v4/bulk_imports endpoint. It is useful for migrating groups or projects from a source GitLab instance to a destination namespace within GitLab. Typical use cases include automating the migration of multiple entities such as groups or projects, including their memberships and nested projects, from one GitLab instance to another.

Use Case Examples

  1. Migrating multiple groups from a source GitLab instance to a destination namespace in a target GitLab instance.
  2. Automating the import of projects with their memberships and nested projects from an external GitLab source.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the request.
baseUrl The base URL of the GitLab instance to which the request is sent.
Method HTTP method to use for the request, default is GET but POST is used for this operation.
Parameter Schema Defines the parameters required for the bulk import operation, including source URL, access token, and entity details such as source type, source path, destination namespace, slug, and migration options.

Output

JSON

  • id - The unique identifier of the bulk import job.
  • status - The current status of the bulk import job.
  • created_at - Timestamp when the bulk import job was created.
  • updated_at - Timestamp when the bulk import job was last updated.
  • entities - Details about the entities being imported, including their source and destination information.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the source GitLab instance URL and access token are correct and have sufficient permissions.
  • Verify that the entities array includes valid source types and paths.
  • Check that the destination namespace exists and is accessible.
  • Common errors include authentication failures, invalid parameters, or permission issues. Verify credentials and parameter formats to resolve these.

Links

Discussion