update_app
Update an app's settings: name, subdomain, environment variables, resource limits, access control, runtime configuration, and more.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | Yes | App ID (UUID) or subdomain | |
| name | No | New display name (1-100 chars) | |
| env_vars | No | Environment variables as a JSON string of key-value pairs (replaces all existing env vars) | |
| always_on | No | Keep the app running 24/7 without auto-sleep. Requires a billing tier that supports always-on apps. | |
| cpu_limit | No | CPU limit (0.5 to 4 cores). Capped by the app's billing tier. | |
| subdomain | No | Rename the app subdomain (WARNING: changes the app URL and recreates the Docker service — use with care) | |
| memory_limit | No | Memory limit, e.g. "512M", "1G", "2G". Capped by the app's billing tier (team tier for team apps; up to 2G on team plans). | |
| start_script | No | Which package.json script to run (e.g. "dev", "serve"). Defaults to "start". Set to empty string to reset to default. | |
| watch_ignore | No | Comma-separated paths to ignore for file watching (e.g. "public,dist,output"). Always ignores node_modules. | |
| sso_auth_mode | No | "any" = any Bonto user can access; "list" = only users in sso_auth_allowed_users. | |
| allow_remixing | No | Allow other Bonto users to create a copy (remix) of this app. | |
| git_auto_commit | No | Enable/disable automatic version history snapshots when files change. Default: true. | |
| sso_auth_enabled | No | Enable/disable Bonto SSO login requirement. When enabled, visitors must sign in with a Bonto account. | |
| watch_extensions | No | Comma-separated file extensions that trigger nodemon restart (e.g. "js,ts"). Leave empty for default (js,ts,json,html,css). | |
| workspace_mounts | No | JSON array of app IDs to mount as read-write volumes at /app/workspace/[slug]/. E.g. '["uuid1","uuid2"]'. Pass '[]' to remove all mounts. | |
| http_auth_enabled | No | Enable or disable HTTP Basic Auth protection. Set to false to remove password protection without changing stored credentials. | |
| http_auth_password | No | Password for HTTP Basic Auth (plaintext, will be hashed). Min 8 chars. Set to enable Basic Auth on this app. | |
| http_auth_username | No | Username for HTTP Basic Auth. Set http_auth_password together with this to enable password protection. | |
| sso_auth_allowed_users | No | JSON array of Bonto user email addresses allowed when sso_auth_mode is "list". E.g. '["alice@example.com","bob@example.com"]'. | |
| healthcheck_timeout_secs | No | Timeout (seconds) for each healthcheck request. Default: 10. | |
| healthcheck_interval_secs | No | How often (seconds) to check if the app is alive. Default: 30. | |
| healthcheck_start_period_secs | No | Grace period (seconds) before the first healthcheck runs after container start. Default: 30. |