diff options
author | Achilleas Pipinellis <axilleas@axilleas.me> | 2016-01-24 22:23:56 +0300 |
---|---|---|
committer | Achilleas Pipinellis <axilleas@axilleas.me> | 2016-01-24 22:23:56 +0300 |
commit | df4d6768119418618ea5473ba4d4e707c5df4cdd (patch) | |
tree | f4fa2eb43fcd50be6bd03db7d7ef26721045661d /doc/api | |
parent | 28c14ceaa2105535b36c0e4898ed477724c9f5e6 (diff) | |
parent | 2b3e64a6015bcb9a2bf365dcab148d5024833d91 (diff) |
Merge branch 'doc_refactor_namespaces_api' into 'master'
Refactor namespaces API documentation
See merge request !2472
Diffstat (limited to 'doc/api')
-rw-r--r-- | doc/api/namespaces.md | 40 |
1 files changed, 33 insertions, 7 deletions
diff --git a/doc/api/namespaces.md b/doc/api/namespaces.md index 7b3238441f6..42d9ce3d391 100644 --- a/doc/api/namespaces.md +++ b/doc/api/namespaces.md @@ -1,13 +1,29 @@ # Namespaces +Usernames and groupnames fall under a special category called namespaces. + +For users and groups supported API calls see the [users](users.md) and +[groups](groups.md) documentation respectively. + +[Pagination](README.md#pagination) is used. + ## List namespaces -Get a list of namespaces. (As user: my namespaces, as admin: all namespaces) +Get a list of the namespaces of the authenticated user. If the user is an +administrator, a list of all namespaces in the GitLab instance is shown. ``` GET /namespaces ``` +Example request: + +```bash +curl -H "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/namespaces +``` + +Example response: + ```json [ { @@ -23,22 +39,32 @@ GET /namespaces ] ``` -You can search for namespaces by name or path, see below. - ## Search for namespace -Get all namespaces that match your string in their name or path. +Get all namespaces that match a string in their name or path. ``` GET /namespaces?search=foobar ``` +| Attribute | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `search` | string | no | Returns a list of namespaces the user is authorized to see based on the search criteria | + +Example request: + +```bash +curl -H "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/namespaces?search=twitter +``` + +Example response: + ```json [ { - "id": 1, - "path": "user1", - "kind": "user" + "id": 4, + "path": "twitter", + "kind": "group" } ] ``` |