diff options
Diffstat (limited to 'doc/api/features.md')
-rw-r--r-- | doc/api/features.md | 25 |
1 files changed, 13 insertions, 12 deletions
diff --git a/doc/api/features.md b/doc/api/features.md index 6f3af683020..819405bea77 100644 --- a/doc/api/features.md +++ b/doc/api/features.md @@ -111,20 +111,21 @@ percentage of time. POST /features/:name ``` -| Attribute | Type | Required | Description | -| --------- | ---- | -------- | ----------- | -| `name` | string | yes | Name of the feature to create or update | -| `value` | integer/string | yes | `true` or `false` to enable/disable, or an integer for percentage of time | -| `key` | string | no | `percentage_of_actors` or `percentage_of_time` (default) | -| `feature_group` | string | no | A Feature group name | -| `user` | string | no | A GitLab username or comma-separated multiple usernames | -| `group` | string | no | A GitLab group's path, for example `gitlab-org`, or comma-separated multiple group paths | -| `namespace` | string | no | A GitLab group or user namespace's path, for example `john-doe`, or comma-separated multiple namespace paths. [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/353117) in GitLab 15.0. | -| `project` | string | no | A projects path, for example `gitlab-org/gitlab-foss`, or comma-separated multiple project paths | -| `force` | boolean | no | Skip feature flag validation checks, such as a YAML definition | +| Attribute | Type | Required | Description | +|-----------------|----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `name` | string | yes | Name of the feature to create or update | +| `value` | integer/string | yes | `true` or `false` to enable/disable, or an integer for percentage of time | +| `key` | string | no | `percentage_of_actors` or `percentage_of_time` (default) | +| `feature_group` | string | no | A Feature group name | +| `user` | string | no | A GitLab username or comma-separated multiple usernames | +| `group` | string | no | A GitLab group's path, for example `gitlab-org`, or comma-separated multiple group paths | +| `namespace` | string | no | A GitLab group or user namespace's path, for example `john-doe`, or comma-separated multiple namespace paths. [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/353117) in GitLab 15.0. | +| `project` | string | no | A projects path, for example `gitlab-org/gitlab-foss`, or comma-separated multiple project paths | +| `repository` | string | no | A repository path, for example `gitlab-org/gitlab-test.git`, `gitlab-org/gitlab-test.wiki.git`, , `snippets/21.git`, to name a few. Use comma to separate multiple repository paths | +| `force` | boolean | no | Skip feature flag validation checks, such as a YAML definition | You can enable or disable a feature for a `feature_group`, a `user`, -a `group`, a `namespace` and a `project` in a single API call. +a `group`, a `namespace`, a `project`, and a `repository` in a single API call. ```shell curl --data "value=30" --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/features/new_library" |