summaryrefslogtreecommitdiff
path: root/doc/api
diff options
context:
space:
mode:
authorJames Lopez <james@jameslopez.es>2018-02-13 15:04:19 +0100
committerJames Lopez <james@jameslopez.es>2018-02-13 15:25:49 +0100
commit17e5ef4b269f4c13d22bd5c10086c6226dc43543 (patch)
treeb0d7a27ad328adcd06ac0a204f0dbba62c0222bc /doc/api
parentde83f29a3506af01af31c6668640fbb2a0dd54a9 (diff)
downloadgitlab-ce-17e5ef4b269f4c13d22bd5c10086c6226dc43543.tar.gz
add docs and changelog
Diffstat (limited to 'doc/api')
-rw-r--r--doc/api/project_import_export.md72
1 files changed, 72 insertions, 0 deletions
diff --git a/doc/api/project_import_export.md b/doc/api/project_import_export.md
new file mode 100644
index 00000000000..c594db7d7f2
--- /dev/null
+++ b/doc/api/project_import_export.md
@@ -0,0 +1,72 @@
+# Project import API
+
+[Introduced][ce-41899] in GitLab 10.6
+
+[Project import/export](../user/project/settings/import_export.md)
+
+## Import a file
+
+```http
+POST /projects/import
+```
+
+| Attribute | Type | Required | Description |
+| --------- | -------------- | -------- | ---------------------------------------- |
+| `namespace` | integer/string | no | The ID or path of the namespace that the project will be imported to. Defaults to the user's namespace |
+| `file` | string | yes | The file to be uploaded |
+| `path` | string | yes | Name and path for new project |
+
+To upload a file from your filesystem, use the `--form` argument. This causes
+cURL to post data using the header `Content-Type: multipart/form-data`.
+The `file=` parameter must point to a file on your filesystem and be preceded
+by `@`. For example:
+
+```console
+curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" -F "path=api-project" -F "file=@/path/to/file" https://gitlab.example.com/api/v4/projects/import
+```
+
+```json
+{
+ "id": 1,
+ "description": null,
+ "name": "api-project",
+ "name_with_namespace": "Administrator / api-project",
+ "path": "api-project",
+ "path_with_namespace": "root/api-project",
+ "created_at": "2018-02-13T09:05:58.023Z",
+ "import_status": "scheduled"
+}
+```
+
+## Import status
+
+Get the status of export.
+
+```http
+GET /projects/:id/import
+```
+
+| Attribute | Type | Required | Description |
+| --------- | -------------- | -------- | ---------------------------------------- |
+| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
+
+```console
+curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v4/projects/1/import
+```
+
+Status can be one of `none`, `started`, or `finished`.
+
+```json
+{
+ "id": 1,
+ "description": "Itaque perspiciatis minima aspernatur corporis consequatur.",
+ "name": "Gitlab Test",
+ "name_with_namespace": "Gitlab Org / Gitlab Test",
+ "path": "gitlab-test",
+ "path_with_namespace": "gitlab-org/gitlab-test",
+ "created_at": "2017-08-29T04:36:44.383Z",
+ "import_status": "started"
+}
+```
+
+[ce-41899]: https://gitlab.com/gitlab-org/gitlab-ce/issues/41899