Skip to main content
POST
更新产物

限制说明

使用说明

  • 仅更新传入的字段 —— 不传 titleteam_id 则对应字段保持不变。
  • team_id: 0 表示转为个人产物(仅创建者可管理);传入大于 0 的 team_id 时,调用者(app_key 调用时为 key 所属成员)必须是该团队成员。
  • 返回更新后的完整产物。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

请求体

application/json

产物的部分字段更新。仅更新传入的字段。

artifact_id
string
必填

产物 ID(art_ 前缀)。同时也是公开分享链接的标识。

title
string | null

新标题。会去除首尾空白,传入时不能为空。不传则不变。

team_id
integer<int64> | null

转移目标空间。0 表示转为个人产物(仅创建者可管理);大于 0 表示转移到调用者所属的团队。不传则不变。

响应

Success

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
object

产物库中的一个已发布产物。时间字段均为 Unix 毫秒时间戳。