Update an application version
edgegap_update_app_versionUpdate an existing Edgegap app version's image tag, active status, resources, ports, env vars, registry login, caching, restart policy, or shutdown grace period without creating a new version.
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 (the API cannot add registry_profile "Edgegap" to an existing version: create a new version for that), turn on image caching (force_cache: Edgegap pre-loads the image so deployments start faster), set the restart policy, 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 or env vars. ports and env REPLACE the version's whole list (per the API): read the current ones with edgegap_get_app_version and pass every port or variable to keep; secret env values are not readable, so get them from the developer. Refused, with nothing sent, for a registry login or env value equal to the API's "This value is set and encrypted" placeholder; leave the registry login out to keep it. cpu_units and memory_mb change together (both or neither); to try other resources for one deployment only, override them in edgegap_deploy instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"application": "<application>",
"version": "<version>"
},
"name": "edgegap_update_app_version"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| env | No | REPLACES every env var on the version; [] removes them all. Values are never echoed back. | |
| ports | No | REPLACES every port on the version. Include the ports to keep, not only new ones. | |
| 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. | |
| cpu_units | No | New vCPU units for later deployments, with memory_mb. 1024 = 1 vCPU. | |
| is_active | No | false blocks new deployments of this version. | |
| memory_mb | No | New memory in MB for later deployments, with cpu_units. At most 2x cpu_units. | |
| 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. | |
| restart_policy | No | What Edgegap does when the server process exits. "never" for match servers that stop themselves (an exit or crash ends the deployment instead of restarting a half-played match); "on_failure" restarts only after a crash (persistent servers); "always" (the API default) restarts after any exit. | |
| endpoint_storage | No | Endpoint Storage name (edgegap_list_endpoint_storage) to export container logs to when deployments end. | |
| 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. |