Commit 17e70d45 authored by Marcel Amirault's avatar Marcel Amirault

Merge branch 'docs/bprescott/20220304-groupsapi' into 'master'

Document groups API runners_token issue

See merge request gitlab-org/gitlab!82194
parents 21905974 8388c5cb
......@@ -484,7 +484,9 @@ Example response:
## Details of a group
Get all details of a group. This endpoint can be accessed without authentication
if the group is publicly accessible. In case the user that requests is administrator of the group, it returns the `runners_token` for the group too.
if the group is publicly accessible. In case the user that requests is an administrator
if the group is publicly accessible. With authentication, it returns the `runners_token`
for the group too, if the user is an administrator or group owner.
```plaintext
GET /groups/:id
......@@ -506,6 +508,11 @@ To get the details of all projects within a group, use either the [list a group'
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/4"
```
NOTE:
There is [a known issue](https://gitlab.com/gitlab-org/gitlab/-/issues/345200) that can
prevent `runners_token` from being returned when the call has the `with_projects=false`
parameter.
This endpoint returns:
- All projects and shared projects in GitLab 12.5 and earlier.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment