summaryrefslogtreecommitdiff
path: root/doc/api
diff options
context:
space:
mode:
authorPatrick Bajao <ebajao@gitlab.com>2019-06-17 11:56:59 +0800
committerPatrick Bajao <ebajao@gitlab.com>2019-06-26 10:10:11 +0800
commit6aa0b173e240f7f27c2cc6d1d4c87b7688940283 (patch)
treec58fc49cbc9dbf806a975be3fd813f101d73cb0e /doc/api
parent550ac52b143b7d4b77203b81c1b92997c4c63e34 (diff)
downloadgitlab-ce-6aa0b173e240f7f27c2cc6d1d4c87b7688940283.tar.gz
Update related documentation
Update the newly added documentation to be more precise and fix the typos. Add information about Project aliases into permissions doc.
Diffstat (limited to 'doc/api')
-rw-r--r--doc/api/project_aliases.md20
1 files changed, 12 insertions, 8 deletions
diff --git a/doc/api/project_aliases.md b/doc/api/project_aliases.md
index 4456388c74f..20e4e844654 100644
--- a/doc/api/project_aliases.md
+++ b/doc/api/project_aliases.md
@@ -1,10 +1,12 @@
-# Project Aliases API
+# Project Aliases API **[PREMIUM ONLY]**
+
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/3264) in GitLab 12.1.
All methods require administrator authorization.
## List all project aliases
-Get a list of all project aliases
+Get a list of all project aliases:
```
GET /project_aliases
@@ -33,7 +35,7 @@ Example response:
## Get project alias' details
-Get details of a project alias
+Get details of a project alias:
```
GET /project_aliases/:name
@@ -57,9 +59,10 @@ Example response:
}
```
-## Create an alias for a project
+## Create a project alias
-Add a new alias for a project. Reponds with a 201 when successful, 400 when there are validation errors (e.g. alias already exists).
+Add a new alias for a project. Responds with a 201 when successful,
+400 when there are validation errors (e.g. alias already exists):
```
POST /project_aliases
@@ -67,7 +70,7 @@ POST /project_aliases
| Attribute | Type | Required | Description |
|--------------|--------|----------|-----------------------------------------------|
-| `project_id` | string | yes | The The ID or URL-encoded path of the project |
+| `project_id` | string | yes | The ID or URL-encoded path of the project. |
| `name` | string | yes | The name of the alias. Must be unique. |
```
@@ -84,9 +87,10 @@ Example response:
}
```
-## Delete a project aliase
+## Delete a project alias
-Removes a project aliases. Respond with a 204 when project alias exists, 404 when it doesn't.
+Removes a project aliases. Responds with a 204 when project alias
+exists, 404 when it doesn't:
```
DELETE /project_aliases/:name