diff options
Diffstat (limited to 'doc/api/import.md')
-rw-r--r-- | doc/api/import.md | 12 |
1 files changed, 11 insertions, 1 deletions
diff --git a/doc/api/import.md b/doc/api/import.md index 78b9beb1815..7a1eb4fe8b3 100644 --- a/doc/api/import.md +++ b/doc/api/import.md @@ -8,7 +8,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w ## Import repository from GitHub -Import your projects from GitHub to GitLab via the API. +Import your projects from GitHub to GitLab using the API. ```plaintext POST /import/github @@ -61,6 +61,16 @@ Example response: } ``` +### Import a public project through the API using a group access token + +> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/362683) in GitLab 15.7, projects are not imported into a [bot user's](../user/group/settings/group_access_tokens.md#bot-users-for-groups) namespace in any circumstances. Projects imported into a bot user's namespace could not be deleted by users with valid tokens, which represented a security risk. + +When you import a project from GitHub to GitLab through the API using a group access +token: + +- The GitLab project inherits the original project's visibility settings. As a result, the project is publicly accessible if the original project is public. +- If the `path` or `target_namespace` does not exist, the project import fails. + ## Cancel GitHub project import > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/364783) in GitLab 15.5. |