Clarify Workers version upload preservation semantics for omitted metadata · Issue #34188 · cloudflare/cloudflare-docs · GitHub
Skip to content

Clarify Workers version upload preservation semantics for omitted metadata #34188

Open

Description

@caothanhbkz43-pixel

Existing documentation URL(s)

What changes are you suggesting?

Please clarify the documented server behavior of POST /accounts/{id}/workers/scripts/{name}/versions when the following metadata is omitted:

  1. migrations / migration_tag
  2. limits.cpu_ms
  3. tail_consumers

Are existing settings preserved, reset, or resolved from another version? If inherited, is the source the latest uploaded version or the currently deployed version?

The multipart metadata documentation excludes migrations and tail_consumers from version uploads, while Wrangler may serialize configured tail consumers. Please clarify the authoritative behavior.

Also, is a version upload safe to retry after a network timeout or lost response? Is there a documented idempotency guarantee?

We request documentation clarification only. No production testing is proposed.

Additional information

No response

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions