2020-10-28 15:08:49 +00:00
---
2021-01-07 00:10:16 +00:00
stage: Manage
group: Access
2020-11-26 06:09:20 +00:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-10-28 15:08:49 +00:00
---
2017-05-10 18:48:07 +00:00
# Groups API
2016-08-08 07:49:54 +00:00
## List groups
2017-08-22 15:10:49 +00:00
Get a list of visible groups for the authenticated user. When accessed without
authentication, only public groups are returned.
2016-10-31 17:37:13 +00:00
2019-12-07 18:07:50 +00:00
By default, this request returns 20 results at a time because the API results [are paginated ](README.md#pagination ).
2016-10-31 17:37:13 +00:00
Parameters:
2019-07-04 08:22:41 +00:00
| Attribute | Type | Required | Description |
| ------------------------ | ----------------- | -------- | ---------- |
| `skip_groups` | array of integers | no | Skip the group IDs passed |
2021-02-16 00:09:01 +00:00
| `all_available` | boolean | no | Show all the groups you have access to (defaults to `false` for authenticated users, `true` for administrators); Attributes `owned` and `min_access_level` have precedence |
2019-07-04 08:22:41 +00:00
| `search` | string | no | Return the list of authorized groups matching the search criteria |
| `order_by` | string | no | Order groups by `name` , `path` or `id` . Default is `name` |
| `sort` | string | no | Order groups in `asc` or `desc` order. Default is `asc` |
2021-02-16 00:09:01 +00:00
| `statistics` | boolean | no | Include group statistics (administrators only) |
| `with_custom_attributes` | boolean | no | Include [custom attributes ](custom_attributes.md ) in response (administrators only) |
2019-07-04 08:22:41 +00:00
| `owned` | boolean | no | Limit to groups explicitly owned by the current user |
2020-07-09 18:10:09 +00:00
| `min_access_level` | integer | no | Limit to groups where current user has at least this [access level ](members.md#valid-access-levels ) |
2020-05-26 03:08:02 +00:00
| `top_level_only` | boolean | no | Limit to top level groups, excluding all subgroups |
2016-08-08 07:49:54 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
GET /groups
```
```json
[
{
"id": 1,
"name": "Foobar Group",
"path": "foo-bar",
2017-01-27 13:53:19 +00:00
"description": "An interesting group",
2017-02-16 13:56:14 +00:00
"visibility": "public",
2019-10-07 15:05:59 +00:00
"share_with_group_lock": false,
"require_two_factor_authentication": false,
"two_factor_grace_period": 48,
"project_creation_level": "developer",
"auto_devops_enabled": null,
"subgroup_creation_level": "owner",
"emails_disabled": null,
2020-01-17 18:08:41 +00:00
"mentions_disabled": null,
2017-01-27 13:53:19 +00:00
"lfs_enabled": true,
2020-03-02 12:07:57 +00:00
"default_branch_protection": 2,
2017-01-27 13:53:19 +00:00
"avatar_url": "http://localhost:3000/uploads/group/avatar/1/foo.jpg",
"web_url": "http://localhost:3000/groups/foo-bar",
"request_access_enabled": false,
"full_name": "Foobar Group",
2017-02-07 15:42:37 +00:00
"full_path": "foo-bar",
2018-09-26 10:58:58 +00:00
"file_template_project_id": 1,
2020-03-24 12:09:42 +00:00
"parent_id": null,
"created_at": "2020-01-15T12:36:29.590Z"
2016-08-08 07:49:54 +00:00
}
]
```
2021-02-16 00:09:01 +00:00
When adding the parameter `statistics=true` and the authenticated user is an administrator, additional group statistics are returned.
2017-10-24 07:05:16 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2017-10-24 07:05:16 +00:00
GET /groups?statistics=true
```
```json
[
{
"id": 1,
"name": "Foobar Group",
"path": "foo-bar",
"description": "An interesting group",
"visibility": "public",
2019-10-07 15:05:59 +00:00
"share_with_group_lock": false,
"require_two_factor_authentication": false,
"two_factor_grace_period": 48,
"project_creation_level": "developer",
"auto_devops_enabled": null,
"subgroup_creation_level": "owner",
"emails_disabled": null,
2020-01-17 18:08:41 +00:00
"mentions_disabled": null,
2017-10-24 07:05:16 +00:00
"lfs_enabled": true,
2020-03-02 12:07:57 +00:00
"default_branch_protection": 2,
2017-10-24 07:05:16 +00:00
"avatar_url": "http://localhost:3000/uploads/group/avatar/1/foo.jpg",
"web_url": "http://localhost:3000/groups/foo-bar",
"request_access_enabled": false,
"full_name": "Foobar Group",
"full_path": "foo-bar",
2018-09-26 10:58:58 +00:00
"file_template_project_id": 1,
2017-10-24 07:05:16 +00:00
"parent_id": null,
2020-03-24 12:09:42 +00:00
"created_at": "2020-01-15T12:36:29.590Z",
2017-10-24 07:05:16 +00:00
"statistics": {
2020-11-10 12:08:57 +00:00
"storage_size" : 363,
2017-10-24 07:05:16 +00:00
"repository_size" : 33,
2019-02-13 22:38:11 +00:00
"wiki_size" : 100,
2017-10-24 07:05:16 +00:00
"lfs_objects_size" : 123,
2019-07-03 09:32:54 +00:00
"job_artifacts_size" : 57,
2020-06-30 18:09:13 +00:00
"packages_size": 0,
"snippets_size" : 50,
2017-10-24 07:05:16 +00:00
}
}
]
```
2016-08-08 07:49:54 +00:00
You can search for groups by name or path, see below.
2017-09-18 15:07:38 +00:00
You can filter by [custom attributes ](custom_attributes.md ) with:
2020-02-27 09:09:01 +00:00
```plaintext
2017-09-18 15:07:38 +00:00
GET /groups?custom_attributes[key]=value& custom_attributes[other_key]=other_value
```
2018-06-13 19:24:01 +00:00
## List a group's subgroups
2017-11-09 16:07:04 +00:00
2020-04-21 15:21:10 +00:00
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/15142) in GitLab 10.3.
2017-11-17 14:04:20 +00:00
2017-11-09 16:07:04 +00:00
Get a list of visible direct subgroups in this group.
When accessed without authentication, only public groups are returned.
2019-12-07 18:07:50 +00:00
By default, this request returns 20 results at a time because the API results [are paginated ](README.md#pagination ).
2017-11-09 16:07:04 +00:00
Parameters:
2019-07-04 08:22:41 +00:00
| Attribute | Type | Required | Description |
| ------------------------ | ----------------- | -------- | ----------- |
2020-07-02 21:09:14 +00:00
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) of the immediate parent group |
2019-07-04 08:22:41 +00:00
| `skip_groups` | array of integers | no | Skip the group IDs passed |
2021-02-16 00:09:01 +00:00
| `all_available` | boolean | no | Show all the groups you have access to (defaults to `false` for authenticated users, `true` for administrators); Attributes `owned` and `min_access_level` have precedence |
2019-07-04 08:22:41 +00:00
| `search` | string | no | Return the list of authorized groups matching the search criteria |
| `order_by` | string | no | Order groups by `name` , `path` or `id` . Default is `name` |
| `sort` | string | no | Order groups in `asc` or `desc` order. Default is `asc` |
2021-02-16 00:09:01 +00:00
| `statistics` | boolean | no | Include group statistics (administrators only) |
| `with_custom_attributes` | boolean | no | Include [custom attributes ](custom_attributes.md ) in response (administrators only) |
2019-07-04 08:22:41 +00:00
| `owned` | boolean | no | Limit to groups explicitly owned by the current user |
2020-07-09 18:10:09 +00:00
| `min_access_level` | integer | no | Limit to groups where current user has at least this [access level ](members.md#valid-access-levels ) |
2017-11-09 16:07:04 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2017-11-09 16:07:04 +00:00
GET /groups/:id/subgroups
```
```json
[
{
"id": 1,
"name": "Foobar Group",
"path": "foo-bar",
"description": "An interesting group",
"visibility": "public",
2019-10-07 15:05:59 +00:00
"share_with_group_lock": false,
"require_two_factor_authentication": false,
"two_factor_grace_period": 48,
"project_creation_level": "developer",
"auto_devops_enabled": null,
"subgroup_creation_level": "owner",
"emails_disabled": null,
2020-01-17 18:08:41 +00:00
"mentions_disabled": null,
2017-11-09 16:07:04 +00:00
"lfs_enabled": true,
2020-03-02 12:07:57 +00:00
"default_branch_protection": 2,
2017-11-09 16:07:04 +00:00
"avatar_url": "http://gitlab.example.com/uploads/group/avatar/1/foo.jpg",
"web_url": "http://gitlab.example.com/groups/foo-bar",
"request_access_enabled": false,
"full_name": "Foobar Group",
"full_path": "foo-bar",
2018-09-26 10:58:58 +00:00
"file_template_project_id": 1,
2020-03-24 12:09:42 +00:00
"parent_id": 123,
"created_at": "2020-01-15T12:36:29.590Z"
2017-11-09 16:07:04 +00:00
}
]
```
2020-09-30 06:09:47 +00:00
## List a group's descendant groups
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/217115) in GitLab 13.5
Get a list of visible descendant groups of this group.
When accessed without authentication, only public groups are returned.
By default, this request returns 20 results at a time because the API results [are paginated ](README.md#pagination ).
Parameters:
| Attribute | Type | Required | Description |
| ------------------------ | ----------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) of the immediate parent group |
| `skip_groups` | array of integers | no | Skip the group IDs passed |
2021-02-16 00:09:01 +00:00
| `all_available` | boolean | no | Show all the groups you have access to (defaults to `false` for authenticated users, `true` for administrators). Attributes `owned` and `min_access_level` have precedence |
2020-09-30 06:09:47 +00:00
| `search` | string | no | Return the list of authorized groups matching the search criteria |
| `order_by` | string | no | Order groups by `name` , `path` , or `id` . Default is `name` |
| `sort` | string | no | Order groups in `asc` or `desc` order. Default is `asc` |
2021-02-16 00:09:01 +00:00
| `statistics` | boolean | no | Include group statistics (administrators only) |
| `with_custom_attributes` | boolean | no | Include [custom attributes ](custom_attributes.md ) in response (administrators only) |
2020-09-30 06:09:47 +00:00
| `owned` | boolean | no | Limit to groups explicitly owned by the current user |
| `min_access_level` | integer | no | Limit to groups where current user has at least this [access level ](members.md#valid-access-levels ) |
```plaintext
GET /groups/:id/descendant_groups
```
```json
[
{
"id": 2,
"name": "Bar Group",
"path": "foo/bar",
"description": "A subgroup of Foo Group",
"visibility": "public",
"share_with_group_lock": false,
"require_two_factor_authentication": false,
"two_factor_grace_period": 48,
"project_creation_level": "developer",
"auto_devops_enabled": null,
"subgroup_creation_level": "owner",
"emails_disabled": null,
"mentions_disabled": null,
"lfs_enabled": true,
"default_branch_protection": 2,
"avatar_url": "http://gitlab.example.com/uploads/group/avatar/1/bar.jpg",
"web_url": "http://gitlab.example.com/groups/foo/bar",
"request_access_enabled": false,
"full_name": "Bar Group",
"full_path": "foo/bar",
"file_template_project_id": 1,
"parent_id": 123,
"created_at": "2020-01-15T12:36:29.590Z"
},
{
"id": 3,
"name": "Baz Group",
"path": "foo/bar/baz",
"description": "A subgroup of Bar Group",
"visibility": "public",
"share_with_group_lock": false,
"require_two_factor_authentication": false,
"two_factor_grace_period": 48,
"project_creation_level": "developer",
"auto_devops_enabled": null,
"subgroup_creation_level": "owner",
"emails_disabled": null,
"mentions_disabled": null,
"lfs_enabled": true,
"default_branch_protection": 2,
"avatar_url": "http://gitlab.example.com/uploads/group/avatar/1/baz.jpg",
"web_url": "http://gitlab.example.com/groups/foo/bar/baz",
"request_access_enabled": false,
"full_name": "Baz Group",
"full_path": "foo/bar/baz",
"file_template_project_id": 1,
"parent_id": 123,
"created_at": "2020-01-15T12:36:29.590Z"
}
]
```
2016-08-08 07:49:54 +00:00
## List a group's projects
2019-12-07 18:07:50 +00:00
Get a list of projects in this group. When accessed without authentication, only public projects are returned.
By default, this request returns 20 results at a time because the API results [are paginated ](README.md#pagination ).
2016-08-08 07:49:54 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
GET /groups/:id/projects
```
Parameters:
2019-07-04 08:22:41 +00:00
| Attribute | Type | Required | Description |
| ----------------------------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) owned by the authenticated user |
| `archived` | boolean | no | Limit by archived status |
| `visibility` | string | no | Limit by visibility `public` , `internal` , or `private` |
2020-07-23 09:09:18 +00:00
| `order_by` | string | no | Return projects ordered by `id` , `name` , `path` , `created_at` , `updated_at` , `similarity` (1), or `last_activity_at` fields. Default is `created_at` |
2019-07-04 08:22:41 +00:00
| `sort` | string | no | Return projects sorted in `asc` or `desc` order. Default is `desc` |
| `search` | string | no | Return list of authorized projects matching the search criteria |
| `simple` | boolean | no | Return only the ID, URL, name, and path of each project |
| `owned` | boolean | no | Limit by projects owned by the current user |
| `starred` | boolean | no | Limit by projects starred by the current user |
| `with_issues_enabled` | boolean | no | Limit by projects with issues feature enabled. Default is `false` |
| `with_merge_requests_enabled` | boolean | no | Limit by projects with merge requests feature enabled. Default is `false` |
| `with_shared` | boolean | no | Include projects shared to this group. Default is `true` |
2019-09-04 16:33:02 +00:00
| `include_subgroups` | boolean | no | Include projects in subgroups of this group. Default is `false` |
2020-07-09 18:10:09 +00:00
| `min_access_level` | integer | no | Limit to projects where current user has at least this [access level ](members.md#valid-access-levels ) |
2021-02-16 00:09:01 +00:00
| `with_custom_attributes` | boolean | no | Include [custom attributes ](custom_attributes.md ) in response (administrators only) |
2019-08-28 14:26:42 +00:00
| `with_security_reports` | boolean | no | ** (ULTIMATE)** Return only projects that have security reports artifacts present in any of their builds. This means "projects with security reports enabled". Default is `false` |
2016-12-13 12:51:30 +00:00
2020-07-23 09:09:18 +00:00
1. Order by similarity: Orders the results by a similarity score calculated from the provided `search`
URL parameter. This is an [alpha ](https://about.gitlab.com/handbook/product/gitlab-the-product/#alpha ) feature [introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/221043 ) in GitLab 13.3.
The feature is behind a feature flag, you can [enable it ](../administration/feature_flags.md#enable-or-disable-the-feature )
with the `similarity_search` flag. When using `order_by=similarity` the `sort` parameter is
ignored. When the `search` parameter is not provided, the API returns the projects ordered by `name` .
2016-12-13 12:51:30 +00:00
Example response:
2016-08-08 07:49:54 +00:00
```json
[
{
"id": 9,
"description": "foo",
"default_branch": "master",
"tag_list": [],
"archived": false,
2017-02-16 13:56:14 +00:00
"visibility": "internal",
2016-08-08 07:49:54 +00:00
"ssh_url_to_repo": "git@gitlab.example.com/html5-boilerplate.git",
"http_url_to_repo": "http://gitlab.example.com/h5bp/html5-boilerplate.git",
"web_url": "http://gitlab.example.com/h5bp/html5-boilerplate",
"name": "Html5 Boilerplate",
"name_with_namespace": "Experimental / Html5 Boilerplate",
"path": "html5-boilerplate",
"path_with_namespace": "h5bp/html5-boilerplate",
"issues_enabled": true,
"merge_requests_enabled": true,
"wiki_enabled": true,
2017-03-06 09:24:03 +00:00
"jobs_enabled": true,
2016-08-08 07:49:54 +00:00
"snippets_enabled": true,
"created_at": "2016-04-05T21:40:50.169Z",
"last_activity_at": "2016-04-06T16:52:08.432Z",
"shared_runners_enabled": true,
"creator_id": 1,
"namespace": {
"id": 5,
"name": "Experimental",
"path": "h5bp",
2017-02-08 20:08:18 +00:00
"kind": "group"
2016-08-08 07:49:54 +00:00
},
"avatar_url": null,
"star_count": 1,
"forks_count": 0,
"open_issues_count": 3,
2017-03-06 09:24:03 +00:00
"public_jobs": true,
2016-09-14 22:04:27 +00:00
"shared_with_groups": [],
"request_access_enabled": false
2016-08-08 07:49:54 +00:00
}
]
```
2020-12-04 21:09:29 +00:00
NOTE:
2020-11-19 21:09:07 +00:00
To distinguish between a project in the group and a project shared to the group, the `namespace` attribute can be used. When a project has been shared to the group, its `namespace` differs from the group the request is being made for.
2020-04-10 06:09:41 +00:00
2020-04-28 15:09:29 +00:00
## List a group's shared projects
Get a list of projects shared to this group. When accessed without authentication, only public shared projects are returned.
By default, this request returns 20 results at a time because the API results [are paginated ](README.md#pagination ).
```plaintext
GET /groups/:id/projects/shared
```
Parameters:
| Attribute | Type | Required | Description |
| ----------------------------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) owned by the authenticated user |
| `archived` | boolean | no | Limit by archived status |
| `visibility` | string | no | Limit by visibility `public` , `internal` , or `private` |
| `order_by` | string | no | Return projects ordered by `id` , `name` , `path` , `created_at` , `updated_at` , or `last_activity_at` fields. Default is `created_at` |
| `sort` | string | no | Return projects sorted in `asc` or `desc` order. Default is `desc` |
| `search` | string | no | Return list of authorized projects matching the search criteria |
| `simple` | boolean | no | Return only the ID, URL, name, and path of each project |
| `starred` | boolean | no | Limit by projects starred by the current user |
| `with_issues_enabled` | boolean | no | Limit by projects with issues feature enabled. Default is `false` |
| `with_merge_requests_enabled` | boolean | no | Limit by projects with merge requests feature enabled. Default is `false` |
2020-07-09 18:10:09 +00:00
| `min_access_level` | integer | no | Limit to projects where current user has at least this [access level ](members.md#valid-access-levels ) |
2021-02-16 00:09:01 +00:00
| `with_custom_attributes` | boolean | no | Include [custom attributes ](custom_attributes.md ) in response (administrators only) |
2020-04-28 15:09:29 +00:00
Example response:
```json
[
{
"id":8,
"description":"Shared project for Html5 Boilerplate",
"name":"Html5 Boilerplate",
"name_with_namespace":"H5bp / Html5 Boilerplate",
"path":"html5-boilerplate",
"path_with_namespace":"h5bp/html5-boilerplate",
"created_at":"2020-04-27T06:13:22.642Z",
"default_branch":"master",
"tag_list":[
],
"ssh_url_to_repo":"ssh://git@gitlab.com/h5bp/html5-boilerplate.git",
"http_url_to_repo":"http://gitlab.com/h5bp/html5-boilerplate.git",
"web_url":"http://gitlab.com/h5bp/html5-boilerplate",
"readme_url":"http://gitlab.com/h5bp/html5-boilerplate/-/blob/master/README.md",
"avatar_url":null,
"star_count":0,
"forks_count":4,
"last_activity_at":"2020-04-27T06:13:22.642Z",
"namespace":{
"id":28,
"name":"H5bp",
"path":"h5bp",
"kind":"group",
"full_path":"h5bp",
"parent_id":null,
"avatar_url":null,
"web_url":"http://gitlab.com/groups/h5bp"
},
"_links":{
"self":"http://gitlab.com/api/v4/projects/8",
"issues":"http://gitlab.com/api/v4/projects/8/issues",
"merge_requests":"http://gitlab.com/api/v4/projects/8/merge_requests",
"repo_branches":"http://gitlab.com/api/v4/projects/8/repository/branches",
"labels":"http://gitlab.com/api/v4/projects/8/labels",
"events":"http://gitlab.com/api/v4/projects/8/events",
"members":"http://gitlab.com/api/v4/projects/8/members"
},
"empty_repo":false,
"archived":false,
"visibility":"public",
"resolve_outdated_diff_discussions":false,
"container_registry_enabled":true,
"container_expiration_policy":{
"cadence":"7d",
"enabled":true,
"keep_n":null,
"older_than":null,
"name_regex":null,
"name_regex_keep":null,
"next_run_at":"2020-05-04T06:13:22.654Z"
},
"issues_enabled":true,
"merge_requests_enabled":true,
"wiki_enabled":true,
"jobs_enabled":true,
"snippets_enabled":true,
"can_create_merge_request_in":true,
"issues_access_level":"enabled",
"repository_access_level":"enabled",
"merge_requests_access_level":"enabled",
"forking_access_level":"enabled",
"wiki_access_level":"enabled",
"builds_access_level":"enabled",
"snippets_access_level":"enabled",
"pages_access_level":"enabled",
"emails_disabled":null,
"shared_runners_enabled":true,
"lfs_enabled":true,
"creator_id":1,
"import_status":"failed",
"open_issues_count":10,
"ci_default_git_depth":50,
2020-10-20 06:09:03 +00:00
"ci_forward_deployment_enabled":true,
2020-04-28 15:09:29 +00:00
"public_jobs":true,
"build_timeout":3600,
"auto_cancel_pending_pipelines":"enabled",
"build_coverage_regex":null,
"ci_config_path":null,
"shared_with_groups":[
{
"group_id":24,
"group_name":"Commit451",
"group_full_path":"Commit451",
"group_access_level":30,
"expires_at":null
}
],
"only_allow_merge_if_pipeline_succeeds":false,
"request_access_enabled":true,
"only_allow_merge_if_all_discussions_are_resolved":false,
"remove_source_branch_after_merge":true,
"printing_merge_request_link_enabled":true,
"merge_method":"merge",
"suggestion_commit_message":null,
"auto_devops_enabled":true,
"auto_devops_deploy_strategy":"continuous",
"autoclose_referenced_issues":true,
"repository_storage":"default"
}
]
```
2016-08-08 07:49:54 +00:00
## Details of a group
2017-08-22 15:10:49 +00:00
Get all details of a group. This endpoint can be accessed without authentication
2021-02-16 00:09:01 +00:00
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.
2016-08-08 07:49:54 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
GET /groups/:id
```
Parameters:
2019-07-04 08:22:41 +00:00
| Attribute | Type | Required | Description |
| ------------------------ | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) owned by the authenticated user. |
2021-02-16 00:09:01 +00:00
| `with_custom_attributes` | boolean | no | Include [custom attributes ](custom_attributes.md ) in response (administrators only). |
2020-11-19 21:09:07 +00:00
| `with_projects` | boolean | no | Include details from projects that belong to the specified group (defaults to `true` ). (Deprecated, [scheduled for removal in API v5 ](https://gitlab.com/gitlab-org/gitlab/-/issues/213797 ). To get the details of all projects within a group, use the [list a group's projects endpoint ](#list-a-groups-projects ).) |
2020-05-08 18:09:55 +00:00
2020-12-04 21:09:29 +00:00
NOTE:
2020-11-19 21:09:07 +00:00
The `projects` and `shared_projects` attributes in the response are deprecated and [scheduled for removal in API v5 ](https://gitlab.com/gitlab-org/gitlab/-/issues/213797 ).
2020-05-08 18:09:55 +00:00
To get the details of all projects within a group, use either the [list a group's projects ](#list-a-groups-projects ) or the [list a group's shared projects ](#list-a-groups-shared-projects ) endpoint.
2016-08-08 07:49:54 +00:00
2020-01-30 15:09:15 +00:00
```shell
2020-05-28 00:08:37 +00:00
curl --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/groups/4"
2016-08-08 07:49:54 +00:00
```
2019-12-07 18:07:50 +00:00
This endpoint returns:
- All projects and shared projects in GitLab 12.5 and earlier.
2020-05-21 06:08:25 +00:00
- A maximum of 100 projects and shared projects [in GitLab 12.6 ](https://gitlab.com/gitlab-org/gitlab/-/issues/31031 )
2019-12-07 18:07:50 +00:00
and later. To get the details of all projects within a group, use the
[list a group's projects endpoint ](#list-a-groups-projects ) instead.
2016-08-08 07:49:54 +00:00
Example response:
```json
{
"id": 4,
"name": "Twitter",
"path": "twitter",
"description": "Aliquid qui quis dignissimos distinctio ut commodi voluptas est.",
2017-02-16 13:56:14 +00:00
"visibility": "public",
2016-08-08 07:49:54 +00:00
"avatar_url": null,
"web_url": "https://gitlab.example.com/groups/twitter",
2016-09-14 22:04:27 +00:00
"request_access_enabled": false,
2017-02-07 15:42:37 +00:00
"full_name": "Twitter",
"full_path": "twitter",
2019-09-17 12:06:48 +00:00
"runners_token": "ba324ca7b1c77fc20bb9",
2018-09-26 10:58:58 +00:00
"file_template_project_id": 1,
2017-02-07 15:42:37 +00:00
"parent_id": null,
2020-03-24 12:09:42 +00:00
"created_at": "2020-01-15T12:36:29.590Z",
2020-06-09 18:08:28 +00:00
"shared_with_groups": [
{
"group_id": 28,
"group_name": "H5bp",
"group_full_path": "h5bp",
"group_access_level": 20,
"expires_at": null
}
],
2020-05-08 18:09:55 +00:00
"projects": [ // Deprecated and will be removed in API v5
2016-08-08 07:49:54 +00:00
{
"id": 7,
"description": "Voluptas veniam qui et beatae voluptas doloremque explicabo facilis.",
"default_branch": "master",
"tag_list": [],
"archived": false,
2017-02-16 13:56:14 +00:00
"visibility": "public",
2016-08-08 07:49:54 +00:00
"ssh_url_to_repo": "git@gitlab.example.com:twitter/typeahead-js.git",
"http_url_to_repo": "https://gitlab.example.com/twitter/typeahead-js.git",
"web_url": "https://gitlab.example.com/twitter/typeahead-js",
"name": "Typeahead.Js",
"name_with_namespace": "Twitter / Typeahead.Js",
"path": "typeahead-js",
"path_with_namespace": "twitter/typeahead-js",
"issues_enabled": true,
"merge_requests_enabled": true,
"wiki_enabled": true,
2017-03-06 09:24:03 +00:00
"jobs_enabled": true,
2016-08-08 07:49:54 +00:00
"snippets_enabled": false,
"container_registry_enabled": true,
"created_at": "2016-06-17T07:47:25.578Z",
"last_activity_at": "2016-06-17T07:47:25.881Z",
"shared_runners_enabled": true,
"creator_id": 1,
"namespace": {
"id": 4,
"name": "Twitter",
"path": "twitter",
2017-02-08 20:08:18 +00:00
"kind": "group"
2016-08-08 07:49:54 +00:00
},
"avatar_url": null,
"star_count": 0,
"forks_count": 0,
"open_issues_count": 3,
2017-03-06 09:24:03 +00:00
"public_jobs": true,
2016-09-14 22:04:27 +00:00
"shared_with_groups": [],
"request_access_enabled": false
2016-08-08 07:49:54 +00:00
},
{
"id": 6,
"description": "Aspernatur omnis repudiandae qui voluptatibus eaque.",
"default_branch": "master",
"tag_list": [],
"archived": false,
2017-02-16 13:56:14 +00:00
"visibility": "internal",
2016-08-08 07:49:54 +00:00
"ssh_url_to_repo": "git@gitlab.example.com:twitter/flight.git",
"http_url_to_repo": "https://gitlab.example.com/twitter/flight.git",
"web_url": "https://gitlab.example.com/twitter/flight",
"name": "Flight",
"name_with_namespace": "Twitter / Flight",
"path": "flight",
"path_with_namespace": "twitter/flight",
"issues_enabled": true,
"merge_requests_enabled": true,
"wiki_enabled": true,
2017-03-06 09:24:03 +00:00
"jobs_enabled": true,
2016-08-08 07:49:54 +00:00
"snippets_enabled": false,
"container_registry_enabled": true,
"created_at": "2016-06-17T07:47:24.661Z",
"last_activity_at": "2016-06-17T07:47:24.838Z",
"shared_runners_enabled": true,
"creator_id": 1,
"namespace": {
"id": 4,
"name": "Twitter",
"path": "twitter",
2017-02-08 20:08:18 +00:00
"kind": "group"
2016-08-08 07:49:54 +00:00
},
"avatar_url": null,
"star_count": 0,
"forks_count": 0,
"open_issues_count": 8,
2017-03-06 09:24:03 +00:00
"public_jobs": true,
2016-09-14 22:04:27 +00:00
"shared_with_groups": [],
"request_access_enabled": false
2016-08-08 07:49:54 +00:00
}
],
2020-05-08 18:09:55 +00:00
"shared_projects": [ // Deprecated and will be removed in API v5
2016-08-08 07:49:54 +00:00
{
"id": 8,
"description": "Velit eveniet provident fugiat saepe eligendi autem.",
"default_branch": "master",
"tag_list": [],
"archived": false,
2017-02-16 13:56:14 +00:00
"visibility": "private",
2016-08-08 07:49:54 +00:00
"ssh_url_to_repo": "git@gitlab.example.com:h5bp/html5-boilerplate.git",
"http_url_to_repo": "https://gitlab.example.com/h5bp/html5-boilerplate.git",
"web_url": "https://gitlab.example.com/h5bp/html5-boilerplate",
"name": "Html5 Boilerplate",
"name_with_namespace": "H5bp / Html5 Boilerplate",
"path": "html5-boilerplate",
"path_with_namespace": "h5bp/html5-boilerplate",
"issues_enabled": true,
"merge_requests_enabled": true,
"wiki_enabled": true,
2017-03-06 09:24:03 +00:00
"jobs_enabled": true,
2016-08-08 07:49:54 +00:00
"snippets_enabled": false,
"container_registry_enabled": true,
"created_at": "2016-06-17T07:47:27.089Z",
"last_activity_at": "2016-06-17T07:47:27.310Z",
"shared_runners_enabled": true,
"creator_id": 1,
"namespace": {
"id": 5,
"name": "H5bp",
"path": "h5bp",
2017-02-08 20:08:18 +00:00
"kind": "group"
2016-08-08 07:49:54 +00:00
},
"avatar_url": null,
"star_count": 0,
"forks_count": 0,
"open_issues_count": 4,
2017-03-06 09:24:03 +00:00
"public_jobs": true,
2016-08-08 07:49:54 +00:00
"shared_with_groups": [
{
"group_id": 4,
"group_name": "Twitter",
2018-12-27 14:37:46 +00:00
"group_full_path": "twitter",
2018-08-09 08:21:17 +00:00
"group_access_level": 30,
"expires_at": null
2016-08-08 07:49:54 +00:00
},
{
"group_id": 3,
"group_name": "Gitlab Org",
2018-12-27 14:37:46 +00:00
"group_full_path": "gitlab-org",
2018-08-09 08:21:17 +00:00
"group_access_level": 10,
"expires_at": "2018-08-14"
2016-08-08 07:49:54 +00:00
}
]
}
]
}
```
2021-02-08 18:09:49 +00:00
Users of [GitLab Premium or higher ](https://about.gitlab.com/pricing/ ) also see
2019-07-03 09:32:54 +00:00
the `shared_runners_minutes_limit` and `extra_shared_runners_minutes_limit` parameters:
2019-07-04 08:22:41 +00:00
Additional response parameters:
2019-07-03 09:32:54 +00:00
```json
2019-07-04 08:22:41 +00:00
{
"id": 4,
"description": "Aliquid qui quis dignissimos distinctio ut commodi voluptas est.",
2019-07-03 09:32:54 +00:00
"shared_runners_minutes_limit": 133,
"extra_shared_runners_minutes_limit": 133,
2019-07-04 08:22:41 +00:00
...
}
2019-07-03 09:32:54 +00:00
```
2021-02-08 18:09:49 +00:00
Users of [GitLab Premium or higher ](https://about.gitlab.com/pricing/ ) also see
2020-06-01 18:08:07 +00:00
the `marked_for_deletion_on` attribute:
```json
{
"id": 4,
"description": "Aliquid qui quis dignissimos distinctio ut commodi voluptas est.",
"marked_for_deletion_on": "2020-04-03",
...
}
```
2020-11-19 21:09:07 +00:00
When adding the parameter `with_projects=false` , projects aren't returned.
2018-07-09 12:24:29 +00:00
2020-01-30 15:09:15 +00:00
```shell
2020-05-28 00:08:37 +00:00
curl --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/groups/4?with_projects=false"
2018-07-09 12:24:29 +00:00
```
Example response:
```json
{
"id": 4,
"name": "Twitter",
"path": "twitter",
"description": "Aliquid qui quis dignissimos distinctio ut commodi voluptas est.",
"visibility": "public",
"avatar_url": null,
"web_url": "https://gitlab.example.com/groups/twitter",
"request_access_enabled": false,
"full_name": "Twitter",
"full_path": "twitter",
2018-09-26 10:58:58 +00:00
"file_template_project_id": 1,
2018-07-09 12:24:29 +00:00
"parent_id": null
}
```
2019-12-07 18:07:50 +00:00
### Disabling the results limit
The 100 results limit can be disabled if it breaks integrations developed using GitLab
12.4 and earlier.
To disable the limit while migrating to using the [list a group's projects ](#list-a-groups-projects ) endpoint, ask a GitLab administrator
with Rails console access to run the following command:
```ruby
Feature.disable(:limit_projects_in_groups_api)
```
2016-08-08 07:49:54 +00:00
## New group
Creates a new project group. Available only for users who can create groups.
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
POST /groups
```
Parameters:
2019-07-04 08:22:41 +00:00
| Attribute | Type | Required | Description |
| ------------------------------------ | ------- | -------- | ----------- |
| `name` | string | yes | The name of the group. |
| `path` | string | yes | The path of the group. |
| `description` | string | no | The group's description. |
2020-03-05 21:08:13 +00:00
| `membership_lock` | boolean | no | ** (STARTER)** Prevent adding new members to project membership within this group. |
2019-07-04 08:22:41 +00:00
| `visibility` | string | no | The group's visibility. Can be `private` , `internal` , or `public` . |
2019-10-07 15:05:59 +00:00
| `share_with_group_lock` | boolean | no | Prevent sharing a project with another group within this group. |
| `require_two_factor_authentication` | boolean | no | Require all users in this group to setup Two-factor authentication. |
| `two_factor_grace_period` | integer | no | Time before Two-factor authentication is enforced (in hours). |
| `project_creation_level` | string | no | Determine if developers can create projects in the group. Can be `noone` (No one), `maintainer` (Maintainers), or `developer` (Developers + Maintainers). |
| `auto_devops_enabled` | boolean | no | Default to Auto DevOps pipeline for all projects within this group. |
2021-04-20 15:09:24 +00:00
| `subgroup_creation_level` | string | no | Allowed to [create subgroups ](../user/group/subgroups/index.md#creating-a-subgroup ). Can be `owner` (Owners), or `maintainer` (Maintainers). |
2019-10-07 15:05:59 +00:00
| `emails_disabled` | boolean | no | Disable email notifications |
2020-05-21 06:08:25 +00:00
| `avatar` | mixed | no | Image file for avatar of the group. [Introduced in GitLab 12.9 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36681 ) |
2020-01-17 18:08:41 +00:00
| `mentions_disabled` | boolean | no | Disable the capability of a group from getting mentioned |
2019-07-04 08:22:41 +00:00
| `lfs_enabled` | boolean | no | Enable/disable Large File Storage (LFS) for the projects in this group. |
| `request_access_enabled` | boolean | no | Allow users to request member access. |
| `parent_id` | integer | no | The parent group ID for creating nested group. |
2020-03-02 12:07:57 +00:00
| `default_branch_protection` | integer | no | See [Options for `default_branch_protection` ](#options-for-default_branch_protection ). Default to the global level default branch protection setting. |
2021-01-29 15:09:40 +00:00
| `shared_runners_minutes_limit` | integer | no | ** (PREMIUM SELF)** Pipeline minutes quota for this group (included in plan). Can be `nil` (default; inherit system default), `0` (unlimited) or `> 0` |
| `extra_shared_runners_minutes_limit` | integer | no | ** (PREMIUM SELF)** Extra pipeline minutes quota for this group (purchased in addition to the minutes included in the plan). |
2016-08-08 07:49:54 +00:00
2020-03-02 12:07:57 +00:00
### Options for `default_branch_protection`
2021-03-17 21:11:29 +00:00
The `default_branch_protection` attribute determines whether developers and maintainers can push to the applicable [default branch ](../user/project/repository/branches/default.md ), as described in the following table:
2020-03-02 12:07:57 +00:00
| Value | Description |
|-------|-------------------------------------------------------------------------------------------------------------|
| `0` | No protection. Developers and maintainers can: < br > - Push new commits< br > - Force push changes< br > - Delete the branch |
| `1` | Partial protection. Developers and maintainers can: < br > - Push new commits |
| `2` | Full protection. Only maintainers can: < br > - Push new commits |
2020-06-10 21:09:29 +00:00
## New Subgroup
2020-11-19 21:09:07 +00:00
This is similar to creating a [New group ](#new-group ). You need the `parent_id` from the [List groups ](#list-groups ) call. You can then enter the desired:
2020-06-10 21:09:29 +00:00
- `subgroup_path`
- `subgroup_name`
```shell
curl --request POST --header "PRIVATE-TOKEN: < your_access_token > " --header "Content-Type: application/json" \
2020-09-24 15:09:51 +00:00
--data '{"path": "< subgroup_path > ", "name": "< subgroup_name > ", "parent_id": < parent_group_id > }' \
2020-06-10 21:09:29 +00:00
"https://gitlab.example.com/api/v4/groups/"
```
2016-08-08 07:49:54 +00:00
## Transfer project to group
2020-02-26 03:09:07 +00:00
Transfer a project to the Group namespace. Available only to instance administrators, although an [alternative API endpoint ](projects.md#transfer-a-project-to-a-new-namespace ) is available which does not require instance administrator access. Transferring projects may fail when tagged packages exist in the project's repository.
2016-08-08 07:49:54 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
POST /groups/:id/projects/:project_id
```
Parameters:
2019-07-04 08:22:41 +00:00
| Attribute | Type | Required | Description |
| ------------ | -------------- | -------- | ----------- |
2020-02-19 00:09:15 +00:00
| `id` | integer/string | yes | The ID or [URL-encoded path of the target group ](README.md#namespaced-path-encoding ) |
2019-07-04 08:22:41 +00:00
| `project_id` | integer/string | yes | The ID or [URL-encoded path of the project ](README.md#namespaced-path-encoding ) |
2016-08-08 07:49:54 +00:00
2020-02-19 00:09:15 +00:00
```shell
2020-05-28 00:08:37 +00:00
curl --request POST --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/groups/4/projects/56"
2020-02-19 00:09:15 +00:00
```
2016-08-08 07:49:54 +00:00
## Update group
Updates the project group. Only available to group owners and administrators.
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
PUT /groups/:id
```
2019-07-04 08:22:41 +00:00
| Attribute | Type | Required | Description |
| ------------------------------------ | ------- | -------- | ----------- |
| `id` | integer | yes | The ID of the group. |
| `name` | string | no | The name of the group. |
| `path` | string | no | The path of the group. |
| `description` | string | no | The description of the group. |
2019-07-08 08:50:38 +00:00
| `membership_lock` | boolean | no | ** (STARTER)** Prevent adding new members to project membership within this group. |
2019-07-04 08:22:41 +00:00
| `share_with_group_lock` | boolean | no | Prevent sharing a project with another group within this group. |
| `visibility` | string | no | The visibility level of the group. Can be `private` , `internal` , or `public` . |
2019-10-07 15:05:59 +00:00
| `require_two_factor_authentication` | boolean | no | Require all users in this group to setup Two-factor authentication. |
| `two_factor_grace_period` | integer | no | Time before Two-factor authentication is enforced (in hours). |
| `project_creation_level` | string | no | Determine if developers can create projects in the group. Can be `noone` (No one), `maintainer` (Maintainers), or `developer` (Developers + Maintainers). |
| `auto_devops_enabled` | boolean | no | Default to Auto DevOps pipeline for all projects within this group. |
2021-04-20 15:09:24 +00:00
| `subgroup_creation_level` | string | no | Allowed to [create subgroups ](../user/group/subgroups/index.md#creating-a-subgroup ). Can be `owner` (Owners), or `maintainer` (Maintainers). |
2019-10-07 15:05:59 +00:00
| `emails_disabled` | boolean | no | Disable email notifications |
2020-05-21 06:08:25 +00:00
| `avatar` | mixed | no | Image file for avatar of the group. [Introduced in GitLab 12.9 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36681 ) |
2020-01-17 18:08:41 +00:00
| `mentions_disabled` | boolean | no | Disable the capability of a group from getting mentioned |
2019-07-04 08:22:41 +00:00
| `lfs_enabled` (optional) | boolean | no | Enable/disable Large File Storage (LFS) for the projects in this group. |
| `request_access_enabled` | boolean | no | Allow users to request member access. |
2020-03-02 12:07:57 +00:00
| `default_branch_protection` | integer | no | See [Options for `default_branch_protection` ](#options-for-default_branch_protection ). |
2019-07-08 08:50:38 +00:00
| `file_template_project_id` | integer | no | ** (PREMIUM)** The ID of a project to load custom file templates from. |
2021-01-29 15:09:40 +00:00
| `shared_runners_minutes_limit` | integer | no | ** (PREMIUM SELF)** Pipeline minutes quota for this group (included in plan). Can be `nil` (default; inherit system default), `0` (unlimited) or `> 0` |
| `extra_shared_runners_minutes_limit` | integer | no | ** (PREMIUM SELF)** Extra pipeline minutes quota for this group (purchased in addition to the minutes included in the plan). |
2020-08-04 15:09:27 +00:00
| `prevent_forking_outside_group` | boolean | no | ** (PREMIUM)** When enabled, users can **not** fork projects from this group to external namespaces
2021-01-14 18:10:59 +00:00
| `shared_runners_setting` | string | no | See [Options for `shared_runners_setting` ](#options-for-shared_runners_setting ). Enable or disable shared runners for a group's subgroups and projects. |
2016-08-08 07:49:54 +00:00
2020-12-04 21:09:29 +00:00
NOTE:
2020-11-19 21:09:07 +00:00
The `projects` and `shared_projects` attributes in the response are deprecated and [scheduled for removal in API v5 ](https://gitlab.com/gitlab-org/gitlab/-/issues/213797 ).
2020-05-08 18:09:55 +00:00
To get the details of all projects within a group, use either the [list a group's projects ](#list-a-groups-projects ) or the [list a group's shared projects ](#list-a-groups-shared-projects ) endpoint.
2020-01-30 15:09:15 +00:00
```shell
2018-12-27 09:03:08 +00:00
curl --request PUT --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/groups/5?name=Experimental"
2016-08-08 07:49:54 +00:00
```
2019-12-07 18:07:50 +00:00
This endpoint returns:
- All projects and shared projects in GitLab 12.5 and earlier.
2020-05-21 06:08:25 +00:00
- A maximum of 100 projects and shared projects [in GitLab 12.6 ](https://gitlab.com/gitlab-org/gitlab/-/issues/31031 )
2019-12-07 18:07:50 +00:00
and later. To get the details of all projects within a group, use the
[list a group's projects endpoint ](#list-a-groups-projects ) instead.
2020-04-10 06:09:41 +00:00
2016-08-08 07:49:54 +00:00
Example response:
```json
{
"id": 5,
"name": "Experimental",
"path": "h5bp",
"description": "foo",
2017-02-16 13:56:14 +00:00
"visibility": "internal",
2016-08-08 07:49:54 +00:00
"avatar_url": null,
"web_url": "http://gitlab.example.com/groups/h5bp",
2016-09-14 22:04:27 +00:00
"request_access_enabled": false,
2017-01-27 13:53:19 +00:00
"full_name": "Foobar Group",
"full_path": "foo-bar",
2018-09-26 10:58:58 +00:00
"file_template_project_id": 1,
2017-02-07 15:42:37 +00:00
"parent_id": null,
2020-03-24 12:09:42 +00:00
"created_at": "2020-01-15T12:36:29.590Z",
2020-05-08 18:09:55 +00:00
"projects": [ // Deprecated and will be removed in API v5
2016-08-08 07:49:54 +00:00
{
"id": 9,
"description": "foo",
"default_branch": "master",
"tag_list": [],
"public": false,
"archived": false,
2017-02-16 13:56:14 +00:00
"visibility": "internal",
2016-08-08 07:49:54 +00:00
"ssh_url_to_repo": "git@gitlab.example.com/html5-boilerplate.git",
"http_url_to_repo": "http://gitlab.example.com/h5bp/html5-boilerplate.git",
"web_url": "http://gitlab.example.com/h5bp/html5-boilerplate",
"name": "Html5 Boilerplate",
"name_with_namespace": "Experimental / Html5 Boilerplate",
"path": "html5-boilerplate",
"path_with_namespace": "h5bp/html5-boilerplate",
"issues_enabled": true,
"merge_requests_enabled": true,
"wiki_enabled": true,
2017-03-06 09:24:03 +00:00
"jobs_enabled": true,
2016-08-08 07:49:54 +00:00
"snippets_enabled": true,
"created_at": "2016-04-05T21:40:50.169Z",
"last_activity_at": "2016-04-06T16:52:08.432Z",
"shared_runners_enabled": true,
"creator_id": 1,
"namespace": {
"id": 5,
"name": "Experimental",
"path": "h5bp",
2017-02-08 20:08:18 +00:00
"kind": "group"
2016-08-08 07:49:54 +00:00
},
"avatar_url": null,
"star_count": 1,
"forks_count": 0,
"open_issues_count": 3,
2017-03-06 09:24:03 +00:00
"public_jobs": true,
2016-09-14 22:04:27 +00:00
"shared_with_groups": [],
"request_access_enabled": false
2016-08-08 07:49:54 +00:00
}
]
}
```
2019-12-07 18:07:50 +00:00
### Disabling the results limit
The 100 results limit can be disabled if it breaks integrations developed using GitLab
12.4 and earlier.
To disable the limit while migrating to using the
[list a group's projects ](#list-a-groups-projects ) endpoint, ask a GitLab administrator
with Rails console access to run the following command:
```ruby
Feature.disable(:limit_projects_in_groups_api)
```
2021-01-14 18:10:59 +00:00
### Options for `shared_runners_setting`
The `shared_runners_setting` attribute determines whether shared runners are enabled for a group's subgroups and projects.
| Value | Description |
|-------|-------------------------------------------------------------------------------------------------------------|
| `enabled` | Enables shared runners for all projects and subgroups in this group. |
| `disabled_with_override` | Disables shared runners for all projects and subgroups in this group, but allows subgroups to override this setting. |
| `disabled_and_unoverridable` | Disables shared runners for all projects and subgroups in this group, and prevents subgroups from overriding this setting. |
2021-01-21 00:11:07 +00:00
### Upload a group avatar
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/36681) in GitLab 12.9.
To upload an avatar file from your file system, use the `--form` argument. This causes
curl to post data using the header `Content-Type: multipart/form-data` . The
`file=` parameter must point to a file on your file system and be preceded by
`@` . For example:
```shell
curl --request PUT --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/groups/22" --form "avatar=@/tmp/example.png"
```
2016-08-08 07:49:54 +00:00
## Remove group
2020-01-24 12:09:01 +00:00
Only available to group owners and administrators.
This endpoint either:
- Removes group, and queues a background job to delete all projects in the group as well.
2021-01-28 21:09:04 +00:00
- Since [GitLab 12.8 ](https://gitlab.com/gitlab-org/gitlab/-/issues/33257 ), on [Premium ](https://about.gitlab.com/pricing/ ) or higher tiers, marks a group for deletion. The deletion happens 7 days later by default, but this can be changed in the [instance settings ](../user/admin_area/settings/visibility_and_access_controls.md#default-deletion-delay ).
2016-08-08 07:49:54 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
DELETE /groups/:id
```
Parameters:
2020-01-24 12:09:01 +00:00
| Attribute | Type | Required | Description |
| --------------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
2020-11-19 21:09:07 +00:00
The response is `202 Accepted` if the user has authorization.
2020-01-24 12:09:01 +00:00
2021-03-29 12:09:14 +00:00
NOTE:
A GitLab.com group can't be removed if it is linked to a subscription. To remove such a group, first [link the subscription ](../subscriptions/index.md#change-the-linked-namespace ) with a different group.
2020-01-24 12:09:01 +00:00
## Restore group marked for deletion **(PREMIUM)**
2020-05-21 06:08:25 +00:00
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/33257) in GitLab 12.8.
2020-01-24 12:09:01 +00:00
Restores a group marked for deletion.
```plaintext
POST /groups/:id/restore
```
Parameters:
2016-08-08 07:49:54 +00:00
2020-01-24 12:09:01 +00:00
| Attribute | Type | Required | Description |
| --------------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
2018-05-18 01:05:11 +00:00
2016-08-08 07:49:54 +00:00
## Search for group
Get all groups that match your string in their name or path.
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
GET /groups?search=foobar
```
```json
[
{
"id": 1,
"name": "Foobar Group",
"path": "foo-bar",
"description": "An interesting group"
}
]
```
2021-02-04 21:09:06 +00:00
## Hooks **(PREMIUM)**
2020-01-23 18:08:53 +00:00
Also called Group Hooks and Webhooks.
These are different from [System Hooks ](system_hooks.md ) that are system wide and [Project Hooks ](projects.md#hooks ) that are limited to one project.
### List group hooks
Get a list of group hooks
2020-02-27 09:09:01 +00:00
```plaintext
2020-01-23 18:08:53 +00:00
GET /groups/:id/hooks
```
| Attribute | Type | Required | Description |
| --------- | --------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
### Get group hook
Get a specific hook for a group.
| Attribute | Type | Required | Description |
| --------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `hook_id` | integer | yes | The ID of a group hook |
2020-02-27 09:09:01 +00:00
```plaintext
2020-01-23 18:08:53 +00:00
GET /groups/:id/hooks/:hook_id
```
```json
{
"id": 1,
"url": "http://example.com/hook",
"group_id": 3,
"push_events": true,
"issues_events": true,
"confidential_issues_events": true,
"merge_requests_events": true,
"tag_push_events": true,
"note_events": true,
2020-04-01 03:07:57 +00:00
"confidential_note_events": true,
2020-01-23 18:08:53 +00:00
"job_events": true,
"pipeline_events": true,
"wiki_page_events": true,
2020-08-31 18:10:43 +00:00
"deployment_events": true,
2020-11-07 00:08:58 +00:00
"releases_events": true,
2021-02-04 21:09:06 +00:00
"subgroup_events": true,
2020-01-23 18:08:53 +00:00
"enable_ssl_verification": true,
"created_at": "2012-10-12T17:04:47Z"
}
```
### Add group hook
Adds a hook to a specified group.
2020-02-27 09:09:01 +00:00
```plaintext
2020-01-23 18:08:53 +00:00
POST /groups/:id/hooks
```
| Attribute | Type | Required | Description |
| -----------------------------| -------------- | ---------| ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `url` | string | yes | The hook URL |
| `push_events` | boolean | no | Trigger hook on push events |
| `issues_events` | boolean | no | Trigger hook on issues events |
| `confidential_issues_events` | boolean | no | Trigger hook on confidential issues events |
| `merge_requests_events` | boolean | no | Trigger hook on merge requests events |
| `tag_push_events` | boolean | no | Trigger hook on tag push events |
| `note_events` | boolean | no | Trigger hook on note events |
2020-04-01 03:07:57 +00:00
| `confidential_note_events` | boolean | no | Trigger hook on confidential note events |
2020-01-23 18:08:53 +00:00
| `job_events` | boolean | no | Trigger hook on job events |
| `pipeline_events` | boolean | no | Trigger hook on pipeline events |
| `wiki_page_events` | boolean | no | Trigger hook on wiki events |
2020-08-31 18:10:43 +00:00
| `deployment_events` | boolean | no | Trigger hook on deployment events |
2020-11-07 00:08:58 +00:00
| `releases_events` | boolean | no | Trigger hook on release events |
2021-02-04 21:09:06 +00:00
| `subgroup_events` | boolean | no | Trigger hook on subgroup events |
2020-01-23 18:08:53 +00:00
| `enable_ssl_verification` | boolean | no | Do SSL verification when triggering the hook |
2020-11-19 21:09:07 +00:00
| `token` | string | no | Secret token to validate received payloads; not returned in the response |
2020-01-23 18:08:53 +00:00
### Edit group hook
Edits a hook for a specified group.
2020-02-27 09:09:01 +00:00
```plaintext
2020-01-23 18:08:53 +00:00
PUT /groups/:id/hooks/:hook_id
```
| Attribute | Type | Required | Description |
| ---------------------------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `hook_id` | integer | yes | The ID of the group hook |
| `url` | string | yes | The hook URL |
| `push_events` | boolean | no | Trigger hook on push events |
| `issues_events` | boolean | no | Trigger hook on issues events |
| `confidential_issues_events` | boolean | no | Trigger hook on confidential issues events |
| `merge_requests_events` | boolean | no | Trigger hook on merge requests events |
| `tag_push_events` | boolean | no | Trigger hook on tag push events |
| `note_events` | boolean | no | Trigger hook on note events |
2020-04-01 03:07:57 +00:00
| `confidential_note_events` | boolean | no | Trigger hook on confidential note events |
2020-01-23 18:08:53 +00:00
| `job_events` | boolean | no | Trigger hook on job events |
| `pipeline_events` | boolean | no | Trigger hook on pipeline events |
| `wiki_events` | boolean | no | Trigger hook on wiki events |
2020-08-31 18:10:43 +00:00
| `deployment_events` | boolean | no | Trigger hook on deployment events |
2020-11-07 00:08:58 +00:00
| `releases_events` | boolean | no | Trigger hook on release events |
2021-02-04 21:09:06 +00:00
| `subgroup_events` | boolean | no | Trigger hook on subgroup events |
2020-01-23 18:08:53 +00:00
| `enable_ssl_verification` | boolean | no | Do SSL verification when triggering the hook |
2020-11-19 21:09:07 +00:00
| `token` | string | no | Secret token to validate received payloads; not returned in the response |
2020-01-23 18:08:53 +00:00
### Delete group hook
Removes a hook from a group. This is an idempotent method and can be called multiple times.
Either the hook is available or not.
2020-02-27 09:09:01 +00:00
```plaintext
2020-01-23 18:08:53 +00:00
DELETE /groups/:id/hooks/:hook_id
```
| Attribute | Type | Required | Description |
| --------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `hook_id` | integer | yes | The ID of the group hook. |
2019-11-15 03:06:34 +00:00
## Group Audit Events **(STARTER)**
2020-09-07 15:09:04 +00:00
Group audit events can be accessed via the [Group Audit Events API ](audit_events.md#group-audit-events )
2019-11-15 03:06:34 +00:00
2021-01-29 15:09:40 +00:00
## Sync group with LDAP **(PREMIUM SELF)**
2019-07-03 09:32:54 +00:00
Syncs the group with its linked LDAP group. Only available to group owners and administrators.
2020-02-27 09:09:01 +00:00
```plaintext
2019-07-03 09:32:54 +00:00
POST /groups/:id/ldap_sync
```
Parameters:
- `id` (required) - The ID or path of a user group
2016-08-08 07:49:54 +00:00
## Group members
2016-06-23 15:14:31 +00:00
Please consult the [Group Members ](members.md ) documentation.
2016-08-08 07:49:54 +00:00
2020-02-14 12:09:03 +00:00
## LDAP Group Links
List, add, and delete LDAP group links.
2021-01-29 15:09:40 +00:00
### List LDAP group links **(PREMIUM SELF)**
2020-02-14 12:09:03 +00:00
Lists LDAP group links.
2020-02-27 09:09:01 +00:00
```plaintext
2020-02-14 12:09:03 +00:00
GET /groups/:id/ldap_group_links
```
2020-04-21 15:21:10 +00:00
| Attribute | Type | Required | Description |
| --------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
2020-02-14 12:09:03 +00:00
2021-01-29 15:09:40 +00:00
### Add LDAP group link with CN or filter **(PREMIUM SELF)**
2019-07-03 09:32:54 +00:00
2020-04-21 15:21:10 +00:00
Adds an LDAP group link using a CN or filter. Adding a group link by filter is only supported in the Premium tier and above.
2019-07-03 09:32:54 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2019-07-03 09:32:54 +00:00
POST /groups/:id/ldap_group_links
```
2020-04-21 15:21:10 +00:00
| Attribute | Type | Required | Description |
| --------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `cn` | string | no | The CN of an LDAP group |
| `filter` | string | no | The LDAP filter for the group |
2020-07-09 18:10:09 +00:00
| `group_access` | integer | yes | Minimum [access level ](members.md#valid-access-levels ) for members of the LDAP group |
2020-04-21 15:21:10 +00:00
| `provider` | string | yes | LDAP provider for the LDAP group link |
2019-07-03 09:32:54 +00:00
2020-12-04 21:09:29 +00:00
NOTE:
2020-04-21 15:21:10 +00:00
To define the LDAP group link, provide either a `cn` or a `filter` , but not both.
2019-07-03 09:32:54 +00:00
2021-01-29 15:09:40 +00:00
### Delete LDAP group link **(PREMIUM SELF)**
2019-07-03 09:32:54 +00:00
2020-11-19 21:09:07 +00:00
Deletes an LDAP group link. Deprecated. Scheduled for removal in a future release.
2019-07-03 09:32:54 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2019-07-03 09:32:54 +00:00
DELETE /groups/:id/ldap_group_links/:cn
```
2020-04-21 15:21:10 +00:00
| Attribute | Type | Required | Description |
| --------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `cn` | string | yes | The CN of an LDAP group |
2019-07-03 09:32:54 +00:00
2020-11-19 21:09:07 +00:00
Deletes an LDAP group link for a specific LDAP provider. Deprecated. Scheduled for removal in a future release.
2019-07-03 09:32:54 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2019-07-03 09:32:54 +00:00
DELETE /groups/:id/ldap_group_links/:provider/:cn
```
2020-04-21 15:21:10 +00:00
| Attribute | Type | Required | Description |
| --------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `cn` | string | yes | The CN of an LDAP group |
| `provider` | string | yes | LDAP provider for the LDAP group link |
2019-07-03 09:32:54 +00:00
2021-01-29 15:09:40 +00:00
### Delete LDAP group link with CN or filter **(PREMIUM SELF)**
2020-04-21 15:21:10 +00:00
Deletes an LDAP group link using a CN or filter. Deleting by filter is only supported in the Premium tier and above.
```plaintext
DELETE /groups/:id/ldap_group_links
```
| Attribute | Type | Required | Description |
| --------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `cn` | string | no | The CN of an LDAP group |
| `filter` | string | no | The LDAP filter for the group |
| `provider` | string | yes | LDAP provider for the LDAP group link |
2020-12-04 21:09:29 +00:00
NOTE:
2020-04-21 15:21:10 +00:00
To delete the LDAP group link, provide either a `cn` or a `filter` , but not both.
2019-07-03 09:32:54 +00:00
2016-08-08 07:49:54 +00:00
## Namespaces in groups
By default, groups only get 20 namespaces at a time because the API results are paginated.
To get more (up to 100), pass the following as an argument to the API call:
2019-07-12 08:09:23 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
/groups?per_page=100
```
And to switch pages add:
2019-07-12 08:09:23 +00:00
2020-02-27 09:09:01 +00:00
```plaintext
2016-08-08 07:49:54 +00:00
/groups?per_page=100& page=2
```
2017-11-17 14:04:20 +00:00
2018-03-05 17:51:40 +00:00
## Group badges
Read more in the [Group Badges ](group_badges.md ) documentation.
2020-02-11 09:08:39 +00:00
## Group Import/Export
Read more in the [Group Import/Export ](group_import_export.md ) documentation.
2020-06-09 18:08:28 +00:00
## Share Groups with Groups
2021-03-04 03:10:58 +00:00
These endpoints create and delete links for sharing a group with another group. For more information, see the related discussion in the [GitLab Groups ](../user/group/index.md#share-a-group-with-another-group ) page.
2020-06-09 18:08:28 +00:00
### Create a link to share a group with another group
Share group with another group. Returns `200` and the [group details ](#details-of-a-group ) on success.
```plaintext
POST /groups/:id/share
```
| Attribute | Type | Required | Description |
| --------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `group_id` | integer | yes | The ID of the group to share with |
2020-07-09 18:10:09 +00:00
| `group_access` | integer | yes | The [access level ](members.md#valid-access-levels ) to grant the group |
2020-06-09 18:08:28 +00:00
| `expires_at` | string | no | Share expiration date in ISO 8601 format: 2016-09-26 |
### Delete link sharing group with another group
Unshare the group from another group. Returns `204` and no content on success.
```plaintext
DELETE /groups/:id/share/:group_id
```
| Attribute | Type | Required | Description |
| --------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `group_id` | integer | yes | The ID of the group to share with |
2020-08-20 00:10:11 +00:00
## Push Rules **(STARTER)**
2020-09-03 21:08:18 +00:00
> Introduced in [GitLab Starter](https://about.gitlab.com/pricing/) 13.4.
2020-09-01 12:11:01 +00:00
### Get group push rules **(STARTER)**
2020-08-20 00:10:11 +00:00
2020-09-07 15:09:04 +00:00
Get the [push rules ](../user/group/index.md#group-push-rules ) of a group.
2020-08-20 00:10:11 +00:00
2020-09-03 21:08:18 +00:00
Only available to group owners and administrators.
2020-08-20 00:10:11 +00:00
```plaintext
GET /groups/:id/push_rule
```
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `id` | integer/string | yes | The ID of the group or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
```json
{
"id": 2,
"created_at": "2020-08-17T19:09:19.580Z",
"commit_message_regex": "[a-zA-Z]",
"commit_message_negative_regex": "[x+]",
"branch_name_regex": "[a-z]",
"deny_delete_tag": true,
"member_check": true,
"prevent_secrets": true,
"author_email_regex": "^[A-Za-z0-9.]+@gitlab.com$",
"file_name_regex": "(exe)$",
"max_file_size": 100
}
```
2021-01-28 21:09:04 +00:00
Users on GitLab [Premium or higher ](https://about.gitlab.com/pricing/ ) also see
2020-08-20 00:10:11 +00:00
the `commit_committer_check` and `reject_unsigned_commits` parameters:
```json
{
"id": 2,
"created_at": "2020-08-17T19:09:19.580Z",
"commit_committer_check": true,
"reject_unsigned_commits": false,
...
}
```
2020-08-27 18:10:29 +00:00
### Add group push rule **(STARTER)**
2020-09-07 15:09:04 +00:00
Adds [push rules ](../user/group/index.md#group-push-rules ) to the specified group.
2020-08-27 18:10:29 +00:00
2020-09-03 21:08:18 +00:00
Only available to group owners and administrators.
2020-08-27 18:10:29 +00:00
```plaintext
POST /groups/:id/push_rule
```
| Attribute | Type | Required | Description |
| --------------------------------------------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `deny_delete_tag` ** (STARTER)** | boolean | no | Deny deleting a tag |
| `member_check` ** (STARTER)** | boolean | no | Allows only GitLab users to author commits |
2020-11-19 21:09:07 +00:00
| `prevent_secrets` ** (STARTER)** | boolean | no | [Files that are likely to contain secrets ](https://gitlab.com/gitlab-org/gitlab/-/blob/master/ee/lib/gitlab/checks/files_denylist.yml ) are rejected |
2020-08-27 18:10:29 +00:00
| `commit_message_regex` ** (STARTER)** | string | no | All commit messages must match the regular expression provided in this attribute, e.g. `Fixed \d+\..*` |
2020-11-19 21:09:07 +00:00
| `commit_message_negative_regex` ** (STARTER)** | string | no | Commit messages matching the regular expression provided in this attribute aren't allowed, e.g. `ssh\:\/\/` |
2020-08-27 18:10:29 +00:00
| `branch_name_regex` ** (STARTER)** | string | no | All branch names must match the regular expression provided in this attribute, e.g. `(feature|hotfix)\/*` |
| `author_email_regex` ** (STARTER)** | string | no | All commit author emails must match the regular expression provided in this attribute, e.g. `@my-company.com$` |
2020-11-19 21:09:07 +00:00
| `file_name_regex` ** (STARTER)** | string | no | Filenames matching the regular expression provided in this attribute are **not** allowed, e.g. `(jar|exe)$` |
2020-08-27 18:10:29 +00:00
| `max_file_size` ** (STARTER)** | integer | no | Maximum file size (MB) allowed |
2020-11-19 21:09:07 +00:00
| `commit_committer_check` ** (PREMIUM)** | boolean | no | Only commits pushed using verified emails are allowed |
| `reject_unsigned_commits` ** (PREMIUM)** | boolean | no | Only commits signed through GPG are allowed |
2020-09-01 12:11:01 +00:00
```shell
curl --request POST --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/groups/19/push_rule"
```
Response:
```json
{
"id": 19,
"created_at": "2020-08-31T15:53:00.073Z",
"commit_message_regex": "[a-zA-Z]",
"commit_message_negative_regex": "[x+]",
"branch_name_regex": null,
"deny_delete_tag": false,
"member_check": false,
"prevent_secrets": false,
"author_email_regex": "^[A-Za-z0-9.]+@gitlab.com$",
"file_name_regex": null,
"max_file_size": 100
}
```
### Edit group push rule **(STARTER)**
Edit push rules for a specified group.
2020-09-03 21:08:18 +00:00
Only available to group owners and administrators.
2020-09-01 12:11:01 +00:00
```plaintext
PUT /groups/:id/push_rule
```
| Attribute | Type | Required | Description |
| --------------------------------------------- | -------------- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |
| `deny_delete_tag` ** (STARTER)** | boolean | no | Deny deleting a tag |
| `member_check` ** (STARTER)** | boolean | no | Restricts commits to be authored by existing GitLab users only |
2020-11-19 21:09:07 +00:00
| `prevent_secrets` ** (STARTER)** | boolean | no | [Files that are likely to contain secrets ](https://gitlab.com/gitlab-org/gitlab/-/blob/master/ee/lib/gitlab/checks/files_denylist.yml ) are rejected |
2020-09-01 12:11:01 +00:00
| `commit_message_regex` ** (STARTER)** | string | no | All commit messages must match the regular expression provided in this attribute, e.g. `Fixed \d+\..*` |
2020-11-19 21:09:07 +00:00
| `commit_message_negative_regex` ** (STARTER)** | string | no | Commit messages matching the regular expression provided in this attribute aren't allowed, e.g. `ssh\:\/\/` |
2020-09-01 12:11:01 +00:00
| `branch_name_regex` ** (STARTER)** | string | no | All branch names must match the regular expression provided in this attribute, e.g. `(feature|hotfix)\/*` |
| `author_email_regex` ** (STARTER)** | string | no | All commit author emails must match the regular expression provided in this attribute, e.g. `@my-company.com$` |
2020-11-19 21:09:07 +00:00
| `file_name_regex` ** (STARTER)** | string | no | Filenames matching the regular expression provided in this attribute are **not** allowed, e.g. `(jar|exe)$` |
2020-09-01 12:11:01 +00:00
| `max_file_size` ** (STARTER)** | integer | no | Maximum file size (MB) allowed |
2020-11-19 21:09:07 +00:00
| `commit_committer_check` ** (PREMIUM)** | boolean | no | Only commits pushed using verified emails are allowed |
| `reject_unsigned_commits` ** (PREMIUM)** | boolean | no | Only commits signed through GPG are allowed |
2020-09-01 12:11:01 +00:00
```shell
curl --request PUT --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/groups/19/push_rule"
```
Response:
```json
{
"id": 19,
"created_at": "2020-08-31T15:53:00.073Z",
"commit_message_regex": "[a-zA-Z]",
"commit_message_negative_regex": "[x+]",
"branch_name_regex": null,
"deny_delete_tag": false,
"member_check": false,
"prevent_secrets": false,
"author_email_regex": "^[A-Za-z0-9.]+@staging.gitlab.com$",
"file_name_regex": null,
"max_file_size": 100
}
```
2020-09-03 21:08:18 +00:00
### Delete group push rule **(STARTER)**
2020-09-07 15:09:04 +00:00
Deletes the [push rules ](../user/group/index.md#group-push-rules ) of a group.
2020-09-03 21:08:18 +00:00
Only available to group owners and administrators.
```plaintext
DELETE /groups/:id/push_rule
```
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the group ](README.md#namespaced-path-encoding ) |