Automated Workflows

The Automated Workflows API and Service allows you to register actions, register triggers and send triggers. An Automated Workflow in Relativity is composed of one trigger and multiple actions.

This page contains the following information:

Automated Workflows changelog

Fundamentals of Automated Workflows

An Automated Workflow is composed of one trigger and multiple actions.


Think of a trigger as an Event that a workflow is listening to, to start its execution.

Types of Trigger:

  • Manual Trigger: a trigger that can only start a workflow manually with the press of a button. (The types listed below can also be manually triggered).
  • Event Trigger: A trigger that listens for an event or trigger to happen, to start the workflow.
  • Scheduled Trigger: A trigger that starts a workflow periodically, such as daily, monthly, weekly, or hourly.


An action is an operation that a workflow should perform. Actions are executed from top to bottom. Actions and triggers can have parameters (called inputs in the Automated Workflows API).

Actions can report statuses to the workflow they are running from. The statuses are:

  • Not Run
  • Pending
  • In Progress
  • Completed
  • Completed with Errors
  • Failed
  • Canceled

Some of these statuses are affected by user interaction: For instance a cancellation of a workflow done by a user will render the status of the action as "Canceled". Some are based on a success or failure of calling an API defined in the action: For instance a Completed with Errors status received as the response of an API call will render the action as "Completed with Errors".

Troubleshooting information

Some troubleshooting tips for working with Automated Workflows programmatically.

  • Event Handlers do not benefit from the built-in IoC container registration that a Relativity Kepler does. You need to either create your own registration for the Event Handler or manually create the dependencies for it.
  • When reusing code in between a Kepler Service and an Event Handler, you may see install errors in the event handler not being able to find the class, or the instance being null.
  • the "x-csrf-header" header is required for Kepler Calls. Use a "-" as its value.
  • Take precautions to avoid circular dependencies with triggering Workflows

Current Automated Workflows API content


REST services