Execute a Circuit | Online Help | Qntrl | Circuit

Test/Execute a Circuit

Once you configured your circuit, you have three options:

  • Save: Stores your current configuration without executing or publishing the circuit.

  • Save and Execute: Saves and immediately runs the circuit without publishing. This is typically used for testing purposes.

  • Publish: Saves and publishes the current configuration of the circuit. Every time changes are published, a new circuit version will be generated automatically.

      

Execute a Circuit

Clicking Save and Execute opens a pop-up window with a predefined JSON input.
  1. Provide a name for the execution in the Name field. This name will be used in Execution logs and is useful for tracking, troubleshooting, and auditing. IIf left blank, a name will be auto-generated.
  2. Modify the key-value pairs to suit your testing scenario. The input provided here is validated against the configured schema before execution begins. If the input does not satisfy the defined validation rules, execution will not start.
    For more information on how validation works, see Schema-Driven Data Validation and Protection .
  3. Click Run to initiate the execution.

Once execution begins, you can monitor the progress in real time.

Info
  • Each circuit can have multiple simultaneous executions.

  • Each execution supports up to 1000 state transitions.

  • The lifetime of a circuit execution is limited to 30 days.                                                              


Managing Executions

New Execution: To initiate a new execution, click the New Execution button at the top-right corner of the execution details page.

Run Again: Re-executes the circuit with a new input and the same configuration.

Retry: Re-attempts a failed execution using the same input, resuming from the failed state.

Stop Execution  : If an execution appears stuck or continues to run for a long time, a Stop Execution button will appear. Clicking it will immediately terminate the execution to prevent resource drain.

Notes
Retry is available only for failed executions.                                              




    Next: Execution logs