연결된 에픽 API (더 이상 사용되지 않음)

요약

Epics REST API는 GitLab 17.0에서 더 이상 사용되지 않으며, API v5에서 제거될 예정입니다. 사용 중인 GitLab 플랜에서 Related Epics 기능을 사용할 수 없으면 403 상태 코드가 반환됩니다.

Warning

Epics REST API는 GitLab 17.0에서 더 이상 사용되지 않으며, API v5에서 제거될 예정입니다. GitLab 17.4부터 18.0 까지는 에픽의 새로운 형태가 활성화된 경우, GitLab 18.1 이상에서는 항상 Work Items API를 대신 사용합니다. 자세한 내용은 에픽 API를 작업 항목으로 마이그레이션을 참고합니다. 이 변경은 브레이킹 체인지입니다.

사용 중인 GitLab 플랜에서 Related Epics 기능을 사용할 수 없으면 403 상태 코드가 반환됩니다.

그룹의 모든 관련 에픽 링크 조회#

지정한 그룹과 그 하위 그룹의 모든 관련 에픽 링크를 조회합니다. 관련 에픽 링크를 보려면 사용자에게 source_epic과 target_epic 양쪽에 대한 액세스 권한이 있어야 합니다.

GET /groups/:id/related_epic_links

지원되는 속성:

속성	유형	필수 여부	설명
`id`	integer or string	Yes	그룹의 ID 또는 URL 인코딩된 경로.
`created_after`	string	no	지정한 시각 이후(해당 시각 포함)에 생성된 관련 에픽 링크를 반환합니다. 형식: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
`created_before`	string	no	지정한 시각 이전(해당 시각 포함)에 생성된 관련 에픽 링크를 반환합니다. 형식: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
`updated_after`	string	no	지정한 시각 이후(해당 시각 포함)에 업데이트된 관련 에픽 링크를 반환합니다. 형식: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
`updated_before`	string	no	지정한 시각 이전(해당 시각 포함)에 업데이트된 관련 에픽 링크를 반환합니다. 형식: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)

요청 예시:

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

응답 예시:

[
  {
    "id": 1,
    "created_at": "2022-01-31T15:10:44.988Z",
    "updated_at": "2022-01-31T15:10:44.988Z",
    "link_type": "relates_to",
    "source_epic": {
      "id": 21,
      "iid": 1,
      "color": "#1068bf",
      "text_color": "#FFFFFF",
      "group_id": 26,
      "parent_id": null,
      "parent_iid": null,
      "title": "Aspernatur recusandae distinctio omnis et qui est iste.",
      "description": "some description",
      "confidential": false,
      "author": {
        "id": 15,
        "username": "trina",
        "name": "Theresia Robel",
        "state": "active",
        "avatar_url": "https://www.gravatar.com/avatar/085e28df717e16484cbf6ceca75e9a93?s=80&d=identicon",
        "web_url": "http://gitlab.example.com/trina"
      },
      "start_date": null,
      "end_date": null,
      "due_date": null,
      "state": "opened",
      "web_url": "http://gitlab.example.com/groups/flightjs/-/epics/1",
      "references": {
        "short": "&1",
        "relative": "&1",
        "full": "flightjs&1"
      },
      "created_at": "2022-01-31T15:10:44.988Z",
      "updated_at": "2022-03-16T09:32:35.712Z",
      "closed_at": null,
      "labels": [],
      "upvotes": 0,
      "downvotes": 0,
      "_links": {
        "self": "http://gitlab.example.com/api/v4/groups/26/epics/1",
        "epic_issues": "http://gitlab.example.com/api/v4/groups/26/epics/1/issues",
        "group": "http://gitlab.example.com/api/v4/groups/26",
        "parent": null
      }
    },
    "target_epic": {
      "id": 25,
      "iid": 5,
      "color": "#1068bf",
      "text_color": "#FFFFFF",
      "group_id": 26,
      "parent_id": null,
      "parent_iid": null,
      "title": "Aut assumenda id nihil distinctio fugiat vel numquam est.",
      "description": "some description",
      "confidential": false,
      "author": {
        "id": 3,
        "username": "valerie",
        "name": "Erika Wolf",
        "state": "active",
        "avatar_url": "https://www.gravatar.com/avatar/9ef7666abb101418a4716a8ed4dded80?s=80&d=identicon",
        "web_url": "http://gitlab.example.com/valerie"
      },
      "start_date": null,
      "end_date": null,
      "due_date": null,
      "state": "opened",
      "web_url": "http://gitlab.example.com/groups/flightjs/-/epics/5",
      "references": {
        "short": "&5",
        "relative": "&5",
        "full": "flightjs&5"
      },
      "created_at": "2022-01-31T15:10:45.080Z",
      "updated_at": "2022-03-16T09:32:35.842Z",
      "closed_at": null,
      "labels": [],
      "upvotes": 0,
      "downvotes": 0,
      "_links": {
        "self": "http://gitlab.example.com/api/v4/groups/26/epics/5",
        "epic_issues": "http://gitlab.example.com/api/v4/groups/26/epics/5/issues",
        "group": "http://gitlab.example.com/api/v4/groups/26",
        "parent": null
      }
    },
  }
]

