Library Folders
These are documented, authenticated API contracts. They still return only the current token owner's folders — a public contract is not public data. The API token acts as that user and has no finer folder scope; the server enforces user_id ownership.
| Method | Path | Description |
|---|---|---|
| GET | /api/library/folders?tree=1 | List your full folder tree |
| GET | /api/library/folders | List root folders, or children of parent_id |
| POST | /api/library/folders | Create a folder; private by default (share_enabled=false) |
| PATCH | /api/library/folders/:id | Rename, move (parent_id), or toggle sharing |
| DELETE | /api/library/folders/:id | Delete a folder: children cascade; prompts/skills become unfiled |
Create a folder
curl -X POST https://prompt.solokit.run/api/library/folders \
-H "Authorization: Bearer ph_your_token" \
-H "Content-Type: application/json" \
-d '{"name":"My folder","parent_id":null}'name is required (max 200 characters). parent_id must belong to you, otherwise the API returns 400. You cannot move a folder under itself or a descendant. Depth is capped at 20. PATCH/DELETE on someone else's folder returns 404.
File a prompt into a folder
Pass library_folder_id on POST /api/prompts, PATCH /api/prompts/:id, or POST /api/prompts/sync. Omitting it on update keeps the current folder. Invalid or foreign IDs return 400. on_duplicate_content=skip leaves an existing exact content match untouched; the default is create, so older clients keep their previous behavior.
NOTE
The free-plan prompt cap still applies. Check the account quota before a large import.
Continue Reading