Skip to content

List all ancestor groups

GET
/api/v4/projects/{id}/groups

Lists all ancestor groups for a specified project.

id
required
One of:
string

The ID or URL-encoded path of the project

search
string
nullable

Return list of groups matching the search criteria

Example
group
skip_groups
Array<integer>
nullable

Array of group ids to exclude from list

with_shared
boolean
nullable

Include shared groups

shared_visible_only
boolean
nullable

Limit to shared groups user has access to

shared_min_access_level
integer
nullable
Allowed values: 10 15 20 25 30 40 50

Limit returned shared groups by minimum access level to the project

page
integer
default: 1 nullable

Current page number

Example
1
per_page
integer
default: 20 nullable

Number of items per page

Example
20

OK

Media type application/json
object
id
integer format: int64
web_url
string
name
string
avatar_url
string
full_name
string
full_path
string
Example
{
"web_url": "http://gitlab.example.com/groups/diaspora",
"name": "Diaspora",
"avatar_url": "http://gitlab.example.com/uploads/group/avatar/1/avatar.png",
"full_name": "Foobar Group",
"full_path": "foo-bar"
}

Bad Request

Unauthenticated

Not found