议题分页
列出议题
列出群组议题
列出项目议题
单个议题
单个项目议题
新建议题
- 速率限制
编辑议题
删除议题
重排序议题
移动议题
克隆议题
通知
- 订阅议题
- 取消订阅议题
创建待办事项
将议题升级为史诗
时间追踪
- 为议题设置预计用时
- 为议题重置预计用时
- 为议题添加已用时间
- 为议题重置已用时间
- 获取工时统计信息
合并请求
- 列出议题关联的合并请求
- 列出合并时关闭议题的合并请求
议题参与人
议题评论
获取用户代理信息
列出议题状态事件
事故
- 上传指标图像
- 列出指标图像
- 更新指标图像
- 删除指标图像

议题 API

通过 REST API 与极狐GitLab 议题进行交互。

用户向私有群组发送 GET 请求时，如果不是该群组的成员会得到 404 状态码。

议题分页

默认情况下，API 返回结果均经过分页机制处理，每次只会返回 20 条结果。请阅读分页页面了解更多信息。

响应中的 reference 属性已经被 references 取代。引入于 12.6 版本。

references.relative 属性值和所请求的群组和项目有关。如果是在某个项目中获取其中的议题，relative 的格式与 short 的格式相同。如果是跨越多个群组或项目进行请求，其格式应该与 full 格式相同。

references.relative 属性是相对于被请求的问题所在的组或项目。当议题从其项目上获取时，relative 格式与 short 格式相同。当跨组或跨项目请求时，其格式应该与 full 格式相同。

列出议题

获取经过身份验证的用户可以访问的所有议题。默认情况下只会返回当前用户创建的议题。您可以使用参数 scope=all 来获取所有议题。

GET /issues
GET /issues?assignee_id=5
GET /issues?author_id=5
GET /issues?confidential=true
GET /issues?iids[]=42&iids[]=43
GET /issues?labels=foo
GET /issues?labels=foo,bar
GET /issues?labels=foo,bar&state=opened
GET /issues?milestone=1.0.0
GET /issues?milestone=1.0.0&state=opened
GET /issues?my_reaction_emoji=star
GET /issues?search=foo&in=title
GET /issues?state=closed
GET /issues?state=opened

参数	类型	是否必需	描述
`assignee_id`	integer	no	对于给定的用户 `id`，返回指派给这个用户的议题。与 `assignee_username` 冲突。使用 `None` 则返回未被指派的议题。使用 `Any` 则返回存在指派人的议题。
`assignee_username`	string array	no	对于给定的用户名 `username`，返回指派给这个用户的议题。与 `assignee_id` 相似且与其冲突。在基础版中， `assignee_username` 数组只能包含单个成员，否则将报参数错误提示。
`author_id`	integer	no	对于给定的用户 `id`，返回这个用户创建的议题。与 `author_username` 冲突。与 `scope=all` 或 `scope=assigned_to_me` 配合使用。
`author_username`	string	no	对于给定的用户名 `username`，返回这个用户创建的议题。与 `author_id` 相似且与其冲突。
`confidential`	boolean	no	筛选私密议题与公开议题。
`created_after`	datetime	no	对于给定的时间戳，返回不早于该时间创建的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`created_before`	datetime	no	对于给定的时间戳，返回不晚于该时间创建的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`due_date`	string	no	返回没有截止日期、已经逾期、本周内逾期、本月内逾期或介于两周前和下个月之间逾期的议题。可接受的值：`0`（没有截止日期）、`any`、`today`、`tomorrow`、`overdue`、`week`、`month`、`next_month_and_previous_two_weeks`。
`epic_id`	integer	no	对于给定的史诗 ID，返回与这个史诗关联的议题。使用 `None` 则返回未与史诗关联的议题。使用 `Any` 则返回存在关联史诗的议题。引入于 13.6 版本。
`health_status`	string	no	返回具有指定 `health_status` 的议题。引入于极狐GitLab 15.4。在极狐GitLab 15.5 及更高版本中，`None` 返回未分配健康状态的议题，`Any` 返回分配健康状态的议题。
`iids[]`	integer array	no	返回包含给定 `iid` 的议题。
`in`	string	no	修改 `search` 属性的范围。可以使用 `title`、`description` 或使用半角逗号对他们进行连接。默认值是 `title,description`。
`issue_type`	string	no	筛选议题的类型，可选值为 `issue`、`incident` 或 `test_case`。引入于 13.12 版本。
`iteration_id`	integer	no	对于给定的迭代 ID，返回与这个迭代关联的议题。使用 `None` 则返回未与迭代关联的议题。使用 `Any` 则返回存在关联迭代的议题。引入于 13.6 版本。
`iteration_title`	string	no	对于给定的迭代名称，返回与这个迭代关联的议题。与 `iteration_id` 相似且与其冲突。引入于 13.6 版本。
`labels`	string	no	对于给定的一系列以半角逗号分隔的标签，返回包含所有给定标签的议题。使用 `None` 则返回没有标签的议题。使用 `Any` 则返回包含至少一个标签的议题。使用 `No+Label`（已被弃用）则返回没有标签的议题。预定义名称对大小写不敏感。
`milestone`	string	no	里程碑名称。使用 `None` 则列出没有里程碑的议题。使用 `Any` 则列出存在关联里程碑的议题。`None` 及 `Any` 的用法将会在未来被弃用，请使用 `milestone_id` 替代。`milestone` 与 `milestone_id` 冲突。
`milestone_id`	string	no	对于给定的时间段（`None`、`Any`、`Upcoming` 或 `Started`），返回与该时间段里程碑相关联的议题。使用 `None` 则列出没有里程碑的议题。使用 `Any` 则列出存在关联里程碑的议题。使用 `Upcoming` 则列出与未开始里程碑相关联的议题。使用 `Started` 则列出与已开始里程碑相关联的议题。`milestone` 和 `milestone_id` 冲突。引入于 14.3 版本。
`my_reaction_emoji`	string	no	对于给定的 `emoji`，返回用户使用该表情回应的议题。使用 `None` 则返回没有使用表情回应的议题。使用 `Any` 则返回使用至少一个表情回应的议题。
`non_archived`	boolean	no	返回未归档项目的议题。若使用 `false` 则同时返回已归档项目和未归档项目的议题。默认值是 `true`。引入于 13.0 版本。
`not`	Hash	no	对于给定的参数，返回不符合此参数约束的议题。可接受的值：`assignee_id`、`assignee_username`、`author_id`、`author_username`、`iids`、`iteration_id`、`iteration_title`、`labels`、`milestone`、`milestone_id` 和 `weight`。
`order_by`	string	no	返回根据 `created_at`、`due_date`、`label_priority`、`milestone_due`、`popularity`、`priority`、`relative_position`、`title`、`updated_at` 或 `weight` 排序的议题。默认值是 `created_at`。
`scope`	string	no	返回满足范围 `created_by_me`、`assigned_to_me` 或 `all` 的议题。默认值是 `created_by_me`。
`search`	string	no	根据 `title` 和 `description` 搜索议题。
`sort`	string	no	按照 `asc` 或 `desc` 的顺序返回议题。默认值是 `desc`。
`state`	string	no	返回全部 `all` 议题或仅返回处于 `opened` 或 `closed` 状态的议题。
`updated_after`	datetime	no	对于给定的时间戳，返回不早于该时间更新的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`updated_before`	datetime	no	对于给定的时间戳，返回不晚于该时间更新的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`weight`	integer	no	返回权重为 `weight` 的议题。使用. `None` 则返回没有设置权重的议题。使用 `Any` 则返回设置了任意权重的议题。仅限于专业版和旗舰版。
`with_labels_details`	boolean	no	若为 `true` 则返回更详尽的标签信息：`:name`、`:color`、`:description`、`:description_html`、`:text_color`。默认值是 `false`。

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/issues"

响应示例：

[
  {
    "state" : "opened",
    "description" : "Ratione dolores corrupti mollitia soluta quia.",
    "author" : {
      "state" : "active",
      "id" : 18,
      "web_url" : "https://gitlab.example.com/eileen.lowe",
      "name" : "Alexandra Bashirian",
      "avatar_url" : null,
      "username" : "eileen.lowe"
    },
    "milestone" : {
      "project_id" : 1,
      "description" : "Ducimus nam enim ex consequatur cumque ratione.",
      "state" : "closed",
      "due_date" : null,
      "iid" : 2,
      "created_at" : "2016-01-04T15:31:39.996Z",
      "title" : "v4.0",
      "id" : 17,
      "updated_at" : "2016-01-04T15:31:39.996Z"
    },
    "project_id" : 1,
    "assignees" : [{
      "state" : "active",
      "id" : 1,
      "name" : "Administrator",
      "web_url" : "https://gitlab.example.com/root",
      "avatar_url" : null,
      "username" : "root"
    }],
    "assignee" : {
      "state" : "active",
      "id" : 1,
      "name" : "Administrator",
      "web_url" : "https://gitlab.example.com/root",
      "avatar_url" : null,
      "username" : "root"
    },
    "type" : "ISSUE",
    "updated_at" : "2016-01-04T15:31:51.081Z",
    "closed_at" : null,
    "closed_by" : null,
    "id" : 76,
    "title" : "Consequatur vero maxime deserunt laboriosam est voluptas dolorem.",
    "created_at" : "2016-01-04T15:31:51.081Z",
    "moved_to_id" : null,
    "iid" : 6,
    "labels" : ["foo", "bar"],
    "upvotes": 4,
    "downvotes": 0,
    "merge_requests_count": 0,
    "user_notes_count": 1,
    "due_date": "2016-07-22",
    "web_url": "http://gitlab.example.com/my-group/my-project/issues/6",
    "references": {
      "short": "#6",
      "relative": "my-group/my-project#6",
      "full": "my-group/my-project#6"
    },
    "time_stats": {
      "time_estimate": 0,
      "total_time_spent": 0,
      "human_time_estimate": null,
      "human_total_time_spent": null
    },
    "has_tasks": true,
    "task_status": "10 of 15 tasks completed",
    "confidential": false,
    "discussion_locked": false,
    "issue_type": "issue",
    "severity": "UNKNOWN",
    "_links":{
      "self":"http://gitlab.example.com/api/v4/projects/1/issues/76",
      "notes":"http://gitlab.example.com/api/v4/projects/1/issues/76/notes",
      "award_emoji":"http://gitlab.example.com/api/v4/projects/1/issues/76/award_emoji",
      "project":"http://gitlab.example.com/api/v4/projects/1",
      "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"
    },
    "task_completion_status":{
      "count":0,
      "completed_count":0
    }
  }
]

