API 参考 / acceptance

修改验收类型

PUT /api/v1/projects/{projectId}/acceptance/types/{typeId} · updateAcceptanceType

需要 manage_acceptance_config。保护：不能停用最后一个验收类型。写审计。

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

参数

projectId（必填）: string
typeId（必填）: string

请求体

name（必填）: string
description: string
status: enum；取值：active / disabled

响应字段 · 200

id（必填）: string
name（必填）: string
description: string
status（必填）: enum；取值：active / disabled
statuses（必填）: AcceptanceStatus[]
statuses[].id（必填）: string
statuses[].name（必填）: string
statuses[].color: string
statuses[].sortOrder: integer
statuses[].systemSemantic（必填）: enum；取值：not_started / in_progress / blocked / needs_changes / passed / failed / closed
statuses[].status（必填）: enum；取值：active / disabled

错误

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

请求示例（curl）

curl -X PUT "https://你的项目.workflow.games/api/v1/projects/{projectId}/acceptance/types/{typeId}" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"name":"示例标题","description":"一段描述文字","status":"active"}'

响应示例

HTTP/1.1 200
{
  "id": "018f3c2e-0000-7000-8000-000000000000",
  "name": "示例标题",
  "status": "active",
  "statuses": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "name": "示例标题",
      "systemSemantic": "not_started",
      "status": "active"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

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