Docs — API & template system

Public share API

Lists live on lists.containd.app. Anonymous browse/search and authenticated owner tools share the /v1 HTTP surface (Firebase Auth bearer for owner routes).

• GET /v1/publicSearch — featured / recent / text search (Typesense when configured).
• GET /v1/publicShare/{slugOrToken} — share meta; static HTML at /s/{slug}/.
• GET /v1/publicProfile/{alias} · /shares — public author profile + portfolio.
• GET|PUT /v1/userCollections · POST …/addShare — private-by-default lists of lists.
• POST|DELETE|GET /v1/shareHeart · GET /v1/catalogHeartCounts · POST|DELETE /v1/catalogFavorite — count-only hearts.
• POST /v1/publicShare/publish · wipe / context — owner publish (kill-switch aware).

Authorization: Bearer <Firebase ID token>
Accept: application/json

Freeze packages are versioned JSON + media; SEO HTML is materialized at publish. Card thumbs use media id card.

Template system

Templates are Containd V2 documents (JSON + media). Authors edit in the template editor; the catalog hosts Official packages for install.

• V2 runtime — items, layouts, Arrange / Style actions, paint descriptors shared with the app and lists viewer.
• Classes — reusable item/class ids cross-linked from catalog detail pages.
• Locales — availableLocales derived from LocalizedText / translation tables inside the template.
• Install — containd://InstallTemplate?url=… or in-app Discover from a catalog package URL.
• Editor — templates.containd.app (opens in a new tab).

Install & packages

• Template packages are V2 JSON (+ media). Install via containd://InstallTemplate?url=… or in-app Discover.
• Example collections are Containd list-export ZIP files. Manual download or containd://ImportList?url=….
• Hosts: catalog.containd.app (catalog) · lists.containd.app (shares) · editor templates.containd.app · app www.containd.app.

Example collections

No example collections published yet. Admins upload a collection ZIP separately and attach the URL on review.

Sample project downloads (developers)

No sample projects published yet. Admins can attach a workspace/project JSON URL per entry.

Classes

Template classes are cross-linked from each detail page. Class pages list every Official public template that defines or uses that class.

Back to templates