GitLab API

GitlabTool

Actions1095

Project_import → postApiV4ProjectsRemoteImport

AI-generated

Summary

Create a new GitLab project by importing it from a remote repository URL.

Inputs

  • url (required) — The URL of the remote file or repository to import.
  • path (required) — The new project path and name in GitLab.
  • name — The project name; defaults to the path if not provided.
  • namespace — Namespace ID or name where the project will be imported; defaults to the current user's namespace.
  • overwrite — Whether to overwrite an existing project in the same namespace with the same name.
  • override_params — An object containing optional project settings and access level configurations to override defaults during import, such as description, visibility, pipeline settings, access levels for features, and more.

Output shape

An object representing the imported GitLab project details as returned by the GitLab API upon successful import.

Returns the full project data from GitLab's remote import endpoint at /api/v4/projects/remote-import. All parameters are sent as form data, and many optional project configuration overrides are supported. Authentication via GitLab API credentials is required unless skipped.

Examples

Example 1: Import a remote Git repository as a new project

Specify the remote URL and desired path; optionally set project name and override settings like description or visibility.

Links

Discussion