Documentation

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.

MethodPathDescription
GET/api/library/folders?tree=1List your full folder tree
GET/api/library/foldersList root folders, or children of parent_id
POST/api/library/foldersCreate a folder; private by default (share_enabled=false)
PATCH/api/library/folders/:idRename, move (parent_id), or toggle sharing
DELETE/api/library/folders/:idDelete a folder: children cascade; prompts/skills become unfiled

Create a folder

bash
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.

Library Folders — PromptMan Docs