Temporal Signal

Temporal Signal

Certified

Send a signal to a running Temporal workflow

Sends a named signal with optional arguments to an existing workflow execution. The task fails with a clear error if the workflow is not found or has already completed.

yaml
type: io.kestra.plugin.temporal.workflow.Signal

Send an approval signal to a running workflow.

yaml
id: approve_order
namespace: company.team

tasks:
  - id: signal
    type: io.kestra.plugin.temporal.workflow.Signal
    endpoint: "localhost:7233"
    workflowId: "order-{{ inputs.orderId }}"
    signalName: "approve"
    args:
      - '"approved"'
Properties

Temporal server endpoint

Host and port of the Temporal frontend service in host: port format. For Temporal Cloud, use the gRPC endpoint for your namespace, e.g. <namespace>.tmprl.cloud: 7233.

Signal name

Must match the signal handler name registered on the workflow.

Workflow ID

The ID of the workflow execution to signal.

API key for Bearer token authentication

Used with Temporal Cloud. Sent as Authorization: Bearer <apiKey> on every gRPC call; TLS is enabled automatically when this property is set. Mutually exclusive with mTLS properties.

SubTypestring

Signal arguments

List of JSON-encoded argument strings, one per signal parameter.

PEM-encoded CA certificate

Verifies the server certificate. Can be used alone for one-way TLS with a custom CA, or together with clientCert/clientKey for mTLS.

PEM-encoded client certificate

Used in mTLS mode. Must be provided together with clientKey.

PEM-encoded client private key

Used in mTLS mode. Must be provided together with clientCert.

Temporal namespace

Defaults to default. For Temporal Cloud, typically <namespace>.<accountId>.

Reference (ref) of the pluginDefaults to apply to this task.

Run ID

Optional. When omitted, the signal targets the latest open run of the given workflow ID.