imports

Start a group or project migration

Starts a group or project migration. To migrate a project, specify entities[project_entity].

post/api/v4/bulk_imports

Request

  • Base URL
    https://gitlab.com
  • Auth
    none declared

Request body application/x-www-form-urlencoded

configuration[url]string required

Source GitLab instance URL

configuration[access_token]string required

Access token to the source GitLab instance

entities[source_type]string[] required

Source entity type

entities[source_full_path]string[] required

Relative path of the source entity to import

entities[destination_namespace]string[] required

Destination namespace for the entity

entities[destination_slug]string[]

Destination slug for the entity

entities[destination_name]string[]

Deprecated: Use :destination_slug instead. Destination slug for the entity

entities[migrate_projects]boolean[]

Indicates group migration should include nested projects

entities[migrate_memberships]boolean[]

The option to migrate memberships or not

Response

Start a group or project migration

idinteger required
status'created' | 'started' | 'finished' | 'timeout' | 'failed' required
source_typestring required
source_urlstring required
created_atstring date-time required
updated_atstring date-time required
has_failuresboolean required

Example response

{
  "id": 1,
  "status": "finished",
  "source_type": "gitlab",
  "source_url": "https://source.gitlab.com/",
  "created_at": "2012-05-28T04:42:42-07:00",
  "updated_at": "2012-05-28T04:42:42-07:00"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.