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

ScopeAllows
library:readSearch listed templates, read a submission, list reference ideas
library:writeSubmit a template, log or update a reference idea

Templates and submissions

MethodPathWhat it does
GET/library/templatesSearch 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/submissionsSubmit a Style folder (a file map), credits and review material
GET/library/submissions/{id}Read status, check issues and warnings
GET/library/ideasList reference ideas this workspace logged
POST/library/ideasLog 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.

On this page