--- title: Beta --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Workers](https://developers.cloudflare.com/api/go/resources/workers) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Beta #### BetaWorkers ##### [List Workers](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/methods/list) client.Workers.Beta.Workers.List(ctx, params) (\*V4PagePaginationArray\[[Worker]()], error) GET/accounts/{account\_id}/workers/workers ##### [Get Worker](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/methods/get) client.Workers.Beta.Workers.Get(ctx, workerID, query) (\*[Worker](), error) GET/accounts/{account\_id}/workers/workers/{worker\_id} ##### [Create Worker](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/methods/create) client.Workers.Beta.Workers.New(ctx, params) (\*[Worker](), error) POST/accounts/{account\_id}/workers/workers ##### [Update Worker](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/methods/update) client.Workers.Beta.Workers.Update(ctx, workerID, params) (\*[Worker](), error) PUT/accounts/{account\_id}/workers/workers/{worker\_id} ##### [Edit Worker](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/methods/edit) client.Workers.Beta.Workers.Edit(ctx, workerID, params) (\*[Worker](), error) PATCH/accounts/{account\_id}/workers/workers/{worker\_id} ##### [Delete Worker](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/methods/delete) client.Workers.Beta.Workers.Delete(ctx, workerID, params) (\*[BetaWorkerDeleteResponse](), error) DELETE/accounts/{account\_id}/workers/workers/{worker\_id} ##### ModelsExpand Collapse
type Worker struct{…} ID string Immutable ID of the Worker. Link to this property CreatedOn Time When the Worker was created. formatdate-time Link to this property Logpush bool Whether logpush is enabled for the Worker. Link to this property Name string Name of the Worker. Link to this property
Observability WorkerObservability Observability settings for the Worker. Enabled boolOptional Whether observability is enabled for the Worker. Link to this property HeadSamplingRate float64Optional The sampling rate for observability. From 0 to 1 (1 = 100%, 0.1 = 10%). Link to this property
Issues WorkerObservabilityIssuesOptional Real-time Issues settings for the Worker. Enabled boolOptional Whether real-time Issues are enabled for the Worker. Link to this property
Link to this property
Logs WorkerObservabilityLogsOptional Log settings for the Worker. Destinations \[]stringOptional A list of destinations where logs will be exported to. Link to this property Enabled boolOptional Whether logs are enabled for the Worker. Link to this property HeadSamplingRate float64Optional The sampling rate for logs. From 0 to 1 (1 = 100%, 0.1 = 10%). Link to this property InvocationLogs boolOptional Whether invocation logs are enabled for the Worker. Link to this property Persist boolOptional Whether log persistence is enabled for the Worker. Link to this property
Link to this property RedactQueryString boolOptional Whether query strings are removed from request URLs in logs and traces. Link to this property
Traces WorkerObservabilityTracesOptional Trace settings for the Worker. Destinations \[]stringOptional A list of destinations where traces will be exported to. Link to this property Enabled boolOptional Whether traces are enabled for the Worker. Link to this property HeadSamplingRate float64Optional The sampling rate for traces. From 0 to 1 (1 = 100%, 0.1 = 10%). Link to this property Persist boolOptional Whether trace persistence is enabled for the Worker. Link to this property
PropagationPolicy WorkerObservabilityTracesPropagationPolicyOptional Controls how inbound trace context (traceparent/tracestate) headers on incoming requests are handled. “authenticated” honors inbound trace context only when accompanied by a valid trace auth token. “accept” unconditionally accepts inbound trace context. Requires the trace propagation feature to be enabled. Returns null when the trace propagation feature is not enabled for the account. One of the following: const WorkerObservabilityTracesPropagationPolicyAuthenticated WorkerObservabilityTracesPropagationPolicy = "authenticated" Link to this property const WorkerObservabilityTracesPropagationPolicyAccept WorkerObservabilityTracesPropagationPolicy = "accept" Link to this property
Link to this property
Link to this property
Link to this property
References WorkerReferences Other resources that reference the Worker and depend on it existing.
DispatchNamespaceOutbounds \[]WorkerReferencesDispatchNamespaceOutbound Other Workers that reference the Worker as an outbound for a dispatch namespace. NamespaceID string ID of the dispatch namespace. Link to this property NamespaceName string Name of the dispatch namespace. Link to this property WorkerID string ID of the Worker using the dispatch namespace. Link to this property WorkerName string Name of the Worker using the dispatch namespace. Link to this property
Link to this property
Domains \[]WorkerReferencesDomain Custom domains connected to the Worker. ID string ID of the custom domain. Link to this property CertificateID string ID of the TLS certificate issued for the custom domain. Link to this property Hostname string Full hostname of the custom domain, including the zone name. Link to this property ZoneID string ID of the zone. Link to this property ZoneName string Name of the zone. Link to this property
Link to this property
DurableObjects \[]WorkerReferencesDurableObject Other Workers that reference Durable Object classes implemented by the Worker. NamespaceID string ID of the Durable Object namespace being used. Link to this property NamespaceName string Name of the Durable Object namespace being used. Link to this property WorkerID string ID of the Worker using the Durable Object implementation. Link to this property WorkerName string Name of the Worker using the Durable Object implementation. Link to this property
Link to this property
Queues \[]WorkerReferencesQueue Queues that send messages to the Worker. QueueConsumerID string ID of the queue consumer configuration. Link to this property QueueID string ID of the queue. Link to this property QueueName string Name of the queue. Link to this property
Link to this property
Workers \[]WorkerReferencesWorker Other Workers that reference the Worker using service bindings. ID string ID of the referencing Worker. Link to this property Name string Name of the referencing Worker. Link to this property
Link to this property
Link to this property
Subdomain WorkerSubdomain Subdomain settings for the Worker. Enabled boolOptional Whether the \*.workers.dev subdomain is enabled for the Worker. Link to this property PreviewURLSuffix stringOptional Prepend a version or preview prefix to this host suffix to form the \*.workers.dev preview URL the Worker would serve on once previews are enabled, e.g. https://<prefix>-my-worker.my-subdomain.workers.dev. Present whenever the account owns a workers.dev subdomain, regardless of whether previews_enabled is true, so presence does not imply preview URLs are currently live. Absent only when the account owns no workers.dev subdomain. Link to this property PreviewsEnabled boolOptional Whether preview URLs are enabled for the Worker. Link to this property URL stringOptional The address the Worker would serve on once its \*.workers.dev subdomain is enabled. Present whenever the account owns a workers.dev subdomain, regardless of whether enabled is true, so presence does not imply the Worker is currently live at this URL. Absent only when the account owns no workers.dev subdomain. formaturi Link to this property
Link to this property Tags \[]string Tags associated with the Worker. Link to this property
TailConsumers \[]WorkerTailConsumer Other Workers that should consume logs from the Worker. Name string Name of the consumer Worker. Link to this property
Link to this property UpdatedOn Time When the Worker was most recently updated. formatdate-time Link to this property DeployedOn TimeOptional When the Worker’s most recent deployment was created. null if the Worker has never been deployed. formatdate-time Link to this property
PreviewsBaseConfig WorkerPreviewsBaseConfigOptional Template configuration used when creating new Previews for this Worker.
CacheOptions WorkerPreviewsBaseConfigCacheOptionsOptional Cache options used when creating new Previews. Enabled bool Whether caching is enabled for this Worker. Link to this property CrossVersionCache boolOptional Whether cached responses are shared across Worker version uploads. This is independent of enabled. It can stay true while caching is off, so the preference survives turning caching off and back on. Link to this property
Link to this property
Env map\[string, WorkerPreviewsBaseConfigEnv]Optional Bindings used when creating new Previews, keyed by binding name. Type string The kind of resource that the binding provides. Link to this property
Link to this property
Limits WorkerPreviewsBaseConfigLimitsOptional Resource limits enforced at runtime for newly created Previews. CPUMs int64Optional The amount of CPU time this Worker can use in milliseconds. Link to this property Subrequests int64Optional The number of subrequests this Worker can make per request. Link to this property
Link to this property Logpush boolOptional Whether logpush is enabled when creating new Previews. Link to this property
Observability WorkerPreviewsBaseConfigObservabilityOptional Observability settings used when creating new Previews. Enabled boolOptional Whether observability is enabled for the Worker. Link to this property HeadSamplingRate float64Optional The sampling rate for observability. From 0 to 1 (1 = 100%, 0.1 = 10%). Link to this property
Issues WorkerPreviewsBaseConfigObservabilityIssuesOptional Real-time Issues settings for the Worker. Enabled boolOptional Whether real-time Issues are enabled for the Worker. Link to this property
Link to this property
Logs WorkerPreviewsBaseConfigObservabilityLogsOptional Log settings for the Worker. Destinations \[]stringOptional A list of destinations where logs will be exported to. Link to this property Enabled boolOptional Whether logs are enabled for the Worker. Link to this property HeadSamplingRate float64Optional The sampling rate for logs. From 0 to 1 (1 = 100%, 0.1 = 10%). Link to this property InvocationLogs boolOptional Whether invocation logs are enabled for the Worker. Link to this property Persist boolOptional Whether log persistence is enabled for the Worker. Link to this property
Link to this property RedactQueryString boolOptional Whether query strings are removed from request URLs in logs and traces. Link to this property
Traces WorkerPreviewsBaseConfigObservabilityTracesOptional Trace settings for the Worker. Destinations \[]stringOptional A list of destinations where traces will be exported to. Link to this property Enabled boolOptional Whether traces are enabled for the Worker. Link to this property HeadSamplingRate float64Optional The sampling rate for traces. From 0 to 1 (1 = 100%, 0.1 = 10%). Link to this property Persist boolOptional Whether trace persistence is enabled for the Worker. Link to this property
PropagationPolicy WorkerPreviewsBaseConfigObservabilityTracesPropagationPolicyOptional Controls how inbound trace context (traceparent/tracestate) headers on incoming requests are handled. “authenticated” honors inbound trace context only when accompanied by a valid trace auth token. “accept” unconditionally accepts inbound trace context. Requires the trace propagation feature to be enabled. Returns null when the trace propagation feature is not enabled for the account. One of the following: const WorkerPreviewsBaseConfigObservabilityTracesPropagationPolicyAuthenticated WorkerPreviewsBaseConfigObservabilityTracesPropagationPolicy = "authenticated" Link to this property const WorkerPreviewsBaseConfigObservabilityTracesPropagationPolicyAccept WorkerPreviewsBaseConfigObservabilityTracesPropagationPolicy = "accept" Link to this property
Link to this property
Link to this property
Link to this property
Placement WorkerPreviewsBaseConfigPlacementOptional Placement configuration used when creating new Previews. One of the following:
type WorkerPreviewsBaseConfigPlacementMode struct{…} Mode WorkerPreviewsBaseConfigPlacementModeMode Enables Smart Placement. Link to this property
Link to this property
type WorkerPreviewsBaseConfigPlacementRegion struct{…} Region string Cloud region for targeted placement in format ‘provider:region’. Link to this property
Link to this property
type WorkerPreviewsBaseConfigPlacementHostname struct{…} Hostname string HTTP hostname for targeted placement. Link to this property
Link to this property
type WorkerPreviewsBaseConfigPlacementHost struct{…} Host string TCP host and port for targeted placement. Link to this property
Link to this property
type WorkerPreviewsBaseConfigPlacementObject struct{…} Mode WorkerPreviewsBaseConfigPlacementObjectMode Targeted placement mode. Link to this property Region string Cloud region for targeted placement in format ‘provider:region’. Link to this property
Link to this property
type WorkerPreviewsBaseConfigPlacementObject struct{…} Hostname string HTTP hostname for targeted placement. Link to this property Mode WorkerPreviewsBaseConfigPlacementObjectMode Targeted placement mode. Link to this property
Link to this property
type WorkerPreviewsBaseConfigPlacementObject struct{…} Host string TCP host and port for targeted placement. Link to this property Mode WorkerPreviewsBaseConfigPlacementObjectMode Targeted placement mode. Link to this property
Link to this property
type WorkerPreviewsBaseConfigPlacementObject struct{…} Mode WorkerPreviewsBaseConfigPlacementObjectMode Targeted placement mode. Link to this property
Target \[]WorkerPreviewsBaseConfigPlacementObjectTarget Array of placement targets (currently limited to single target). One of the following:
type WorkerPreviewsBaseConfigPlacementObjectTargetRegion struct{…} Region string Cloud region in format ‘provider:region’. Link to this property
Link to this property
type WorkerPreviewsBaseConfigPlacementObjectTargetHostname struct{…} Hostname string HTTP hostname for targeted placement. Link to this property
Link to this property
type WorkerPreviewsBaseConfigPlacementObjectTargetHost struct{…} Host string TCP host:port for targeted placement. Link to this property
Link to this property
Link to this property
Link to this property
Link to this property
TailConsumers \[]WorkerPreviewsBaseConfigTailConsumerOptional Other Workers that should consume logs from newly created Previews. Name string Name of the consumer Worker. Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20workers.beta.workers%20%3E%20(model)%20worker%20%3E%20(schema)>) #### BetaWorkersVersions ##### [List Worker Versions](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/subresources/versions/methods/list) client.Workers.Beta.Workers.Versions.List(ctx, workerID, params) (\*V4PagePaginationArray\[[Version]()], error) GET/accounts/{account\_id}/workers/workers/{worker\_id}/versions ##### [Get Worker Version](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/subresources/versions/methods/get) client.Workers.Beta.Workers.Versions.Get(ctx, workerID, versionID, params) (\*[Version](), error) GET/accounts/{account\_id}/workers/workers/{worker\_id}/versions/{version\_id} ##### [Create Worker Version](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/subresources/versions/methods/create) client.Workers.Beta.Workers.Versions.New(ctx, workerID, params) (\*[Version](), error) POST/accounts/{account\_id}/workers/workers/{worker\_id}/versions ##### [Delete Worker Version](https://developers.cloudflare.com/api/go/resources/workers/subresources/beta/subresources/workers/subresources/versions/methods/delete) client.Workers.Beta.Workers.Versions.Delete(ctx, workerID, versionID, body) (\*[BetaWorkerVersionDeleteResponse](), error) DELETE/accounts/{account\_id}/workers/workers/{worker\_id}/versions/{version\_id} ##### ModelsExpand Collapse
type Version struct{…} ID string Version identifier. formatuuid Link to this property CreatedOn Time When the version was created. formatdate-time Link to this property Number int64 The integer version number, starting from one. Link to this property URLs \[]string All routable URLs that always point to this version. Does not include alias URLs, since aliases can be updated to point to a different version. Link to this property
Annotations VersionAnnotationsOptional Metadata about the version. WorkersMessage stringOptional Human-readable message about the version. Truncated to 1000 bytes if longer. maxLength1000 Link to this property WorkersTag stringOptional User-provided identifier for the version. Maximum 100 bytes. maxLength100 Link to this property WorkersTriggeredBy stringOptional Operation that triggered the creation of the version. Link to this property
Link to this property
Assets VersionAssetsOptional Configuration for assets within a Worker. _headers and _redirects files should be included as modules named _headers and _redirects with content type text/plain.
Config VersionAssetsConfigOptional Configuration for assets within a Worker. BasePath stringOptional The public URL path prefix under which assets are served. A null request value resets it to /; responses represent the root as /. All versions in a gradual deployment must use the same canonical value. To change it, first deploy the version containing the change at 100%. Link to this property
HTMLHandling VersionAssetsConfigHTMLHandlingOptional Determines the redirects and rewrites of requests for HTML content. One of the following: const VersionAssetsConfigHTMLHandlingAutoTrailingSlash VersionAssetsConfigHTMLHandling = "auto-trailing-slash" Link to this property const VersionAssetsConfigHTMLHandlingForceTrailingSlash VersionAssetsConfigHTMLHandling = "force-trailing-slash" Link to this property const VersionAssetsConfigHTMLHandlingDropTrailingSlash VersionAssetsConfigHTMLHandling = "drop-trailing-slash" Link to this property const VersionAssetsConfigHTMLHandlingNone VersionAssetsConfigHTMLHandling = "none" Link to this property
Link to this property
NotFoundHandling VersionAssetsConfigNotFoundHandlingOptional Determines the response when a request does not match a static asset, and there is no Worker script. One of the following: const VersionAssetsConfigNotFoundHandlingNone VersionAssetsConfigNotFoundHandling = "none" Link to this property const VersionAssetsConfigNotFoundHandling404Page VersionAssetsConfigNotFoundHandling = "404-page" Link to this property const VersionAssetsConfigNotFoundHandlingSinglePageApplication VersionAssetsConfigNotFoundHandling = "single-page-application" Link to this property
Link to this property
RunWorkerFirst VersionAssetsConfigRunWorkerFirstUnionOptional Contains a list path rules to control routing to either the Worker or assets. Glob (\*) and negative (!) rules are supported. Rules must start with either ’/’ or ’!/’. At least one non-negative rule must be provided, and negative rules have higher precedence than non-negative rules. One of the following: type VersionAssetsConfigRunWorkerFirstArray \[]string Contains a list path rules to control routing to either the Worker or assets. Glob (\*) and negative (!) rules are supported. Rules must start with either ’/’ or ’!/’. At least one non-negative rule must be provided, and negative rules have higher precedence than non-negative rules. Link to this property UnionBool Link to this property
Link to this property
Link to this property JWT stringOptional Token provided upon successful upload of all files from a registered manifest. Link to this property
Link to this property AuthorEmail stringOptional Email of the user who created the version. formatemail Link to this property AuthorID stringOptional Identifier of the user who created the version. Link to this property
Bindings \[]VersionBindingOptional List of bindings attached to a Worker. You can find more about bindings on our docs: https://developers.cloudflare.com/workers/configuration/multipart-upload-metadata/#bindings. One of the following:
type VersionBindingsWorkersBindingKindAI struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindAIType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindAISearch struct{…} InstanceName string The user-chosen instance name. Must exist at deploy time. The worker can search, chat, update, and manage items/jobs on this instance. Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindAISearchType The kind of resource that the binding provides. Link to this property Namespace stringOptional The namespace the instance belongs to. Defaults to “default” if omitted. Customers who don’t use namespaces can simply omit this field. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindAISearchNamespace struct{…} Name string A JavaScript variable name for the binding. Link to this property Namespace string The user-chosen namespace name. Must exist before deploy — Wrangler handles auto-creation on deploy failure (R2 bucket pattern). The “default” namespace is auto-created by config-api for new accounts. Grants full access (CRUD + search + chat) to all instances within the namespace. Link to this property Type VersionBindingsWorkersBindingKindAISearchNamespaceType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindMessaging struct{…} Name string A JavaScript variable name for the binding. Link to this property Namespace string The Messaging namespace to bind to. Link to this property Type VersionBindingsWorkersBindingKindMessagingType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindAnalyticsEngine struct{…} Dataset string The name of the dataset to bind to. Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindAnalyticsEngineType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindArtifacts struct{…} Name string A JavaScript variable name for the binding. Link to this property Namespace string The Artifacts namespace exposed to the Worker in the Worker’s account. Must be 2-63 characters, start with an ASCII alphanumeric character, contain only ASCII alphanumeric characters, dots, underscores, and hyphens, and must not end with a hyphen. The namespace does not need to be created before binding it. maxLength63 minLength2 Link to this property Type VersionBindingsWorkersBindingKindArtifactsType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindAssets struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindAssetsType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindBrowser struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindBrowserType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindD1 struct{…} DatabaseID string Identifier of the D1 database to bind to. Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindD1Type The kind of resource that the binding provides. Link to this property DeprecatedID stringOptional This property has been renamed to database_id. Identifier of the D1 database to bind to. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindDataBlob struct{…} Name string A JavaScript variable name for the binding. Link to this property Part string The name of the file containing the data content. Only accepted for service worker syntax Workers. Link to this property DeprecatedType VersionBindingsWorkersBindingKindDataBlobType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindDispatchNamespace struct{…} Name string A JavaScript variable name for the binding. Link to this property Namespace string The name of the dispatch namespace. Link to this property Type VersionBindingsWorkersBindingKindDispatchNamespaceType The kind of resource that the binding provides. Link to this property
Outbound VersionBindingsWorkersBindingKindDispatchNamespaceOutboundOptional Outbound worker.
Params \[]VersionBindingsWorkersBindingKindDispatchNamespaceOutboundParamOptional Pass information from the Dispatch Worker to the Outbound Worker through the parameters. Name string Name of the parameter. Link to this property
Link to this property
Worker VersionBindingsWorkersBindingKindDispatchNamespaceOutboundWorkerOptional Outbound worker. Entrypoint stringOptional Entrypoint to invoke on the outbound worker. Link to this property Environment stringOptional Environment of the outbound worker. Link to this property Service stringOptional Name of the outbound worker. Link to this property
Link to this property
Link to this property
Link to this property
type VersionBindingsWorkersBindingKindDurableObjectNamespace struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindDurableObjectNamespaceType The kind of resource that the binding provides. Link to this property ClassName stringOptional The exported class name of the Durable Object. Link to this property DispatchNamespace stringOptional The dispatch namespace the Durable Object script belongs to. Link to this property Environment stringOptional The environment of the script\_name to bind to. Link to this property NamespaceID stringOptional Namespace identifier tag. maxLength32 Link to this property ScriptName stringOptional The script where the Durable Object is defined, if it is external to this Worker. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindHyperdrive struct{…} ID string Identifier of the Hyperdrive connection to bind to. Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindHyperdriveType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindInherit struct{…} Name string The name of the inherited binding. Link to this property Type VersionBindingsWorkersBindingKindInheritType The kind of resource that the binding provides. Link to this property OldName stringOptional The old name of the inherited binding. If set, the binding will be renamed from old_name to name in the new version. If not set, the binding will keep the same name between versions. Link to this property VersionID stringOptional Identifier for the version to inherit the binding from, which can be the version ID or the literal “latest” to inherit from the latest version. Defaults to inheriting the binding from the latest version. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindImages struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindImagesType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindJson struct{…} Json unknown JSON data to use. Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindJsonType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindKVNamespace struct{…} Name string A JavaScript variable name for the binding. Link to this property NamespaceID string Namespace identifier tag. maxLength32 Link to this property Type VersionBindingsWorkersBindingKindKVNamespaceType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindMedia struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindMediaType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindMTLSCertificate struct{…} CertificateID string Identifier of the certificate to bind to. Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindMTLSCertificateType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindPlainText struct{…} Name string A JavaScript variable name for the binding. Link to this property Text string The text value to use. Link to this property Type VersionBindingsWorkersBindingKindPlainTextType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindPipelines struct{…} Name string A JavaScript variable name for the binding. Link to this property Pipeline string Name of the Pipeline to bind to. Link to this property Type VersionBindingsWorkersBindingKindPipelinesType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindK2 struct{…} A K2 stream binding. Available only to accounts enabled for K2. Name string A JavaScript variable name for the binding. Link to this property Stream string ID of a K2 stream owned by the account deploying the Worker. Link to this property Type VersionBindingsWorkersBindingKindK2Type The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindQueue struct{…} Name string A JavaScript variable name for the binding. Link to this property QueueName string Name of the Queue to bind to. Link to this property Type VersionBindingsWorkersBindingKindQueueType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindRatelimit struct{…} Name string A JavaScript variable name for the binding. Link to this property NamespaceID string Identifier of the rate limit namespace to bind to. Link to this property
Simple VersionBindingsWorkersBindingKindRatelimitSimple The rate limit configuration. Limit float64 The limit (requests per period). Link to this property Period int64 The period in seconds. Link to this property MitigationTimeout int64Optional Duration in seconds to apply the mitigation action after the rate limit is exceeded. Valid values are 0 (disabled), 10, or multiples of 60 up to 86400. Must be greater than or equal to the period when non-zero. Link to this property
Link to this property Type VersionBindingsWorkersBindingKindRatelimitType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindR2Bucket struct{…} BucketName string R2 bucket to bind to. Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindR2BucketType The kind of resource that the binding provides. Link to this property
Jurisdiction VersionBindingsWorkersBindingKindR2BucketJurisdictionOptional The jurisdiction of the R2 bucket. One of the following: const VersionBindingsWorkersBindingKindR2BucketJurisdictionEu VersionBindingsWorkersBindingKindR2BucketJurisdiction = "eu" Link to this property const VersionBindingsWorkersBindingKindR2BucketJurisdictionFedramp VersionBindingsWorkersBindingKindR2BucketJurisdiction = "fedramp" Link to this property const VersionBindingsWorkersBindingKindR2BucketJurisdictionFedrampHigh VersionBindingsWorkersBindingKindR2BucketJurisdiction = "fedramp-high" Link to this property const VersionBindingsWorkersBindingKindR2BucketJurisdictionUs VersionBindingsWorkersBindingKindR2BucketJurisdiction = "us" Link to this property
Link to this property
Link to this property
type VersionBindingsWorkersBindingKindSecretText struct{…} Name string A JavaScript variable name for the binding. Link to this property Text string The secret value to use. Link to this property Type VersionBindingsWorkersBindingKindSecretTextType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindSendEmail struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindSendEmailType The kind of resource that the binding provides. Link to this property AllowedDestinationAddresses \[]stringOptional List of allowed destination addresses. Link to this property AllowedSenderAddresses \[]stringOptional List of allowed sender addresses. Link to this property DestinationAddress stringOptional Destination address for the email. formatemail Link to this property
Link to this property
type VersionBindingsWorkersBindingKindService struct{…} Name string A JavaScript variable name for the binding. Link to this property Service string Name of Worker to bind to. Link to this property Type VersionBindingsWorkersBindingKindServiceType The kind of resource that the binding provides. Link to this property Entrypoint stringOptional Entrypoint to invoke on the target Worker. Link to this property Environment stringOptional Optional environment if the Worker utilizes one. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindTextBlob struct{…} Name string A JavaScript variable name for the binding. Link to this property Part string The name of the file containing the text content. Only accepted for service worker syntax Workers. Link to this property DeprecatedType VersionBindingsWorkersBindingKindTextBlobType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindVectorize struct{…} IndexName string Name of the Vectorize index to bind to. Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindVectorizeType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindVersionMetadata struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindVersionMetadataType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindSecretsStoreSecret struct{…} Name string A JavaScript variable name for the binding. Link to this property SecretName string Name of the secret in the store. Link to this property StoreID string ID of the store containing the secret. Link to this property Type VersionBindingsWorkersBindingKindSecretsStoreSecretType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindFlagship struct{…} AppID string ID of the Flagship app to bind to for feature flag evaluation. maxLength128 Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindFlagshipType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindSecretKey struct{…} Algorithm unknown Algorithm-specific key parameters. Learn more. Link to this property
Format VersionBindingsWorkersBindingKindSecretKeyFormat Data format of the key. Learn more. One of the following: const VersionBindingsWorkersBindingKindSecretKeyFormatRaw VersionBindingsWorkersBindingKindSecretKeyFormat = "raw" Link to this property const VersionBindingsWorkersBindingKindSecretKeyFormatPkcs8 VersionBindingsWorkersBindingKindSecretKeyFormat = "pkcs8" Link to this property const VersionBindingsWorkersBindingKindSecretKeyFormatSpki VersionBindingsWorkersBindingKindSecretKeyFormat = "spki" Link to this property const VersionBindingsWorkersBindingKindSecretKeyFormatJwk VersionBindingsWorkersBindingKindSecretKeyFormat = "jwk" Link to this property
Link to this property Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindSecretKeyType The kind of resource that the binding provides. Link to this property
Usages \[]VersionBindingsWorkersBindingKindSecretKeyUsage Allowed operations with the key. Learn more. One of the following: const VersionBindingsWorkersBindingKindSecretKeyUsageEncrypt VersionBindingsWorkersBindingKindSecretKeyUsage = "encrypt" Link to this property const VersionBindingsWorkersBindingKindSecretKeyUsageDecrypt VersionBindingsWorkersBindingKindSecretKeyUsage = "decrypt" Link to this property const VersionBindingsWorkersBindingKindSecretKeyUsageSign VersionBindingsWorkersBindingKindSecretKeyUsage = "sign" Link to this property const VersionBindingsWorkersBindingKindSecretKeyUsageVerify VersionBindingsWorkersBindingKindSecretKeyUsage = "verify" Link to this property const VersionBindingsWorkersBindingKindSecretKeyUsageDeriveKey VersionBindingsWorkersBindingKindSecretKeyUsage = "deriveKey" Link to this property const VersionBindingsWorkersBindingKindSecretKeyUsageDeriveBits VersionBindingsWorkersBindingKindSecretKeyUsage = "deriveBits" Link to this property const VersionBindingsWorkersBindingKindSecretKeyUsageWrapKey VersionBindingsWorkersBindingKindSecretKeyUsage = "wrapKey" Link to this property const VersionBindingsWorkersBindingKindSecretKeyUsageUnwrapKey VersionBindingsWorkersBindingKindSecretKeyUsage = "unwrapKey" Link to this property
Link to this property KeyBase64 stringOptional Base64-encoded key data. Required if format is “raw”, “pkcs8”, or “spki”. Link to this property KeyJwk unknownOptional Key data in JSON Web Key format. Required if format is “jwk”. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindWorkflow struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindWorkflowType The kind of resource that the binding provides. Link to this property WorkflowName string Name of the Workflow to bind to. Link to this property ClassName stringOptional Class name of the Workflow. Should only be provided if the Workflow belongs to this script. Link to this property ScriptName stringOptional Script name that contains the Workflow. If not provided, defaults to this script name. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindWasmModule struct{…} Name string A JavaScript variable name for the binding. Link to this property Part string The name of the file containing the WebAssembly module content. Only accepted for service worker syntax Workers. Link to this property DeprecatedType VersionBindingsWorkersBindingKindWasmModuleType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindVPCService struct{…} Name string A JavaScript variable name for the binding. Link to this property ServiceID string Identifier of the VPC service to bind to. Link to this property Type VersionBindingsWorkersBindingKindVPCServiceType The kind of resource that the binding provides. Link to this property
Link to this property
type VersionBindingsWorkersBindingKindVPCNetwork struct{…} Name string A JavaScript variable name for the binding. Link to this property Type VersionBindingsWorkersBindingKindVPCNetworkType The kind of resource that the binding provides. Link to this property Identity VersionBindingsWorkersBindingKindVPCNetworkIdentityOptional Enables Gateway identity for the binding. Requires network\_id to be “cf1:network” and cannot be combined with tunnel\_id. Link to this property NetworkID stringOptional Identifier of the network to bind to. Only “cf1:network” is currently supported. Mutually exclusive with tunnel\_id. Link to this property TunnelID stringOptional UUID of the Cloudflare Tunnel to bind to. Mutually exclusive with network\_id. Link to this property
Link to this property
Link to this property
CacheOptions VersionCacheOptionsOptional Global CacheW configuration for the Worker. When caching is on, the platform provisions a cloudflare.app zone for the Worker. A type: worker entry in the exports map can override this value for a single entrypoint. Enabled bool Whether caching is enabled for this Worker. Link to this property CrossVersionCache boolOptional Whether cached responses are shared across Worker version uploads. This is independent of enabled. It can stay true while caching is off, so the preference survives turning caching off and back on. Link to this property
Link to this property CompatibilityDate stringOptional Date indicating targeted support in the Workers runtime. Backwards incompatible fixes to the runtime following this date will not affect this Worker. Link to this property CompatibilityFlags \[]stringOptional Flags that enable or disable certain features in the Workers runtime. Used to enable upcoming features or opt in or out of specific changes not included in a compatibility_date. Link to this property
Containers \[]VersionContainerOptional List of containers attached to a Worker. Containers can only be attached to Durable Object classes of this Worker script. ClassName string Select which Durable Object class should get this container attached. Link to this property
Link to this property
Exports map\[string, VersionExport]Optional Declarative exports for the version, including Durable Object classes (with their storage backend) and named Worker entrypoints. On reads, tombstoned lifecycle entries are omitted, so only live exports (created and expecting-transfer) are returned. exports and migrations are mutually exclusive on upload. One of the following:
type VersionExportsWorkersWorkerExport struct{…} A named Worker entrypoint export (type: worker). Worker entrypoints are always live (state: created) and carry no storage or lifecycle fields. The optional cache block overrides the Worker’s global cache_options.enabled for this entrypoint. Type VersionExportsWorkersWorkerExportType Marks this entry as a Worker entrypoint export. Link to this property
Cache VersionExportsWorkersWorkerExportCacheOptional Cache override for this entrypoint. Overrides the Worker’s global cache_options.enabled for this entrypoint only. Enabled bool Whether caching is enabled for this entrypoint. Link to this property
Link to this property State VersionExportsWorkersWorkerExportStateOptional Live export. May be omitted; defaults to created. Link to this property
Link to this property
type VersionExportsWorkersDurableObjectExport struct{…} A live Durable Object export (state: created, the default). The platform auto-provisions the namespace on first deploy, matches it on subsequent deploys, and never mutates or deletes it as a side effect of a code-only change. storage is required; renamed_to, transferred_to and transfer_from are not allowed on a live entry.
Storage VersionExportsWorkersDurableObjectExportStorage Durable Object storage backend. sqlite is the recommended (and only) backend for new namespaces. legacy-kv is accepted only for a class whose namespace already exists as KV-backed; the exports flow never provisions a new legacy-kv namespace. One of the following: const VersionExportsWorkersDurableObjectExportStorageSqlite VersionExportsWorkersDurableObjectExportStorage = "sqlite" Link to this property const VersionExportsWorkersDurableObjectExportStorageLegacyKV VersionExportsWorkersDurableObjectExportStorage = "legacy-kv" Link to this property
Link to this property Type VersionExportsWorkersDurableObjectExportType Marks this entry as a Durable Object export. Link to this property Container stringOptional Name of the container (declared in the upload’s metadata.containers) that backs this Durable Object. When set, the namespace is container-enabled. Valid only on live entries. maxLength128 Link to this property State VersionExportsWorkersDurableObjectExportStateOptional Live export. May be omitted; defaults to created. Link to this property
Link to this property
type VersionExportsWorkersDurableObjectDeletedExport struct{…} A deleted tombstone: retires the provisioned namespace for this class and all of its data. The class must be absent from the uploaded code and no other Worker in the account may bind to the namespace, otherwise the deploy is rejected. No other fields are allowed. Deletion is irreversible. State VersionExportsWorkersDurableObjectDeletedExportState Tombstone that deletes the namespace. Link to this property Type VersionExportsWorkersDurableObjectDeletedExportType Marks this entry as a Durable Object export. Link to this property
Link to this property
type VersionExportsWorkersDurableObjectRenamedExport struct{…} A renamed tombstone: rewrites the provisioned namespace’s class name from this map key to renamed_to. The source class may stay in code during the rollout window (an info notice is emitted). storage, transferred_to and transfer_from are not allowed. RenamedTo string The destination class name. Must differ from the source class (the map key) and must be declared as a live (created) entry in the same exports map. Write-only: never present in GET responses. maxLength128 Link to this property State VersionExportsWorkersDurableObjectRenamedExportState Tombstone that renames the namespace’s class. Link to this property Type VersionExportsWorkersDurableObjectRenamedExportType Marks this entry as a Durable Object export. Link to this property
Link to this property
type VersionExportsWorkersDurableObjectTransferredExport struct{…} A transferred tombstone (source side of a two-phase transfer): hands ownership of the provisioned namespace to another script in the same account, named by transferred_to. The target must have already deployed a matching expecting-transfer entry. The source class may stay in code during the rollout window (an info notice is emitted). storage, renamed_to and transfer_from are not allowed. State VersionExportsWorkersDurableObjectTransferredExportState Tombstone that transfers the namespace to another script. Link to this property TransferredTo string The destination script name. Must be in the same account and the same dispatch-namespace context (or both non-dispatch). Cross-dispatch-namespace transfers are rejected. Write-only: never present in GET responses. maxLength128 Link to this property Type VersionExportsWorkersDurableObjectTransferredExportType Marks this entry as a Durable Object export. Link to this property
Link to this property
type VersionExportsWorkersDurableObjectExpectingTransferExport struct{…} The target side of a two-phase transfer (state: expecting-transfer). Declares that this script expects to receive a namespace for this class from the transfer_from script. This is a live entry, not a tombstone: bindings resolve through the source’s namespace until the source commits with a transferred tombstone. storage and transfer_from are required; renamed_to and transferred_to are not allowed. State VersionExportsWorkersDurableObjectExpectingTransferExportState Target side of a two-phase transfer. Link to this property
Storage VersionExportsWorkersDurableObjectExpectingTransferExportStorage Durable Object storage backend. sqlite is the recommended (and only) backend for new namespaces. legacy-kv is accepted only for a class whose namespace already exists as KV-backed; the exports flow never provisions a new legacy-kv namespace. One of the following: const VersionExportsWorkersDurableObjectExpectingTransferExportStorageSqlite VersionExportsWorkersDurableObjectExpectingTransferExportStorage = "sqlite" Link to this property const VersionExportsWorkersDurableObjectExpectingTransferExportStorageLegacyKV VersionExportsWorkersDurableObjectExpectingTransferExportStorage = "legacy-kv" Link to this property
Link to this property TransferFrom string The source script name to receive the namespace from. Must be in the same account and dispatch-namespace context. Present on reads for expecting-transfer entries. maxLength128 Link to this property Type VersionExportsWorkersDurableObjectExpectingTransferExportType Marks this entry as a Durable Object export. Link to this property Container stringOptional Name of the container (declared in the upload’s metadata.containers) that backs this Durable Object once the transfer settles. Valid only on live entries. maxLength128 Link to this property
Link to this property
Link to this property
ExportsReconciliation VersionExportsReconciliationOptional Summary of the declarative exports reconciliation that ran on this upload. Populated only when the uploaded metadata included an exports block. Durable Object entries drive reconciliation; type: worker entries do not contribute to this summary. Created \[]string Class names for which a new namespace was provisioned. Link to this property Deleted \[]string Class names whose namespace was deleted by a deleted tombstone. Link to this property
Info \[]VersionExportsReconciliationInfo Non-blocking info entries (stale tombstones, tombstone applied with class still in code). See exports_reconciliation_info. Class string The class name the info entry is about. Link to this property Message string Human-readable explanation. Link to this property
Scenario VersionExportsReconciliationInfoScenario Stable, machine-readable tag identifying which reconciliation scenario produced an error, warning, or info entry. Clients may branch on this value instead of parsing message. One of the following: const VersionExportsReconciliationInfoScenarioCodeClassNotInExports VersionExportsReconciliationInfoScenario = "code\_class\_not\_in\_exports" Link to this property const VersionExportsReconciliationInfoScenarioProvisionedClassMissingFromConfig VersionExportsReconciliationInfoScenario = "provisioned\_class\_missing\_from\_config" Link to this property const VersionExportsReconciliationInfoScenarioConfigExportNotInCode VersionExportsReconciliationInfoScenario = "config\_export\_not\_in\_code" Link to this property const VersionExportsReconciliationInfoScenarioConfigReferencesNonexistentClass VersionExportsReconciliationInfoScenario = "config\_references\_nonexistent\_class" Link to this property const VersionExportsReconciliationInfoScenarioOrphanedProvisionedNamespace VersionExportsReconciliationInfoScenario = "orphaned\_provisioned\_namespace" Link to this property const VersionExportsReconciliationInfoScenarioStorageTypeMismatch VersionExportsReconciliationInfoScenario = "storage\_type\_mismatch" Link to this property const VersionExportsReconciliationInfoScenarioFreeTierRequiresSqlite VersionExportsReconciliationInfoScenario = "free\_tier\_requires\_sqlite" Link to this property const VersionExportsReconciliationInfoScenarioInvalidExport VersionExportsReconciliationInfoScenario = "invalid\_export" Link to this property const VersionExportsReconciliationInfoScenarioTombstoneDeleteClassStillInCode VersionExportsReconciliationInfoScenario = "tombstone\_delete\_class\_still\_in\_code" Link to this property const VersionExportsReconciliationInfoScenarioTombstoneDeleteBlockedByExternalBindings VersionExportsReconciliationInfoScenario = "tombstone\_delete\_blocked\_by\_external\_bindings" Link to this property const VersionExportsReconciliationInfoScenarioTombstoneRenamedToOccupied VersionExportsReconciliationInfoScenario = "tombstone\_renamed\_to\_occupied" Link to this property const VersionExportsReconciliationInfoScenarioTransferredPendingNotFound VersionExportsReconciliationInfoScenario = "transferred\_pending\_not\_found" Link to this property const VersionExportsReconciliationInfoScenarioTransferredTargetMissing VersionExportsReconciliationInfoScenario = "transferred\_target\_missing" Link to this property const VersionExportsReconciliationInfoScenarioTransferredTargetMismatch VersionExportsReconciliationInfoScenario = "transferred\_target\_mismatch" Link to this property const VersionExportsReconciliationInfoScenarioPhaseOneTransferSourceMissing VersionExportsReconciliationInfoScenario = "phase\_one\_transfer\_source\_missing" Link to this property const VersionExportsReconciliationInfoScenarioPhaseOneTransferSourceNamespaceMissing VersionExportsReconciliationInfoScenario = "phase\_one\_transfer\_source\_namespace\_missing" Link to this property const VersionExportsReconciliationInfoScenarioPhaseOneTransferTargetClassProvisioned VersionExportsReconciliationInfoScenario = "phase\_one\_transfer\_target\_class\_provisioned" Link to this property const VersionExportsReconciliationInfoScenarioPhaseOneTransferAfterCommitMismatch VersionExportsReconciliationInfoScenario = "phase\_one\_transfer\_after\_commit\_mismatch" Link to this property const VersionExportsReconciliationInfoScenarioPhaseOneTransferDuplicate VersionExportsReconciliationInfoScenario = "phase\_one\_transfer\_duplicate" Link to this property const VersionExportsReconciliationInfoScenarioPhaseOneTransferTargetInDispatchNamespace VersionExportsReconciliationInfoScenario = "phase\_one\_transfer\_target\_in\_dispatch\_namespace" Link to this property const VersionExportsReconciliationInfoScenarioPhaseOneTransferSourceInDispatchNamespace VersionExportsReconciliationInfoScenario = "phase\_one\_transfer\_source\_in\_dispatch\_namespace" Link to this property const VersionExportsReconciliationInfoScenarioTransferredSourceInDispatchNamespace VersionExportsReconciliationInfoScenario = "transferred\_source\_in\_dispatch\_namespace" Link to this property const VersionExportsReconciliationInfoScenarioTransferredTargetInDispatchNamespace VersionExportsReconciliationInfoScenario = "transferred\_target\_in\_dispatch\_namespace" Link to this property const VersionExportsReconciliationInfoScenarioContainerUndeclaredReference VersionExportsReconciliationInfoScenario = "container\_undeclared\_reference" Link to this property const VersionExportsReconciliationInfoScenarioContainerClassNotDurableObject VersionExportsReconciliationInfoScenario = "container\_class\_not\_durable\_object" Link to this property const VersionExportsReconciliationInfoScenarioContainerWiringInconsistent VersionExportsReconciliationInfoScenario = "container\_wiring\_inconsistent" Link to this property const VersionExportsReconciliationInfoScenarioContainerMultipleDurableObjects VersionExportsReconciliationInfoScenario = "container\_multiple\_durable\_objects" Link to this property const VersionExportsReconciliationInfoScenarioTransferContainerParityMismatch VersionExportsReconciliationInfoScenario = "transfer\_container\_parity\_mismatch" Link to this property const VersionExportsReconciliationInfoScenarioTransferContainerParityMismatchOnCommit VersionExportsReconciliationInfoScenario = "transfer\_container\_parity\_mismatch\_on\_commit" Link to this property const VersionExportsReconciliationInfoScenarioTombstoneClassStillInCode VersionExportsReconciliationInfoScenario = "tombstone\_class\_still\_in\_code" Link to this property const VersionExportsReconciliationInfoScenarioStaleTombstone VersionExportsReconciliationInfoScenario = "stale\_tombstone" Link to this property const VersionExportsReconciliationInfoScenarioTransferReceiveAlreadyApplied VersionExportsReconciliationInfoScenario = "transfer\_receive\_already\_applied" Link to this property const VersionExportsReconciliationInfoScenarioTransferReceiveCleanupComplete VersionExportsReconciliationInfoScenario = "transfer\_receive\_cleanup\_complete" Link to this property
Link to this property NamespaceID stringOptional The provisioned namespace the entry relates to, when applicable. formatuuid Link to this property ReferencingScripts \[]stringOptional Other Workers in the account that still bind to the affected class. Advisory: while non-empty the tombstone is not yet safe to remove — redeploy these Workers with bindings re-pointed first. Link to this property
Link to this property RemovableEntries \[]string Source class names whose tombstone entry is now stale and safe to delete from exports (no remaining referencing scripts). Link to this property
Renamed \[]VersionExportsReconciliationRenamed Applied renamed tombstones. From string The original (source) class name. Link to this property To string The new class name (renamed_to). Link to this property
Link to this property
TransferPending \[]VersionExportsReconciliationTransferPending Phase-1 transfer hints recorded on the target side. Class string The target-side class name awaiting transfer. Link to this property From string The source script the namespace will be transferred from. Link to this property
Link to this property
Transferred \[]VersionExportsReconciliationTransferred Committed transferred tombstones (phase-2). Class string The source class name that was transferred. Link to this property Phase VersionExportsReconciliationTransferredPhase The transfer phase. Currently always committed. Link to this property To string The destination script that now owns the namespace. Link to this property
Link to this property Updated \[]string Class names whose provisioned namespace was mutated in place. Link to this property
Warnings \[]VersionExportsReconciliationWarning Non-blocking warnings. See exports_reconciliation_warning. Class string The class name the warning is about. Link to this property Message string Human-readable explanation of the warning. Link to this property
Scenario VersionExportsReconciliationWarningsScenario Stable, machine-readable tag identifying which reconciliation scenario produced an error, warning, or info entry. Clients may branch on this value instead of parsing message. One of the following: const VersionExportsReconciliationWarningsScenarioCodeClassNotInExports VersionExportsReconciliationWarningsScenario = "code\_class\_not\_in\_exports" Link to this property const VersionExportsReconciliationWarningsScenarioProvisionedClassMissingFromConfig VersionExportsReconciliationWarningsScenario = "provisioned\_class\_missing\_from\_config" Link to this property const VersionExportsReconciliationWarningsScenarioConfigExportNotInCode VersionExportsReconciliationWarningsScenario = "config\_export\_not\_in\_code" Link to this property const VersionExportsReconciliationWarningsScenarioConfigReferencesNonexistentClass VersionExportsReconciliationWarningsScenario = "config\_references\_nonexistent\_class" Link to this property const VersionExportsReconciliationWarningsScenarioOrphanedProvisionedNamespace VersionExportsReconciliationWarningsScenario = "orphaned\_provisioned\_namespace" Link to this property const VersionExportsReconciliationWarningsScenarioStorageTypeMismatch VersionExportsReconciliationWarningsScenario = "storage\_type\_mismatch" Link to this property const VersionExportsReconciliationWarningsScenarioFreeTierRequiresSqlite VersionExportsReconciliationWarningsScenario = "free\_tier\_requires\_sqlite" Link to this property const VersionExportsReconciliationWarningsScenarioInvalidExport VersionExportsReconciliationWarningsScenario = "invalid\_export" Link to this property const VersionExportsReconciliationWarningsScenarioTombstoneDeleteClassStillInCode VersionExportsReconciliationWarningsScenario = "tombstone\_delete\_class\_still\_in\_code" Link to this property const VersionExportsReconciliationWarningsScenarioTombstoneDeleteBlockedByExternalBindings VersionExportsReconciliationWarningsScenario = "tombstone\_delete\_blocked\_by\_external\_bindings" Link to this property const VersionExportsReconciliationWarningsScenarioTombstoneRenamedToOccupied VersionExportsReconciliationWarningsScenario = "tombstone\_renamed\_to\_occupied" Link to this property const VersionExportsReconciliationWarningsScenarioTransferredPendingNotFound VersionExportsReconciliationWarningsScenario = "transferred\_pending\_not\_found" Link to this property const VersionExportsReconciliationWarningsScenarioTransferredTargetMissing VersionExportsReconciliationWarningsScenario = "transferred\_target\_missing" Link to this property const VersionExportsReconciliationWarningsScenarioTransferredTargetMismatch VersionExportsReconciliationWarningsScenario = "transferred\_target\_mismatch" Link to this property const VersionExportsReconciliationWarningsScenarioPhaseOneTransferSourceMissing VersionExportsReconciliationWarningsScenario = "phase\_one\_transfer\_source\_missing" Link to this property const VersionExportsReconciliationWarningsScenarioPhaseOneTransferSourceNamespaceMissing VersionExportsReconciliationWarningsScenario = "phase\_one\_transfer\_source\_namespace\_missing" Link to this property const VersionExportsReconciliationWarningsScenarioPhaseOneTransferTargetClassProvisioned VersionExportsReconciliationWarningsScenario = "phase\_one\_transfer\_target\_class\_provisioned" Link to this property const VersionExportsReconciliationWarningsScenarioPhaseOneTransferAfterCommitMismatch VersionExportsReconciliationWarningsScenario = "phase\_one\_transfer\_after\_commit\_mismatch" Link to this property const VersionExportsReconciliationWarningsScenarioPhaseOneTransferDuplicate VersionExportsReconciliationWarningsScenario = "phase\_one\_transfer\_duplicate" Link to this property const VersionExportsReconciliationWarningsScenarioPhaseOneTransferTargetInDispatchNamespace VersionExportsReconciliationWarningsScenario = "phase\_one\_transfer\_target\_in\_dispatch\_namespace" Link to this property const VersionExportsReconciliationWarningsScenarioPhaseOneTransferSourceInDispatchNamespace VersionExportsReconciliationWarningsScenario = "phase\_one\_transfer\_source\_in\_dispatch\_namespace" Link to this property const VersionExportsReconciliationWarningsScenarioTransferredSourceInDispatchNamespace VersionExportsReconciliationWarningsScenario = "transferred\_source\_in\_dispatch\_namespace" Link to this property const VersionExportsReconciliationWarningsScenarioTransferredTargetInDispatchNamespace VersionExportsReconciliationWarningsScenario = "transferred\_target\_in\_dispatch\_namespace" Link to this property const VersionExportsReconciliationWarningsScenarioContainerUndeclaredReference VersionExportsReconciliationWarningsScenario = "container\_undeclared\_reference" Link to this property const VersionExportsReconciliationWarningsScenarioContainerClassNotDurableObject VersionExportsReconciliationWarningsScenario = "container\_class\_not\_durable\_object" Link to this property const VersionExportsReconciliationWarningsScenarioContainerWiringInconsistent VersionExportsReconciliationWarningsScenario = "container\_wiring\_inconsistent" Link to this property const VersionExportsReconciliationWarningsScenarioContainerMultipleDurableObjects VersionExportsReconciliationWarningsScenario = "container\_multiple\_durable\_objects" Link to this property const VersionExportsReconciliationWarningsScenarioTransferContainerParityMismatch VersionExportsReconciliationWarningsScenario = "transfer\_container\_parity\_mismatch" Link to this property const VersionExportsReconciliationWarningsScenarioTransferContainerParityMismatchOnCommit VersionExportsReconciliationWarningsScenario = "transfer\_container\_parity\_mismatch\_on\_commit" Link to this property const VersionExportsReconciliationWarningsScenarioTombstoneClassStillInCode VersionExportsReconciliationWarningsScenario = "tombstone\_class\_still\_in\_code" Link to this property const VersionExportsReconciliationWarningsScenarioStaleTombstone VersionExportsReconciliationWarningsScenario = "stale\_tombstone" Link to this property const VersionExportsReconciliationWarningsScenarioTransferReceiveAlreadyApplied VersionExportsReconciliationWarningsScenario = "transfer\_receive\_already\_applied" Link to this property const VersionExportsReconciliationWarningsScenarioTransferReceiveCleanupComplete VersionExportsReconciliationWarningsScenario = "transfer\_receive\_cleanup\_complete" Link to this property
Link to this property NamespaceID stringOptional The provisioned namespace the warning relates to, when applicable. formatuuid Link to this property
Link to this property
Link to this property
Limits VersionLimitsOptional Resource limits enforced at runtime. CPUMs int64Optional CPU time limit in milliseconds. Link to this property Subrequests int64Optional Subrequest limit per request. Link to this property
Link to this property MainModule stringOptional The name of the main module in the modules array (e.g. the name of the module that exports a fetch handler). Link to this property MigrationTag stringOptional Durable Object migration tag. Set when the version is deployed. Omitted if the version has not been deployed or the Worker does not use Durable Objects. Link to this property
Migrations VersionMigrationsOptional Migrations for Durable Objects associated with the version. Migrations are applied when the version is deployed. One of the following:
type SingleStepMigration struct{…} A single set of migrations to apply. DeletedClasses \[]stringOptional A list of classes to delete Durable Object namespaces from. Link to this property NewClasses \[]stringOptional A list of classes to create Durable Object namespaces from. Link to this property NewSqliteClasses \[]stringOptional A list of classes to create Durable Object namespaces with SQLite from. Link to this property NewTag stringOptional Tag to set as the latest migration tag. Link to this property OldTag stringOptional Tag used to verify against the latest migration tag for this Worker. If they don’t match, the upload is rejected. Link to this property
RenamedClasses \[]SingleStepMigrationRenamedClassOptional A list of classes with Durable Object namespaces that were renamed. From stringOptional Link to this property To stringOptional Link to this property
Link to this property
TransferredClasses \[]SingleStepMigrationTransferredClassOptional A list of transfers for Durable Object namespaces from a different Worker and class to a class defined in this Worker. From stringOptional Link to this property FromScript stringOptional Link to this property To stringOptional Link to this property
Link to this property
Link to this property
type VersionMigrationsWorkersMultipleStepMigrations struct{…} NewTag stringOptional Tag to set as the latest migration tag. Link to this property OldTag stringOptional Tag used to verify against the latest migration tag for this Worker. If they don’t match, the upload is rejected. Link to this property
Steps \[]MigrationStepOptional Migrations to apply in order. DeletedClasses \[]stringOptional A list of classes to delete Durable Object namespaces from. Link to this property NewClasses \[]stringOptional A list of classes to create Durable Object namespaces from. Link to this property NewSqliteClasses \[]stringOptional A list of classes to create Durable Object namespaces with SQLite from. Link to this property
RenamedClasses \[]MigrationStepRenamedClassOptional A list of classes with Durable Object namespaces that were renamed. From stringOptional Link to this property To stringOptional Link to this property
Link to this property
TransferredClasses \[]MigrationStepTransferredClassOptional A list of transfers for Durable Object namespaces from a different Worker and class to a class defined in this Worker. From stringOptional Link to this property FromScript stringOptional Link to this property To stringOptional Link to this property
Link to this property
Link to this property
Link to this property
Link to this property
Modules \[]VersionModuleOptional Code, sourcemaps, and other content used at runtime. This includes _headers and _redirects files used to configure Static Assets. _headers and _redirects files should be included as modules named _headers and _redirects with content type text/plain. ContentBase64 string The base64-encoded module content. formatbyte Link to this property ContentType string The content type of the module. Link to this property Name string The name of the module. Link to this property
Link to this property
PackageDependencies \[]VersionPackageDependencyOptional The list of npm packages that were installed and used when this Worker version was built. InstalledVersion string The exact version that was resolved and installed by the package manager. Link to this property Name string The npm package name. Link to this property PackageJsonVersion string The version constraint as written in package.json. Link to this property
Link to this property
Placement VersionPlacementOptional Configuration for Smart Placement. Specify mode=‘smart’ for Smart Placement, or one of region/hostname/host. One of the following:
type VersionPlacementMode struct{…} Mode VersionPlacementModeMode Enables Smart Placement. Link to this property
Link to this property
type VersionPlacementRegion struct{…} Region string Cloud region for targeted placement in format ‘provider:region’. Link to this property
Link to this property
type VersionPlacementHostname struct{…} Hostname string HTTP hostname for targeted placement. Link to this property
Link to this property
type VersionPlacementHost struct{…} Host string TCP host and port for targeted placement. Link to this property
Link to this property
type VersionPlacementObject struct{…} Mode VersionPlacementObjectMode Targeted placement mode. Link to this property Region string Cloud region for targeted placement in format ‘provider:region’. Link to this property
Link to this property
type VersionPlacementObject struct{…} Hostname string HTTP hostname for targeted placement. Link to this property Mode VersionPlacementObjectMode Targeted placement mode. Link to this property
Link to this property
type VersionPlacementObject struct{…} Host string TCP host and port for targeted placement. Link to this property Mode VersionPlacementObjectMode Targeted placement mode. Link to this property
Link to this property
type VersionPlacementObject struct{…} Mode VersionPlacementObjectMode Targeted placement mode. Link to this property
Target \[]VersionPlacementObjectTarget Array of placement targets (currently limited to single target). One of the following:
type VersionPlacementObjectTargetRegion struct{…} Region string Cloud region in format ‘provider:region’. Link to this property
Link to this property
type VersionPlacementObjectTargetHostname struct{…} Hostname string HTTP hostname for targeted placement. Link to this property
Link to this property
type VersionPlacementObjectTargetHost struct{…} Host string TCP host:port for targeted placement. Link to this property
Link to this property
Link to this property
Link to this property
Link to this property Source stringOptional The client used to create the version. Link to this property StartupTimeMs int64Optional Time in milliseconds spent on Worker startup. Link to this property
DeprecatedUsageModel VersionUsageModelOptional Usage model for the version. One of the following: const VersionUsageModelStandard VersionUsageModel = "standard" Link to this property const VersionUsageModelBundled VersionUsageModel = "bundled" Link to this property const VersionUsageModelUnbound VersionUsageModel = "unbound" Link to this property
Link to this property
[Link to this property](<#(resource)%20workers.beta.workers.versions%20%3E%20(model)%20version%20%3E%20(schema)>)