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
164 lines
4.8 KiB
Markdown
164 lines
4.8 KiB
Markdown
# Project milestones API
|
|
|
|
## List project milestones
|
|
|
|
Returns a list of project milestones.
|
|
|
|
```
|
|
GET /projects/:id/milestones
|
|
GET /projects/:id/milestones?iids[]=42
|
|
GET /projects/:id/milestones?iids[]=42&iids[]=43
|
|
GET /projects/:id/milestones?state=active
|
|
GET /projects/:id/milestones?state=closed
|
|
GET /projects/:id/milestones?title=1.0
|
|
GET /projects/:id/milestones?search=version
|
|
```
|
|
|
|
Parameters:
|
|
|
|
| Attribute | Type | Required | Description |
|
|
| --------- | ------ | -------- | ----------- |
|
|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](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/projects/5/milestones
|
|
```
|
|
|
|
Example Response:
|
|
|
|
```json
|
|
[
|
|
{
|
|
"id": 12,
|
|
"iid": 3,
|
|
"project_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 project milestone.
|
|
|
|
```
|
|
GET /projects/:id/milestones/:milestone_id
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of the project's milestone
|
|
|
|
## Create new milestone
|
|
|
|
Creates a new project milestone.
|
|
|
|
```
|
|
POST /projects/:id/milestones
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the project](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 project milestone.
|
|
|
|
```
|
|
PUT /projects/:id/milestones/:milestone_id
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of a project 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 or activate)
|
|
|
|
## Delete project milestone
|
|
|
|
Only for user with developer access to the project.
|
|
|
|
```
|
|
DELETE /projects/:id/milestones/:milestone_id
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of the project's milestone
|
|
|
|
## Get all issues assigned to a single milestone
|
|
|
|
Gets all issues assigned to a single project milestone.
|
|
|
|
```
|
|
GET /projects/:id/milestones/:milestone_id/issues
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of a project milestone
|
|
|
|
## Get all merge requests assigned to a single milestone
|
|
|
|
Gets all merge requests assigned to a single project milestone.
|
|
|
|
```
|
|
GET /projects/:id/milestones/:milestone_id/merge_requests
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of a project milestone
|
|
|
|
## Promote project milestone to a group milestone
|
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/53861) in GitLab 11.9
|
|
|
|
Only for users with developer access to the group.
|
|
|
|
```
|
|
POST /projects/:id/milestones/:milestone_id/promote
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of a project milestone
|
|
|
|
## Get all burndown chart events for a single milestone **(STARTER)**
|
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4737) in GitLab 12.1
|
|
|
|
Gets all burndown chart events for a single milestone.
|
|
|
|
```
|
|
GET /projects/:id/milestones/:milestone_id/burndown_events
|
|
```
|
|
|
|
Parameters:
|
|
|
|
- `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
|
|
- `milestone_id` (required) - The ID of a project milestone
|