Cloudflare: Workflows, Workers - Delete Workflow instances individually or in batchesPublicado el 17 de septiembre de 2026Lo cubre Cipher

Cloudflare Workflows: borrar instancias una a una o en lote

Ahora podés eliminar instancias de Workflows y su estado guardado desde la API o Wrangler 4.125.0+, algo que sirve si necesitás liberar almacenamiento o detener ejecuciones activas.

Borrar una instancia con delete()

Llamás a delete() sobre el handle de la instancia para liberar su estado guardado y detener su ejecución actual. Si un Workflow borra su propia instancia, la ejecución se detiene durante el await instance.delete() y el código posterior a esa llamada no corre.

typescript

const instance = await env.MY_WORKFLOW.get("instance-abc");

await instance.delete();

Borrar hasta 100 instancias con deleteBatch()

El binding de Workflow expone deleteBatch() para borrar varias instancias en una sola llamada, hasta 100 IDs por vez. El resultado incluye result.deleted con las entradas { id } de las eliminaciones exitosas y result.errors con los errores por instancia, incluyendo IDs que no existen. Si repetís un ID en la lista, cuenta hacia el límite pero se borra una sola vez, y el resultado se repite para cada posición de entrada.

typescript

const result = await env.MY_WORKFLOW.deleteBatch([

"instance-abc",

"instance-def",

]);

console.log(result.deleted);

console.log(result.errors);

Borrar desde Wrangler

Wrangler acepta IDs de instancia como argumentos posicionales, un archivo con un array JSON de strings en el nivel superior, o ambos, hasta 100 IDs en total. También podés usar latest para borrar la instancia creada más recientemente, o --local para apuntar a una sesión de wrangler dev local.

bash

npx wrangler workflows instances delete my-workflow <INSTANCE_ID>

npx wrangler workflows instances delete my-workflow <INSTANCE_ID> <INSTANCE_ID>

npx wrangler workflows instances delete my-workflow latest

npx wrangler workflows instances delete my-workflow --filename ./instance-ids.json

npx wrangler workflows instances delete my-workflow <INSTANCE_ID> --local

Qué te llevas

delete() borra una instancia y libera su estado; si la instancia se borra a sí misma, el código después del await no ejecuta.
deleteBatch() maneja hasta 100 IDs por llamada y devuelve deleted y errors por separado, incluyendo IDs inexistentes como error.
IDs duplicados en un batch cuentan hacia el límite pero se borran una sola vez.
Wrangler 4.125.0+ soporta borrado por CLI con IDs directos, archivo JSON, latest o --local.

Este resumen lo escribimos a partir de las notas oficiales del release. Lo que no estaba ahí, no está acá.

Anuncio original de Cloudflare

¿Quieres una clase de esto?

Si varias personas lo piden, entra al programa. No hace falta dejar mail ni nombre.