scripts

Creates, updates, deletes, gets or lists a scripts resource.

Overview

Name	scripts
Type	Resource
Id	cloudflare.workers.scripts

Fields

The following fields are returned by SELECT queries:

list

List scripts in namespace response.

Name	Datatype	Description
created_on	string (date-time)	When the script was created. (example: 2017-01-01T00:00:00Z)
dispatch_namespace	string	Name of the Workers for Platforms dispatch namespace. (example: my-dispatch-namespace)
modified_on	string (date-time)	When the script was last modified. (example: 2017-01-01T00:00:00Z)
script	object

get

Worker successfully downloaded. Returns script content as a multipart form, with no metadata part and no JSON encoding applied.

Name	Datatype	Description
contents	string

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	account_id, dispatch_namespace	tags	Fetch a list of scripts uploaded to a Workers for Platforms namespace.
get	select	account_id, script_name		Fetch raw script content for your worker. Note this is the original script content, not JSON encoded.
update	replace	account_id, script_name	bindings_inherit	Upload a worker module. You can find more about the multipart metadata on our docs: https://developers.cloudflare.com/workers/configuration/multipart-upload-metadata/.
namespace_worker_delete_scripts	delete	account_id, dispatch_namespace	tags, limit	Delete multiple scripts from a Workers for Platforms namespace based on optional tag filters.
delete	delete	account_id, script_name	force	Delete your worker. This call has no response body on a successful delete.
create_assets_upload_session	exec	account_id, script_name, manifest		Start uploading a collection of assets for use in a Worker version. To learn more about the direct uploads of assets, see https://developers.cloudflare.com/workers/static-assets/direct-upload/.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string	The Cloudflare account ID.
dispatch_namespace	string	The Workers-for-Platforms dispatch namespace.
script_name	string	The Worker script name.
bindings_inherit	string	When set to "strict", the upload will fail if any inherit type bindings cannot be resolved against the previous version of the Worker. Without this, unresolvable inherit bindings are silently dropped.
force	boolean	If set to true, delete will not be stopped by associated service binding, durable object, or other binding. Any of these associated bindings/durable objects will be deleted along with the script.
limit	integer	Limit the number of scripts to delete.
tags	string	Filter scripts by tags before deletion. Format: comma-separated list of tag:allowed pairs where allowed is 'yes' or 'no'.

SELECT examples

list

Fetch a list of scripts uploaded to a Workers for Platforms namespace.

SELECT
created_on,
dispatch_namespace,
modified_on,
script
FROM cloudflare.workers.scripts
WHERE account_id = '{{ account_id }}' -- required
AND dispatch_namespace = '{{ dispatch_namespace }}' -- required
AND tags = '{{ tags }}'
;

get

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

SELECT
contents
FROM cloudflare.workers.scripts
WHERE account_id = '{{ account_id }}' -- required
AND script_name = '{{ script_name }}' -- required
;

REPLACE examples

update

Upload a worker module. You can find more about the multipart metadata on our docs: https://developers.cloudflare.com/workers/configuration/multipart-upload-metadata/.

REPLACE cloudflare.workers.scripts
SET 
-- No updatable properties
WHERE 
account_id = '{{ account_id }}' --required
AND script_name = '{{ script_name }}' --required
AND bindings_inherit = '{{ bindings_inherit}}'
RETURNING
errors,
messages,
result,
success;

DELETE examples

namespace_worker_delete_scripts

Delete multiple scripts from a Workers for Platforms namespace based on optional tag filters.

DELETE FROM cloudflare.workers.scripts
WHERE account_id = '{{ account_id }}' --required
AND dispatch_namespace = '{{ dispatch_namespace }}' --required
AND tags = '{{ tags }}'
AND limit = '{{ limit }}'
;

delete

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

DELETE FROM cloudflare.workers.scripts
WHERE account_id = '{{ account_id }}' --required
AND script_name = '{{ script_name }}' --required
AND force = '{{ force }}'
;

Lifecycle Methods

create_assets_upload_session

Start uploading a collection of assets for use in a Worker version. To learn more about the direct uploads of assets, see https://developers.cloudflare.com/workers/static-assets/direct-upload/.

EXEC cloudflare.workers.scripts.create_assets_upload_session 
@account_id='{{ account_id }}' --required, 
@script_name='{{ script_name }}' --required 
@@json=
'{
"manifest": "{{ manifest }}"
}'
;