Skip to content
Cloudy docs

Apps API

Apps built from live spaces: previews, going live, rollbacks and export.

All paths are relative to the API origin. Send Authorization: Bearer <token> unless a route says otherwise; see the API overview for tokens and errors.

GET /v1/apps

Apps in live spaces you can view

Request: listAppsQuery

Response: listAppsOutput

GET /v1/apps/:id

View on the live space

Response: appSchema

PATCH /v1/apps/:id

Manage (name, access, join code)

Request: updateAppInput

Response: appSchema

DELETE /v1/apps/:id

Manage

Response: 204, no body

POST /v1/apps/:id/live

Manage; first go-live, plan live-app limit

Request: goLiveInput

Response: appSchema

POST /v1/apps/:id/promote

Manage; live = latest preview version

Response: appSchema

POST /v1/apps/:id/rollback

Manage

Request: rollbackInput

Response: appSchema

GET /v1/apps/:id/deploys

View

Response: appDeploysOutput

GET /v1/apps/:id/users

Manage; the app's end users

Response: appUsersOutput

POST /v1/apps/:id/owner-link

Edit; signed 10-minute admin link into the live app

Response: ownerLinkOutput

GET /v1/apps/:id/export

Manage; a standalone project you can host yourself

Response: application/zip