---
title: Modify an application
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Containers](https://developers.cloudflare.com/api/resources/containers)
[Applications](https://developers.cloudflare.com/api/resources/containers/subresources/applications)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Modify an application
PATCH/accounts/{account\_id}/containers/applications/{application\_id}
Modifies a single application by id. Durable Object-managed application settings are published to runtime metadata without creating deployments or rollouts. Top-level `observability` for these applications supports only `logs.enabled`. The supported fields depend on the existing application’s scheduling policy. For scheduler-backed applications, changes that replace instance deployment configuration, including the image, require a rollout.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required)
`Workers Containers Write`
##### P ath ParametersExpand Collapse
account\_id: string
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
application\_id: string
An Application ID represents an identifier of an application.
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20application_id%20%3E%20(schema)>)
##### Body ParametersJSONExpand Collapse
configuration: optional object {authorized\_keys, wrangler\_ssh }
Application configuration fields you can change without creating a rollout.
authorized\_keys: optional array of object {public\_key, name }
public\_key: string
An SSH public key.
Link to this property
name: optional string
Optional human readable name for this key.
Link to this property
Link to this property
wrangler\_ssh: optional object {enabled, port }
Configuration properties for connecting with SSH to a container using Wrangler.
enabled: optional boolean
Link to this property
port: optional number
maximum65535
minimum1
Link to this property
Link to this property
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20configuration%20%3E%20(schema)>)
constraints: optional object {jurisdiction, regions }
jurisdiction: optional string
Restricts placement to datacenters in the selected jurisdiction. Choose “eu”, “fedramp”, or “us”. When combined with regions, EU supports EEUR and WEUR while FedRAMP and US support ENAM and WNAM.
Link to this property
regions: optional array of string
Link to this property
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20constraints%20%3E%20(schema)>)
max\_instances: optional number
Maximum number of instances that an autoscaling application can run.
minimum0
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20max_instances%20%3E%20(schema)>)
observability: optional object {logs }
Top-level application observability settings. Scheduler-backed applications hot-reload these settings across existing instances. An existing Durable Object-managed application accepts only logs.enabled and publishes these settings to runtime metadata without creating deployments or rollouts.
logs: optional object {enabled }
Observability logging settings.
enabled: optional boolean
Link to this property
Link to this property
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20observability%20%3E%20(schema)>)
rollout\_active\_grace\_period: optional number
Grace period for active instances to stay alive before becoming eligible for shutdown signal due to a rollout, in seconds. Defaults to 0.
maximum604800
minimum0
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20rollout_active_grace_period%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of object {code, message, documentation\_url, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
documentation\_url: optional string
Link to this property
source: optional object {pointer }
pointer: optional string
Link to this property
Link to this property
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {code, message, documentation\_url, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
documentation\_url: optional string
Link to this property
source: optional object {pointer }
pointer: optional string
Link to this property
Link to this property
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: object {id, account\_id, configuration, 13 more } or object {id, account\_id, created\_at, 7 more }
The public Containers API returns an application.
One of the following:
CcScheduledApplication object {id, account\_id, configuration, 13 more }
Describes an application and the parameters that govern how it places its instances.
id: string
An Application ID represents an identifier of an application.
Link to this property
account\_id: string
A unique identifier for the user’s account.
Link to this property
configuration: object {image, authorized\_keys, command, 4 more }
User-specified container configuration.
image: string
Image url.
Link to this property
authorized\_keys: optional array of object {public\_key, name }
public\_key: string
An SSH public key.
Link to this property
name: optional string
Optional human readable name for this key.
Link to this property
Link to this property
command: optional array of string
The command that runs when the container starts, passed to the entrypoint. You can override this at run-time. If you override only the command, it gets passed to the default entrypoint specified in the image.
Link to this property
entrypoint: optional array of string
The entry point for the container, specifying the executable to run when the container starts. You can override this at run-time. If you do, the default command from the image is ignored. Specify both entrypoint and command at run-time to completely replace the image defaults.
Link to this property
environment\_variables: optional array of object {name, value }
Container environment variables.
name: string
An environment variable name.
Link to this property
value: string
An environment variable value.
Link to this property
Link to this property
instance\_type: optional "lite"or "basic"or "standard-1"or 3 more
The instance type configures vCPU, memory, and disk.
- “lite”: 1/16 vCPU, 256 MiB memory, 2 GB disk
- “basic”: 1/4 vCPU, 1 GiB memory, 4 GB disk
- “standard-1”: 1/2 vCPU, 4 GiB memory, 8 GB disk
- “standard-2”: 1 vCPU, 6 GiB memory, 12 GB disk
- “standard-3”: 2 vCPU, 8 GiB memory, 16 GB disk
- “standard-4”: 4 vCPU, 12 GiB memory, 20 GB disk
One of the following:
"lite"
Link to this property
"basic"
Link to this property
"standard-1"
Link to this property
"standard-2"
Link to this property
"standard-3"
Link to this property
"standard-4"
Link to this property
Link to this property
observability: optional object {logs }
Settings for deployment observability such as logging.
logs: optional object {enabled }
Observability logging settings.
enabled: optional boolean
Link to this property
Link to this property
Link to this property
Link to this property
created\_at: string
UTC timestamp string in ISO 8601 format.
Link to this property
instances: number
Number of deployments to create.
Link to this property
name: string
The application name.
Link to this property
scheduling\_policy: "default"or "durable\_object"
The scheduling policy to use for an application.
One of the following:
"default"
Link to this property
"durable\_object"
Link to this property
Link to this property
updated\_at: string
UTC timestamp string in ISO 8601 format.
Link to this property
version: number
Link to this property
active\_rollout\_id: optional string
An identifier for a specific rollout within an application.
Link to this property
constraints: optional object {jurisdiction, regions }
jurisdiction: optional string
Restricts placement to datacenters in the selected jurisdiction. Choose “eu”, “fedramp”, or “us”. When combined with regions, EU supports EEUR and WEUR while FedRAMP and US support ENAM and WNAM.
Link to this property
regions: optional array of string
Link to this property
Link to this property
durable\_objects: optional object {namespace\_id }
Durable object configuration stored on and returned from a Cloudchamber application.
namespace\_id: string
The namespace ID of the durable object namespace to use for this application.
Link to this property
Link to this property
health: optional object {errors, instances, summary }
errors: array of object {event, instance\_id }
event: object {id, details, message, 4 more }
An event within a Placement or a Job.
id: string
Link to this property
details: map\[unknown]
Link to this property
message: string
Link to this property
name: "SchedulerPlaced"or "NetworkingIPAssigned"or "VMStarted"or 14 more
Name of the event that describes the kind event that happened.
- SchedulerPlaced: It’s the first event that creates a container placement. It happens when the Containers runtime was able to retrieve deployment resources and start verifying everything is correct.
- NetworkingIPAssigned: It’s sent when the Containers runtime maps the IP to the container.
- VMStarted: It’s sent when the Containers runtime starts the VM. The container might remain unhealthy at this point.
- ImagePulled: It’s sent when the Containers runtime pulls the image successfully.
- ImagePullError: It’s sent when the Containers runtime is having issues pulling the image. The message and details have more information on what happened for debugging.
- VMFailedToStart: It’s sent when the Containers runtime was unable to boot the VM.
- VMStopping: It’s sent when the scheduler is stopping the VM.
- VMStopped: It’s sent when the VM finally exits.
- VMFailed: It’s sent when the scheduling of the VM failed in the current location.
- RuntimeStartFailed: It’s sent when the runtime hits an internal error.
- SSHStarted: It’s sent when the container gains network connectivity and opens the SSH port. Containers only send this event when SSH keys exist.
- CheckUpdate: Sent when the status of a health or readiness check changes. This may also affect the health status of the placement.
- DurableObjectConnected: Sent when a durable object instance connects and gains control of the deployment. This event is only sent for durable object deployments. It is sent after VMStarted.
- ContainerStarted: It’s sent when the container starts running.
One of the following:
"SchedulerPlaced"
Link to this property
"NetworkingIPAssigned"
Link to this property
"VMStarted"
Link to this property
"ImagePulled"
Link to this property
"ImagePullError"
Link to this property
"VMFailedToStart"
Link to this property
"NetworkingIPAssignmentFailed"
Link to this property
"VMRunning"
Link to this property
"VMStopping"
Link to this property
"VMStopped"
Link to this property
"VMFailed"
Link to this property
"RuntimeStartFailed"
Link to this property
"SSHStarted"
Link to this property
"ServiceHealthUpdates"
Link to this property
"CheckUpdate"
Link to this property
"DurableObjectConnected"
Link to this property
"ContainerStarted"
Link to this property
Link to this property
statusChange: map\[unknown]
Link to this property
time: string
UTC timestamp string in ISO 8601 format.
Link to this property
type: "Info"or "Error"or "Warn"or 2 more
One of the following:
"Info"
Link to this property
"Error"
Link to this property
"Warn"
Link to this property
"UserError"
Link to this property
"SystemError"
Link to this property
Link to this property
Link to this property
instance\_id: string
An instance ID represents an identifier of an instance configuration that maintains an underlying placement.
Link to this property
Link to this property
instances: object {active, assigned }
Shows a count of application instance states.
active: number
Number of instances whose runtime reports the container as running (container\_status = “running”). This is a subset of the placements that remain up: an instance that is already bound to a Durable Object and serving traffic is counted under “assigned” until its container\_status catches up to “running”, so container\_status can briefly lag Durable Object attachment under churn. To estimate running, Durable-Object-bound instances, sum “active” + “assigned” rather than reading “active” alone.
Link to this property
assigned: number
Number of instances bound to a Durable Object with a running placement whose container\_status remains behind “running”. These count as live, serving instances; “active” + “assigned” approximates the running, Durable-Object-bound count.
Link to this property
Link to this property
summary: optional "healthy"or "degraded"or "unhealthy"or "pending"
High-level health assessment. Only populated for “new\_instances” strategy. Based on a sample of target-version instances rather than a full count.
- “pending”: Zero target-version instances exist yet.
- “healthy”: Every sampled target-version instance reports running or active.
- “degraded”: Some sampled instances remain starting or scheduling.
- “unhealthy”: One or more sampled instances have failed.
One of the following:
"healthy"
Link to this property
"degraded"
Link to this property
"unhealthy"
Link to this property
"pending"
Link to this property
Link to this property
Link to this property
max\_instances: optional number
Maximum number of instances the application allows. This is relevant for applications that auto-scale.
Link to this property
observability: optional object {logs }
Top-level observability settings for the application. This field is mutually exclusive with configuration.observability.
logs: optional object {enabled }
Observability logging settings.
enabled: optional boolean
Link to this property
Link to this property
Link to this property
rollout\_active\_grace\_period: optional number
Grace period for active instances to stay alive before becoming eligible for shutdown signal due to a rollout, in seconds. Defaults to 0.
maximum604800
minimum0
Link to this property
Link to this property
CcDurableObjectApplication object {id, account\_id, created\_at, 7 more }
Each Durable Object creates and manages the lifecycle of its container instance.
id: string
An Application ID represents an identifier of an application.
Link to this property
account\_id: string
A unique identifier for the user’s account.
Link to this property
created\_at: string
UTC timestamp string in ISO 8601 format.
Link to this property
durable\_objects: object {namespace\_id }
Durable object configuration using a namespace ID.
namespace\_id: string
The namespace ID of the durable object namespace to use for this application.
Link to this property
Link to this property
name: string
The application name.
Link to this property
scheduling\_policy: "durable\_object"
Selects a Durable Object-managed application. Each Durable Object creates and manages the lifecycle of its container instance. Configure application-wide observability settings here. Deployment configuration, scaling, placement constraints, versions, and rollouts do not apply.
Link to this property
updated\_at: string
UTC timestamp string in ISO 8601 format.
Link to this property
configuration: optional object {authorized\_keys, wrangler\_ssh }
Application-wide settings for a Durable Object-managed application.
authorized\_keys: optional array of object {public\_key, name }
public\_key: string
An SSH public key.
Link to this property
name: optional string
Optional human readable name for this key.
Link to this property
Link to this property
wrangler\_ssh: optional object {enabled, port }
Configuration properties for connecting with SSH to a container using Wrangler.
enabled: optional boolean
Link to this property
port: optional number
maximum65535
minimum1
Link to this property
Link to this property
Link to this property
health: optional object {instances, summary }
Aggregate current activity for the latest observed placement of each instance. Runtime snapshots feed periodic background sweeps. Counts refresh after each complete sweep. Instance listings retain their separate three-month history for failure discovery.
instances: object {active, starting }
Counts of observed non-terminal instances.
active: number
Number of instances whose runtime reports running or stopping.
minimum0
Link to this property
starting: number
Number of instances whose runtime reports starting.
minimum0
Link to this property
Link to this property
summary: optional "pending"
Present as pending until the first activity sweep completes; omitted afterward.
Link to this property
Link to this property
observability: optional object {logs }
Application-wide logging settings for a Durable Object-managed application. The application publishes these settings to its runtime metadata. Updating them does not create a deployment or rollout.
logs: optional object {enabled }
Application-wide logging settings.
enabled: optional boolean
Link to this property
Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
success: boolean
Whether the API call was successful.
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20edit%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### Modify an application
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/containers/applications/$APPLICATION_ID \
-X PATCH \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{}'
```
200 example
```
{
"errors": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"result": {
"id": "id",
"account_id": "account_id",
"configuration": {
"image": "image",
"authorized_keys": [
{
"public_key": "public_key",
"name": "name"
}
],
"command": [
"myapp",
"--default-option"
],
"entrypoint": [
"/bin/bash"
],
"environment_variables": [
{
"name": "name",
"value": "value"
}
],
"instance_type": "lite",
"observability": {
"logs": {
"enabled": true
}
}
},
"created_at": "2021-04-01T12:32:41.488Z",
"instances": 0,
"name": "name",
"scheduling_policy": "default",
"updated_at": "2021-04-01T12:32:41.488Z",
"version": 0,
"active_rollout_id": "active_rollout_id",
"constraints": {
"jurisdiction": "jurisdiction",
"regions": [
"WNAM"
]
},
"durable_objects": {
"namespace_id": "14758f1afd44c09b7992073ccf00b43d"
},
"health": {
"errors": [
{
"event": {
"id": "id",
"details": {
"foo": "bar"
},
"message": "message",
"name": "SchedulerPlaced",
"statusChange": {
"foo": "bar"
},
"time": "2021-04-01T12:32:41.488Z",
"type": "Info"
},
"instance_id": "instance_id"
}
],
"instances": {
"active": 0,
"assigned": 0
},
"summary": "healthy"
},
"max_instances": 0,
"observability": {
"logs": {
"enabled": true
}
},
"rollout_active_grace_period": 0
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"errors": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"result": {
"id": "id",
"account_id": "account_id",
"configuration": {
"image": "image",
"authorized_keys": [
{
"public_key": "public_key",
"name": "name"
}
],
"command": [
"myapp",
"--default-option"
],
"entrypoint": [
"/bin/bash"
],
"environment_variables": [
{
"name": "name",
"value": "value"
}
],
"instance_type": "lite",
"observability": {
"logs": {
"enabled": true
}
}
},
"created_at": "2021-04-01T12:32:41.488Z",
"instances": 0,
"name": "name",
"scheduling_policy": "default",
"updated_at": "2021-04-01T12:32:41.488Z",
"version": 0,
"active_rollout_id": "active_rollout_id",
"constraints": {
"jurisdiction": "jurisdiction",
"regions": [
"WNAM"
]
},
"durable_objects": {
"namespace_id": "14758f1afd44c09b7992073ccf00b43d"
},
"health": {
"errors": [
{
"event": {
"id": "id",
"details": {
"foo": "bar"
},
"message": "message",
"name": "SchedulerPlaced",
"statusChange": {
"foo": "bar"
},
"time": "2021-04-01T12:32:41.488Z",
"type": "Info"
},
"instance_id": "instance_id"
}
],
"instances": {
"active": 0,
"assigned": 0
},
"summary": "healthy"
},
"max_instances": 0,
"observability": {
"logs": {
"enabled": true
}
},
"rollout_active_grace_period": 0
},
"success": true
}
```