그룹 에픽 보드 API

Tier: Premium, Ultimate

Offering: GitLab.com, Self-managed, GitLab Dedicated

모든 그룹 에픽 보드 API 호출은 인증이 필요합니다.

사용자가 그룹의 구성원이 아니고 그룹이 비공식인 경우, GET 요청은 404 상태 코드를 반환합니다.

그룹의 모든 에픽 보드 목록

지정된 그룹의 에픽 보드를 나열합니다.

GET /groups/:id/epic_boards
속성 유형 필수 설명
id 정수/문자열 예 인증된 사용자가 접근할 수 있는 그룹의 ID 또는 URL-인코딩 경로 
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/epic_boards"

예시 응답:

[
  {
    "id": 1,
    "name": "그룹 에픽 보드",
    "group": {
      "id": 5,
      "name": "Documentcloud",
      "web_url": "http://example.com/groups/documentcloud"
    },
    "hide_backlog_list": false,
    "hide_closed_list": false,
    "labels": [
      {
        "id": 1,
        "title": "보드 레이블",
        "color": "#c21e56",
        "description": "에픽 보드에 적용된 레이블",
        "group_id": 5,
        "project_id": null,
        "template": false,
        "text_color": "#FFFFFF",
        "created_at": "2023-01-27T10:40:59.738Z",
        "updated_at": "2023-01-27T10:40:59.738Z"
      }
    ],
    "lists": [
      {
        "id": 1,
        "label": {
          "id": 69,
          "name": "테스트",
          "color": "#F0AD4E",
          "description": null
        },
        "position": 1,
        "list_type": "label"
      },
      {
        "id": 2,
        "label": {
          "id": 70,
          "name": "준비 완료",
          "color": "#FF0000",
          "description": null
        },
        "position": 2,
        "list_type": "label"
      },
      {
        "id": 3,
        "label": {
          "id": 71,
          "name": "생산",
          "color": "#FF5F00",
          "description": null
        },
        "position": 3,
        "list_type": "label"
      }
    ]
  }
]

단일 그룹 에픽 보드

단일 그룹 에픽 보드를 가져옵니다.

GET /groups/:id/epic_boards/:board_id
속성 유형 필수 설명
id 정수/문자열 예 인증된 사용자가 접근할 수 있는 그룹의 ID 또는 URL-인코딩 경로
board_id 정수 예 에픽 보드의 ID 
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/epic_boards/1"

예시 응답:

  {
    "id": 1,
    "name": "그룹 에픽 보드",
    "group": {
      "id": 5,
      "name": "Documentcloud",
      "web_url": "http://example.com/groups/documentcloud"
    },
    "labels": [
      {
        "id": 1,
        "title": "보드 레이블",
        "color": "#c21e56",
        "description": "에픽 보드에 적용된 레이블",
        "group_id": 5,
        "project_id": null,
        "template": false,
        "text_color": "#FFFFFF",
        "created_at": "2023-01-27T10:40:59.738Z",
        "updated_at": "2023-01-27T10:40:59.738Z"
      }
    ],
    "lists" : [
      {
        "id" : 1,
        "label" : {
          "id": 69,
          "name" : "테스트",
          "color" : "#F0AD4E",
          "description" : null
        },
        "position" : 1,
        "list_type": "label"
      },
      {
        "id" : 2,
        "label" : {
          "id": 70,
          "name" : "준비 완료",
          "color" : "#FF0000",
          "description" : null
        },
        "position" : 2,
        "list_type": "label"
      },
      {
        "id" : 3,
        "label" : {
          "id": 71,
          "name" : "생산",
          "color": "#FF5F00",
          "description": null
        },
        "position": 3,
        "list_type": "label"
      }
    ]
  }

그룹 에픽 보드 목록 리스트

에픽 보드의 목록을 가져옵니다.

open 및 closed 목록은 포함되지 않습니다.

GET /groups/:id/epic_boards/:board_id/lists
속성 유형 필수 설명
id 정수/문자열 예 인증된 사용자가 접근할 수 있는 그룹의 ID 또는 URL-인코딩 경로
board_id 정수 예 에픽 보드의 ID 
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/epic_boards/1/lists"

예시 응답:

[
  {
    "id" : 1,
    "label" : {
      "name" : "Testing",
      "color" : "#F0AD4E",
      "description" : null
    },
    "position" : 1,
    "list_type" : "label",
    "collapsed" : false
  },
  {
    "id" : 2,
    "label" : {
      "name" : "Ready",
      "color" : "#FF0000",
      "description" : null
    },
    "position" : 2,
    "list_type" : "label",
    "collapsed" : false
  },
  {
    "id" : 3,
    "label" : {
      "name" : "Production",
      "color" : "#FF5F00",
      "description" : null
    },
    "position" : 3,
    "list_type" : "label",
    "collapsed" : false
  }
]

단일 그룹 에픽 보드 목록

단일 보드 목록을 가져옵니다.

GET /groups/:id/epic_boards/:board_id/lists/:list_id
속성 유형 필수 설명
id 정수/문자열 예 인증된 사용자가 접근할 수 있는 그룹의 ID 또는 URL-인코딩 경로
board_id 정수 예 에픽 보드의 ID
list_id 정수 예 에픽 보드 목록의 ID 
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/epic_boards/1/lists/1"

예시 응답:

{
  "id" : 1,
  "label" : {
    "name" : "Testing",
    "color" : "#F0AD4E",
    "description" : null
  },
  "position" : 1,
  "list_type" : "label",
  "collapsed" : false
}