API 参考 / requirement-rooms

批量收纳对象

POST /api/v1/rooms/{roomId}/objects · attachRoomObjects

把多个既有需求 / 缺陷（工作项）收纳进该室（设置其 roomId）——供创建面板「收纳已有对象多选」。 引用不存在的对象返 422；已属其它室的对象直接改归属到本室。需 manage_requirements。

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

参数

roomId（必填）
string

请求体

objects（必填）
RoomObjectRef[]
objects[].objectType（必填）
enum；取值：requirement / work_item
objects[].objectId（必填）
string

响应字段 · 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

错误

请求示例（curl）

curl -X POST "https://你的项目.workflow.games/api/v1/rooms/{roomId}/objects" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"objects":[{"objectType":"requirement","objectId":"018f3c2e-0000-7000-8000-000000000000"}]}'

响应示例

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 参考索引

Workflow 正在加载…