import.md 911 Bytes
Newer Older
Ben's avatar
Ben committed
1 2 3 4 5 6
# Import API

## Import repository from GitHub

Import your projects from GitHub to GitLab via the API.

Amy Qualls's avatar
Amy Qualls committed
7
```plaintext
Ben's avatar
Ben committed
8 9 10 11 12 13 14
POST /import/github
```

| Attribute  | Type    | Required | Description         |
|------------|---------|----------|---------------------|
| `personal_access_token`       | string | yes      | GitHub personal access token |
| `repo_id`   | integer | yes      | GitHub repository ID     |
15 16
| `new_name`   | string | no      | New repository name     |
| `target_namespace`   | string | yes      | Namespace to import repository into     |
Ben's avatar
Ben committed
17

18
```shell
Greg Myers's avatar
Greg Myers committed
19
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --data "personal_access_token=abc123&repo_id=12345&target_namespace=root" "https://gitlab.example.com/api/v4/import/github"
Ben's avatar
Ben committed
20 21 22 23 24 25 26 27 28 29 30 31
```

Example response:

```json
{
    "id": 27,
    "name": "my-repo",
    "full_path": "/root/my-repo",
    "full_name": "Administrator / my-repo"
}
```