Skip to main content

Collections

Collections are curated lists of appgrammars. Use them to organize related appgrammars, create learning paths, or share themed sets with others.

Creating a Collection​

POST /api/collections
{
  "name": "Full-Stack Starters",
  "description": "Production-ready starter kits with auth, database, and deployment"
}

A URL-friendly slug is auto-generated from the name (e.g., full-stack-starters). The collection is public by default.

In the web UI, go to Collections in the sidebar to create and manage your collections.

Managing Items​

Adding an Appgrammar​

POST /api/collections/:id/items
{
  "appgrammarId": "uuid-of-appgrammar"
}

In the web UI, use the Add to Collection dropdown on any appgrammar's detail page.

Removing an Appgrammar​

DELETE /api/collections/:id/items/:appgrammarId

Browsing Collections​

Your Collections​

GET /api/collections/mine

Returns your collections with their items included.

Public Collections​

GET /api/collections?limit=20&offset=0

Browse all public collections with pagination.

Collection Detail​

GET /api/collections/:slug

Returns the collection with its full item list. Accessible by slug for clean URLs.

Deleting a Collection​

DELETE /api/collections/:id

Only the collection owner can delete it. Deleting a collection does not affect the appgrammars in it.