文档 API v2patchModerationFolder

patchModerationFolder

处置收藏夹的文本

改写或清空任意用户收藏夹的名称与简介，或强制设为私密。不动收藏夹里的条目。需要持有人具备 catalog.folder.moderate 权限的用户访问令牌：moderator、admin、ren 角色默认具备，权限控制台可以授予其他角色。审核目录编辑或投稿认领的权限不包含它。

patch/v2/moderation/folders/{id}

Authorization: Bearer <用户访问令牌>（用户授权后的访问令牌,不是 API 密钥）

参数

参数	类型	位置	说明
`id` 必填	`string`	`path`	收藏夹 id。

请求体

application/json

descriptionstring
新的备注；传空字符串即清除。不得用作判别条件。
namestring
新的显示名称。不要用它做判别依据。空字符串只在这里被接受：审核要清掉的违规内容往往就是这个名字，而重新起名是夹主自己的事。
visibilitystring
设为 private 会把这个收藏夹从 /v2/folders 上撤下来，但什么也不删除。
枚举privatepublic

响应

created_atstringdate-time 必填
RFC 3339 UTC。
descriptionstring 必填
拥有者自己的备注。没有则为空字符串。不得用作判别条件。
idstring 必填
收藏夹 id。
is_defaultboolean 必填
每个用户至多一个收藏夹带此标记。把它设到某个收藏夹上会清除原持有者的标记。
item_countintegerint64 必填
该收藏夹内的作品数量。
namestring 必填
展示名。不得用作判别条件。
objectstring 必填
类型判别字段。恒为 folder。
枚举folder
owner_uidstring 必填
拥有这个收藏夹的账号。这是 NextMoe 各站共用的中央登录用户 id，不是某个站自己的用户 id。
updated_atstringdate-time 必填
RFC 3339 UTC。
visibilitystring 必填
public 的收藏夹任何人都可以通过 /v2/folders 读到；private 的只有夹主自己能看见，走 /v2/me/folders。
枚举privatepublic

请求示例

cURL

curl -X PATCH "https://api.nextmoe.dev/v2/moderation/folders/1" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"description":"string","name":"string","visibility":"private"}'