应用延期传播

POST /api/v1/schedule/propagation/apply · applySchedulePropagation

根据上游工作项的新排期计算并写入所有受影响下游任务；失败时不产生部分更新。计算与 POST /schedule/propagation/preview 同一段代码，落库条目集合与预览返回的 affectedItems 逐条一致（R-00029）。

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

请求体

workItemId（必填）: string
startOn: string
dueOn: string
reason: string

响应字段 · 200

affectedItems（必填）: PropagationAffectedItem[]
affectedItems[].workItemId（必填）: string
affectedItems[].beforeStartOn（必填）: string
affectedItems[].beforeDueOn（必填）: string
affectedItems[].afterStartOn（必填）: string
affectedItems[].afterDueOn（必填）: string
affectedItems[].shiftedDays（必填）: integer
criticalPathChanged（必填）: boolean
projectedEndOn（必填）: string
milestoneRisks（必填）: ScheduleRisk[]
milestoneRisks[].id（必填）: string
milestoneRisks[].kind（必填）: enum；取值：dependency / dependency_violation / milestone / freeze / workload
milestoneRisks[].severity（必填）: enum；取值：low / medium / high
milestoneRisks[].message（必填）: string
milestoneRisks[].entityType（必填）: enum；取值：requirement / work_item / milestone / release_window
milestoneRisks[].entityId（必填）: string
freezeRisks（必填）: ScheduleRisk[]
freezeRisks[].id（必填）: string
freezeRisks[].kind（必填）: enum；取值：dependency / dependency_violation / milestone / freeze / workload
freezeRisks[].severity（必填）: enum；取值：low / medium / high
freezeRisks[].message（必填）: string
freezeRisks[].entityType（必填）: enum；取值：requirement / work_item / milestone / release_window
freezeRisks[].entityId（必填）: string

错误

403：Problem 错误响应
409：Problem 错误响应
422：Problem 错误响应

请求示例（curl）

curl -X POST "https://你的项目.workflow.games/api/v1/schedule/propagation/apply" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"workItemId":"018f3c2e-0000-7000-8000-000000000000","startOn":"2026-08-01","dueOn":"2026-08-01"}'

响应示例

HTTP/1.1 200
{
  "affectedItems": [
    {
      "workItemId": "018f3c2e-0000-7000-8000-000000000000",
      "beforeStartOn": "2026-08-01",
      "beforeDueOn": "2026-08-01",
      "afterStartOn": "2026-08-01",
      "afterDueOn": "2026-08-01",
      "shiftedDays": 1
    }
  ],
  "criticalPathChanged": true,
  "projectedEndOn": "2026-08-01",
  "milestoneRisks": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "kind": "dependency",
      "severity": "low",
      "message": "示例文本",
      "entityType": "requirement",
      "entityId": "018f3c2e-0000-7000-8000-000000000000"
    }
  ],
  "freezeRisks": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "kind": "dependency",
      "severity": "low",
      "message": "示例文本",
      "entityType": "requirement",
      "entityId": "018f3c2e-0000-7000-8000-000000000000"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

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