그룹 마일스톤 API

요약

이 API로 그룹 마일스톤을 관리합니다. 프로젝트 마일스톤은 프로젝트 마일스톤 API를 사용합니다. 기존 그룹 마일스톤을 업데이트합니다. 그룹에 대한 Developer 권한을 가진 사용자만 사용할 수 있습니다. 단일 그룹 마일스톤에 할당된 모든 이슈를 가져옵니다.

이 API로 그룹 마일스톤을 관리합니다.

프로젝트 마일스톤은 프로젝트 마일스톤 API를 사용합니다.

그룹 마일스톤 목록 조회#

그룹 마일스톤 목록을 반환합니다.

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
GET /groups/:id/milestones?search_title=17.3+17.4
GET /groups/:id/milestones?search_title=17.3%2017.4
GET /groups/:id/milestones?updated_before=2013-10-02T09%3A24%3A18Z
GET /groups/:id/milestones?updated_after=2013-10-02T09%3A24%3A18Z
GET /groups/:id/milestones?containing_date=2013-10-02T09%3A24%3A18Z
GET /groups/:id/milestones?start_date=2013-10-02T09%3A24%3A18Z&end_date=2013-11-02T09%3A24%3A18Z

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로입니다.
`iids[]`	integer array	no	지정한 `iid`를 가진 마일스톤만 반환합니다. `include_ancestors`가 `true` 이면 무시됩니다.
`state`	string	no	`active` 또는 `closed` 마일스톤만 반환합니다.
`title`	string	no	지정한 `title`을 가진 마일스톤만 반환합니다(대소문자 구분).
`search`	string	no	제목 또는 설명이 지정한 문자열과 일치하는 마일스톤만 반환합니다(대소문자 구분 안 함).
`search_title`	string	no	제목이 지정한 문자열과 일치하는 마일스톤만 반환합니다(대소문자 구분 안 함). 여러 용어를 검색하려면 이스케이프된 공백(`+` 또는 `%20`)으로 구분합니다. 결과는 모든 용어와 일치해야 합니다. 예를 들어 `17.4+17.5`는 부분 문자열 `17.4`와 `17.5`를 순서에 상관없이 일치시킵니다.
`include_parent_milestones`	boolean	no	사용 중단되었습니다. 대신 `include_ancestors`를 사용합니다.
`include_ancestors`	boolean	no	모든 상위 그룹의 마일스톤을 포함합니다.
`include_descendants`	boolean	no	해당 그룹과 그 하위 그룹의 마일스톤을 포함합니다.
`updated_before`	datetime	no	지정한 일시 이전에 업데이트된 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다.
`updated_after`	datetime	no	지정한 일시 이후에 업데이트된 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다.
`containing_date`	datetime	no	`start_date <= containing_date <= due_date` 인 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다.
`start_date`	datetime	no	`due_date >=` 지정한 `start_date` 인 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다. 참고: `end_date`도 함께 지정한 경우에만 유효합니다.
`end_date`	datetime	no	`start_date <=` 지정한 `end_date` 인 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다. 참고: `start_date`도 함께 지정한 경우에만 유효합니다.

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/milestones"

응답 예시:

[
  {
    "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",
    "expired": false,
    "web_url": "https://gitlab.com/groups/gitlab-org/-/milestones/42"
  }
]

단일 마일스톤 조회#

단일 그룹 마일스톤을 가져옵니다.

GET /groups/:id/milestones/:milestone_id

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID

새 마일스톤 생성#

새 그룹 마일스톤을 생성합니다.

POST /groups/:id/milestones

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`title`	string	yes	마일스톤의 제목
`description`	string	no	마일스톤의 설명
`due_date`	date	no	마일스톤의 마감일, ISO 8601 형식(`YYYY-MM-DD`)
`start_date`	date	no	마일스톤의 시작일, ISO 8601 형식(`YYYY-MM-DD`)

마일스톤 편집#

기존 그룹 마일스톤을 업데이트합니다.

PUT /groups/:id/milestones/:milestone_id

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID
`title`	string	no	마일스톤의 제목
`description`	string	no	마일스톤의 설명
`due_date`	date	no	마일스톤의 마감일, ISO 8601 형식(`YYYY-MM-DD`)
`start_date`	date	no	마일스톤의 시작일, ISO 8601 형식(`YYYY-MM-DD`)
`state_event`	string	no	마일스톤의 상태 이벤트 (`close` 또는 `activate`)

그룹 마일스톤 삭제#

그룹에 대한 Developer 권한을 가진 사용자만 사용할 수 있습니다.

DELETE /groups/:id/milestones/:milestone_id

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID

단일 마일스톤에 할당된 모든 이슈 조회#

단일 그룹 마일스톤에 할당된 모든 이슈를 가져옵니다.

GET /groups/:id/milestones/:milestone_id/issues

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID

이 API 엔드포인트는 하위 그룹의 이슈를 반환하지 않습니다. 마일스톤의 모든 이슈를 가져오려면 대신 이슈 목록 조회 API를 사용해 특정 마일스톤으로 필터링합니다(예: GET /issues?milestone=1.0.0&state=opened).

단일 마일스톤에 할당된 모든 머지 리퀘스트 조회#

단일 그룹 마일스톤에 할당된 모든 머지 리퀘스트를 가져옵니다.

GET /groups/:id/milestones/:milestone_id/merge_requests

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID

단일 마일스톤의 모든 번다운 차트 이벤트 조회#