使用专业版或更高级别创建，且包含权重 weight 的议题：

[
   {
      "state" : "opened",
      "description" : "Ratione dolores corrupti mollitia soluta quia.",
      "weight": null,
      ...
   }
]

使用专业版或更高级别创建，且包含关联史诗 epic 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "epic_iid" : 5, //deprecated, use `iid` of the `epic` attribute
   "epic": {
     "id" : 42,
     "iid" : 5,
     "title": "My epic epic",
     "url" : "/groups/h5bp/-/epics/5",
     "group_id": 8
   },
   ...
}

使用专业版或更高级别创建，且包含关联迭代 iteration 的议题：

{
  "iteration": {
    "id":90,
    "iid":4,
    "sequence":2,
    "group_id":162,
    "title":null,
    "description":null,
    "state":2,
    "created_at":"2022-03-14T05:21:11.929Z",
    "updated_at":"2022-03-14T05:21:11.929Z",
    "start_date":"2022-03-08",
    "due_date":"2022-03-14",
    "web_url":"https://gitlab.com/groups/my-group/-/iterations/90"
  }
  ...
}

使用旗舰版创建，且包含健康状态 health_status 的议题：

[
   {
      "state" : "opened",
      "description" : "Ratione dolores corrupti mollitia soluta quia.",
      "health_status": "on_track",
      ...
   }
]

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

epic_iid 已经被弃用。我们将在第 5 版本的 API 中将其移除。作为替代，请使用 epic 属性的 iid。

列出群组议题

获取某个群组的议题。

如果这个群组是私有的，请求者必须提供有效的鉴权信息。我们推荐您使用个人访问令牌进行鉴权。

GET /groups/:id/issues
GET /groups/:id/issues?assignee_id=5
GET /groups/:id/issues?author_id=5
GET /groups/:id/issues?confidential=true
GET /groups/:id/issues?iids[]=42&iids[]=43
GET /groups/:id/issues?labels=foo
GET /groups/:id/issues?labels=foo,bar
GET /groups/:id/issues?labels=foo,bar&state=opened
GET /groups/:id/issues?milestone=1.0.0
GET /groups/:id/issues?milestone=1.0.0&state=opened
GET /groups/:id/issues?my_reaction_emoji=star
GET /groups/:id/issues?search=issue+title+or+description
GET /groups/:id/issues?state=closed
GET /groups/:id/issues?state=opened

参数	类型	是否必需	描述
`id`	integer/string	Yes	全局ID 或URL 编码的群组路径。
`assignee_id`	integer	no	对于给定的用户 `id`，返回指派给这个用户的议题。与 `assignee_username` 冲突。使用 `None` 则返回未被指派的议题。使用 `Any` 则返回存在指派人的议题。
`assignee_username`	string array	no	对于给定的用户名 `username`，返回指派给这个用户的议题。与 `assignee_id` 相似且与其冲突。在基础版中，`assignee_username` 数组只能包含单个成员，否则将报参数错误提示。
`author_id`	integer	no	对于给定的用户 `id`，返回这个用户创建的议题。与 `author_username` 冲突。与 `scope=all` 或 `scope=assigned_to_me` 配合使用。
`author_username`	string	no	对于给定的用户名 `username`，返回这个用户创建的议题。与 `author_id` 相似且与其冲突。
`confidential`	boolean	no	筛选私密议题与公开议题。
`created_after`	datetime	no	对于给定的时间戳，返回不早于该时间创建的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）
`created_before`	datetime	no	对于给定的时间戳，返回不晚于该时间创建的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）
`due_date`	string	no	返回没有截止日期、已经逾期、本周内逾期、本月内逾期或介于两周前和下个月之间逾期的议题。可接受的值：`0`（没有截止日期）、`any`、`today`、`tomorrow`、`overdue`、`week`、`month`、`next_month_and_previous_two_weeks`。
`epic_id`	integer	no	对于给定的史诗 ID，返回与这个史诗关联的议题。使用 `None` 则返回未与史诗关联的议题。使用 `Any` 则返回存在关联史诗的议题。仅限于专业版和旗舰版。
`iids[]`	integer array	no	返回包含给定 `iid` 的议题。
`issue_type`	string	no	筛选议题的类型，可选值为 `issue`、`incident` 或 `test_case`。引入于 13.12 版本。
`iteration_id`	integer	no	对于给定的迭代 ID，返回与这个迭代关联的议题。使用 `None` 则返回未与迭代关联的议题。使用 `Any` 则返回存在关联迭代的议题。仅限于专业版和旗舰版。
`iteration_title`	string	no	对于给定的迭代名称，返回与这个迭代关联的议题。与 `iteration_id` 相似且与其冲突。仅限于专业版和旗舰版。
`labels`	string	no	对于给定的一系列以半角逗号分隔的标签，返回包含所有给定标签的议题。使用 `None` 则返回没有标签的议题。使用 `Any` 则返回包含至少一个标签的议题。使用 `No+Label`（已被弃用）则返回没有标签的议题。预定义名称不区分大小写。
`milestone`	string	no	里程碑名称。使用 `None` 则列出没有里程碑的议题。使用 `Any` 则列出存在关联里程碑的议题。
`my_reaction_emoji`	string	no	对于给定的 `emoji`，返回用户使用该表情回应的议题。使用 `None` 则返回没有使用表情回应的议题。使用 `Any` 则返回使用至少一个表情回应的议题。
`non_archived`	boolean	no	返回未归档项目的议题。默认值是 `true`。引入于 12.8 版本。
`not`	Hash	no	对于给定的参数，返回不符合此参数约束的议题。可接受的值：`labels`、`milestone`、`author_id`、`author_username`、`assignee_id`、`assignee_username`、`my_reaction_emoji`、`search` 和 `in`。
`order_by`	string	no	返回根据 `created_at`、`updated_at`、`priority`、`due_date`、`relative_position`、`label_priority`、`milestone_due`、`popularity` 或 `weight` 排序的议题。默认值是 `created_at`。
`scope`	string	no	返回满足范围 `created_by_me`、`assigned_to_me` 或 `all` 的议题。默认值是 `all`。
`search`	string	no	根据 `title` 和 `description` 搜索群组议题。
`sort`	string	no	按照 `asc` 或 `desc` 的顺序返回议题。默认值是 `desc`。
`state`	string	no	返回全部 `all` 议题或仅返回处于 `opened` 或 `closed` 状态的议题。
`updated_after`	datetime	no	对于给定的时间戳，返回不早于该时间更新的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`updated_before`	datetime	no	对于给定的时间戳，返回不晚于该时间更新的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`weight`	integer	no	返回权重为 `weight` 的议题。使用. `None` 则返回没有设置权重的议题。使用 `Any` 则返回设置了任意权重的议题。
`with_labels_details`	boolean	no	若为 `true` 则返回更详尽的标签信息：`:name`、`:color`、`:description`、`:description_html`、`:text_color`。默认值是 `false`。

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/4/issues"

响应示例：

[
  {
    "project_id" : 4,
    "milestone" : {
      "due_date" : null,
      "project_id" : 4,
      "state" : "closed",
      "description" : "Rerum est voluptatem provident consequuntur molestias similique ipsum dolor.",
      "iid" : 3,
      "id" : 11,
      "title" : "v3.0",
      "created_at" : "2016-01-04T15:31:39.788Z",
      "updated_at" : "2016-01-04T15:31:39.788Z"
    },
    "author" : {
      "state" : "active",
      "web_url" : "https://gitlab.example.com/root",
      "avatar_url" : null,
      "username" : "root",
      "id" : 1,
      "name" : "Administrator"
    },
    "description" : "Omnis vero earum sunt corporis dolor et placeat.",
    "state" : "closed",
    "iid" : 1,
    "assignees" : [{
      "avatar_url" : null,
      "web_url" : "https://gitlab.example.com/lennie",
      "state" : "active",
      "username" : "lennie",
      "id" : 9,
      "name" : "Dr. Luella Kovacek"
    }],
    "assignee" : {
      "avatar_url" : null,
      "web_url" : "https://gitlab.example.com/lennie",
      "state" : "active",
      "username" : "lennie",
      "id" : 9,
      "name" : "Dr. Luella Kovacek"
    },
    "type" : "ISSUE",
    "labels" : ["foo", "bar"],
    "upvotes": 4,
    "downvotes": 0,
    "merge_requests_count": 0,
    "id" : 41,
    "title" : "Ut commodi ullam eos dolores perferendis nihil sunt.",
    "updated_at" : "2016-01-04T15:31:46.176Z",
    "created_at" : "2016-01-04T15:31:46.176Z",
    "closed_at" : null,
    "closed_by" : null,
    "user_notes_count": 1,
    "due_date": null,
    "web_url": "http://gitlab.example.com/my-group/my-project/issues/1",
    "references": {
      "short": "#1",
      "relative": "my-project#1",
      "full": "my-group/my-project#1"
    },
    "time_stats": {
      "time_estimate": 0,
      "total_time_spent": 0,
      "human_time_estimate": null,
      "human_total_time_spent": null
    },
    "has_tasks": true,
    "task_status": "10 of 15 tasks completed",
    "confidential": false,
    "discussion_locked": false,
    "issue_type": "issue",
    "severity": "UNKNOWN",
    "_links":{
      "self":"http://gitlab.example.com/api/v4/projects/4/issues/41",
      "notes":"http://gitlab.example.com/api/v4/projects/4/issues/41/notes",
      "award_emoji":"http://gitlab.example.com/api/v4/projects/4/issues/41/award_emoji",
      "project":"http://gitlab.example.com/api/v4/projects/4",
      "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"
    },
    "task_completion_status":{
      "count":0,
      "completed_count":0
    }
  }
]

