Update Application Configuration

PATCH

apps

{id}

config

curl --request PATCH \
  --url https://api.vertracloud.app/v1/apps/{id}/config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": {},
  "main_file": "<string>",
  "language": "<string>",
  "version": "<string>",
  "start_command": {},
  "build_command": {},
  "ram": 123,
  "deploy": {
    "zero_downtime": "<string>",
    "auto_rollback": true,
    "health_check_path": {}
  }
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: {},
    main_file: '<string>',
    language: '<string>',
    version: '<string>',
    start_command: {},
    build_command: {},
    ram: 123,
    deploy: {zero_downtime: '<string>', auto_rollback: true, health_check_path: {}}
  })
};

fetch('https://api.vertracloud.app/v1/apps/{id}/config', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.vertracloud.app/v1/apps/{id}/config"

payload = {
    "name": "<string>",
    "description": {},
    "main_file": "<string>",
    "language": "<string>",
    "version": "<string>",
    "start_command": {},
    "build_command": {},
    "ram": 123,
    "deploy": {
        "zero_downtime": "<string>",
        "auto_rollback": True,
        "health_check_path": {}
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/apps/{id}/config"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": {},\n  \"main_file\": \"<string>\",\n  \"language\": \"<string>\",\n  \"version\": \"<string>\",\n  \"start_command\": {},\n  \"build_command\": {},\n  \"ram\": 123,\n  \"deploy\": {\n    \"zero_downtime\": \"<string>\",\n    \"auto_rollback\": true,\n    \"health_check_path\": {}\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "response": "success"
}

string

required

The application ID to update. If the application belongs to a workspace, pass its ID in the workspace_id query parameter.

string

If the application belongs to a workspace, the workspace’s ID. Required for workspace members acting on an application they don’t own.

Send only the fields you want to change. Every body field is optional, but at least one must be present — an empty body is rejected. Fields you omit keep their current value.

string

The application display name. Maximum 50 characters.

string | null

The application description. Maximum 128 characters. Send null to clear it.

string

The entrypoint file of the application (e.g., index.js). Cannot be empty.

string

The application’s runtime language. One of javascript, typescript, bun, python, static, php, go, ruby, java, rust, deno, dotnet, elixir. Any other value is rejected.

Changing the language resets the version. When language differs from the application’s current language, version is forced to recommended in the same update, even if the request body also sends an explicit version — the version stored for the old language may not exist for the new one. main_file and start_command are not adjusted automatically; an entrypoint or start command written for the old language may not run under the new one.

string

The runtime version. Accepts recommended, latest, auto or an explicit version string supported by the application’s language. Cannot be empty.

string | null

A custom start command (e.g., node index.js). Maximum 512 characters. Send null to fall back to the default command for the language.

string | null

An optional build command (e.g., npm run build). Maximum 512 characters. Send null to remove it. Runs on the next deploy, after dependency installation and before the application starts, in an isolated build environment (2× the application’s RAM, min 1,024 MB max 4,096 MB; 10-minute timeout). Available on every plan. A plain restart does not re-run the build if the previous one succeeded with the same command.

integer

The memory allocated to the application, in MB. Must be an integer of at least 100. Applications published on the web (with a subdomain or a custom domain) require at least 512.

Changing the memory changes the application’s disk ceiling. The volume quota is derived from the allocated memory, so lowering ram lowers how much the application is allowed to store — which is why lowering it can be refused with 409 STORAGE_ABOVE_NEW_LIMIT. See Common Error Codes.

object

How a new deploy is applied and what happens if it fails. Send only the subfields you want to change.

Show deploy properties

string

How a deploy replaces the running version. One of off, auto or on. off (the default) stops the running version before the new one starts; auto deploys without downtime only when the application receives web traffic; on always deploys without downtime. on requires the Enterprise plan; auto only has an effect on Enterprise.

boolean

When true, if the new version stops within 60 seconds after a deploy, the platform goes back to the previous version, once, and notifies you. Only the code files go back, not the environment variables. Defaults to false, including for applications created before the feature. true requires Pro or higher.

string | null

The HTTP path the platform calls on a new version to check that it is healthy. Must start with /, have at most 200 characters, and use only printable ASCII without spaces. Percent-encode anything else (for example, %20 for a space). Send null to clear it and go back to /.

Plan gates for deploy. zero_downtime: "on" below Starter 2 fails with 403 PLAN_DOES_NOT_SUPPORT_ZERO_DOWNTIME, and auto_rollback: true below Pro fails with 403 PLAN_DOES_NOT_SUPPORT_AUTO_ROLLBACK. The check applies even when the value you send equals the value already saved. zero_downtime: "off", zero_downtime: "auto" and auto_rollback: false are always accepted. A saved value stays on the application after a downgrade, but only takes effect on a plan that includes the feature.

Changing deploy does not restart the application. The new settings apply from the next deploy. The deploy object returned by Get Application shows what applies right now.

Changing build_command counts against the account’s hourly deploy budget, the same one creating an application or uploading a ZIP draws from. See Deploy rate limits.

Request example

curl -X PATCH https://api.vertracloud.app/v1/apps/{id}/config \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "deploy": {
      "auto_rollback": true,
      "zero_downtime": "auto",
      "health_check_path": "/health"
    }
  }'

