# Start a new GitLab Migration

**POST /bulk_imports**

This feature was introduced in GitLab 14.2.


## Servers
- https://www.gitlab.com/api/v4: https://www.gitlab.com/api/v4 ()


## Authentication methods
- Api key auth


## Parameters



### Body: application/x-www-form-urlencoded (object)

- **configuration[url]** (string)
  Source GitLab instance URL
- **configuration[access_token]** (string)
  Access token to the source GitLab instance
- **entities[source_type]** (array[string])
  Source entity type
- **entities[source_full_path]** (array[string])
  Relative path of the source entity to import
- **entities[destination_namespace]** (array[string])
  Destination namespace for the entity
- **entities[destination_slug]** (array[string])
  Destination slug for the entity
- **entities[destination_name]** (array[string])
  Deprecated: Use :destination_slug instead. Destination slug for the entity
- **entities[migrate_projects]** (array[boolean])
  Indicates group migration should include nested projects


## Responses
### 200
Start a new GitLab Migration

#### Body: application/json (object)
- **id** (integer(int32))

- **status** (string)

- **source_type** (string)

- **created_at** (string(date-time))

- **updated_at** (string(date-time))


### 400
Bad request

### 401
Unauthorized

### 404
Not found

### 422
Unprocessable entity

### 503
Service unavailable


[Powered by Bump.sh](https://bump.sh)