Update Workflow Definitions

The API to update an existing workflow definition.

Input Payload

You can update the workflow definitions directly via UI and using API. The workflow definition include the following parameters:

Attribute	Description
name	Provide a unique name to identify the workflow. This field is mandatory.
description	Include a description to indicate the purpose of the workflow. This field is optional.
version	You can give versions to the workflow to keep track of the changes. By default, the value is 1.
tasks	You can provide the tasks to be executed in the workflow here. If the task type is an operator or a system task, it is handled by the Conductor server. For user-defined/worker tasks, a worker running outside the Conductor environment is required.
inputParameters	Indicates the input values for the workflow.
outputParameters	Indicates the output values of the workflow.
schemaVersion	Indicates the version number of the workflow definition schema.
restartable	Set this value to true to restart a completed workflow. If restarting a completed workflow can impact the functioning, set this value to false.
workflowStatusListenerEnabled	Setting this value to true, archive the workflow when completed. This would remove the workflow definition from the Redis persistence module. To unarchive, set the value to false.
ownerEmail	This field will be auto-populated with the user’s email address.
timeoutSeconds	Time (in seconds), after which the workflow is marked as TIMED_OUT if not completed after transitioning to IN_PROGRESS status for the first time. No timeout occurs if the value is set to 0.
timeoutPolicy	Indicates the condition at which the workflow should time out. It can take any of the following values: TIME_OUT_WF - The workflow status is marked as TIMEOUT and is terminated. ALERT_ONLY - Registers a counter.
failureWorkflow	Provide the workflow name to be triggered upon a failure of the execution of this workflow.

API Endpoint

PUT /api/metadata/workflow

When overwrite is passed to true it will overwrite the existing workflow definitions.

Client SDK Methods

Java

void OrkesMetadataClient.updateWorkflowDefs(List<WorkflowDef> workflowDefs) throws ApiException
void OrkesMetadataClient.updateWorkflowDefs(List<WorkflowDef> workflowDefs, boolean overwrite) throws ApiException

Golang

func (a *MetadataResourceApiService) Update(ctx context.Context, body []model.WorkflowDef) (*http.Response, error)

Python

MetadataResourceApi.update1(body, **kwargs)

CSharp

Object MetadataResourceApi.UpdateWorkflowDefinitions(List<WorkflowDef> body, bool? overwrite = null)

Javascript

MetadataResourceService.update(
    requestBody: Array<WorkflowDef>,
    overwrite: boolean = true,
  ): CancelablePromise<any>

Typescript

MetadataResourceService.update(
    requestBody: Array<WorkflowDef>,
    overwrite: boolean = true,
  ): CancelablePromise<any>

Clojure

(metadata/update-workflows-def options workflows)