Scripts

List

Fetch a list of uploaded workers.

$response = $client->workers()->scripts()->list('ACCOUNT_ID', []);

Download

Fetch raw script content for your worker. Note this is the original script content, not JSON encoded.

$response = $client->workers()->scripts()->download('ACCOUNT_ID', 'SCRIPT_NAME');

Upload

Upload a Worker, replacing the deployed script and its configuration.

The request is a multipart upload: a JSON metadata part describing the Worker, and one part per module holding its source. Bindings and settings come from the metadata, so anything left out of it is dropped — send the whole configuration, not just what changed. To replace only the code, use updateContent(); to stage a Worker without deploying it, upload a version instead.

$client->workers()->scripts()->upload('ACCOUNT_ID', 'my-worker', [
    ['name' => 'worker.js', 'content' => file_get_contents('dist/worker.js')],
], [
    'compatibility_date' => '2026-01-01',
    'bindings' => [
        ['type' => 'kv_namespace', 'name' => 'KV', 'namespace_id' => 'NAMESPACE_ID'],
    ],
]);

$response = $client->workers()->scripts()->upload('ACCOUNT_ID', 'SCRIPT_NAME', [], [], []);

Update Content

Replace a Worker's code, leaving its configuration and metadata alone.

The counterpart of upload() for a code-only deploy: bindings, compatibility date and the rest of the Worker's settings are kept as they are.

$client->workers()->scripts()->updateContent('ACCOUNT_ID', 'my-worker', [
    ['name' => 'worker.js', 'content' => file_get_contents('dist/worker.js')],
]);

$response = $client->workers()->scripts()->updateContent('ACCOUNT_ID', 'SCRIPT_NAME', [], []);

Get Content

Fetch script content only.

$response = $client->workers()->scripts()->getContent('ACCOUNT_ID', 'SCRIPT_NAME');

Get Script Settings

Get script-level settings when using Worker Versions. Includes Logpush and Tail Consumers.

$response = $client->workers()->scripts()->getScriptSettings('ACCOUNT_ID', 'SCRIPT_NAME');

Update Script Settings

Patch script-level settings when using Worker Versions. Includes Logpush and Tail Consumers.

$response = $client->workers()->scripts()->updateScriptSettings('ACCOUNT_ID', 'SCRIPT_NAME', []);

Get Settings

Get metadata and config, such as bindings or usage model

$response = $client->workers()->scripts()->getSettings('ACCOUNT_ID', 'SCRIPT_NAME');

Update Settings

Patch metadata or config, such as bindings or usage model

$response = $client->workers()->scripts()->updateSettings('ACCOUNT_ID', 'SCRIPT_NAME', []);

Get Usage Model

Fetches the Usage Model for a given Worker.

$response = $client->workers()->scripts()->getUsageModel('ACCOUNT_ID', 'SCRIPT_NAME');

Update Usage Model

Updates the Usage Model for a given Worker. Requires a Workers Paid subscription.

$response = $client->workers()->scripts()->updateUsageModel('ACCOUNT_ID', 'SCRIPT_NAME', 'USAGE_MODEL');

Delete

Delete your worker. This call has no response body on a successful delete.

$response = $client->workers()->scripts()->delete('ACCOUNT_ID', 'SCRIPT_NAME', true);