You can trigger the start of the workflow from the main one via workers bindings, but if you want tr

You can trigger the start of the workflow from the main one via workers bindings, but if you want true separation of concerns, why not use a queue? You can push a message to start the next one or use https://developers.cloudflare.com/reference-architecture/diagrams/storage/event-notifications-for-storage/

Cloudflare Docs

Event notifications for storage

Use Cloudflare Workers or an external service to monitor for notifications about data changes and then handle them appropriately.

PPhoenixSpace You can trigger the start of the workflow from the main one via workers bindings...

stephen•11/6/25, 5:11 PM

Thanks! This is why I asked.

I'll look into Queues.

Sstephen I need architecture / design guidance on my Workflow. I have my MAIN workflow w...

Matt Silverlock•11/6/25, 10:06 PM

You can also just... call the other Workflow. Call it, and if it successfully starts, that's it. Your "main" Workflow instance won't be blocked.

Sstephen I need architecture / design guidance on my Workflow. I have my MAIN workflow w...

Matt Silverlock•11/6/25, 10:07 PM

await step.do("kick off next workflow", {
    return await env.WORKFLOW.create(...)
})

await step.do("kick off next workflow", {
    return await env.WORKFLOW.create(...)
})

There's nothing special here. If the other workflow fails to start, it'll fail the step — just like any other API call — and invoke your retry logic. If it starts, it'll return the instance data and the step will be successful.

confusionprevails•11/7/25, 12:07 PM

is the workflow API docs site down?
https://developers.cloudflare.com/api/resources/workflows/methods/list/

confusionprevails•11/7/25, 12:12 PM

Another question -- where do i see logs for workflows, eg any logging that workflow does, how do i see those logs?

scook•11/8/25, 6:36 PM

I had a workflow that failed in production with nothing more than

internal error

internal error

. It shows "Errored" in the dashboard. Is there any more investigation I can do to know what happened? Instance: bd1a0c85-6f10-451d-a91b-ee229909d0a6

HK•11/8/25, 7:12 PM

how can I deploy a workflow in a nextjs or tanstack start wrangler project? where do I export the workflow class. workflows needs to be exported in a

src/index.ts

src/index.ts

Levi•11/11/25, 1:50 PM

Is there a recommended way to have a conditional step in a workflow? It seems like an "if" outside of a step, causes an error even if the workflow completes successfully. I'm wanting to pull a config from the KV store, so I can toggle steps on/off without having to deploy code. Should I put the conditional inside a step?

.r20•11/13/25, 10:12 PM

For workflows when I try and copy the output for a given step it says [truncated output] at the end is there any way to get the full output

ajay | dreamlit.ai•11/13/25, 11:00 PM

Hey @avenceslau something odd happened with this workflow with the SLEEP step functionality.

1- most obvious error artificat is that there appears to be 5 "wait" steps still "RUNNING" for this workflow instance
2- this workflow was supposed to run over 7 days (with 1 day wait in between each). Yet it seems to have accelerated and run in 1 day.

I double checked and we are awaitawaiting the

step.sleep

step.sleep

and we did not touch the sleep step name. Any idea on what happened here?

