Update an application version
edgegap_update_app_versionChange settings on an existing version instead of creating a new one: point it at a new image tag, turn it on or off, change max_duration, set the registry login, turn on image caching (force_cache: Edgegap pre-loads the image so…
Instructions
Change settings on an existing version instead of creating a new one: point it at a new image tag, turn it on or off, change max_duration, set the registry login, turn on image caching (force_cache: Edgegap pre-loads the image so deployments start faster), or set the shutdown grace period. Only the fields you pass change. Deployments already running keep their old settings; new deployments get the new ones. Same refusals as edgegap_create_app_version: "latest" or empty tags, a docker_image holding a host or tag, and the API token in the registry login. Resources, ports and env vars cannot be changed here; create a new version for those.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | Show the exact request (method, host, path, body) with secrets masked, and send nothing. Local checks still run. Use it to confirm a billable or destructive call before making it. | |
| version | Yes | Version name to change. | |
| is_active | No | false blocks new deployments of this version. | |
| docker_tag | No | New image tag: a build ID, commit SHA or timestamp. | |
| application | Yes | Application name. | |
| force_cache | No | Pre-load the image on Edgegap so deployments start faster. | |
| docker_image | No | Image path, e.g. "my-org-abc123/my-game-server". | |
| verify_image | No | Check Edgegap can pull the image when saving. | |
| registry_token | No | Registry password or token. Never echoed back. | |
| docker_repository | No | Registry host, e.g. "registry.edgegap.com". | |
| registry_username | No | ||
| max_duration_minutes | No | Auto-stop after this many minutes. Capped by EDGEGAP_MAX_DURATION_MINUTES. | |
| termination_grace_period_seconds | No | Seconds between SIGTERM and SIGKILL when a deployment stops. |