Document

Run Published Workflows

A published run executes the workflow version currently marked Published. It starts from a live trigger, records a separate run ID, and remains tied to the workflow definition accepted at the start of that run. Saving or testing a newer draft does not change the live version.

This article uses the Documentation - Published Runs pipeline in the Hack It UP - event project.

Confirm the published version

Open the pipeline in Designer and use the version selector to identify the entry marked Published. Selecting that version displays Public version is read-only.

The published v1 selected as the read-only public workflow versionThe published v1 selected as the read-only public workflow version

Before sending live input:

  1. Confirm the project and pipeline in the breadcrumb.
  2. Check the sequential version number and descriptive version name.
  3. Verify that the intended entry carries the Published label.
  4. Review the live trigger configuration from that published version.

Do not use the selected version alone as evidence. An editable draft can be selected while another entry remains published.

Start a published run

A live trigger starts the published workflow when it accepts its corresponding event. The way you create that event depends on the trigger.

Trigger pathRequired setupHow to start the published run
Manual TriggerNo integrationOpen the pipeline's Runs view and use Trigger run.
Endpoint TriggerNo integration; configure the endpoint authorizationSend a request to the generated URL with the configured method, authorization, headers, and body.
Web Form TriggerNo integrationSubmit the hosted form URL.
Chat TriggerNo integrationSend a controlled message through the published chat URL.
Cron TriggerNo integrationWait for the configured schedule.
EmailEmail integration with inbox access, such as Gmail, Outlook, or IMAPDeliver a controlled message to the monitored mailbox, folder, or label.
Slack MessageSlack integration receiving message eventsSend a controlled message through the connected Slack workspace.
Twilio SMSTwilio SMS integration receiving webhooksSend an SMS to the connected Twilio number.
Signal MessageSignal bridge integration receiving messagesSend a controlled message through the connected Signal bridge.
Microsoft Teams MessageMicrosoft Teams integration receiving subscriptionsSend a controlled message in the subscribed Teams context.
WhatsApp Business MessageWhatsApp Business integration with its webhook configured in MetaSend a controlled message to the connected WhatsApp Business account.
Queue MessageRabbitMQ, ActiveMQ, Amazon SQS, or Amazon SNS integrationPublish a controlled message to the configured queue or topic.
Issue EventJira, GitHub, or GitLab issue-tracker integration receiving eventsCreate or update an issue that matches the configured event, label, author, and text filters.

An integration trigger is available only when its compatible integration is configured and accessible in the project's personal or team ownership scope. Configure the provider's webhook, subscription, inbox, or queue permissions before publishing, then generate one controlled event in that external service.

The Run action on a trigger block in Designer creates a test run of the selected saved version. It is not a substitute for verifying the live entry point.

For an Endpoint Trigger, confirm the HTTP method, custom path, generated URL, authorization mode, and synchronous or asynchronous behavior. Keep protected tokens outside screenshots, documentation, source control, and request logs.

A protected asynchronous endpoint configured as the live workflow entry pointA protected asynchronous endpoint configured as the live workflow entry point

Use a small, recognizable payload that is safe to process. For a protected endpoint, include its current authorization token through the required client configuration. A successful asynchronous response can contain triggered: true and a runId. This confirms that Builders accepted the request; it does not confirm that downstream blocks completed successfully.

Follow an active run

Open Runs from Designer or the pipeline actions. Select Running to isolate executions that have not reached a terminal state.

The Running filter showing an active live endpoint executionThe Running filter showing an active live endpoint execution

Use the row to correlate:

  • Pipeline with the workflow that accepted the event;
  • Started with the trigger request or external event time;
  • Run ID with the identifier returned by the trigger, when available;
  • Cost with compute tokens consumed so far;
  • Test with the execution context.

A live run does not carry the test marker shown for Designer tests. Do not infer success from an empty Test column; it identifies context, not outcome.

Each accepted event creates its own run. Several rows can be active at the same time until the project or owner reaches its applicable concurrent-run limit. Check the trigger response and the Running filter when traffic is accepted slowly or rejected. A row can initially show only the trigger cost while downstream work is still pending.

Inspect the completed run

Select All or Completed, find the run by ID, and open Logs from its Actions column. The run inspector identifies the project and pipeline, the run UUID, start and finish times, final status, total cost, and every recorded block execution.

A completed live run located by its run ID in the pipeline historyA completed live run located by its run ID in the pipeline history

A successful published run with the live workflow path shown block by blockA successful published run with the live workflow path shown block by block

Read the execution path from top to bottom:

  1. Confirm that the expected trigger created the run.
  2. Check that every required block reached success.
  3. Select individual executions and inspect their runtime messages.
  4. Compare the final effect with the business result you expected.
  5. Keep the run UUID when the event must be correlated with an external system.

The trigger's accepted response and the run's final status answer different questions. The response confirms admission; the completed run shows whether the workflow finished. A success status also does not replace verification of an external effect such as a delivered message or stored record.

Identify the exact workflow version

The run list identifies the project, pipeline, trigger context, time, and run ID, but it may not display the version number directly. Add runtime metadata to an audit record when exact version attribution is required:

Runtime valueUse
{{run.id}}Store the Builders run identifier.
{{run.pipelineVersionId}}Store the immutable version identifier.
{{run.pipelineVersionNumber}}Store the sequential version number, such as 1.
{{run.triggerType}}Record which trigger type started the run.
{{run.isTest}}Distinguish a Designer test from a published execution.
{{run.correlationId}}Correlate related execution data when the workflow uses it.

Write this metadata to the same database row, event, or log entry as the workflow's business identifier. The run inspector then provides the block-level execution details, while the stored metadata identifies the exact release that produced the result.

Keep draft changes isolated

After publication, create a new version for further work. The version selector can show an editable v2 while v1 remains marked Published.

An editable v2 draft with a changed block while v1 remains publishedAn editable v2 draft with a changed block while v1 remains published

In the example, the draft changes Queue Live Registration to Queue Live Registration - Draft and shortens its delay. A later live endpoint request still executes the original Queue Live Registration block because v1, not v2, remains published.

The same isolation applies after a run starts. Publishing a replacement version affects newly accepted events; it does not rewrite the workflow definition of an execution already in progress. Unpublishing also does not cancel active runs.

Use this release sequence for changes:

  1. Create and save a new version.
  2. Test the draft from every relevant trigger path.
  3. Publish the verified version.
  4. Send one controlled event through the real live trigger.
  5. Inspect the new run and its external result.
  6. Keep or roll back the release according to the observed behavior.

Troubleshoot missing or delayed runs

  • No run appears: confirm that the workflow is published and that the event reached the URL, schedule, form, or connected service configured in the published version.
  • The trigger rejects the event: check authorization, payload validation, compute-token balance, concurrent-run availability, and the exact response returned to the caller.
  • A run remains active: open its logs, identify the running block, and check timeouts or the availability of the external dependency.
  • The run uses older behavior: reopen the version selector and verify which version carries Published. Saving a draft does not release it.
  • The trigger accepted the event but work failed: find the returned run ID and inspect the first failed block. Acceptance is not completion.
  • The row is marked as a test: reproduce the event through the live trigger rather than the Designer's block-level Run action.

Next steps

Boilerplate Wiki - Run Published Workflows