API 参考 / project-versions

删除项目版本

DELETE /api/v1/projects/{projectId}/versions/{versionId} · deleteProjectVersion

需要 manage_project_settings。硬删除该 ReleaseWindow 并产 ChangeSet/Event。

为什么补这个命令（B-00310）：版本建完之后既改不了名字也删不掉——合同只有 PUT、前端连 PUT 都没接线，而版本是需求「目标版本」下拉的服务端真值来源，一条名字打错或日期填错的版本会长期污染下拉。产品面必须有一条把它清掉的路径。

当前版本不可删：先用 setCurrentProjectVersion 把「当前」挪到别的版本，否则 409。这道保护是为了不让项目落进「没有当前版本」的中间态。被里程碑引用的版本仍可删（里程碑的 releaseWindowId 会置空），不做级联删除。

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

参数

版本已删除

curl -X DELETE "https://你的项目.workflow.games/api/v1/projects/{projectId}/versions/{versionId}" \
  -H "Authorization: Bearer wfp_…"

HTTP/1.1 204
{}