에픽의 모든 연결된 에픽 조회#

지정한 에픽의 연결된 에픽을 모두 조회합니다.

GET /groups/:id/epics/:epic_iid/related_epics

지원되는 속성:

속성	유형	필수 여부	설명
`epic_iid`	integer	Yes	그룹 에픽의 내부 ID
`id`	integer or string	Yes	그룹의 ID 또는 URL 인코딩된 경로.

요청 예시:

curl --request GET \
 --header "PRIVATE-TOKEN: <your_access_token>" \
 --url "https://gitlab.example.com/api/v4/groups/:id/epics/:epic_iid/related_epics"

응답 예시:

[
   {
      "id":2,
      "iid":2,
      "color":"#1068bf",
      "text_color":"#FFFFFF",
      "group_id":2,
      "parent_id":null,
      "parent_iid":null,
      "title":"My title 2",
      "description":null,
      "confidential":false,
      "author":{
         "id":3,
         "username":"user3",
         "name":"Sidney Jones4",
         "state":"active",
         "avatar_url":"https://www.gravatar.com/avatar/82797019f038ab535a84c6591e7bc936?s=80u0026d=identicon",
         "web_url":"http://localhost/user3"
      },
      "start_date":null,
      "end_date":null,
      "due_date":null,
      "state":"opened",
      "web_url":"http://localhost/groups/group1/-/epics/2",
      "references":{
         "short":"u00262",
         "relative":"u00262",
         "full":"group1u00262"
      },
      "created_at":"2022-03-10T18:35:24.479Z",
      "updated_at":"2022-03-10T18:35:24.479Z",
      "closed_at":null,
      "labels":[

      ],
      "upvotes":0,
      "downvotes":0,
      "_links":{
         "self":"http://localhost/api/v4/groups/2/epics/2",
         "epic_issues":"http://localhost/api/v4/groups/2/epics/2/issues",
         "group":"http://localhost/api/v4/groups/2",
         "parent":null
      },
      "related_epic_link_id":1,
      "link_type":"relates_to",
      "link_created_at":"2022-03-10T18:35:24.496+00:00",
      "link_updated_at":"2022-03-10T18:35:24.496+00:00"
   }
]

속성	유형	필수 여부	설명
`epic_iid`	integer	Yes	그룹 에픽의 내부 ID.
`id`	integer or string	Yes	그룹의 ID 또는 URL 인코딩된 경로.
`target_epic_iid`	integer or string	Yes	타깃 그룹 에픽의 내부 ID.
`target_group_id`	integer or string	Yes	타깃 그룹의 ID 또는 URL 인코딩된 경로.
`link_type`	string	No	관계 유형(`relates_to`, `blocks`, `is_blocked_by`)이며, 기본값은 `relates_to` 입니다.

속성	유형	필수 여부	설명
`epic_iid`	integer	Yes	그룹 에픽의 내부 ID.
`id`	integer or string	Yes	그룹의 ID 또는 URL 인코딩된 경로.
`related_epic_link_id`	integer or string	Yes	관련 에픽 링크의 내부 ID.

연결된 에픽 API (더 이상 사용되지 않음)

GitLab v19.5

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

원문 보기

번역일: 2026-09-18

요약

Warning

사용 중인 GitLab 플랜에서 Related Epics 기능을 사용할 수 없으면 403 상태 코드가 반환됩니다.

그룹의 모든 관련 에픽 링크 조회#

GET /groups/:id/related_epic_links

지원되는 속성:

속성	유형	필수 여부	설명
`id`	integer or string	Yes	그룹의 ID 또는 URL 인코딩된 경로.
`created_after`	string	no	지정한 시각 이후(해당 시각 포함)에 생성된 관련 에픽 링크를 반환합니다. 형식: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
`created_before`	string	no	지정한 시각 이전(해당 시각 포함)에 생성된 관련 에픽 링크를 반환합니다. 형식: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
`updated_after`	string	no	지정한 시각 이후(해당 시각 포함)에 업데이트된 관련 에픽 링크를 반환합니다. 형식: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
`updated_before`	string	no	지정한 시각 이전(해당 시각 포함)에 업데이트된 관련 에픽 링크를 반환합니다. 형식: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)

요청 예시:

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

응답 예시:

