Commit 8ac2c3ef authored by Marcel Amirault's avatar Marcel Amirault Committed by Achilleas Pipinellis

Clean up EE api docs that were merged to CE

Many small fixes to api docs which were merged from EE to CE,
and tables cleaned up, as noted in issue
https://gitlab.com/gitlab-org/gitlab-ce/issues/64072
parent 9a4b5f08
...@@ -5,7 +5,7 @@ Every API call to group boards must be authenticated. ...@@ -5,7 +5,7 @@ Every API call to group boards must be authenticated.
If a user is not a member of a group and the group is private, a `GET` If a user is not a member of a group and the group is private, a `GET`
request will result in `404` status code. request will result in `404` status code.
## Group Board ## List all group issue boards in a group
Lists Issue Boards in the given group. Lists Issue Boards in the given group.
...@@ -71,8 +71,7 @@ Example response: ...@@ -71,8 +71,7 @@ Example response:
``` ```
Users on GitLab [Premium, Silver, or higher](https://about.gitlab.com/pricing/) will see Users on GitLab [Premium, Silver, or higher](https://about.gitlab.com/pricing/) will see
different parameters, due to the ability to have multiple group boards. Refer to the table different parameters, due to the ability to have multiple group boards.
above to see what enpoint(s) belong to each tier.
Example response: Example response:
...@@ -123,9 +122,9 @@ Example response: ...@@ -123,9 +122,9 @@ Example response:
] ]
``` ```
## Single board ## Single group issue board
Gets a single board. Gets a single group issue board.
``` ```
GET /groups/:id/boards/:board_id GET /groups/:id/boards/:board_id
...@@ -188,7 +187,7 @@ Example response: ...@@ -188,7 +187,7 @@ Example response:
``` ```
Users on GitLab [Premium, Silver, or higher](https://about.gitlab.com/pricing/) will see Users on GitLab [Premium, Silver, or higher](https://about.gitlab.com/pricing/) will see
different parameters, due to the ability to have multiple group boards: different parameters, due to the ability to have multiple group issue boards.s
Example response: Example response:
...@@ -237,7 +236,7 @@ Example response: ...@@ -237,7 +236,7 @@ Example response:
} }
``` ```
## Create a Group Issue Board **[PREMIUM]** ## Create a group issue board **[PREMIUM]**
Creates a Group Issue Board. Creates a Group Issue Board.
...@@ -301,9 +300,9 @@ Example response: ...@@ -301,9 +300,9 @@ Example response:
} }
``` ```
## Update a Group Issue Board **[PREMIUM]** ## Update a group issue board **[PREMIUM]**
> [Introduced][ee-5954] in GitLab 11.1. > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5954) in GitLab 11.1.
Updates a Group Issue Board. Updates a Group Issue Board.
...@@ -321,7 +320,6 @@ PUT /groups/:id/boards/:board_id ...@@ -321,7 +320,6 @@ PUT /groups/:id/boards/:board_id
| `labels` | string | no | Comma-separated list of label names which the board should be scoped to | | `labels` | string | no | Comma-separated list of label names which the board should be scoped to |
| `weight` | integer | no | The weight range from 0 to 9, to which the board should be scoped to | | `weight` | integer | no | The weight range from 0 to 9, to which the board should be scoped to |
```bash ```bash
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/boards/1?name=new_name&milestone_id=44&assignee_id=1&labels=GroupLabel&weight=4 curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/boards/1?name=new_name&milestone_id=44&assignee_id=1&labels=GroupLabel&weight=4
``` ```
...@@ -370,7 +368,7 @@ Example response: ...@@ -370,7 +368,7 @@ Example response:
} }
``` ```
## Delete a Group Issue Board **[PREMIUM]** ## Delete a group issue board **[PREMIUM]**
Deletes a Group Issue Board. Deletes a Group Issue Board.
...@@ -387,7 +385,7 @@ DELETE /groups/:id/boards/:board_id ...@@ -387,7 +385,7 @@ DELETE /groups/:id/boards/:board_id
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/boards/1 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/boards/1
``` ```
## List board lists ## List group issue board lists
Get a list of the board's lists. Get a list of the board's lists.
Does not include `open` and `closed` lists Does not include `open` and `closed` lists
...@@ -439,7 +437,7 @@ Example response: ...@@ -439,7 +437,7 @@ Example response:
] ]
``` ```
## Single board list ## Single group issue board list
Get a single board list. Get a single board list.
...@@ -471,7 +469,7 @@ Example response: ...@@ -471,7 +469,7 @@ Example response:
} }
``` ```
## New board list ## New group issue board list
Creates a new Issue Board list. Creates a new Issue Board list.
...@@ -503,7 +501,7 @@ Example response: ...@@ -503,7 +501,7 @@ Example response:
} }
``` ```
## Edit board list ## Edit group issue board list
Updates an existing Issue Board list. This call is used to change list position. Updates an existing Issue Board list. This call is used to change list position.
...@@ -536,7 +534,7 @@ Example response: ...@@ -536,7 +534,7 @@ Example response:
} }
``` ```
## Delete a board list ## Delete a group issue board list
Only for admins and group owners. Soft deletes the board list in question. Only for admins and group owners. Soft deletes the board list in question.
...@@ -553,5 +551,3 @@ DELETE /groups/:id/boards/:board_id/lists/:list_id ...@@ -553,5 +551,3 @@ DELETE /groups/:id/boards/:board_id/lists/:list_id
```bash ```bash
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/boards/1/lists/1 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/boards/1/lists/1
``` ```
[ee-5954]: https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5954
This diff is collapsed.
...@@ -850,9 +850,9 @@ If `approvals_before_merge` **[STARTER]** is not provided, it inherits the value ...@@ -850,9 +850,9 @@ If `approvals_before_merge` **[STARTER]** is not provided, it inherits the value
target project. If it is provided, then the following conditions must hold in target project. If it is provided, then the following conditions must hold in
order for it to take effect: order for it to take effect:
1. The target project's `approvals_before_merge` must be greater than zero. (A 1. The target project's `approvals_before_merge` must be greater than zero. A
value of zero disables approvals for that project.) value of zero disables approvals for that project.
2. The provided value of `approvals_before_merge` must be greater than the 1. The provided value of `approvals_before_merge` must be greater than the
target project's `approvals_before_merge`. target project's `approvals_before_merge`.
```json ```json
...@@ -1296,7 +1296,7 @@ the `approvals_before_merge` parameter: ...@@ -1296,7 +1296,7 @@ the `approvals_before_merge` parameter:
## Merge to default merge ref path ## Merge to default merge ref path
Merge the changes between the merge request source and target branches into `refs/merge-requests/:iid/merge` Merge the changes between the merge request source and target branches into `refs/merge-requests/:iid/merge`
ref, of the target project repository, if possible. This ref will have the state the target branch would have if ref, of the target project repository, if possible. This ref will have the state the target branch would have if
a regular merge action was taken. a regular merge action was taken.
......
...@@ -68,7 +68,7 @@ the `plan` parameter associated with a namespace: ...@@ -68,7 +68,7 @@ the `plan` parameter associated with a namespace:
] ]
``` ```
**Note**: Only group maintainers/owners are presented with `members_count_with_descendants`, as well as `plan` **[BRONZE ONLY]**. NOTE: **Note:** Only group maintainers/owners are presented with `members_count_with_descendants`, as well as `plan` **[BRONZE ONLY]**.
## Search for namespace ## Search for namespace
......
# Notification settings API # Notification settings API
>**Note:** This feature was [introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/5632) in GitLab 8.12. > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/5632) in GitLab 8.12.
**Valid notification levels** ## Valid notification levels
The notification levels are defined in the `NotificationSetting.level` model enumeration. Currently, these levels are recognized: The notification levels are defined in the `NotificationSetting.level` model enumeration. Currently, these levels are recognized:
...@@ -33,7 +33,6 @@ If the `custom` level is used, specific email events can be controlled. Availabl ...@@ -33,7 +33,6 @@ If the `custom` level is used, specific email events can be controlled. Availabl
- `success_pipeline` - `success_pipeline`
- `new_epic` **[ULTIMATE]** - `new_epic` **[ULTIMATE]**
## Global notification settings ## Global notification settings
Get current notification settings and email address. Get current notification settings and email address.
......
...@@ -108,9 +108,9 @@ POST /projects/:id/pipeline_schedules ...@@ -108,9 +108,9 @@ POST /projects/:id/pipeline_schedules
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `description` | string | yes | The description of pipeline schedule | | `description` | string | yes | The description of pipeline schedule |
| `ref` | string | yes | The branch/tag name will be triggered | | `ref` | string | yes | The branch/tag name will be triggered |
| `cron ` | string | yes | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron)) | | `cron` | string | yes | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron)) |
| `cron_timezone ` | string | no | The timezone supported by `ActiveSupport::TimeZone` (e.g. `Pacific Time (US & Canada)`) (default: `'UTC'`) | | `cron_timezone` | string | no | The timezone supported by `ActiveSupport::TimeZone` (e.g. `Pacific Time (US & Canada)`) (default: `'UTC'`) |
| `active ` | boolean | no | The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially (default: `true`) | | `active` | boolean | no | The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially (default: `true`) |
```sh ```sh
curl --request POST --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" --form description="Build packages" --form ref="master" --form cron="0 1 * * 5" --form cron_timezone="UTC" --form active="true" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules" curl --request POST --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" --form description="Build packages" --form ref="master" --form cron="0 1 * * 5" --form cron_timezone="UTC" --form active="true" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules"
...@@ -153,9 +153,9 @@ PUT /projects/:id/pipeline_schedules/:pipeline_schedule_id ...@@ -153,9 +153,9 @@ PUT /projects/:id/pipeline_schedules/:pipeline_schedule_id
| `pipeline_schedule_id` | integer | yes | The pipeline schedule id | | `pipeline_schedule_id` | integer | yes | The pipeline schedule id |
| `description` | string | no | The description of pipeline schedule | | `description` | string | no | The description of pipeline schedule |
| `ref` | string | no | The branch/tag name will be triggered | | `ref` | string | no | The branch/tag name will be triggered |
| `cron ` | string | no | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron)) | | `cron` | string | no | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron)) |
| `cron_timezone ` | string | no | The timezone supported by `ActiveSupport::TimeZone` (e.g. `Pacific Time (US & Canada)`) or `TZInfo::Timezone` (e.g. `America/Los_Angeles`) | | `cron_timezone` | string | no | The timezone supported by `ActiveSupport::TimeZone` (e.g. `Pacific Time (US & Canada)`) or `TZInfo::Timezone` (e.g. `America/Los_Angeles`) |
| `active ` | boolean | no | The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially. | | `active` | boolean | no | The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially. |
```sh ```sh
curl --request PUT --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" --form cron="0 2 * * *" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules/13" curl --request PUT --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" --form cron="0 2 * * *" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules/13"
......
...@@ -55,8 +55,8 @@ GET /projects ...@@ -55,8 +55,8 @@ GET /projects
| `with_issues_enabled` | boolean | no | Limit by enabled issues feature | | `with_issues_enabled` | boolean | no | Limit by enabled issues feature |
| `with_merge_requests_enabled` | boolean | no | Limit by enabled merge requests feature | | `with_merge_requests_enabled` | boolean | no | Limit by enabled merge requests feature |
| `with_programming_language` | string | no | Limit by projects which use the given programming language | | `with_programming_language` | string | no | Limit by projects which use the given programming language |
| `wiki_checksum_failed` | boolean | no | **[PREMIUM]** Limit projects where the wiki checksum calculation has failed *([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2)* | | `wiki_checksum_failed` | boolean | no | **[PREMIUM]** Limit projects where the wiki checksum calculation has failed ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2) |
| `repository_checksum_failed` | boolean | no | **[PREMIUM]** Limit projects where the repository checksum calculation has failed *([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2)* | | `repository_checksum_failed` | boolean | no | **[PREMIUM]** Limit projects where the repository checksum calculation has failed ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2) |
| `min_access_level` | integer | no | Limit by current user minimal [access level](members.md) | | `min_access_level` | integer | no | Limit by current user minimal [access level](members.md) |
When `simple=true` or the user is unauthenticated this returns something like: When `simple=true` or the user is unauthenticated this returns something like:
...@@ -734,7 +734,7 @@ POST /projects ...@@ -734,7 +734,7 @@ POST /projects
| `mirror_trigger_builds` | boolean | no | **[STARTER]** Pull mirroring triggers builds | | `mirror_trigger_builds` | boolean | no | **[STARTER]** Pull mirroring triggers builds |
| `initialize_with_readme` | boolean | no | `false` by default | | `initialize_with_readme` | boolean | no | `false` by default |
>**Note**: If your HTTP repository is not publicly accessible, NOTE: **Note:** If your HTTP repository is not publicly accessible,
add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git` add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git`
where `password` is a public access key with the `api` scope enabled. where `password` is a public access key with the `api` scope enabled.
...@@ -779,7 +779,7 @@ POST /projects/user/:user_id ...@@ -779,7 +779,7 @@ POST /projects/user/:user_id
| `mirror` | boolean | no | **[STARTER]** Enables pull mirroring in a project | | `mirror` | boolean | no | **[STARTER]** Enables pull mirroring in a project |
| `mirror_trigger_builds` | boolean | no | **[STARTER]** Pull mirroring triggers builds | | `mirror_trigger_builds` | boolean | no | **[STARTER]** Pull mirroring triggers builds |
>**Note**: If your HTTP repository is not publicly accessible, NOTE: **Note:** If your HTTP repository is not publicly accessible,
add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git` add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git`
where `password` is a public access key with the `api` scope enabled. where `password` is a public access key with the `api` scope enabled.
...@@ -828,7 +828,7 @@ PUT /projects/:id ...@@ -828,7 +828,7 @@ PUT /projects/:id
| `mirror_overwrites_diverged_branches` | boolean | no | **[STARTER]** Pull mirror overwrites diverged branches | | `mirror_overwrites_diverged_branches` | boolean | no | **[STARTER]** Pull mirror overwrites diverged branches |
| `packages_enabled` | boolean | no | **[PREMIUM ONLY]** Enable or disable packages repository feature | | `packages_enabled` | boolean | no | **[PREMIUM ONLY]** Enable or disable packages repository feature |
>**Note**: If your HTTP repository is not publicly accessible, NOTE: **Note:** If your HTTP repository is not publicly accessible,
add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git` add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git`
where `password` is a public access key with the `api` scope enabled. where `password` is a public access key with the `api` scope enabled.
...@@ -1354,7 +1354,7 @@ Example response: ...@@ -1354,7 +1354,7 @@ Example response:
## Remove project ## Remove project
Removes a project including all associated resources (issues, merge requests etc.) Removes a project including all associated resources (issues, merge requests etc).
``` ```
DELETE /projects/:id DELETE /projects/:id
...@@ -1643,10 +1643,17 @@ GET /projects/:id/push_rule ...@@ -1643,10 +1643,17 @@ GET /projects/:id/push_rule
} }
``` ```
The following attributes are restricted to certain plans, and will not appear if Users on GitLab [Premium, Silver, or higher](https://about.gitlab.com/pricing/) will also see
you do not have access to those features: the `commit_committer_check` parameter:
* `commit_committer_check` only available on **[PREMIUM]** ```json
{
"id": 1,
"project_id": 3,
"commit_committer_check": false
...
}
```
### Add project push rule ### Add project push rule
......
This diff is collapsed.
This diff is collapsed.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment