Skip to main content

Interface: IStartWorkflowExecutionRequest

workflowservice.v1.IStartWorkflowExecutionRequest

Properties of a StartWorkflowExecutionRequest.

Hierarchy​

Properties​

completionCallbacks​

• Optional completionCallbacks: null | $Properties[]

Callbacks to be called by the server when this workflow reaches a terminal state. If the workflow continues-as-new, these callbacks will be carried over to the new execution. Callback addresses must be whitelisted in the server's dynamic configuration.

Inherited from​

$Properties.completionCallbacks


continuedFailure​

• Optional continuedFailure: null | $Properties

These values will be available as ContinuedFailure and LastCompletionResult in the WorkflowExecutionStarted event and through SDKs. The are currently only used by the server itself (for the schedules feature) and are not intended to be exposed in StartWorkflowExecution.

Inherited from​

$Properties.continuedFailure


cronSchedule​

• Optional cronSchedule: null | string

See https://docs.temporal.io/docs/content/what-is-a-temporal-cron-job/

Inherited from​

$Properties.cronSchedule


eagerWorkerDeploymentOptions​

• Optional eagerWorkerDeploymentOptions: null | $Properties

Deployment Options of the worker who will process the eager task. Passed when request_eager_execution=true.

Inherited from​

$Properties.eagerWorkerDeploymentOptions


• Optional header: null | $Properties

StartWorkflowExecutionRequest header

Inherited from​

$Properties.header


identity​

• Optional identity: null | string

The identity of the client who initiated this request

Inherited from​

$Properties.identity


input​

• Optional input: null | $Properties

Serialized arguments to the workflow. These are passed as arguments to the workflow function.

Inherited from​

$Properties.input


lastCompletionResult​

• Optional lastCompletionResult: null | $Properties

StartWorkflowExecutionRequest lastCompletionResult

Inherited from​

$Properties.lastCompletionResult


• Optional links: null | $Properties[]

Links to be associated with the workflow.

Inherited from​

$Properties.links


memo​

• Optional memo: null | $Properties

StartWorkflowExecutionRequest memo

Inherited from​

$Properties.memo


namespace​

• Optional namespace: null | string

StartWorkflowExecutionRequest namespace

Inherited from​

$Properties.namespace


onConflictOptions​

• Optional onConflictOptions: null | $Properties

Defines actions to be done to the existing running workflow when the conflict policy WORKFLOW_ID_CONFLICT_POLICY_USE_EXISTING is used. If not set (ie., nil value) or set to a empty object (ie., all options with default value), it won't do anything to the existing running workflow. If set, it will add a history event to the running workflow.

Inherited from​

$Properties.onConflictOptions


priority​

• Optional priority: null | $Properties

Priority metadata

Inherited from​

$Properties.priority


requestEagerExecution​

• Optional requestEagerExecution: null | boolean

Request to get the first workflow task inline in the response bypassing matching service and worker polling. If set to true the caller is expected to have a worker available and capable of processing the task. The returned task will be marked as started and is expected to be completed by the specified workflow_task_timeout.

Inherited from​

$Properties.requestEagerExecution


requestId​

• Optional requestId: null | string

A unique identifier for this start request. Typically UUIDv4.

Inherited from​

$Properties.requestId


retryPolicy​

• Optional retryPolicy: null | $Properties

The retry policy for the workflow. Will never exceed workflow_execution_timeout.

Inherited from​

$Properties.retryPolicy


searchAttributes​

• Optional searchAttributes: null | $Properties

StartWorkflowExecutionRequest searchAttributes

Inherited from​

$Properties.searchAttributes


taskQueue​

• Optional taskQueue: null | $Properties

StartWorkflowExecutionRequest taskQueue

Inherited from​

$Properties.taskQueue


timeSkippingConfig​

• Optional timeSkippingConfig: null | $Properties

Time-skipping configuration. If not set, time skipping is disabled.

Inherited from​

$Properties.timeSkippingConfig


userMetadata​

• Optional userMetadata: null | $Properties

Metadata on the workflow if it is started. This is carried over to the WorkflowExecutionInfo for use by user interfaces to display the fixed as-of-start summary and details of the workflow.

Inherited from​

$Properties.userMetadata


versioningOverride​

• Optional versioningOverride: null | $Properties

If set, takes precedence over the Versioning Behavior sent by the SDK on Workflow Task completion. To unset the override after the workflow is running, use UpdateWorkflowExecutionOptions.

Inherited from​

$Properties.versioningOverride


workflowExecutionTimeout​

• Optional workflowExecutionTimeout: null | $Properties

Total workflow execution timeout including retries and continue as new.

Inherited from​

$Properties.workflowExecutionTimeout


workflowId​

• Optional workflowId: null | string

StartWorkflowExecutionRequest workflowId

Inherited from​

$Properties.workflowId


workflowIdConflictPolicy​

• Optional workflowIdConflictPolicy: null | WorkflowIdConflictPolicy

Defines how to resolve a workflow id conflict with a running workflow. The default policy is WORKFLOW_ID_CONFLICT_POLICY_FAIL.

See workflow_id_reuse_policy for handling a workflow id duplication with a closed workflow.

Inherited from​

$Properties.workflowIdConflictPolicy


workflowIdReusePolicy​

• Optional workflowIdReusePolicy: null | WorkflowIdReusePolicy

Defines whether to allow re-using the workflow id from a previously closed workflow. The default policy is WORKFLOW_ID_REUSE_POLICY_ALLOW_DUPLICATE.

See workflow_id_conflict_policy for handling a workflow id duplication with a running workflow.

Inherited from​

$Properties.workflowIdReusePolicy


workflowRunTimeout​

• Optional workflowRunTimeout: null | $Properties

Timeout of a single workflow run.

Inherited from​

$Properties.workflowRunTimeout


workflowStartDelay​

• Optional workflowStartDelay: null | $Properties

Time to wait before making the first workflow task available for dispatch. Cannot be used with cron_schedule. If the workflow gets a signal before the delay, a workflow task will be made available for dispatch and the rest of the delay will be ignored.

Inherited from​

$Properties.workflowStartDelay


workflowTaskTimeout​

• Optional workflowTaskTimeout: null | $Properties

Timeout of a single workflow task.

Inherited from​

$Properties.workflowTaskTimeout


workflowType​

• Optional workflowType: null | $Properties

StartWorkflowExecutionRequest workflowType

Inherited from​

$Properties.workflowType