그룹 에픽 보드 API

Tier: 프리미엄, 얼티메이트 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 epic board",
    "group": {
      "id": 5,
      "name": "Documentcloud",
      "web_url": "http://example.com/groups/documentcloud"
    },
    "hide_backlog_list": false,
    "hide_closed_list": false,
    "labels": [
      {
        "id": 1,
        "title": "Board Label",
        "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": "Testing",
          "color": "#F0AD4E",
          "description": null
        },
        "position": 1,
        "list_type": "label"
      },
      {
        "id": 2,
        "label": {
          "id": 70,
          "name": "Ready",
          "color": "#FF0000",
          "description": null
        },
        "position": 2,
        "list_type": "label"
      },
      {
        "id": 3,
        "label": {
          "id": 71,
          "name": "Production",
          "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 epic board",
  "group": {
    "id": 5,
    "name": "Documentcloud",
    "web_url": "http://example.com/groups/documentcloud"
  },
  "labels": [
    {
      "id": 1,
      "title": "Board Label",
      "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" : "Testing",
        "color" : "#F0AD4E",
        "description" : null
      },
      "position" : 1,
      "list_type": "label"
    },
    {
      "id" : 2,
      "label" : {
        "id": 70,
        "name" : "Ready",
        "color" : "#FF0000",
        "description" : null
      },
      "position" : 2,
      "list_type": "label"
    },
    {
      "id" : 3,
      "label" : {
        "id": 71,
        "name" : "Production",
        "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 integer/string 예 인증된 사용자가 액세스할 수 있는 그룹의 ID 또는 URL-인코딩된 경로
board_id integer 예 에픽 보드의 ID
list_id integer 예 에픽 보드의 목록의 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
}