使用专业版或更高级别创建，且包含权重 weight 的议题：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "weight": null,
      ...
   }
]

使用专业版或更高级别创建，且包含关联史诗 epic 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "epic_iid" : 5, //deprecated, use `iid` of the `epic` attribute
   "epic": {
     "id" : 42,
     "iid" : 5,
     "title": "My epic epic",
     "url" : "/groups/h5bp/-/epics/5",
     "group_id": 8
   },
   ...
}

使用旗舰版创建，且包含健康状态 health_status 的议题：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "health_status": "at_risk",
      ...
   }
]

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

epic_iid 已经被弃用。我们将在第 5 版本的 API 中将其移除。作为替代，请使用 epic 属性的 iid。

列出项目议题

due_date 属性引入于 13.3 版本。

weight 属性在 13.9 版本被移动到专业版。

due_date 过滤器 any、today 和 `tomorro引入于 14.8 版本。

列出一个项目的议题。

如果这个项目是私有的，请求者必须提供有效的鉴权信息。我们推荐您使用个人访问令牌进行鉴权。

GET /projects/:id/issues
GET /projects/:id/issues?assignee_id=5
GET /projects/:id/issues?author_id=5
GET /projects/:id/issues?confidential=true
GET /projects/:id/issues?iids[]=42&iids[]=43
GET /projects/:id/issues?labels=foo
GET /projects/:id/issues?labels=foo,bar
GET /projects/:id/issues?labels=foo,bar&state=opened
GET /projects/:id/issues?milestone=1.0.0
GET /projects/:id/issues?milestone=1.0.0&state=opened
GET /projects/:id/issues?my_reaction_emoji=star
GET /projects/:id/issues?search=issue+title+or+description
GET /projects/:id/issues?state=closed
GET /projects/:id/issues?state=opened

参数	类型	是否必需	描述
`assignee_id`	integer	no	对于给定的用户 `id`，返回指派给这个用户的议题。与 `assignee_username` 冲突。使用 `None` 则返回未被指派的议题。使用 `Any` 则返回存在指派人的议题。
`assignee_username`	string array	no	对于给定的用户名 `username`，返回指派给这个用户的议题。与 `assignee_id` 相似且与其冲突。在基础版中， `assignee_username` 数组只能包含单个成员，否则将报参数错误提示。
`author_id`	integer	no	对于给定的用户 `id`，返回这个用户创建的议题。与 `author_username` 冲突。与 `scope=all` 或 `scope=assigned_to_me` 配合使用。
`author_username`	string	no	对于给定的用户名 `username`，返回这个用户创建的议题。与 `author_id` 相似且与其冲突。
`confidential`	boolean	no	筛选私密议题与公开议题。
`created_after`	datetime	no	对于给定的时间戳，返回不早于该时间创建的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`created_before`	datetime	no	对于给定的时间戳，返回不晚于该时间创建的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`due_date`	string	no	返回没有截止日期、已经逾期、本周内逾期、本月内逾期或介于两周前和下个月之间逾期的议题。可接受的值：`0`（没有截止日期）、`any`、`today`、`tomorrow`、`overdue`、`week`、`month`、`next_month_and_previous_two_weeks`。
`epic_id`	integer	no	对于给定的史诗 ID，返回与这个史诗关联的议题。使用 `None` 则返回未与史诗关联的议题。使用 `Any` 则返回存在关联史诗的议题。仅限于专业版和旗舰版。
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径。
`iids[]`	integer array	no	返回包含给定 `iid` 的议题。
`issue_type`	string	no	筛选议题的类型，可选值为 `issue`、`incident` 或 `test_case`。引入于 13.12 版本。
`iteration_id`	integer	no	对于给定的迭代 ID，返回与这个迭代关联的议题。使用 `None` 则返回未与迭代关联的议题。使用 `Any` 则返回存在关联迭代的议题。仅限于专业版和旗舰版。
`iteration_title`	string	no	对于给定的迭代名称，返回与这个迭代关联的议题。与 `iteration_id` 相似且与其冲突。仅限于专业版和旗舰版。
`labels`	string	no	对于给定的一系列以半角逗号分隔的标签，返回包含所有给定标签的议题。使用 `None` 则返回没有标签的议题。使用 `Any` 则返回包含至少一个标签的议题。使用 `No+Label`（已被弃用）则返回没有标签的议题。预定义名称不区分大小写。
`milestone`	string	no	里程碑名称。使用 `None` 则列出没有里程碑的议题。使用 `Any` 则列出存在关联里程碑的议题。
`my_reaction_emoji`	string	no	对于给定的 `emoji`，返回用户使用该表情回应的议题。使用 `None` 则返回没有使用表情回应的议题。使用 `Any` 则返回使用至少一个表情回应的议题。
`not`	Hash	no	对于给定的参数，返回不符合此参数约束的议题。可接受的值：`labels`、`milestone`、`author_id`、`author_username`、`assignee_id`、`assignee_username`、`my_reaction_emoji`、`search` 和 `in`。
`order_by`	string	no	返回根据 `created_at`、`updated_at`、`priority`、`due_date`、`relative_position`、`label_priority`、`milestone_due`、`popularity` 或 `weight` 排序的议题。默认值是 `created_at`。
`scope`	string	no	返回满足范围 `created_by_me`、`assigned_to_me` 或 `all` 的议题。默认值是 `all`。
`search`	string	no	根据 `title` 和 `description` 搜索项目议题。
`sort`	string	no	按照 `asc` 或 `desc` 的顺序返回议题。默认值是 `desc`。
`state`	string	no	返回全部 `all` 议题或仅返回处于 `opened` 或 `closed` 状态的议题。
`updated_after`	datetime	no	对于给定的时间戳，返回不早于该时间更新的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`updated_before`	datetime	no	对于给定的时间戳，返回不晚于该时间更新的议题。时间戳应符合 ISO 8601 格式（`2019-03-15T08:00:00Z`）。
`weight`	integer	no	返回权重为 `weight` 的议题。使用. `None` 则返回没有设置权重的议题。使用 `Any` 则返回设置了任意权重的议题。仅限于专业版和旗舰版。
`with_labels_details`	boolean	no	若为 `true` 则返回更详尽的标签信息：`:name`、`:color`、`:description`、`:description_html`、`:text_color`。默认值是 `false`。

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url  "https://gitlab.example.com/api/v4/projects/4/issues"

响应示例：

[
  {
    "project_id" : 4,
    "milestone" : {
      "due_date" : null,
      "project_id" : 4,
      "state" : "closed",
      "description" : "Rerum est voluptatem provident consequuntur molestias similique ipsum dolor.",
      "iid" : 3,
      "id" : 11,
      "title" : "v3.0",
      "created_at" : "2016-01-04T15:31:39.788Z",
      "updated_at" : "2016-01-04T15:31:39.788Z"
    },
    "author" : {
      "state" : "active",
      "web_url" : "https://gitlab.example.com/root",
      "avatar_url" : null,
      "username" : "root",
      "id" : 1,
      "name" : "Administrator"
    },
    "description" : "Omnis vero earum sunt corporis dolor et placeat.",
    "state" : "closed",
    "iid" : 1,
    "assignees" : [{
      "avatar_url" : null,
      "web_url" : "https://gitlab.example.com/lennie",
      "state" : "active",
      "username" : "lennie",
      "id" : 9,
      "name" : "Dr. Luella Kovacek"
    }],
    "assignee" : {
      "avatar_url" : null,
      "web_url" : "https://gitlab.example.com/lennie",
      "state" : "active",
      "username" : "lennie",
      "id" : 9,
      "name" : "Dr. Luella Kovacek"
    },
    "type" : "ISSUE",
    "labels" : ["foo", "bar"],
    "upvotes": 4,
    "downvotes": 0,
    "merge_requests_count": 0,
    "id" : 41,
    "title" : "Ut commodi ullam eos dolores perferendis nihil sunt.",
    "updated_at" : "2016-01-04T15:31:46.176Z",
    "created_at" : "2016-01-04T15:31:46.176Z",
    "closed_at" : "2016-01-05T15:31:46.176Z",
    "closed_by" : {
      "state" : "active",
      "web_url" : "https://gitlab.example.com/root",
      "avatar_url" : null,
      "username" : "root",
      "id" : 1,
      "name" : "Administrator"
    },
    "user_notes_count": 1,
    "due_date": "2016-07-22",
    "web_url": "http://gitlab.example.com/my-group/my-project/issues/1",
    "references": {
      "short": "#1",
      "relative": "#1",
      "full": "my-group/my-project#1"
    },
    "time_stats": {
      "time_estimate": 0,
      "total_time_spent": 0,
      "human_time_estimate": null,
      "human_total_time_spent": null
    },
    "has_tasks": true,
    "task_status": "10 of 15 tasks completed",
    "confidential": false,
    "discussion_locked": false,
    "issue_type": "issue",
    "severity": "UNKNOWN",
    "_links":{
      "self":"http://gitlab.example.com/api/v4/projects/4/issues/41",
      "notes":"http://gitlab.example.com/api/v4/projects/4/issues/41/notes",
      "award_emoji":"http://gitlab.example.com/api/v4/projects/4/issues/41/award_emoji",
      "project":"http://gitlab.example.com/api/v4/projects/4",
      "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"
    },
    "task_completion_status":{
      "count":0,
      "completed_count":0
    }
  }
]

使用专业版或更高级别创建，且包含权重 weight 的议题：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "weight": null,
      ...
   }
]

使用专业版或更高级别创建，且包含关联史诗 epic 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "epic_iid" : 5, //deprecated, use `iid` of the `epic` attribute
   "epic": {
     "id" : 42,
     "iid" : 5,
     "title": "My epic epic",
     "url" : "/groups/h5bp/-/epics/5",
     "group_id": 8
   },
   ...
}

使用旗舰版创建，且包含健康状态 health_status 的议题：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "health_status": "at_risk",
      ...
   }
]

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

epic_iid 已经被弃用。我们将在第 5 版本的 API 中将其移除。作为替代，请使用 epic 属性的 iid。

单个议题

仅适用于管理员。获取单个议题。我们推荐您使用个人访问令牌进行鉴权。

GET /issues/:id

参数	类型	是否必需	描述
`id`	integer	yes	议题的 ID 号

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/issues/41"

示例响应：

{
  "id": 1,
  "milestone": {
    "due_date": null,
    "project_id": 4,
    "state": "closed",
    "description": "Rerum est voluptatem provident consequuntur molestias similique ipsum dolor.",
    "iid": 3,
    "id": 11,
    "title": "v3.0",
    "created_at": "2016-01-04T15:31:39.788Z",
    "updated_at": "2016-01-04T15:31:39.788Z",
    "closed_at": "2016-01-05T15:31:46.176Z"
  },
  "author": {
    "state": "active",
    "web_url": "https://gitlab.example.com/root",
    "avatar_url": null,
    "username": "root",
    "id": 1,
    "name": "Administrator"
  },
  "description": "Omnis vero earum sunt corporis dolor et placeat.",
  "state": "closed",
  "iid": 1,
  "assignees": [
    {
      "avatar_url": null,
      "web_url": "https://gitlab.example.com/lennie",
      "state": "active",
      "username": "lennie",
      "id": 9,
      "name": "Dr. Luella Kovacek"
    }
  ],
  "assignee": {
    "avatar_url": null,
    "web_url": "https://gitlab.example.com/lennie",
    "state": "active",
    "username": "lennie",
    "id": 9,
    "name": "Dr. Luella Kovacek"
  },
  "type": "ISSUE",
  "labels": [],
  "upvotes": 4,
  "downvotes": 0,
  "merge_requests_count": 0,
  "title": "Ut commodi ullam eos dolores perferendis nihil sunt.",
  "updated_at": "2016-01-04T15:31:46.176Z",
  "created_at": "2016-01-04T15:31:46.176Z",
  "closed_at": null,
  "closed_by": null,
  "subscribed": false,
  "user_notes_count": 1,
  "due_date": null,
  "web_url": "http://example.com/my-group/my-project/issues/1",
  "references": {
    "short": "#1",
    "relative": "#1",
    "full": "my-group/my-project#1"
  },
  "time_stats": {
    "time_estimate": 0,
    "total_time_spent": 0,
    "human_time_estimate": null,
    "human_total_time_spent": null
  },
  "confidential": false,
  "discussion_locked": false,
  "issue_type": "issue",
  "severity": "UNKNOWN",
  "task_completion_status": {
    "count": 0,
    "completed_count": 0
  },
  "weight": null,
  "has_tasks": false,
  "_links": {
    "self": "http://gitlab.example:3000/api/v4/projects/1/issues/1",
    "notes": "http://gitlab.example:3000/api/v4/projects/1/issues/1/notes",
    "award_emoji": "http://gitlab.example:3000/api/v4/projects/1/issues/1/award_emoji",
    "project": "http://gitlab.example:3000/api/v4/projects/1",
    "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"
  },
  "moved_to_id": null,
  "service_desk_reply_to": "service.desk@gitlab.com"
}

使用专业版或更高级别创建，且包含权重 weight 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "weight": null,
   ...
}

使用专业版或更高级别创建，且包含关联史诗 epic 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "epic": {
   "epic_iid" : 5, //deprecated, use `iid` of the `epic` attribute
   "epic": {
     "id" : 42,
     "iid" : 5,
     "title": "My epic epic",
     "url" : "/groups/h5bp/-/epics/5",
     "group_id": 8
   },
   ...
}

旗舰版用户还可以看到健康状态 health_status 信息：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "health_status": "on_track",
      ...
   }
]

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

epic_iid 已经被弃用。我们将在第 5 版本的 API 中将其移除。作为替代，请使用 epic 属性的 iid。

单个项目议题

获取单个项目议题。

如果这个项目是私有的或议题是私密的，请求者必须提供有效的鉴权信息。我们推荐您使用个人访问令牌进行鉴权。

GET /projects/:id/issues/:issue_iid

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/4/issues/41"

响应示例：

{
  "project_id" : 4,
  "milestone" : {
    "due_date" : null,
    "project_id" : 4,
    "state" : "closed",
    "description" : "Rerum est voluptatem provident consequuntur molestias similique ipsum dolor.",
    "iid" : 3,
    "id" : 11,
    "title" : "v3.0",
    "created_at" : "2016-01-04T15:31:39.788Z",
    "updated_at" : "2016-01-04T15:31:39.788Z",
    "closed_at" : "2016-01-05T15:31:46.176Z"
  },
  "author" : {
    "state" : "active",
    "web_url" : "https://gitlab.example.com/root",
    "avatar_url" : null,
    "username" : "root",
    "id" : 1,
    "name" : "Administrator"
  },
  "description" : "Omnis vero earum sunt corporis dolor et placeat.",
  "state" : "closed",
  "iid" : 1,
  "assignees" : [{
    "avatar_url" : null,
    "web_url" : "https://gitlab.example.com/lennie",
    "state" : "active",
    "username" : "lennie",
    "id" : 9,
    "name" : "Dr. Luella Kovacek"
  }],
  "assignee" : {
    "avatar_url" : null,
    "web_url" : "https://gitlab.example.com/lennie",
    "state" : "active",
    "username" : "lennie",
    "id" : 9,
    "name" : "Dr. Luella Kovacek"
  },
  "type" : "ISSUE",
  "labels" : [],
  "upvotes": 4,
  "downvotes": 0,
  "merge_requests_count": 0,
  "id" : 41,
  "title" : "Ut commodi ullam eos dolores perferendis nihil sunt.",
  "updated_at" : "2016-01-04T15:31:46.176Z",
  "created_at" : "2016-01-04T15:31:46.176Z",
  "closed_at" : null,
  "closed_by" : null,
  "subscribed": false,
  "user_notes_count": 1,
  "due_date": null,
  "web_url": "http://gitlab.example.com/my-group/my-project/issues/1",
  "references": {
    "short": "#1",
    "relative": "#1",
    "full": "my-group/my-project#1"
  },
  "time_stats": {
    "time_estimate": 0,
    "total_time_spent": 0,
    "human_time_estimate": null,
    "human_total_time_spent": null
  },
  "confidential": false,
  "discussion_locked": false,
  "issue_type": "issue",
  "severity": "UNKNOWN",
  "_links": {
    "self": "http://gitlab.example.com/api/v4/projects/1/issues/2",
    "notes": "http://gitlab.example.com/api/v4/projects/1/issues/2/notes",
    "award_emoji": "http://gitlab.example.com/api/v4/projects/1/issues/2/award_emoji",
    "project": "http://gitlab.example.com/api/v4/projects/1",
    "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"
  },
  "task_completion_status":{
    "count":0,
    "completed_count":0
  }
}

使用专业版或更高级别创建，且包含权重 weight 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "weight": null,
   ...
}

使用专业版或更高级别创建，且包含关联史诗 epic 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "epic_iid" : 5, //deprecated, use `iid` of the `epic` attribute
   "epic": {
     "id" : 42,
     "iid" : 5,
     "title": "My epic epic",
     "url" : "/groups/h5bp/-/epics/5",
     "group_id": 8
   },
   ...
}

旗舰版用户还可以看到健康状态 health_status 信息：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "health_status": "on_track",
      ...
   }
]

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

epic_iid 已经被弃用。我们将在第 5 版本的 API 中将其移除。作为替代，请使用 epic 属性的 iid。

新建议题

创建一个新的项目议题。

POST /projects/:id/issues

参数	类型	是否必需	描述
`assignee_id`	integer	no	指派人的用户 ID，仅适用于基础版。
`assignee_ids`	integer array	no	指派人的用户 ID。仅限于专业版和旗舰版。
`confidential`	boolean	no	将议题设置为私密。默认值为 `false`。
`created_at`	string	no	议题的创建时间。使用 ISO 8601 格式，如 `2016-03-11T03:45:40Z`。需要管理员或项目/群组拥有者权限。
`description`	string	no	议题描述。不能超过 1,048,576 个字符。
`discussion_to_resolve`	string	no	解决讨论的 ID。这将对议题描述进行自动填充并将对应讨论标记为已解决。和 `merge_request_to_resolve_discussions_of` 配合使用。
`due_date`	string	no	截止日期。使用 `YYYY-MM-DD` 格式，如 `2016-03-11`
`epic_id`	integer	no	需要关联的史诗 ID。提供的值必须大于等于 0。仅限于专业版和旗舰版。
`epic_iid`	integer	no	需要关联的史诗 IID。提供的值必须大于等于 0。已被弃用，第五版 API 将会移除此属性。仅限于专业版和旗舰版。
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径。
`iid`	integer/string	no	项目议题内部 ID（需要管理员或项目拥有者权限）。
`issue_type`	string	no	议题类型，可以是 `issue`、`incident` 和 `test_case` 中的一个。默认值是 `issue`。
`labels`	string	no	议题的标签名称，使用半角逗号分隔。
`merge_request_to_resolve_discussions_of`	integer	no	用于解决议题的合并请求 IID。这将对议题描述进行自动填充并将对应讨论标记为已解决。如果您同时提供描述或标题，这些值优先于默认值。
`milestone_id`	integer	no	议题关联的里程碑全局 ID。要查看一个里程碑的 `milestone_id`，找到一个与该里程碑关联的议题并使用 API 获取议题的信息。
`title`	string	yes	议题的标题。
`weight`	integer	no	议题的权重。提供的值必须大于等于 0。仅限于专业版和旗舰版。

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url  "https://gitlab.example.com/api/v4/projects/4/issues?title=Issues%20with%20auth&labels=bug"

响应示例：

{
  "project_id" : 4,
  "id" : 84,
  "created_at" : "2016-01-07T12:44:33.959Z",
  "iid" : 14,
  "title" : "Issues with auth",
  "state" : "opened",
  "assignees" : [],
  "assignee" : null,
  "type" : "ISSUE",
  "labels" : [
    "bug"
  ],
  "upvotes": 4,
  "downvotes": 0,
  "merge_requests_count": 0,
  "author" : {
    "name" : "Alexandra Bashirian",
    "avatar_url" : null,
    "state" : "active",
    "web_url" : "https://gitlab.example.com/eileen.lowe",
    "id" : 18,
    "username" : "eileen.lowe"
  },
  "description" : null,
  "updated_at" : "2016-01-07T12:44:33.959Z",
  "closed_at" : null,
  "closed_by" : null,
  "milestone" : null,
  "subscribed" : true,
  "user_notes_count": 0,
  "due_date": null,
  "web_url": "http://gitlab.example.com/my-group/my-project/issues/14",
  "references": {
    "short": "#14",
    "relative": "#14",
    "full": "my-group/my-project#14"
  },
  "time_stats": {
    "time_estimate": 0,
    "total_time_spent": 0,
    "human_time_estimate": null,
    "human_total_time_spent": null
  },
  "confidential": false,
  "discussion_locked": false,
  "issue_type": "issue",
  "severity": "UNKNOWN",
  "_links": {
    "self": "http://gitlab.example.com/api/v4/projects/1/issues/2",
    "notes": "http://gitlab.example.com/api/v4/projects/1/issues/2/notes",
    "award_emoji": "http://gitlab.example.com/api/v4/projects/1/issues/2/award_emoji",
    "project": "http://gitlab.example.com/api/v4/projects/1",
    "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"
  },
  "task_completion_status":{
    "count":0,
    "completed_count":0
  }
}

使用专业版或更高级别创建，且包含权重 weight 的议题：

{
   "project_id" : 4,
   "description" : null,
   "weight": null,
   ...
}

使用专业版或更高级别创建，且包含关联史诗 epic 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "epic_iid" : 5, //deprecated, use `iid` of the `epic` attribute
   "epic": {
     "id" : 42,
     "iid" : 5,
     "title": "My epic epic",
     "url" : "/groups/h5bp/-/epics/5",
     "group_id": 8
   },
   ...
}

使用旗舰版创建，且包含健康状态 health_status 的议题：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "health_status": "on_track",
      ...
   }
]

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

epic_iid 已经被弃用。我们将在第 5 版本的 API 中将其移除。作为替代，请使用 epic 属性的 iid。

速率限制

为了避免滥用情况，用户每分钟可以调用的创建相关请求的次数将被受到限制。阅读议题速率限制页面了解更多信息。

编辑议题

更新已有的项目的议题，或者将议题关闭。

下面这些参数，您需要至少提供一个：

:assignee_id
:assignee_ids
:confidential
:created_at
:description
:discussion_locked
:due_date
:issue_type
:labels
:milestone_id
:state_event
:title

PUT /projects/:id/issues/:issue_iid

参数	类型	是否必需	描述
`id`	integer/string	Yes	全局 ID 或 URL 编码的项目路径。
`issue_iid`	integer	Yes	项目的议题内部 ID。
`add_labels`	string	no	需要给议题添加的标签，使用半角逗号分隔。
`assignee_ids`	integer array	no	议题指派人的 ID。将此项设置为 `0` 或提供一个空值以取消所有已有指派。
`confidential`	boolean	no	将议题设置为私密。
`description`	string	no	议题的描述。不能超过 1,048,576 个字符。
`discussion_locked`	boolean	no	标记此议题讨论是否被锁定。只有项目成员可以往锁定的议题添加或编辑讨论。
`due_date`	string	no	截止日期。使用格式 `YYYY-MM-DD`，如 `2016-03-11`。
`epic_id`	integer	no	需要关联的史诗 ID。提供的值必须大于等于 0。仅限于专业版和旗舰版。
`epic_iid`	integer	no	需要关联的史诗 IID。提供的值必须大于等于 0。已被弃用，第五版 API 将会移除此属性。仅限于专业版和旗舰版。
`issue_iid`	integer	yes	项目议题内部 ID（需要管理员或项目拥有者权限）。
`issue_type`	string	no	议题类型，可以是 `issue`、`incident` 和 `test_case` 中的一个。
`labels`	string	no	议题的标签名称，使用半角逗号分隔。使用空串来删除所有标签。
`milestone_id`	integer	no	议题关联的里程碑全局 ID。将此项设置为 `0` 或提供一个空值以移除里程碑。
`remove_labels`	string	no	需要给议题删除的标签，使用半角逗号分隔。
`state_event`	string	no	议题的状态。设置为 `close` 以关闭议题，设置为 `reopen` 以重新打开议题。
`title`	string	no	议题的标题。
`updated_at`	string	no	议题的更新时间。使用 ISO 8601 格式，如 `2016-03-11T03:45:40Z`。需要管理员或项目/群组拥有者权限。不能提供空串。
`weight`	integer	no	议题的权重。提供的值必须大于等于 0。仅限于专业版和旗舰版。

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/4/issues/85?state_event=close"

Example response:

{
  "created_at" : "2016-01-07T12:46:01.410Z",
  "author" : {
    "name" : "Alexandra Bashirian",
    "avatar_url" : null,
    "username" : "eileen.lowe",
    "id" : 18,
    "state" : "active",
    "web_url" : "https://gitlab.example.com/eileen.lowe"
  },
  "state" : "closed",
  "title" : "Issues with auth",
  "project_id" : 4,
  "description" : null,
  "updated_at" : "2016-01-07T12:55:16.213Z",
  "closed_at" : "2016-01-08T12:55:16.213Z",
  "closed_by" : {
    "state" : "active",
    "web_url" : "https://gitlab.example.com/root",
    "avatar_url" : null,
    "username" : "root",
    "id" : 1,
    "name" : "Administrator"
  },
  "iid" : 15,
  "labels" : [
    "bug"
  ],
  "upvotes": 4,
  "downvotes": 0,
  "merge_requests_count": 0,
  "id" : 85,
  "assignees" : [],
  "assignee" : null,
  "milestone" : null,
  "subscribed" : true,
  "user_notes_count": 0,
  "due_date": "2016-07-22",
  "web_url": "http://gitlab.example.com/my-group/my-project/issues/15",
  "references": {
    "short": "#15",
    "relative": "#15",
    "full": "my-group/my-project#15"
  },
  "time_stats": {
    "time_estimate": 0,
    "total_time_spent": 0,
    "human_time_estimate": null,
    "human_total_time_spent": null
  },
  "confidential": false,
  "discussion_locked": false,
  "issue_type": "issue",
  "severity": "UNKNOWN",
  "_links": {
    "self": "http://gitlab.example.com/api/v4/projects/1/issues/2",
    "notes": "http://gitlab.example.com/api/v4/projects/1/issues/2/notes",
    "award_emoji": "http://gitlab.example.com/api/v4/projects/1/issues/2/award_emoji",
    "project": "http://gitlab.example.com/api/v4/projects/1",
    "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"

  },
  "task_completion_status":{
    "count":0,
    "completed_count":0
  }
}

使用专业版或更高级别创建，且包含权重 weight 的议题：

{
   "project_id" : 4,
   "description" : null,
   "weight": null,
   ...
}

使用专业版或更高级别创建，且包含关联史诗 epic 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "epic_iid" : 5, //deprecated, use `iid` of the `epic` attribute
   "epic": {
     "id" : 42,
     "iid" : 5,
     "title": "My epic epic",
     "url" : "/groups/h5bp/-/epics/5",
     "group_id": 8
   },
   ...
}

使用旗舰版创建，且包含健康状态 health_status 的议题：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "health_status": "on_track",
      ...
   }
]

epic_iid 已经被弃用。我们将在第 5 版本的 API 中将其移除。作为替代，请使用 epic 属性的 iid。

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

删除议题

仅使用于管理员和项目拥有者。删除议题。

DELETE /projects/:id/issues/:issue_iid

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径。
`issue_iid`	integer	yes	项目议题的内部 ID。

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/4/issues/85"

如果成功，返回 204 No Content。

重排序议题

将一个议题进行重新排序，手动排序后的效果可直接肉眼观察到。

PUT /projects/:id/issues/:issue_iid/reorder

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID
`move_after_id`	integer	no	议题后面紧跟着的项目议题的全局 ID
`move_before_id`	integer	no	议题前面紧跟着的项目议题的全局 ID

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/4/issues/85/reorder?move_after_id=51&move_before_id=92"

移动议题

将议题移至不同的项目。如果目标项目就是源项目或者用户权限不足，将返回一则错误信息和 400 状态码。

如果目标项目中也存在给定的标签或里程碑，他们会被自动关联到议题中。

POST /projects/:id/issues/:issue_iid/move

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID
`to_project_id`	integer	yes	新项目的 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" --form to_project_id=5 "https://gitlab.example.com/api/v4/projects/4/issues/85/move"

Example response:

{
  "id": 92,
  "iid": 11,
  "project_id": 5,
  "title": "Sit voluptas tempora quisquam aut doloribus et.",
  "description": "Repellat voluptas quibusdam voluptatem exercitationem.",
  "state": "opened",
  "created_at": "2016-04-05T21:41:45.652Z",
  "updated_at": "2016-04-07T12:20:17.596Z",
  "closed_at": null,
  "closed_by": null,
  "labels": [],
  "upvotes": 4,
  "downvotes": 0,
  "merge_requests_count": 0,
  "milestone": null,
  "assignees": [{
    "name": "Miss Monserrate Beier",
    "username": "axel.block",
    "id": 12,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/46f6f7dc858ada7be1853f7fb96e81da?s=80&d=identicon",
    "web_url": "https://gitlab.example.com/axel.block"
  }],
  "assignee": {
    "name": "Miss Monserrate Beier",
    "username": "axel.block",
    "id": 12,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/46f6f7dc858ada7be1853f7fb96e81da?s=80&d=identicon",
    "web_url": "https://gitlab.example.com/axel.block"
  },
  "type" : "ISSUE",
  "author": {
    "name": "Kris Steuber",
    "username": "solon.cremin",
    "id": 10,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/7a190fecbaa68212a4b68aeb6e3acd10?s=80&d=identicon",
    "web_url": "https://gitlab.example.com/solon.cremin"
  },
  "due_date": null,
  "web_url": "http://gitlab.example.com/my-group/my-project/issues/11",
  "references": {
    "short": "#11",
    "relative": "#11",
    "full": "my-group/my-project#11"
  },
  "time_stats": {
    "time_estimate": 0,
    "total_time_spent": 0,
    "human_time_estimate": null,
    "human_total_time_spent": null
  },
  "confidential": false,
  "discussion_locked": false,
  "issue_type": "issue",
  "severity": "UNKNOWN",
  "_links": {
    "self": "http://gitlab.example.com/api/v4/projects/1/issues/2",
    "notes": "http://gitlab.example.com/api/v4/projects/1/issues/2/notes",
    "award_emoji": "http://gitlab.example.com/api/v4/projects/1/issues/2/award_emoji",
    "project": "http://gitlab.example.com/api/v4/projects/1",
    "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"
  },
  "task_completion_status":{
    "count":0,
    "completed_count":0
  }
}

使用专业版或更高级别创建，且包含权重 weight 的议题：

{
  "project_id": 5,
  "description": "Repellat voluptas quibusdam voluptatem exercitationem.",
  "weight": null,
  ...
}

使用专业版或更高级别创建，且包含关联史诗 epic 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "epic_iid" : 5, //deprecated, use `iid` of the `epic` attribute
   "epic": {
     "id" : 42,
     "iid" : 5,
     "title": "My epic epic",
     "url" : "/groups/h5bp/-/epics/5",
     "group_id": 8
   },
   ...
}

使用旗舰版创建，且包含健康状态 health_status 的议题：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "health_status": "on_track",
      ...
   }
]

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

epic_iid 已经被弃用。我们将在第 5 版本的 API 中将其移除。作为替代，请使用 epic 属性的 iid。

克隆议题

将议题克隆至指定的项目。如果用户没有对应的权限，将返回一则错误信息和 400 状态码。

只要目标项目包含等效标准，如标记或里程碑，就尽可能多地复制数据。

POST /projects/:id/issues/:issue_iid/clone

参数	类型	是否必需	描述
`id`	integer/string	Yes	经过身份验证的用户拥有的项目 ID 或经过 URL 编码处理的路径。
`issue_iid`	integer	Yes	项目议题的内部 ID。
`to_project_id`	integer	Yes	目标项目的 ID。
`with_notes`	boolean	No	是否连同备注一同迁移。默认值为 `false`。

curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
-- url "https://gitlab.example.com/api/v4/projects/5/issues/1/clone?with_notes=true&to_project_id=6"

响应示例：

{
  "id":290,
  "iid":1,
  "project_id":143,
  "title":"foo",
  "description":"closed",
  "state":"opened",
  "created_at":"2021-09-14T22:24:11.696Z",
  "updated_at":"2021-09-14T22:24:11.696Z",
  "closed_at":null,
  "closed_by":null,
  "labels":[

  ],
  "milestone":null,
  "assignees":[
    {
      "id":179,
      "name":"John Doe2",
      "username":"john",
      "state":"active",
      "avatar_url":"https://www.gravatar.com/avatar/10fc7f102be8de7657fb4d80898bbfe3?s=80\u0026d=identicon",
      "web_url":"https://gitlab.example.com/john"
    }
  ],
  "author":{
    "id":179,
    "name":"John Doe2",
    "username":"john",
    "state":"active",
    "avatar_url":"https://www.gravatar.com/avatar/10fc7f102be8de7657fb4d80898bbfe3?s=80\u0026d=identicon",
    "web_url":"https://gitlab.example.com/john"
  },
  "type":"ISSUE",
  "assignee":{
    "id":179,
    "name":"John Doe2",
    "username":"john",
    "state":"active",
    "avatar_url":"https://www.gravatar.com/avatar/10fc7f102be8de7657fb4d80898bbfe3?s=80\u0026d=identicon",
    "web_url":"https://gitlab.example.com/john"
  },
  "user_notes_count":1,
  "merge_requests_count":0,
  "upvotes":0,
  "downvotes":0,
  "due_date":null,
  "confidential":false,
  "discussion_locked":null,
  "issue_type":"issue",
  "severity": "UNKNOWN",
  "web_url":"https://gitlab.example.com/namespace1/project2/-/issues/1",
  "time_stats":{
    "time_estimate":0,
    "total_time_spent":0,
    "human_time_estimate":null,
    "human_total_time_spent":null
  },
  "task_completion_status":{
    "count":0,
    "completed_count":0
  },
  "blocking_issues_count":0,
  "has_tasks":false,
  "_links":{
    "self":"https://gitlab.example.com/api/v4/projects/143/issues/1",
    "notes":"https://gitlab.example.com/api/v4/projects/143/issues/1/notes",
    "award_emoji":"https://gitlab.example.com/api/v4/projects/143/issues/1/award_emoji",
    "project":"https://gitlab.example.com/api/v4/projects/143",
    "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"
  },
  "references":{
    "short":"#1",
    "relative":"#1",
    "full":"namespace1/project2#1"
  },
  "subscribed":true,
  "moved_to_id":null,
  "service_desk_reply_to":null
}

通知

如下请求与议题的邮件通知有关。

订阅议题

经过身份验证的用户可以订阅议题以接收该议题的通知。如果用户已经订阅了某个议题，将返回 304 状态码。

POST /projects/:id/issues/:issue_iid/subscribe

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/93/subscribe"

响应示例：

{
  "id": 92,
  "iid": 11,
  "project_id": 5,
  "title": "Sit voluptas tempora quisquam aut doloribus et.",
  "description": "Repellat voluptas quibusdam voluptatem exercitationem.",
  "state": "opened",
  "created_at": "2016-04-05T21:41:45.652Z",
  "updated_at": "2016-04-07T12:20:17.596Z",
  "closed_at": null,
  "closed_by": null,
  "labels": [],
  "upvotes": 4,
  "downvotes": 0,
  "merge_requests_count": 0,
  "milestone": null,
  "assignees": [{
    "name": "Miss Monserrate Beier",
    "username": "axel.block",
    "id": 12,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/46f6f7dc858ada7be1853f7fb96e81da?s=80&d=identicon",
    "web_url": "https://gitlab.example.com/axel.block"
  }],
  "assignee": {
    "name": "Miss Monserrate Beier",
    "username": "axel.block",
    "id": 12,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/46f6f7dc858ada7be1853f7fb96e81da?s=80&d=identicon",
    "web_url": "https://gitlab.example.com/axel.block"
  },
  "type" : "ISSUE",
  "author": {
    "name": "Kris Steuber",
    "username": "solon.cremin",
    "id": 10,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/7a190fecbaa68212a4b68aeb6e3acd10?s=80&d=identicon",
    "web_url": "https://gitlab.example.com/solon.cremin"
  },
  "due_date": null,
  "web_url": "http://gitlab.example.com/my-group/my-project/issues/11",
  "references": {
    "short": "#11",
    "relative": "#11",
    "full": "my-group/my-project#11"
  },
  "time_stats": {
    "time_estimate": 0,
    "total_time_spent": 0,
    "human_time_estimate": null,
    "human_total_time_spent": null
  },
  "confidential": false,
  "discussion_locked": false,
  "issue_type": "issue",
  "severity": "UNKNOWN",
  "_links": {
    "self": "http://gitlab.example.com/api/v4/projects/1/issues/2",
    "notes": "http://gitlab.example.com/api/v4/projects/1/issues/2/notes",
    "award_emoji": "http://gitlab.example.com/api/v4/projects/1/issues/2/award_emoji",
    "project": "http://gitlab.example.com/api/v4/projects/1",
    "closed_as_duplicate_of": "http://gitlab.example.com/api/v4/projects/1/issues/75"
  },
  "task_completion_status":{
    "count":0,
    "completed_count":0
  }
}

使用专业版或更高级别创建，且包含权重 weight 的议题：

{
  "project_id": 5,
  "description": "Repellat voluptas quibusdam voluptatem exercitationem.",
  "weight": null,
  ...
}

使用专业版或更高级别创建，且包含关联史诗 epic 的议题：

{
   "project_id" : 4,
   "description" : "Omnis vero earum sunt corporis dolor et placeat.",
   "epic_iid" : 5, //deprecated, use `iid` of the `epic` attribute
   "epic": {
     "id" : 42,
     "iid" : 5,
     "title": "My epic epic",
     "url" : "/groups/h5bp/-/epics/5",
     "group_id": 8
   },
   ...
}

使用旗舰版创建，且包含健康状态 health_status 的议题：

[
   {
      "project_id" : 4,
      "description" : "Omnis vero earum sunt corporis dolor et placeat.",
      "health_status": "on_track",
      ...
   }
]

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

epic_iid 已经被弃用。我们将在第 5 版本的 API 中将其移除。作为替代，请使用 epic 属性的 iid。

取消订阅议题

经过身份验证的用户可以取消订阅议题以不再接收该议题的通知。如果用户并没有订阅这个议题，将返回 304 状态码。

POST /projects/:id/issues/:issue_iid/unsubscribe

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/93/unsubscribe"

响应示例：

{
  "id": 93,
  "iid": 12,
  "project_id": 5,
  "title": "Incidunt et rerum ea expedita iure quibusdam.",
  "description": "Et cumque architecto sed aut ipsam.",
  "state": "opened",
  "created_at": "2016-04-05T21:41:45.217Z",
  "updated_at": "2016-04-07T13:02:37.905Z",
  "labels": [],
  "upvotes": 4,
  "downvotes": 0,
  "merge_requests_count": 0,
  "milestone": null,
  "assignee": {
    "name": "Edwardo Grady",
    "username": "keyon",
    "id": 21,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/3e6f06a86cf27fa8b56f3f74f7615987?s=80&d=identicon",
    "web_url": "https://gitlab.example.com/keyon"
  },
  "type" : "ISSUE",
  "closed_at": null,
  "closed_by": null,
  "author": {
    "name": "Vivian Hermann",
    "username": "orville",
    "id": 11,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/5224fd70153710e92fb8bcf79ac29d67?s=80&d=identicon",
    "web_url": "https://gitlab.example.com/orville"
  },
  "subscribed": false,
  "due_date": null,
  "web_url": "http://gitlab.example.com/my-group/my-project/issues/12",
  "references": {
    "short": "#12",
    "relative": "#12",
    "full": "my-group/my-project#12"
  },
  "confidential": false,
  "discussion_locked": false,
  "issue_type": "issue",
  "severity": "UNKNOWN",
  "task_completion_status":{
    "count":0,
    "completed_count":0
  }
}

创建待办事项

为当前用户基于某个议题手动创建待办事项。如果这个议题已经是用户的待办事项，将返回 304 状态码。

POST /projects/:id/issues/:issue_iid/todo

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/issues/93/todo"

响应示例：

{
  "id": 112,
  "project": {
    "id": 5,
    "name": "GitLab CI/CD",
    "name_with_namespace": "GitLab Org / GitLab CI/CD",
    "path": "gitlab-ci",
    "path_with_namespace": "gitlab-org/gitlab-ci"
  },
  "author": {
    "name": "Administrator",
    "username": "root",
    "id": 1,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
    "web_url": "https://gitlab.example.com/root"
  },
  "action_name": "marked",
  "target_type": "Issue",
  "target": {
    "id": 93,
    "iid": 10,
    "project_id": 5,
    "title": "Vel voluptas atque dicta mollitia adipisci qui at.",
    "description": "Tempora laboriosam sint magni sed voluptas similique.",
    "state": "closed",
    "created_at": "2016-06-17T07:47:39.486Z",
    "updated_at": "2016-07-01T11:09:13.998Z",
    "labels": [],
    "milestone": {
      "id": 26,
      "iid": 1,
      "project_id": 5,
      "title": "v0.0",
      "description": "Accusantium nostrum rerum quae quia quis nesciunt suscipit id.",
      "state": "closed",
      "created_at": "2016-06-17T07:47:33.832Z",
      "updated_at": "2016-06-17T07:47:33.832Z",
      "due_date": null
    },
    "assignees": [{
      "name": "Jarret O'Keefe",
      "username": "francisca",
      "id": 14,
      "state": "active",
      "avatar_url": "http://www.gravatar.com/avatar/a7fa515d53450023c83d62986d0658a8?s=80&d=identicon",
      "web_url": "https://gitlab.example.com/francisca"
    }],
    "assignee": {
      "name": "Jarret O'Keefe",
      "username": "francisca",
      "id": 14,
      "state": "active",
      "avatar_url": "http://www.gravatar.com/avatar/a7fa515d53450023c83d62986d0658a8?s=80&d=identicon",
      "web_url": "https://gitlab.example.com/francisca"
    },
    "type" : "ISSUE",
    "author": {
      "name": "Maxie Medhurst",
      "username": "craig_rutherford",
      "id": 12,
      "state": "active",
      "avatar_url": "http://www.gravatar.com/avatar/a0d477b3ea21970ce6ffcbb817b0b435?s=80&d=identicon",
      "web_url": "https://gitlab.example.com/craig_rutherford"
    },
    "subscribed": true,
    "user_notes_count": 7,
    "upvotes": 0,
    "downvotes": 0,
    "merge_requests_count": 0,
    "due_date": null,
    "web_url": "http://gitlab.example.com/my-group/my-project/issues/10",
    "references": {
      "short": "#10",
      "relative": "#10",
      "full": "my-group/my-project#10"
    },
    "confidential": false,
    "discussion_locked": false,
    "issue_type": "issue",
    "severity": "UNKNOWN",
    "task_completion_status":{
      "count":0,
      "completed_count":0
    }
  },
  "target_url": "https://gitlab.example.com/gitlab-org/gitlab-ci/issues/10",
  "body": "Vel voluptas atque dicta mollitia adipisci qui at.",
  "state": "pending",
  "created_at": "2016-07-01T11:09:13.992Z"
}

assignee 已经被弃用。我们已经转而使用 assignees 一维数组以维持不同版本 API 的一致性。

将议题升级为史诗

通过添加 /promote 快速操作评论将议题升级为史诗。

要了解将议题升级为史诗的更多信息，请访问管理史诗页面。

POST /projects/:id/issues/:issue_iid/notes

支持的属性：

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径。
`issue_iid`	integer	yes	项目议题的内部 ID。
`body`	String	yes	记录的内容。必须将 `/promote` 置于单独一行的开头。

请求示例：

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/11/notes?body=Lets%20promote%20this%20to%20an%20epic%0A%0A%2Fpromote"

响应示例：

{
   "id":699,
   "type":null,
   "body":"Lets promote this to an epic",
   "attachment":null,
   "author": {
      "id":1,
      "name":"Alexandra Bashirian",
      "username":"eileen.lowe",
      "state":"active",
      "avatar_url":"https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
      "web_url":"https://gitlab.example.com/eileen.lowe"
   },
   "created_at":"2020-12-03T12:27:17.844Z",
   "updated_at":"2020-12-03T12:27:17.844Z",
   "system":false,
   "noteable_id":461,
   "noteable_type":"Issue",
   "resolvable":false,
   "confidential":false,
   "noteable_iid":33,
   "commands_changes": {
      "promote_to_epic":true
   }
}

时间追踪

以下请求与议题的时间追踪相关。

为议题设置预计用时

为某个议题设置您预计需要在其所耗费的时间。

POST /projects/:id/issues/:issue_iid/time_estimate

参数	类型	是否必需	描述
`duration`	string	yes	预计用时，如 `3h30m`
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/93/time_estimate?duration=3h30m"

响应示例：

{
  "human_time_estimate": "3h 30m",
  "human_total_time_spent": null,
  "time_estimate": 12600,
  "total_time_spent": 0
}

为议题重置预计用时

将议题的预计用时重置为零。

POST /projects/:id/issues/:issue_iid/reset_time_estimate

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url  "https://gitlab.example.com/api/v4/projects/5/issues/93/reset_time_estimate"

响应示例：

{
  "human_time_estimate": null,
  "human_total_time_spent": null,
  "time_estimate": 0,
  "total_time_spent": 0
}

为议题添加已用时间

为议题添加您已经在其耗费的时间。

POST /projects/:id/issues/:issue_iid/add_spent_time

参数	类型	是否必需	描述
`duration`	string	yes	所耗费的时间，如 `3h30m`
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID
`summary`	string	no	简要描述这段时间是如何耗费的

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/93/add_spent_time?duration=1h"

响应示例：

{
  "human_time_estimate": null,
  "human_total_time_spent": "1h",
  "time_estimate": 0,
  "total_time_spent": 3600
}

为议题重置已用时间

将议题的已用时间重置为零。

POST /projects/:id/issues/:issue_iid/reset_spent_time

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/93/reset_spent_time"

响应示例：

{
  "human_time_estimate": null,
  "human_total_time_spent": null,
  "time_estimate": 0,
  "total_time_spent": 0
}

获取工时统计信息

如果这个项目是私有的或议题是私密的，请求者必须提供有效的鉴权信息。我们推荐您使用个人访问令牌进行鉴权。

GET /projects/:id/issues/:issue_iid/time_stats

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/issues/93/time_stats"

响应示例：

{
  "human_time_estimate": "2h",
  "human_total_time_spent": "1h",
  "time_estimate": 7200,
  "total_time_spent": 3600
}

合并请求

以下请求与议题和合并请求之间的关系相关。

列出议题关联的合并请求

获取所有与给定议题相关联的合并请求。

如果这个项目是私有的或议题是私密的，请求者必须提供有效的鉴权信息。我们推荐您使用个人访问令牌进行鉴权。

GET /projects/:id/issues/:issue_iid/related_merge_requests

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/11/related_merge_requests"

响应示例：

[
  {
    "id": 29,
    "iid": 11,
    "project_id": 1,
    "title": "Provident eius eos blanditiis consequatur neque odit.",
    "description": "Ut consequatur ipsa aspernatur quisquam voluptatum fugit. Qui harum corporis quo fuga ut incidunt veritatis. Autem necessitatibus et harum occaecati nihil ea.\r\n\r\ntwitter/flight#8",
    "state": "opened",
    "created_at": "2018-09-18T14:36:15.510Z",
    "updated_at": "2018-09-19T07:45:13.089Z",
    "closed_by": null,
    "closed_at": null,
    "target_branch": "v2.x",
    "source_branch": "so_long_jquery",
    "user_notes_count": 9,
    "upvotes": 0,
    "downvotes": 0,
    "author": {
      "id": 14,
      "name": "Verna Hills",
      "username": "lawanda_reinger",
      "state": "active",
      "avatar_url": "https://www.gravatar.com/avatar/de68a91aeab1cff563795fb98a0c2cc0?s=80&d=identicon",
      "web_url": "https://gitlab.example.com/lawanda_reinger"
    },
    "assignee": {
      "id": 19,
      "name": "Jody Baumbach",
      "username": "felipa.kuvalis",
      "state": "active",
      "avatar_url": "https://www.gravatar.com/avatar/6541fc75fc4e87e203529bd275fafd07?s=80&d=identicon",
      "web_url": "https://gitlab.example.com/felipa.kuvalis"
    },
    "source_project_id": 1,
    "target_project_id": 1,
    "labels": [],
    "draft": false,
    "work_in_progress": false,
    "milestone": {
      "id": 27,
      "iid": 2,
      "project_id": 1,
      "title": "v1.0",
      "description": "Et tenetur voluptatem minima doloribus vero dignissimos vitae.",
      "state": "active",
      "created_at": "2018-09-18T14:35:44.353Z",
      "updated_at": "2018-09-18T14:35:44.353Z",
      "due_date": null,
      "start_date": null,
      "web_url": "https://gitlab.example.com/twitter/flight/milestones/2"
    },
    "merge_when_pipeline_succeeds": false,
    "merge_status": "cannot_be_merged",
    "sha": "3b7b528e9353295c1c125dad281ac5b5deae5f12",
    "merge_commit_sha": null,
    "squash_commit_sha": null,
    "discussion_locked": null,
    "should_remove_source_branch": null,
    "force_remove_source_branch": false,
    "reference": "!11",
    "web_url": "https://gitlab.example.com/twitter/flight/merge_requests/4",
    "references": {
      "short": "!4",
      "relative": "!4",
      "full": "twitter/flight!4"
    },
    "time_stats": {
      "time_estimate": 0,
      "total_time_spent": 0,
      "human_time_estimate": null,
      "human_total_time_spent": null
    },
    "squash": false,
    "task_completion_status": {
      "count": 0,
      "completed_count": 0
    },
    "changes_count": "10",
    "latest_build_started_at": "2018-12-05T01:16:41.723Z",
    "latest_build_finished_at": "2018-12-05T02:35:54.046Z",
    "first_deployed_to_production_at": null,
    "pipeline": {
      "id": 38980952,
      "sha": "81c6a84c7aebd45a1ac2c654aa87f11e32338e0a",
      "ref": "test-branch",
      "status": "success",
      "web_url": "https://gitlab.com/gitlab-org/gitlab/pipelines/38980952"
    },
    "head_pipeline": {
      "id": 38980952,
      "sha": "81c6a84c7aebd45a1ac2c654aa87f11e32338e0a",
      "ref": "test-branch",
      "status": "success",
      "web_url": "https://gitlab.example.com/twitter/flight/pipelines/38980952",
      "before_sha": "3c738a37eb23cf4c0ed0d45d6ddde8aad4a8da51",
      "tag": false,
      "yaml_errors": null,
      "user": {
        "id": 19,
        "name": "Jody Baumbach",
        "username": "felipa.kuvalis",
        "state": "active",
        "avatar_url": "https://www.gravatar.com/avatar/6541fc75fc4e87e203529bd275fafd07?s=80&d=identicon",
        "web_url": "https://gitlab.example.com/felipa.kuvalis"
      },
      "created_at": "2018-12-05T01:16:13.342Z",
      "updated_at": "2018-12-05T02:35:54.086Z",
      "started_at": "2018-12-05T01:16:41.723Z",
      "finished_at": "2018-12-05T02:35:54.046Z",
      "committed_at": null,
      "duration": 4436,
      "coverage": "46.68",
      "detailed_status": {
        "icon": "status_warning",
        "text": "passed",
        "label": "passed with warnings",
        "group": "success-with-warnings",
        "tooltip": "passed",
        "has_details": true,
        "details_path": "/twitter/flight/pipelines/38",
        "illustration": null,
        "favicon": "https://gitlab.example.com/assets/ci_favicons/favicon_status_success-8451333011eee8ce9f2ab25dc487fe24a8758c694827a582f17f42b0a90446a2.png"
      }
    },
    "diff_refs": {
      "base_sha": "d052d768f0126e8cddf80afd8b1eb07f406a3fcb",
      "head_sha": "81c6a84c7aebd45a1ac2c654aa87f11e32338e0a",
      "start_sha": "d052d768f0126e8cddf80afd8b1eb07f406a3fcb"
    },
    "merge_error": null,
    "user": {
      "can_merge": true
    }
  }
]

列出合并时关闭议题的合并请求

列出所有在合并的时候能关闭指定议题的合并请求。

如果这个项目是私有的或议题是私密的，请求者必须提供有效的鉴权信息。我们推荐您使用个人访问令牌进行鉴权。

GET /projects/:id/issues/:issue_iid/closed_by

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/11/closed_by"

响应示例：

[
  {
    "id": 6471,
    "iid": 6432,
    "project_id": 1,
    "title": "add a test for cgi lexer options",
    "description": "closes #11",
    "state": "opened",
    "created_at": "2017-04-06T18:33:34.168Z",
    "updated_at": "2017-04-09T20:10:24.983Z",
    "target_branch": "master",
    "source_branch": "feature.custom-highlighting",
    "upvotes": 0,
    "downvotes": 0,
    "author": {
      "name": "Administrator",
      "username": "root",
      "id": 1,
      "state": "active",
      "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
      "web_url": "https://gitlab.example.com/root"
    },
    "assignee": null,
    "source_project_id": 1,
    "target_project_id": 1,
    "closed_at": null,
    "closed_by": null,
    "labels": [],
    "draft": false,
    "work_in_progress": false,
    "milestone": null,
    "merge_when_pipeline_succeeds": false,
    "merge_status": "unchecked",
    "sha": "5a62481d563af92b8e32d735f2fa63b94e806835",
    "merge_commit_sha": null,
    "squash_commit_sha": null,
    "user_notes_count": 1,
    "should_remove_source_branch": null,
    "force_remove_source_branch": false,
    "web_url": "https://gitlab.example.com/gitlab-org/gitlab-test/merge_requests/6432",
    "reference": "!6432",
    "references": {
      "short": "!6432",
      "relative": "!6432",
      "full": "gitlab-org/gitlab-test!6432"
    },
    "time_stats": {
      "time_estimate": 0,
      "total_time_spent": 0,
      "human_time_estimate": null,
      "human_total_time_spent": null
    }
  }
]

议题参与人

如果这个项目是私有的或议题是私密的，请求者必须提供有效的鉴权信息。我们推荐您使用个人访问令牌进行鉴权。

GET /projects/:id/issues/:issue_iid/participants

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/93/participants"

响应示例：

[
  {
    "id": 1,
    "name": "John Doe1",
    "username": "user1",
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/c922747a93b40d1ea88262bf1aebee62?s=80&d=identicon",
    "web_url": "http://gitlab.example.com/user1"
  },
  {
    "id": 5,
    "name": "John Doe5",
    "username": "user5",
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/4aea8cf834ed91844a2da4ff7ae6b491?s=80&d=identicon",
    "web_url": "http://gitlab.example.com/user5"
  }
]

议题评论

评论相关操作由备注相关接口实现。

获取用户代理信息

仅适用于管理员。

GET /projects/:id/issues/:issue_iid/user_agent_detail

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/93/user_agent_detail"

响应示例：

{
  "user_agent": "AppleWebKit/537.36",
  "ip_address": "127.0.0.1",
  "akismet_submitted": false
}

列出议题状态事件

要追踪议题当前状态、由谁设置、发生时间，可移步资源状态事件 API。

事故

以下请求仅对于事故可用。

上传指标图像

仅适用于事件议题。

上传度量图表的截图以显示在事件的度量标签页中。当您上传图片时，您可以将图片和文本或链接关联到事件详情中。如果您添加了一个 URL，您可以通过选择图片上方的超链接来访问原始图表。

POST /projects/:id/issues/:issue_iid/metric_images

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID
`file`	file	yes	需要上传的图像文件
`url`	string	no	事件详情的链接
`url_text`	string	no	图像或链接的描述

curl --header "PRIVATE-TOKEN: <your_access_token>" \ 
  --form 'file=@/path/to/file.png' \ 
  --form 'url=http://example.com'   \ 
  --form 'url_text=Example website' "https://gitlab.example.com/api/v4/projects/5/issues/93/metric_images"

响应示例：

{
    "id": 23,
    "created_at": "2020-11-13T00:06:18.084Z",
    "filename": "file.png",
    "file_path": "/uploads/-/system/issuable_metric_image/file/23/file.png",
    "url": "http://example.com",
    "url_text": "Example website"
}

列出指标图像

仅适用于事件议题。

列出显示在事件的度量标签页中的度量图表的截图。

GET /projects/:id/issues/:issue_iid/metric_images

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/issues/93/metric_images"

响应示例：

[
    {
        "id": 17,
        "created_at": "2020-11-12T20:07:58.156Z",
        "filename": "sample_2054",
        "file_path": "/uploads/-/system/issuable_metric_image/file/17/sample_2054.png",
        "url": "example.com/metric"
    },
    {
        "id": 18,
        "created_at": "2020-11-12T20:14:26.441Z",
        "filename": "sample_2054",
        "file_path": "/uploads/-/system/issuable_metric_image/file/18/sample_2054.png",
        "url": "example.com/metric"
    }
]

更新指标图像

仅适用于事件议题。

编辑显示在事件度量标签页中的度量图表截图的属性。

PUT /projects/:id/issues/:issue_iid/metric_images/:image_id

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID
`image_id`	integer	yes	图像 ID
`url`	string	no	事件详情的链接
`url_text`	string	no	图像或链接的描述

curl --header "PRIVATE-TOKEN: <your_access_token>" --request PUT  --form 'url=http://example.com' --form 'url_text=Example website' "https://gitlab.example.com/api/v4/projects/5/issues/93/metric_images/1"

响应示例：

{
    "id": 23,
    "created_at": "2020-11-13T00:06:18.084Z",
    "filename": "file.png",
    "file_path": "/uploads/-/system/issuable_metric_image/file/23/file.png",
    "url": "http://example.com",
    "url_text": "Example website"
}

删除指标图像

仅适用于事件议题。

删除显示在事件度量标签页中的度量图表的截图。

DELETE /projects/:id/issues/:issue_iid/metric_images/:image_id

参数	类型	是否必需	描述
`id`	integer/string	yes	经过身份验证的用户拥有的全局 ID 或经过 URL 编码处理的路径
`issue_iid`	integer	yes	项目议题的内部 ID
`image_id`	integer	yes	图像 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" --request DELETE "https://gitlab.example.com/api/v4/projects/5/issues/93/metric_images/1"

可能返回的状态码包括：

204 No Content 表示图像删除成功。
400 Bad Request 表示图像无法被删除。