73c6477b7e
Previously, we used brackets to denote the tier badges, but this made Kramdown, the docs site Markdown renderer, show many warnings when building the site. This is now fixed by using parentheses instead of square brackets. This was caused by [PREMIUM] looking like a link to Kramdown, which couldn't find a URL there. See: - https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/484 - https://gitlab.com/gitlab-org/gitlab-ce/issues/63800
153 lines
4.4 KiB
Markdown
153 lines
4.4 KiB
Markdown
# Group milestones API
|
|
|
|
> [Introduced][ce-12819] in GitLab 9.5.
|
|
|
|
## List group milestones
|
|
|
|
Returns a list of group milestones.
|
|
|
|
```
|
|
GET /groups/:id/milestones
|
|
GET /groups/:id/milestones?iids[]=42
|
|
GET /groups/:id/milestones?iids[]=42&iids[]=43
|
|
GET /groups/:id/milestones?state=active
|
|
GET /groups/:id/milestones?state=closed
|
|
GET /groups/:id/milestones?title=1.0
|
|
GET /groups/:id/milestones?search=version
|
|
```
|
|
|
|
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 |
|
|
| `iids[]` | integer array | optional | Return only the milestones having the given `iid` |
|
|
| `state` | string | optional | Return only `active` or `closed` milestones |
|
|
| `title` | string | optional | Return only the milestones having the given `title` |
|
|
| `search` | string | optional | Return only milestones with a title or description matching the provided string |
|
|
|
|
```bash
|
|
curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/milestones
|
|
```
|
|
|
|
Example Response:
|
|
|
|
```json
|
|
[
|
|
{
|
|
"id": 12,
|
|
"iid": 3,
|
|
"group_id": 16,
|
|
"title": "10.0",
|
|
"description": "Version",
|
|
"due_date": "2013-11-29",
|
|
"start_date": "2013-11-10",
|
|
"state": "active",
|
|
"updated_at": "2013-10-02T09:24:18Z",
|
|
"created_at": "2013-10-02T09:24:18Z"
|
|
}
|
|
]
|
|
```
|
|
|
|
## Get single milestone
|
|
|
|
Gets a single group milestone.
|
|
|
|
```
|
|
GET /groups/:id/milestones/:milestone_id
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of the group milestone
|
|
|
|
## Create new milestone
|
|
|
|
Creates a new group milestone.
|
|
|
|
```
|
|
POST /groups/:id/milestones
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `title` (required) - The title of a milestone
|
|
- `description` (optional) - The description of the milestone
|
|
- `due_date` (optional) - The due date of the milestone
|
|
- `start_date` (optional) - The start date of the milestone
|
|
|
|
## Edit milestone
|
|
|
|
Updates an existing group milestone.
|
|
|
|
```
|
|
PUT /groups/:id/milestones/:milestone_id
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of a group milestone
|
|
- `title` (optional) - The title of a milestone
|
|
- `description` (optional) - The description of a milestone
|
|
- `due_date` (optional) - The due date of the milestone
|
|
- `start_date` (optional) - The start date of the milestone
|
|
- `state_event` (optional) - The state event of the milestone (close|activate)
|
|
|
|
## Delete group milestone
|
|
|
|
Only for user with developer access to the group.
|
|
|
|
```
|
|
DELETE /groups/:id/milestones/:milestone_id
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of the group's milestone
|
|
|
|
## Get all issues assigned to a single milestone
|
|
|
|
Gets all issues assigned to a single group milestone.
|
|
|
|
```
|
|
GET /groups/:id/milestones/:milestone_id/issues
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of a group milestone
|
|
|
|
## Get all merge requests assigned to a single milestone
|
|
|
|
Gets all merge requests assigned to a single group milestone.
|
|
|
|
```
|
|
GET /groups/:id/milestones/:milestone_id/merge_requests
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of a group milestone
|
|
|
|
[ce-12819]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12819
|
|
|
|
## Get all burndown chart events for a single milestone **(STARTER)**
|
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4737) in GitLab 12.1
|
|
|
|
Get all burndown chart events for a single milestone.
|
|
|
|
```
|
|
GET /groups/:id/milestones/:milestone_id/burndown_events
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of a group milestone
|