Skip to main content

On-demand Triggers: Enable user-initiated executions

Learn how to set up and customize on-demand Triggers in Torq Workflows to allow manual Workflow initiation from the Workflow Designer.

Updated today

On-demand Triggers in Torq allow users to manually start Workflows anytime from the Workflow Designer. These Triggers can be customized with parameters to tailor the start event.

Workflows with on-demand Triggers can also be:

  • Exposed in Torq Cases

  • Used as nested Workflows or made into nested-only Workflows

  • Used as Socrates or Agent Tools

Any Workflow descriptions and Trigger parameters you provide should be meaningful as they affect AI outputs. For example, parameter types, names, and descriptions are used by Socrates to determine the Actions it will take.

Set up an on-demand Trigger

  1. Create or modify a workflow: Choose the on-demand Trigger when creating a Workflow on the Build > Workflows page or change an existing Trigger by clicking the replace icon.

  2. Configure Trigger parameters: Customize the Trigger by adding parameters.

    • Type: the type of data. The default is Short text.

    • Name: the name of the parameter

    • (Optional) Description: the description of the parameter

    • (Optional) Default Value: the default value assigned to the parameter

    • Required: Whether the parameters are required or optional

Upload files to be accessed during Workflow execution. The file link generated is secure and private, accessible within Torq using {{file $.event.<parameter_name>}}.

Run and test Workflows

The Exit Operator returns the data to the parent Workflow in the case of nested Workflows, and to the Agent or Socrates when the Workflow is used as a Tool.

  1. Execute a test run: After adding Steps, click Test Run to manually initiate the Workflow.

  2. Use Trigger data: Incorporate event data in Workflow Steps with $.event.<parameter name>.

Share Workflows

  1. Publish the Workflow: Click Publish on the top right.

    1. (Optional) Add a version description to track changes.

    2. (Optional) Add any relevant tags.

    3. (Optional) Modify the TimeBack estimate to record how much time is saved using this Workflow.

    4. Click Publish.

  2. Share the Workflow: Return to the Build > Workflows page, find the relevant Workflow, and click Sharing in the more options menu. This will allow you to share the Workflow and any dependencies with other workspaces.

Resend Trigger events

  1. Open the Event Log: Click the Trigger and select the Event Log tab.

  2. (Optional) Modify the parameters: Click the resend button and then edit the relevant parameters.

  3. Resend the event: Click Execute.

Did this answer your question?