设置需求所属里程碑

PUT /api/v1/schedule/requirements/{requirementId}/milestone · assignRequirementMilestone

原子替换需求的里程碑归属。需要 manage_schedule。milestoneId 非空时，先移除该需求的全部旧关联，再只关联指定里程碑；milestoneId 为空串时仅移除全部旧关联。需求与目标里程碑都必须属于当前项目。写命令在同一 TenantTx 内产 ChangeSet + requirement.milestone_updated Event。

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

参数

requirementId（必填）: string

请求体

milestoneId（必填）: string —— 目标里程碑 UUID；空串表示移出全部里程碑。
reason（必填）: string —— 本次归属变化原因；去除首尾空白后不得为空。

响应 · 204

里程碑归属已更新

错误

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

请求示例（curl）

curl -X PUT "https://你的项目.workflow.games/api/v1/schedule/requirements/{requirementId}/milestone" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"milestoneId":"018f3c2e-0000-7000-8000-000000000000","reason":"操作原因(会记入变更流)"}'

响应示例

HTTP/1.1 204
{}

合同真值：OpenAPI 3.1（0.1.0）。

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