# CMS modules

CMS v2 modules published by an app

## List an app's CMS modules

 - [GET /api/v2/apps/{appUuid}/cms-modules](https://developer.caraer.com/apis/cms-modules/list.md): Includes retired modules, so a developer can see what a push removed.

## Replace an app's CMS module catalog

 - [PUT /api/v2/apps/{appUuid}/cms-modules](https://developer.caraer.com/apis/cms-modules/upsert.md): Registers the modules shipped by a published package version. Modules missing from the payload are retired rather than deleted, because pages may still reference them.

## Publish an app's CMS module package

 - [POST /api/v2/apps/{appUuid}/cms-modules/package](https://developer.caraer.com/apis/cms-modules/publishpackage.md): Accepts a staged npm tarball (base64) and module manifests. Publishes to the platform registry with the host token, then replaces the catalog.