[
  {
    "id": 1,
    "created_at": "2022-01-31T15:10:44.988Z",
    "updated_at": "2022-01-31T15:10:44.988Z",
    "link_type": "relates_to",
    "source_epic": {
      "id": 21,
      "iid": 1,
      "color": "#1068bf",
      "text_color": "#FFFFFF",
      "group_id": 26,
      "parent_id": null,
      "parent_iid": null,
      "title": "Aspernatur recusandae distinctio omnis et qui est iste.",
      "description": "some description",
      "confidential": false,
      "author": {
        "id": 15,
        "username": "trina",
        "name": "Theresia Robel",
        "state": "active",
        "avatar_url": "https://www.gravatar.com/avatar/085e28df717e16484cbf6ceca75e9a93?s=80&d=identicon",
        "web_url": "http://gitlab.example.com/trina"
      },
      "start_date": null,
      "end_date": null,
      "due_date": null,
      "state": "opened",
      "web_url": "http://gitlab.example.com/groups/flightjs/-/epics/1",
      "references": {
        "short": "&1",
        "relative": "&1",
        "full": "flightjs&1"
      },
      "created_at": "2022-01-31T15:10:44.988Z",
      "updated_at": "2022-03-16T09:32:35.712Z",
      "closed_at": null,
      "labels": [],
      "upvotes": 0,
      "downvotes": 0,
      "_links": {
        "self": "http://gitlab.example.com/api/v4/groups/26/epics/1",
        "epic_issues": "http://gitlab.example.com/api/v4/groups/26/epics/1/issues",
        "group": "http://gitlab.example.com/api/v4/groups/26",
        "parent": null
      }
    },
    "target_epic": {
      "id": 25,
      "iid": 5,
      "color": "#1068bf",
      "text_color": "#FFFFFF",
      "group_id": 26,
      "parent_id": null,
      "parent_iid": null,
      "title": "Aut assumenda id nihil distinctio fugiat vel numquam est.",
      "description": "some description",
      "confidential": false,
      "author": {
        "id": 3,
        "username": "valerie",
        "name": "Erika Wolf",
        "state": "active",
        "avatar_url": "https://www.gravatar.com/avatar/9ef7666abb101418a4716a8ed4dded80?s=80&d=identicon",
        "web_url": "http://gitlab.example.com/valerie"
      },
      "start_date": null,
      "end_date": null,
      "due_date": null,
      "state": "opened",
      "web_url": "http://gitlab.example.com/groups/flightjs/-/epics/5",
      "references": {
        "short": "&5",
        "relative": "&5",
        "full": "flightjs&5"
      },
      "created_at": "2022-01-31T15:10:45.080Z",
      "updated_at": "2022-03-16T09:32:35.842Z",
      "closed_at": null,
      "labels": [],
      "upvotes": 0,
      "downvotes": 0,
      "_links": {
        "self": "http://gitlab.example.com/api/v4/groups/26/epics/5",
        "epic_issues": "http://gitlab.example.com/api/v4/groups/26/epics/5/issues",
        "group": "http://gitlab.example.com/api/v4/groups/26",
        "parent": null
      }
    },
  }
]

에픽의 모든 연결된 에픽 조회#

지정한 에픽의 연결된 에픽을 모두 조회합니다.

GET /groups/:id/epics/:epic_iid/related_epics

지원되는 속성:

속성	유형	필수 여부	설명
`epic_iid`	integer	Yes	그룹 에픽의 내부 ID
`id`	integer or string	Yes	그룹의 ID 또는 URL 인코딩된 경로.

요청 예시:

curl --request GET \
 --header "PRIVATE-TOKEN: <your_access_token>" \
 --url "https://gitlab.example.com/api/v4/groups/:id/epics/:epic_iid/related_epics"

응답 예시:

[
   {
      "id":2,
      "iid":2,
      "color":"#1068bf",
      "text_color":"#FFFFFF",
      "group_id":2,
      "parent_id":null,
      "parent_iid":null,
      "title":"My title 2",
      "description":null,
      "confidential":false,
      "author":{
         "id":3,
         "username":"user3",
         "name":"Sidney Jones4",
         "state":"active",
         "avatar_url":"https://www.gravatar.com/avatar/82797019f038ab535a84c6591e7bc936?s=80u0026d=identicon",
         "web_url":"http://localhost/user3"
      },
      "start_date":null,
      "end_date":null,
      "due_date":null,
      "state":"opened",
      "web_url":"http://localhost/groups/group1/-/epics/2",
      "references":{
         "short":"u00262",
         "relative":"u00262",
         "full":"group1u00262"
      },
      "created_at":"2022-03-10T18:35:24.479Z",
      "updated_at":"2022-03-10T18:35:24.479Z",
      "closed_at":null,
      "labels":[

      ],
      "upvotes":0,
      "downvotes":0,
      "_links":{
         "self":"http://localhost/api/v4/groups/2/epics/2",
         "epic_issues":"http://localhost/api/v4/groups/2/epics/2/issues",
         "group":"http://localhost/api/v4/groups/2",
         "parent":null
      },
      "related_epic_link_id":1,
      "link_type":"relates_to",
      "link_created_at":"2022-03-10T18:35:24.496+00:00",
      "link_updated_at":"2022-03-10T18:35:24.496+00:00"
   }
]

연결된 에픽 API (더 이상 사용되지 않음)

그룹의 모든 관련 에픽 링크 조회#

에픽의 모든 연결된 에픽 조회#

관련 에픽 링크 생성#

관련 에픽 링크 삭제#

연결된 에픽 API (더 이상 사용되지 않음)

그룹의 모든 관련 에픽 링크 조회#

에픽의 모든 연결된 에픽 조회#

관련 에픽 링크 생성#

관련 에픽 링크 삭제#