Update Worker Settings
update_worker_settingsModify a Worker's bindings, compatibility date/flags, logpush, and observability without re-uploading code. Binding changes replace the full set and deploy a new version when no rollout is pending.
Instructions
Update a Worker's settings (bindings, compatibility date/flags, logpush, observability) without re-uploading its code. Bindings REPLACE the Worker's full binding set, except that existing secrets are kept unless listed. Binding and compatibility changes deploy a new version; refuses while a staged version or a gradual rollout is pending.
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": {
"script_name": "<script_name>"
},
"name": "update_worker_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| logpush | No | ||
| bindings | No | Resource bindings — REPLACES the Worker's full binding set | |
| script_name | Yes | The name of the Worker script | |
| observability | No | Workers Logs configuration | |
| compatibility_date | No | YYYY-MM-DD | |
| compatibility_flags | No | Runtime compatibility flags. nodejs_compat is on by default for compatibility_date >= 2026-08-04, so it is not needed with the default (today) date |