文档

资料库分组

这些是需要 Bearer Token 的公开接口契约,数据仍只返回当前用户自己的分组。公开契约不等于公开数据。Token 代表该用户身份,没有更细的分组 scope;服务端按 user_id 做归属校验。

方法路径说明
GET/api/library/folders?tree=1列出自己的全部分组树
GET/api/library/folders列出根级,或用 parent_id 列子分组
POST/api/library/folders创建分组,默认私有(share_enabled=false)
PATCH/api/library/folders/:id重命名、移动(parent_id)、开关分享
DELETE/api/library/folders/:id删除分组:子分组级联删除,提示词/技能取消归类

创建分组

bash
curl -X POST https://prompt.solokit.run/api/library/folders \
  -H "Authorization: Bearer ph_your_token" \
  -H "Content-Type: application/json" \
  -d '{"name":"我的分组","parent_id":null}'

name 必填,最长 200 字符。parent_id 必须是自己的分组,否则 400「父文件夹不存在」。不能把分组移动到自身或其子分组下,层级最多 20 层。非本人分组的 PATCH/DELETE 返回 404「未找到或无权限」。

把提示词放入分组

创建或更新提示词时传入 library_folder_id。POST /api/prompts 与 POST /api/prompts/sync 都支持。更新时若省略该字段,会保持原分组。无效或不属于你的 ID 返回 400「library_folder_id 无效」。可加 on_duplicate_content=skip,按正文精确匹配跳过重复且不覆盖已存记录;默认 create,兼容旧客户端。

NOTE

免费版提示词数量上限仍适用。导入大批量前请确认套餐额度。