API 参考 / requirement-rooms

更新需求室

PATCH /api/v1/rooms/{roomId} · updateRoom

更新名称 / 描述 / 模块 / 状态（active|archived）。需 manage_requirements。

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

参数

roomId（必填）: string

请求体

name: string
description: string
module: string
status: enum；取值：active / archived

响应字段 · 200

id（必填）: string
displayKey（必填）: string
name（必填）: string
description: string
module（必填）: string
status（必填）: enum；取值：active / archived
requirementCount（必填）: integer
requirementOpenCount（必填）: integer
bugCount（必填）: integer
bugOpenCount（必填）: integer
atRiskCount（必填）: integer
feishuChat: RoomFeishuChat
feishuChat.status（必填）: enum；取值：creating / active / failed
feishuChat.source（必填）: enum；取值：created / bound
feishuChat.chatId（必填）: string
feishuChat.chatName（必填）: string
feishuChat.error（必填）: string
feishuChat.invitedCount: integer
feishuChat.skippedUnboundCount: integer
feishuChat.updatedAt（必填）: string
createdAt（必填）: string
updatedAt（必填）: string

错误

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

请求示例（curl）

curl -X PATCH "https://你的项目.workflow.games/api/v1/rooms/{roomId}" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"name":"示例标题","description":"一段描述文字","module":"示例文本"}'

响应示例

HTTP/1.1 200
{
  "id": "018f3c2e-0000-7000-8000-000000000000",
  "displayKey": "示例文本",
  "name": "示例标题",
  "module": "示例文本",
  "status": "active",
  "requirementCount": 1,
  "requirementOpenCount": 1,
  "bugCount": 1,
  "bugOpenCount": 1,
  "atRiskCount": 1,
  "createdAt": "示例文本",
  "updatedAt": "2026-08-01"
}

合同真值：OpenAPI 3.1（0.1.0）。

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