Skip to main content
A production app is the deployed instance of an entity. It represents the running application with a subdomain, database, and deployment history.

List production apps

Authentication: User authentication required.

Create production app

Creates the production app record and assigns a cloud identifier for deployment infrastructure. Authentication: Organization member + entities:deploy scope + entity publisher.

Get production app

Returns production app details including recent deployments. Authentication: User authentication required.

Update production app

appUrl and apiUrl must be absolute http(s) URLs with no query string or fragment. Values are normalized (trailing slash stripped, path preserved); an invalid value returns 400. Authentication: Organization member + entities:deploy scope + entity publisher.

Vanity URLs

Production app responses carry four URL fields: Vanity URLs are baked in at deploy time, so the deployed_* fields update only when a deployment completes. A configured value that differs from its deployed counterpart means a redeploy is required. Setup (proxying your domain, CORS, and OAuth callbacks) is covered in Vanity URLs.

Delete production app

Deletes the production app and tears down all associated cloud resources (compute, CDN, database connections). Authentication: Organization member + entities:deploy scope + entity publisher.

Subdomain availability

Returns whether the subdomain is available and the normalized form. Authentication: User authentication required.