Skip to main content

Hosted apps

Hosted apps are Easy Mode's sponsored web apps: each one is a project with a repo in Jaah's GitHub organization that deploys on every push to main, served at its own address. These endpoints preview an app's address, create an app, read its state, last deploy and usage, retry a setup that failed, read the organization's Easy Mode sponsorship, and list, connect, check, remove and make main an app's custom domains.

๐Ÿ“„๏ธCreate a hosted app

Creates an Easy Mode app from the Jaah web template: its project, a private repo in Jaah's GitHub organization and, in the background, its hosting. Returns 201 with the project id and the app in `provisioning`; the app turns `live`, or `failed` with the step and the reason. `template` may be left out or `web`, and any other value returns 422; returns 409 when the organization already has its plan's number of apps or the app's address was just taken (try again), and 503 when app hosting is not set up.

๐Ÿ“„๏ธConnect a custom domain

Connects a custom domain to the app; with `with_twin` also its root or www twin, and `main` picks which of the two becomes the main address once live. Returns 201 with the app's domains, each waiting for DNS. Requires the Org Owner or Org Admin role and Custom domains on the plan (else 403); returns 422 with the reason for a name that is not a valid hostname, a wildcard, one of Jaah's domains, already connected to another app, over the plan's domains per app, or an app that is not live, and 503 while custom domains are not available.