文档
资料库分组
这些是需要 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
免费版提示词数量上限仍适用。导入大批量前请确认套餐额度。
本页目录