List all invited groups in a project

GET

/api/v4/projects/{id}/invited_groups

Lists all invited groups in a project. Unauthenticated requests return only public invited groups. Limited to 60 requests a minute per user account for authenticated requires and per IP address for unauthenticated requests. Supports offset-based pagination (up to 50,000 projects) and keyset-based pagination (greater than 50,000 projects).

Authorizations

http
oauth2

Parameters

Path Parameters

required

One of:

string
integer

string

The ID or URL-encoded path of the project

Query Parameters

relation

Array<string>

nullable

Filter by group relation

search

string

nullable

Search for a specific group

min_access_level

integer

nullable

Allowed values: 10 15 20 25 30 40 50

Limit by minimum access level of authenticated user

page

integer

default: 1 nullable

Current page number

Example

per_page

integer

default: 20 nullable

Number of items per page

Example

with_custom_attributes

boolean

nullable

Include custom attributes in the response

custom_attributes

Filter with custom attributes

object

Responses

200

application/json

object

integer format: int64

web_url

string

name

string

path

string

description

string

visibility

string

share_with_group_lock

boolean

require_two_factor_authentication

boolean

two_factor_grace_period

integer

project_creation_level

string

auto_devops_enabled

string

subgroup_creation_level

string

emails_disabled

boolean

emails_enabled

boolean

show_diff_preview_in_email

boolean

mentions_disabled

string

lfs_enabled

boolean

archived

boolean

math_rendering_limits_enabled

boolean

lock_math_rendering_limits_enabled

boolean

crm_enabled

boolean

resource_access_token_notify_inherited

boolean

lock_resource_access_token_notify_inherited

boolean

default_branch

string

default_branch_protection

integer

default_branch_protection_defaults

string

avatar_url

string

request_access_enabled

boolean

full_name

string

full_path

string

created_at

string

parent_id

string

organization_id

integer format: int64

shared_runners_setting

string

max_artifacts_size

integer

custom_attributes

object

key

string

value

string

statistics

string

marked_for_deletion_on

string

root_storage_statistics

object

build_artifacts_size

CI artifacts size in bytes.

integer

container_registry_size

Container registry size in bytes.

integer

container_registry_size_is_estimated

Indicates whether the deduplicated container registry size for the namespace is an estimated value or not.

boolean

dependency_proxy_size

Dependency Proxy sizes in bytes.

integer

lfs_objects_size

LFS objects size in bytes.

integer

packages_size

Packages size in bytes.

integer

pipeline_artifacts_size

CI pipeline artifacts size in bytes.

integer

repository_size

Git repository size in bytes.

integer

snippets_size

Snippets size in bytes.

integer

storage_size

Total storage in bytes.

integer

uploads_size

Uploads size in bytes.

integer

wiki_size

Wiki size in bytes.

integer

ldap_cn

string

ldap_access

string

ldap_group_links

object

string

group_access

integer

provider

string

filter

string

member_role_id

integer format: int64

saml_group_links

object

name

string

access_level

integer

member_role_id

integer format: int64

provider

string

file_template_project_id

string

wiki_access_level

string

repository_storage

string

duo_core_features_enabled

[Experimental] Indicates whether GitLab Duo Core features are enabled for the group

boolean

duo_features_enabled

string

lock_duo_features_enabled

string

auto_duo_code_review_enabled

string

web_based_commit_signing_enabled

string

allow_personal_snippets

string

duo_namespace_access_rules

string

built_in_project_templates_enabled

boolean

lock_built_in_project_templates_enabled

boolean

Example

{
  "web_url": "http://gitlab.example.com/groups/diaspora",
  "name": "Diaspora",
  "custom_attributes": {
    "key": "foo",
    "value": "bar"
  },
  "ldap_group_links": {
    "cn": "ldap-group-1",
    "group_access": 10,
    "provider": "ldapmain",
    "filter": "id >= 500",
    "member_role_id": 12
  },
  "saml_group_links": {
    "name": "saml-group-1",
    "access_level": 40,
    "member_role_id": 12,
    "provider": "saml"
  }
}

400

Bad Request

404

Not Found