단일 마일스톤의 모든 번다운 차트 이벤트를 가져옵니다.

GET /groups/:id/milestones/:milestone_id/burndown_events

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID

그룹 마일스톤 API

GitLab v19.5

Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

원문 보기

번역일: 2026-09-18

요약

이 API로 그룹 마일스톤을 관리합니다.

프로젝트 마일스톤은 프로젝트 마일스톤 API를 사용합니다.

그룹 마일스톤 목록 조회#

그룹 마일스톤 목록을 반환합니다.

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
GET /groups/:id/milestones?search_title=17.3+17.4
GET /groups/:id/milestones?search_title=17.3%2017.4
GET /groups/:id/milestones?updated_before=2013-10-02T09%3A24%3A18Z
GET /groups/:id/milestones?updated_after=2013-10-02T09%3A24%3A18Z
GET /groups/:id/milestones?containing_date=2013-10-02T09%3A24%3A18Z
GET /groups/:id/milestones?start_date=2013-10-02T09%3A24%3A18Z&end_date=2013-11-02T09%3A24%3A18Z

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로입니다.
`iids[]`	integer array	no	지정한 `iid`를 가진 마일스톤만 반환합니다. `include_ancestors`가 `true` 이면 무시됩니다.
`state`	string	no	`active` 또는 `closed` 마일스톤만 반환합니다.
`title`	string	no	지정한 `title`을 가진 마일스톤만 반환합니다(대소문자 구분).
`search`	string	no	제목 또는 설명이 지정한 문자열과 일치하는 마일스톤만 반환합니다(대소문자 구분 안 함).
`search_title`	string	no	제목이 지정한 문자열과 일치하는 마일스톤만 반환합니다(대소문자 구분 안 함). 여러 용어를 검색하려면 이스케이프된 공백(`+` 또는 `%20`)으로 구분합니다. 결과는 모든 용어와 일치해야 합니다. 예를 들어 `17.4+17.5`는 부분 문자열 `17.4`와 `17.5`를 순서에 상관없이 일치시킵니다.
`include_parent_milestones`	boolean	no	사용 중단되었습니다. 대신 `include_ancestors`를 사용합니다.
`include_ancestors`	boolean	no	모든 상위 그룹의 마일스톤을 포함합니다.
`include_descendants`	boolean	no	해당 그룹과 그 하위 그룹의 마일스톤을 포함합니다.
`updated_before`	datetime	no	지정한 일시 이전에 업데이트된 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다.
`updated_after`	datetime	no	지정한 일시 이후에 업데이트된 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다.
`containing_date`	datetime	no	`start_date <= containing_date <= due_date` 인 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다.
`start_date`	datetime	no	`due_date >=` 지정한 `start_date` 인 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다. 참고: `end_date`도 함께 지정한 경우에만 유효합니다.
`end_date`	datetime	no	`start_date <=` 지정한 `end_date` 인 마일스톤만 반환합니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)이어야 합니다. 참고: `start_date`도 함께 지정한 경우에만 유효합니다.

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/milestones"

응답 예시:

[
  {
    "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",
    "expired": false,
    "web_url": "https://gitlab.com/groups/gitlab-org/-/milestones/42"
  }
]

단일 마일스톤 조회#

단일 그룹 마일스톤을 가져옵니다.

GET /groups/:id/milestones/:milestone_id

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID

새 마일스톤 생성#

새 그룹 마일스톤을 생성합니다.

POST /groups/:id/milestones

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`title`	string	yes	마일스톤의 제목
`description`	string	no	마일스톤의 설명
`due_date`	date	no	마일스톤의 마감일, ISO 8601 형식(`YYYY-MM-DD`)
`start_date`	date	no	마일스톤의 시작일, ISO 8601 형식(`YYYY-MM-DD`)

마일스톤 편집#

기존 그룹 마일스톤을 업데이트합니다.

PUT /groups/:id/milestones/:milestone_id

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID
`title`	string	no	마일스톤의 제목
`description`	string	no	마일스톤의 설명
`due_date`	date	no	마일스톤의 마감일, ISO 8601 형식(`YYYY-MM-DD`)
`start_date`	date	no	마일스톤의 시작일, ISO 8601 형식(`YYYY-MM-DD`)
`state_event`	string	no	마일스톤의 상태 이벤트 (`close` 또는 `activate`)

그룹 마일스톤 삭제#

그룹에 대한 Developer 권한을 가진 사용자만 사용할 수 있습니다.

DELETE /groups/:id/milestones/:milestone_id

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID

단일 마일스톤에 할당된 모든 이슈 조회#

단일 그룹 마일스톤에 할당된 모든 이슈를 가져옵니다.

GET /groups/:id/milestones/:milestone_id/issues

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID

단일 마일스톤에 할당된 모든 머지 리퀘스트 조회#

단일 그룹 마일스톤에 할당된 모든 머지 리퀘스트를 가져옵니다.

GET /groups/:id/milestones/:milestone_id/merge_requests

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID

단일 마일스톤의 모든 번다운 차트 이벤트 조회#

단일 마일스톤의 모든 번다운 차트 이벤트를 가져옵니다.

GET /groups/:id/milestones/:milestone_id/burndown_events

파라미터:

속성	유형	필수 여부	설명
`id`	integer or string	yes	그룹의 ID 또는 URL 인코딩된 경로
`milestone_id`	integer	yes	그룹 마일스톤의 ID