Skip to content
Search
See the whole radar
Cloudflare: Workflows, Workers - Delete Workflow instances individually or in batchesCovered by 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

What you get

  • 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.

We wrote this summary from the official release notes. What wasn't there isn't here.

Original announcement from Cloudflare

Want a class on this?

If enough people ask for it, it goes on the schedule. No email, no name needed.