列出工作项可用转移

GET /api/v1/work-items/{workItemId}/transitions · listWorkItemTransitions

返回当前工作项从激活状态出发的全部出边，并逐边标注是否可执行（allowed）及阻塞原因（blockedReason）。调用方可据此渲染「流转到」下拉选项，屏蔽不可用选项并展示原因。鉴权模块按目标条目自身的 type 判定：缺陷（type=bug）走 bugs 模块、其余走 subtasks，均要求 >= edit（缺陷即 type=bug 的工作项，没有独立端点）。

鉴权：项目 API Token（Authorization: Bearer wfp_…）。详见 Agent 接入。

参数

workItemId（必填）: string

响应字段 · 200

transitions（必填）: WorkItemTransition[]
transitions[].toStateKey（必填）: string
transitions[].name（必填）: string
transitions[].allowed（必填）: boolean
transitions[].blockedReason: string
transitions[].guardCode: enum；取值：permission / missing_field / separation_of_duties / slot_empty / not_slot_member / not_visited / unknown
transitions[].requireReason: boolean
transitions[].href（必填）: string
transitions[].method（必填）: string

错误

403：Problem 错误响应
404：Problem 错误响应

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/work-items/{workItemId}/transitions" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "transitions": [
    {
      "toStateKey": "示例文本",
      "name": "示例标题",
      "allowed": true,
      "href": "示例文本",
      "method": "示例文本"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引