文档 API v2patchMyFolder

patchMyFolder

更新收藏夹

部分更新：name、description、visibility、is_default。需要带 folder:write 的用户访问令牌。

patch/v2/me/folders/{id}

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

参数

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

请求体

application/json

descriptionstring
新的备注；传空字符串即清除。不得用作判别条件。
is_defaultboolean
只接受 true：它把默认标记移到该收藏夹上。传 false 是 422——改为把标记设到另一个收藏夹上。
namestring
新的展示名。不得用作判别条件。
visibilitystring
新的可见性。
枚举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/me/folders/1" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"description":"全路线通关的作品","is_default":true,"name":"已通关","visibility":"public"}'