(link to workflow instance: https://dash.cloudflare.com/470d4729e23e8936fd2a8f6569770873/workers/workflows/trigger-workflow/instance/f70d8594-01c1-4a4c-8722-e6ace1ea29af)

Need_Not•11/14/25, 5:18 AM

How do you delete a WF instance? I have a workflow for when a user deletes their account. If the user changes their mind I can terminate it but does that get rid of the instance? If the same user goes to delete their account again I need to make a new WF with the same ID

Need_Not•11/14/25, 5:19 AM

I currently have an errored out WF and am unable to use the same ID on a new one since I can't find how to delete the old one.

Need_Not•11/14/25, 5:29 AM

of course maybe the id is supposed to be forever unique in that case how am i supposed to easily find the instance again when needed? i could store a KV but something could go wrong there too. and I would NOT want two workflows for the same user running at the same time.

NNeed_Not of course maybe the id is supposed to be forever unique in that case how am i su...

1984 Ford Laser•11/14/25, 6:38 AM

You'd wanna associate the workflow ID with the user ID in your backend somehow

11984 Ford Laser You'd wanna associate the workflow ID with the user ID in your backend somehow

Need_Not•11/14/25, 6:40 AM

correct. But i can't just put the userId as the id since i can't make another. Since I have an updatedAt field on the user i could maybe put the userId+updatedAt but can still have problems

Need_Not•11/14/25, 6:40 AM

You can't list and filter can you?

1984 Ford Laser•11/14/25, 6:42 AM

Just make a new Workflow, then save the new ID in the user's config/storage whatever

Need_Not•11/14/25, 6:49 AM

ohh yeah since i've already put a timestamp on the user for when it's going to be deleted. pass that same timestamp in the id and params. and when executing if the timestamp doesn't match just terminate

Need_Not•11/14/25, 6:51 AM

No risk of deletion since canceling the deletion would set the timestamp to null and the sql query wont delete if it's null. But the workflow sends out emails so i didn't want multiple workflows possibly spamming someone from multiple workflows and for an account that isn't going to be deleted.

Quantum64•11/14/25, 6:59 PM

why do some of my workflow instances not record their cpu time?

woops•11/14/25, 7:03 PM

Hey guys, I'm running into a persistent issue where workers report typical wall time (200ms) but my client-side ends up taking around 5-6s and timing out. Haven't been able to reproduce consistently but run into this problem every single day basically.

Here's an example of what I've logged from one of these faulty requests:

Wall time (233ms)
Request from upstream provider (LLM Inference) - (181ms)

Client-Side

While connecting

summary | reused:0 proto:h3 dns:1ms tcp:118ms tls:117ms server:2918ms total:3154ms
-> Reused indicates if this was a previously open connection.

While receiving
->

Total Time for Server Response: 3156ms

woops•11/14/25, 7:06 PM

Is wall time source of truth for when CFW returns the request?

ByteBeast•11/17/25, 5:22 AM

Hey everyone!
I'm using sleepUntil in my workflow, but when the end time is reached, the entire workflow restarts instead of resuming from the sleep step. Because of this, the sleepUntil action never completes or fails. As a result, my code detects that the step is still pending and triggers sleepUntil again, causing it to re-execute continuously.

ByteBeast•11/17/25, 6:24 AM

I also noticed that this issue only happens when the sleep duration is long, while short sleep periods work perfectly fine.

Has anyone encountered this behavior or knows why it might be happening?

d3v1an7•11/17/25, 6:59 AM

Hey all! Does a workflow that is currently in a waitForEventwaitForEvent state count towards the concurrent instances limit? And out of interest, does a workflow in this state have any active compute for listening?

Ondreian•11/17/25, 4:04 PM

I have been messing with Workflows for a week or so for ETL and the limits feel incredibly hard to deal with, specifically the 1k sub requests. Sure I could implement some complex job splitting, but it just feels like a lot of juggling and a really rough DevEx. For example, let's say you have a JSON file with a few thousand records in it you want to import into your D1 instance you're going to hit the limits almost immediately and this isn't really a "lot of work" for production.
Am I missing something here? It seems to basically only really be a viable tool for trickle emails and other short, simple workflows.

Ondreian•11/17/25, 4:06 PM

fan-out, fan-in doesn't really seem to be supported because if you start scheduling sub-workflows you will just hit the limit then as well in your orchestrator.

OOndreian I have been messing with Workflows for a week or so for ETL and the limits feel ...

xvvvyz•11/17/25, 4:16 PM

my solution to this was to pass the work off to a container.

Xxvvvyz my solution to this was to pass the work off to a container.

Ondreian•11/17/25, 4:23 PM

When you say "the work" do you mean basically every step.dostep.do call or just some sort of top-level orchestration that would kick off smaller workflows? If you mean all of step.dostep.do calls, what value is wrapping it in a workflow even adding then since you lose all of the Workflow APIs inside of the Container where the processing is being done?

xvvvyz•11/17/25, 4:26 PM

only step in my workflow has too many sub requests.

xvvvyz•11/17/25, 4:27 PM

actually now that I think of it do container requests count towards sub requests?

Ondreian•11/17/25, 4:33 PM

I don't think the rate limiter counts them as a tree, but as direct subrequests from the Workflow

xvvvyz•11/17/25, 4:37 PM

anyway this is specifically what I do on the step that would hit the limit

await step.do("generate images", async () => {
  void containerFetch(this.env, "/pdf-to-images", {
    document_id: document.id,
    file: pdf,
    workflow_id: event.instanceId,
  });
});

if (!hasLastPageImage) {
  await step.waitForEvent("images generated", {
    timeout: "1 hour",
    type: WorkflowEventType.ImagesGenerated,
  });
}

await step.do("generate images", async () => {
  void containerFetch(this.env, "/pdf-to-images", {
    document_id: document.id,
    file: pdf,
    workflow_id: event.instanceId,
  });
});

if (!hasLastPageImage) {
  await step.waitForEvent("images generated", {
    timeout: "1 hour",
    type: WorkflowEventType.ImagesGenerated,
  });
}

xvvvyz•11/17/25, 4:38 PM

since it has to upload images one by one to r2

Ondreian•11/17/25, 4:52 PM

I guess that's a viable work around. If I am evaluating that though, it's still weirdly complex and developer hostile to require that for kind of basic "workflow" operations. I would have expected that was something you could easily handle in the Workflow declaratively. The whole point of a Workflow is to let you break down complex tasks into simple, repeatable processes, not create a lot of odd architectural dependencies. What happens if you re-deploy the container in the middle of a long workflow run? Feels like it allows some weirdly potentially, non-deterministic designs to become common place. Basically now you'll need some sort of mutex deployment for your Container to make sure you don't break any in-flight work with that, or I guess a transaction system.

xvvvyz•11/17/25, 5:00 PM

you're not wrong!

xvvvyz•11/17/25, 5:01 PM

don't think it's the best but at a certain point I need to ship something (:

Ondreian•11/17/25, 5:08 PM

Not a critique of your workaround at all, as you said, you needed to ship something. Just kind of an odd choice for Cloudflare to design Workflows in a manner that doesn't really let you get too far without pulling in a lot of complexity. I guess I will just go back to my basic Queue processor fan-out strategy, it felt weird because of the lack of observability but as you've kindly advised, I don't really seem to have any other option

Ondreian•11/17/25, 5:08 PM

i very much appreciate that you ran into the same problem and had to come up with a similar sort of workaround for it, that assures me I am not just missing some glaringly obvious thing in the docs

James•11/17/25, 8:45 PM

I find workflows not great if you can't work well within its bounds. I ended up creating my own fan-out/fan-in task mgmt system w queues and a simple workflow type tracking table. A lot more flexibility for a couple days work in building an orchestrator of my own.
For mass job creation, I had to do something similar and build out a meta-handler for managing sub requests. Once I had that working, I just left it in the background and the queue mgmt is handled. I guess it's not the ideal DX, but at the same time, I prefer local control over beta-magic.

OOndreian I guess that's a viable work around. If I am evaluating that though, it's still ...

1984 Ford Laser•11/17/25, 8:55 PM

Queues might be more suited to what you're trying to do?

ByteBeast•11/18/25, 6:24 AM

do anyone have any idea about after I execute sleep until for long period of time, how much time cloudflare takes to be in hibernation mode?

OOndreian I have been messing with Workflows for a week or so for ETL and the limits feel ...

Deltachaos•11/18/25, 2:23 PM

Yes this is something i have experienced as well. I am working around this by having abstracted away the actual workflow stuff and now I am building "steps" in away that they can ether be messages in a queue or newly dispatched workflows as both get fresh limits. I dont know exactly how the steps stuff is implemented, but in my opinion the limits should apply on a per step basis, instead of on a per workflow basis

kleinpetr•11/18/25, 8:07 PM

Hi I would like to understand the lifecycle of workflow, I am trying to replace cron by workflow, so I've done something like

run(){
while(true){
  await step.do(...)

  await step.sleep(5 min)
}
}

run(){
while(true){
  await step.do(...)

  await step.sleep(5 min)
}
}

locally it seems to work, but on remote I am getting internal error without any message or log. So I am wondering if it's possible to do it that way.

also I am experiencing another internal error while I am trying to restart instance. So I am not sure if it depends on my approach or workflows are just like beta..

kleinpetr•11/18/25, 10:44 PM

I am trying to end up workflow with custom error, so I used NonRetryableError NonRetryableError outside of step, but the the message was not used as an error.

Aiden•11/18/25, 11:09 PM

Is there a way to redact values from the step output, so that it doesn't appear in the Workflow logs (workflows/example-workflow/instance/runIDworkflows/example-workflow/instance/runID)? We have a step that passes API keys to another step, and it's all logged in the workflow runs... which isn't ideal.

kleinpetr•11/21/25, 9:10 AM

Just to be sure — there is no way to restart() only a specific step in a workflow, right?

I'm asking because I'm thinking about idempotency. For example, in the official example for sending an invoice after payment creation (https://developers.cloudflare.com/workflows/examples/send-invoices/)

If the email step fails, the entire workflow ends up in an errored state. If I still want to deliver that email, it seems like there’s no option to retry just that failed step.

Within a standard Queue, this would normally end up in a DLQ, and I could re-post all failed email events later.

Is there any equivalent approach in Workflows? I’m trying to understand the right mental model for handling retries or partial failures. Thanks

Paul•11/21/25, 3:36 PM

I am able to use email catch all, but sending seems to be problematic, just want to verify is email SENDING different from receiving in terms of permissions, like does the sending require a private beta? If so, how can I request access? Thanks

PPaul I am able to use email catch all, but sending seems to be problematic, just want...

Paul•11/21/25, 3:53 PM

Also if anyone can share specific valid example how to configure a worker to have a EMAIL binding in toml config file, I've tried like 20 different patterns, can't figure it out, which leads me to wonder if there is a private beta somewhere?

I keep seeing in my cloudlfare logs:

"logs": [
{
"message": [
"EMAIL binding is not configured in wrangler.toml"
],
"level": "error",
"timestamp": 1763740274632
}

You can trigger the start of the workflow from the main one via workers bindings, but if you want tr

Similar Threads

Similar Threads

Similar Threads