Library API: Templates, Submissions and Ideas
Read and submit FoxCue Library templates with library:read and library:write: search listed templates, submit a style, and track draft, checked, listed and parked.
The Library API covers shared templates and the review that happens before a template is listed. These routes are in the live OpenAPI schema. A template another workspace listed is addressed as shared:<slug>@<revision>.
Listing is not instant. A submission moves through draft, checked, listed and parked. Automatic checks can return issues and warnings. Admin → Library review is where a reviewer parks or lists a submission. That review may not be available on every workspace.
Scopes
| Scope | Allows |
|---|---|
library:read | Search listed templates, read a submission, list reference ideas |
library:write | Submit a template, log or update a reference idea |
Templates and submissions
| Method | Path | What it does |
|---|---|---|
GET | /library/templates | Search listed templates (q, category). mine=true lists every template this workspace submitted |
GET | /library/templates/{id} | Read a listed template, or one this workspace submitted, with its checks and revisions |
POST | /library/submissions | Submit a Style folder (a file map), credits and review material |
GET | /library/submissions/{id} | Read status, check issues and warnings |
GET | /library/ideas | List reference ideas this workspace logged |
POST | /library/ideas | Log a reference idea (source URL, creator, why, breakdown) before building |
PATCH | /library/ideas/{id} | Mark an idea building or dismissed |
There is also a public template feed at GET /api/public/library/templates. It is outside /api/v1 and does not use a workspace key.
See Edit and upload library packages for the same flow in the app, and the operations reference for the full table.