Skip to content

Commit 34895a4

Browse files
Ashraf KhamisManoj M JLorena Ciutacu
committed
Merge branch 'master-patch-d8e3' into 'master'
Update app settings API version history See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/130710 Merged-by: Ashraf Khamis <akhamis@gitlab.com> Approved-by: Ashraf Khamis <akhamis@gitlab.com> Approved-by: Manoj M J <mmj@gitlab.com> Reviewed-by: Manoj M J <mmj@gitlab.com> Reviewed-by: Lorena Ciutacu <lciutacu@gitlab.com> Co-authored-by: Manoj M J <mmj@gitlab.com> Co-authored-by: Lorena Ciutacu <lciutacu@gitlab.com>
2 parents 225dc1e + a7f4c05 commit 34895a4

1 file changed

Lines changed: 8 additions & 16 deletions

File tree

doc/api/settings.md

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,9 @@ For information on how to control the application settings cache for an instance
1717

1818
## Get current application settings
1919

20+
> - `always_perform_delayed_deletion` feature flag [enabled](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/113332) in GitLab 15.11.
21+
> - `delayed_project_deletion` and `delayed_group_deletion` attributes removed in GitLab 16.0.
22+
2023
List the current [application settings](#list-of-settings-that-can-be-accessed-via-api-calls)
2124
of the GitLab instance.
2225

@@ -127,27 +130,20 @@ these parameters:
127130
- `file_template_project_id`
128131
- `geo_node_allowed_ips`
129132
- `geo_status_timeout`
130-
- `delayed_project_deletion`
131-
- `delayed_group_deletion`
132133
- `default_project_deletion_protection`
133134
- `deletion_adjourned_period`
134135
- `disable_personal_access_tokens`
135136
- `security_policy_global_group_approvers_enabled`
136137
- `delete_unconfirmed_users`
137138
- `unconfirmed_users_delete_after_days`
138139

139-
From [GitLab 15.11](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/113332), with the `always_perform_delayed_deletion` feature flag enabled,
140-
the `delayed_project_deletion` and `delayed_group_deletion` attributes will not be exposed. These attributes will be removed in GitLab 16.0.
141-
142140
```json
143141
{
144142
"id": 1,
145143
"signup_enabled": true,
146144
"group_owners_can_manage_default_branch_protection": true,
147145
"file_template_project_id": 1,
148146
"geo_node_allowed_ips": "0.0.0.0/0, ::/0",
149-
"delayed_project_deletion": false,
150-
"delayed_group_deletion": false,
151147
"default_project_deletion_protection": false,
152148
"deletion_adjourned_period": 7,
153149
"disable_personal_access_tokens": false,
@@ -157,6 +153,9 @@ the `delayed_project_deletion` and `delayed_group_deletion` attributes will not
157153

158154
## Change application settings
159155

156+
> - `always_perform_delayed_deletion` feature flag [enabled](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/113332) in GitLab 15.11.
157+
> - `delayed_project_deletion` and `delayed_group_deletion` attributes removed in GitLab 16.0.
158+
160159
Use an API call to modify GitLab instance
161160
[application settings](#list-of-settings-that-can-be-accessed-via-api-calls).
162161

@@ -273,18 +272,13 @@ these parameters:
273272
- `file_template_project_id`
274273
- `geo_node_allowed_ips`
275274
- `geo_status_timeout`
276-
- `delayed_project_deletion`
277-
- `delayed_group_deletion`
278275
- `default_project_deletion_protection`
279276
- `deletion_adjourned_period`
280277
- `disable_personal_access_tokens`
281278
- `security_policy_global_group_approvers_enabled`
282279
- `delete_unconfirmed_users`
283280
- `unconfirmed_users_delete_after_days`
284281

285-
From [GitLab 15.11](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/113332), with the `always_perform_delayed_deletion` feature flag enabled,
286-
the `delayed_project_deletion` and `delayed_group_deletion` attributes will not be exposed. These attributes will be removed in GitLab 16.0.
287-
288282
Example responses: **(PREMIUM SELF)**
289283

290284
```json
@@ -359,12 +353,10 @@ listed in the descriptions of the relevant settings.
359353
| `default_project_visibility` | string | no | What visibility level new projects receive. Can take `private`, `internal` and `public` as a parameter. Default is `private`. |
360354
| `default_projects_limit` | integer | no | Project limit per user. Default is `100000`. |
361355
| `default_snippet_visibility` | string | no | What visibility level new snippets receive. Can take `private`, `internal` and `public` as a parameter. Default is `private`. |
362-
| `default_syntax_highlighting_theme` | integer | no | Default syntax highlighting theme for new users and users who are not signed in. See [IDs of available themes](https://gitlab.com/gitlab-org/gitlab/blob/master/lib/gitlab/themes.rb#L16).
363-
| `delayed_project_deletion` **(PREMIUM SELF)** | boolean | no | Enable delayed project deletion by default in new groups. Default is `false`. [From GitLab 15.1](https://gitlab.com/gitlab-org/gitlab/-/issues/352960), can only be enabled when `delayed_group_deletion` is true. From [GitLab 15.11](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/113332), with the `always_perform_delayed_deletion` feature flag enabled, this attribute has been removed. This attribute will be completely removed in GitLab 16.0. |
364-
| `delayed_group_deletion` **(PREMIUM SELF)** | boolean | no | Enable delayed group deletion. Default is `true`. [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/352959) in GitLab 15.0. [From GitLab 15.1](https://gitlab.com/gitlab-org/gitlab/-/issues/352960), disables and locks the group-level setting for delayed protect deletion when set to `false`. From [GitLab 15.11](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/113332), with the `always_perform_delayed_deletion` feature flag enabled, this attribute has been removed. This attribute will be completely removed in GitLab 16.0. |
356+
| `default_syntax_highlighting_theme` | integer | no | Default syntax highlighting theme for users who are new or not signed in. See [IDs of available themes](https://gitlab.com/gitlab-org/gitlab/blob/master/lib/gitlab/themes.rb#L16). |
365357
| `default_project_deletion_protection` **(PREMIUM SELF)** | boolean | no | Enable default project deletion protection so only administrators can delete projects. Default is `false`. |
366358
| `delete_unconfirmed_users` **(PREMIUM SELF)** | boolean | no | Specifies whether users who have not confirmed their email should be deleted. Default is `false`. When set to `true`, unconfirmed users are deleted after `unconfirmed_users_delete_after_days` days. [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/352514) in GitLab 16.1. |
367-
| `deletion_adjourned_period` **(PREMIUM SELF)** | integer | no | The number of days to wait before deleting a project or group that is marked for deletion. Value must be between `1` and `90`. Defaults to `7`. [From GitLab 15.1](https://gitlab.com/gitlab-org/gitlab/-/issues/352960), a hook on `deletion_adjourned_period` sets the period to `1` on every update, and sets both `delayed_project_deletion` and `delayed_group_deletion` to `false` if the period is `0`. |
359+
| `deletion_adjourned_period` **(PREMIUM SELF)** | integer | no | Number of days to wait before deleting a project or group that is marked for deletion. Value must be between `1` and `90`. Defaults to `7`. |
368360
| `diagramsnet_enabled` | boolean | no | (If enabled, requires `diagramsnet_url`) Enable [Diagrams.net integration](../administration/integration/diagrams_net.md). Default is `true`. |
369361
| `diagramsnet_url` | string | required by: `diagramsnet_enabled` | The Diagrams.net instance URL for integration. |
370362
| `diff_max_patch_bytes` | integer | no | Maximum [diff patch size](../administration/diff_limits.md), in bytes. |

0 commit comments

Comments
 (0)