Response

string

The operation status (success).

{
  "response": "success"
}

Error Responses

string

The error code indicating the reason for the failure. Possible values:

USER_NOT_FOUND: The request is not authenticated (401).
VALIDATION_ERROR: A field failed validation — wrong type, over the length limit, or an empty body (400). The response carries message and path pointing at the offending field.
APP_NOT_FOUND: The specified application does not exist (404).
ACCESS_DENIED: The user does not have permission to act on the application (403).
PLAN_DOES_NOT_SUPPORT_AUTO_ROLLBACK: deploy.auto_rollback: true was sent and the owner’s plan is below Pro (403).
PLAN_DOES_NOT_SUPPORT_ZERO_DOWNTIME: deploy.zero_downtime: "on" was sent and the owner’s plan is not Enterprise (403).
APP_SHIELD_COOLDOWN: Vertra Shield paused the application; this action is blocked until the pause ends (403). details.until says when.
OWNER_APP_WITHOUT_LIMITS: The plan limits of the application owner could not be read, so the requested memory cannot be validated (404).
MEMORY_BELOW_MINIMUM: The requested memory is below the minimum for this application — 512 MB for a web-published application (400).
MEMORY_LIMIT_EXCEEDED: The requested memory does not fit in the plan’s remaining memory, counting every other resource of the owner (400).
STORAGE_ABOVE_NEW_LIMIT: The volume already holds more than the disk ceiling implied by the requested memory (409). Nothing was changed. See below.
DEPLOY_RATE_LIMITED: A build_command change was requested and the account’s hourly deploy budget for its plan was already reached (429).
INTERNAL_SERVER_ERROR: The configuration could not be updated (500).

string

A descriptive message providing additional details about the error.

object

Present on STORAGE_ABOVE_NEW_LIMIT. Carries used_mb, limit_mb and free_mb — how much the volume holds, the ceiling the requested memory would impose, and how much has to be deleted before the change is accepted.

{
  "code": "MEMORY_LIMIT_EXCEEDED"
}

{
  "code": "ACCESS_DENIED"
}

{
  "code": "APP_NOT_FOUND"
}

{
  "code": "STORAGE_ABOVE_NEW_LIMIT",
  "details": {
    "used_mb": 2048,
    "limit_mb": 1024,
    "free_mb": 1024
  }
}

This route writes configuration; it does not restart or rebuild the container. The new values take effect on the next rebuild of the application. The deploy settings take effect on the next restart or deploy.

Last modified on November 1, 2026

Update Application Configuration

curl --request PATCH \
  --url https://api.vertracloud.app/v1/apps/{id}/config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": {},
  "main_file": "<string>",
  "language": "<string>",
  "version": "<string>",
  "start_command": {},
  "build_command": {},
  "ram": 123,
  "deploy": {
    "zero_downtime": "<string>",
    "auto_rollback": true,
    "health_check_path": {}
  }
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: {},
    main_file: '<string>',
    language: '<string>',
    version: '<string>',
    start_command: {},
    build_command: {},
    ram: 123,
    deploy: {zero_downtime: '<string>', auto_rollback: true, health_check_path: {}}
  })
};

fetch('https://api.vertracloud.app/v1/apps/{id}/config', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.vertracloud.app/v1/apps/{id}/config"

payload = {
    "name": "<string>",
    "description": {},
    "main_file": "<string>",
    "language": "<string>",
    "version": "<string>",
    "start_command": {},
    "build_command": {},
    "ram": 123,
    "deploy": {
        "zero_downtime": "<string>",
        "auto_rollback": True,
        "health_check_path": {}
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/apps/{id}/config"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": {},\n  \"main_file\": \"<string>\",\n  \"language\": \"<string>\",\n  \"version\": \"<string>\",\n  \"start_command\": {},\n  \"build_command\": {},\n  \"ram\": 123,\n  \"deploy\": {\n    \"zero_downtime\": \"<string>\",\n    \"auto_rollback\": true,\n    \"health_check_path\": {}\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "response": "success"
}

Overview

Endpoints

Update Application Configuration

Request example

Response

Error Responses

​Request example

​Response

​Error Responses

Request example

Response

Error Responses