InvokeLambdaFunction

typed block

Invokes an AWS Lambda function with a collection of optional parameters. This AWS Lambda function is also given a copy of the flow run data if there is an associated contact with the flow.

Factories

InvokeLambdaFunction

InvokeLambdaFunction() -> InvokeLambdaFunctionHandle

Construct a fresh InvokeLambdaFunction block with an auto-generated id.

Use this when authoring from scratch, the runtime picks a UUID automatically.

InvokeLambdaFunction

InvokeLambdaFunction(id: String) -> InvokeLambdaFunctionHandle

Construct a InvokeLambdaFunction block with an operator-supplied id.

ParameterTypeRequiredDescription
idStringyesWire identifier, typically a Connect UUID restored by decompile so round-trips stay byte-stable.

Methods

lambda_function_arn

lambda_function_arn(value: String) -> InvokeLambdaFunctionHandle

Set the LambdaFunctionARN parameter. The ARN of the AWS Lambda function to be invoked. May be defined statically or dynamically. Measured 2026-10-14: Connect accepts any non-empty string here, an ARN, a JSONPath or neither, and a number; it refuses the empty string, a boolean, an object and an array.

ParameterTypeRequiredDescription
valueStringyesThe ARN of the AWS Lambda function to be invoked. May be defined statically or dynamically. Measured 2026-10-14: Connect accepts any non-empty string here, an ARN, a JSONPath or neither, and a number; it refuses the empty string, a boolean, an object and an array.

invocation_time_limit_seconds

invocation_time_limit_seconds(value: i64) -> InvokeLambdaFunctionHandle

Set the InvocationTimeLimitSeconds parameter. The number of seconds to wait for a response from the AWS Lambda function. Measured 2026-10-14: Connect accepts a whole number from 1 to 8 as a JSON integer or a string ("05", "+5"), and refuses "9", "0", "5.5", 6.0, " 5" and every JSONPath.

ParameterTypeRequiredDescription
valuei64yesThe number of seconds to wait for a response from the AWS Lambda function. Measured 2026-10-14: Connect accepts a whole number from 1 to 8 as a JSON integer or a string ("05", "+5"), and refuses "9", "0", "5.5", 6.0, " 5" and every JSONPath.

invocation_type

invocation_type(value?: InvocationType) -> InvokeLambdaFunctionHandle

Set the InvocationType parameter. Specifies the invocation type, allowed values: "SYNCHRONOUS" | "ASYNCHRONOUS".

ParameterTypeRequiredDescription
valueInvocationTypenoSpecifies the invocation type, allowed values: "SYNCHRONOUS" | "ASYNCHRONOUS".

lambda_invocation_attributes

lambda_invocation_attributes(value?: Map<String, String>) -> InvokeLambdaFunctionHandle

Set the LambdaInvocationAttributes parameter. A map of additional data to send to the AWS Lambda function when invoking it. Keys and values may be set statically or dynamically.

ParameterTypeRequiredDescription
valueMap<String, String>noA map of additional data to send to the AWS Lambda function when invoking it. Keys and values may be set statically or dynamically.

response_validation

response_validation(value?: Map (ResponseValidation)) -> InvokeLambdaFunctionHandle

Set the ResponseValidation parameter.

ParameterTypeRequiredDescription
valueMap (ResponseValidation)no

next

next(target: Handle) -> InvokeLambdaFunctionHandle

Wire the success-path transition. Substitutes the target's auto-generated UUID into the wire Transitions.NextAction slot.

ParameterTypeRequiredDescription
targetHandleyesThe block to route to once this block completes successfully.

on_no_matching

on_no_matching(target: Handle) -> InvokeLambdaFunctionHandle

Wire an error transition for NoMatchingError: if no other Error matches.

ParameterTypeRequiredDescription
targetHandleyesBlock to route to on NoMatchingError. if no other Error matches.

meta_use_dynamic

meta_use_dynamic(value?: bool) -> InvokeLambdaFunctionHandle

Set Metadata.ActionMetadata[<id>].useDynamic. Block-level summary toggle — true if any parameter on this block uses a dynamic JSONPath value.

ParameterTypeRequiredDescription
valueboolnoBlock-level summary toggle — true if any parameter on this block uses a dynamic JSONPath value.

set_id

set_id(id: String) -> InvokeLambdaFunctionHandle

Override the auto-generated identifier with a specific wire id.

ParameterTypeRequiredDescription
idStringyesWire identifier override. Decompile threads this through to round-trip Connect-side UUIDs.

meta_position

meta_position(x: i64, y: i64) -> InvokeLambdaFunctionHandle

Set the block's canvas position. Mostly auto-emitted by decompile; authored scripts call Flow.auto_layout() instead and let the layout pass fill positions in.

ParameterTypeRequiredDescription
xi64yesCanvas X coordinate.
yi64yesCanvas Y coordinate.

set_meta

set_meta(key: String, value: Dynamic) -> InvokeLambdaFunctionHandle

Single-key escape hatch, set one ActionMetadata key by name when the typed meta_* setters don't cover it.

ParameterTypeRequiredDescription
keyStringyesWire key name (under Metadata.ActionMetadata[<id>]).
valueDynamicyesAny JSON-serializable Rhai value.

overwrite_meta

overwrite_meta(value: Map) -> InvokeLambdaFunctionHandle

Full-replace escape hatch, overwrite the entire ActionMetadata blob.

ParameterTypeRequiredDescription
valueMapyesReplacement map for the entire ActionMetadata sub-object.

set_meta_param

set_meta_param(param: String, flag: String, value: Dynamic) -> InvokeLambdaFunctionHandle

Set a single per-parameter ActionMetadata flag.

ParameterTypeRequiredDescription
paramStringyesParameter name (e.g. "Text").
flagStringyesFlag name ("useDynamic", "MFLAG_*", etc.).
valueDynamicyesFlag value.

overwrite_meta_param

overwrite_meta_param(param: String, value: Map) -> InvokeLambdaFunctionHandle

Replace the entire flag map for one parameter.

ParameterTypeRequiredDescription
paramStringyesParameter name.
valueMapyesReplacement flag map for the parameter.

overwrite_parameters

overwrite_parameters(value: Map) -> InvokeLambdaFunctionHandle

Wire-shape escape hatch, overwrite the entire Parameters blob.

ParameterTypeRequiredDescription
valueMapyesReplacement parameter map for the block.

raw_transitions

raw_transitions(value: Map) -> InvokeLambdaFunctionHandle

Wire-shape escape hatch for non-canonical transition objects.

ParameterTypeRequiredDescription
valueMapyesReplacement transitions map (raw JSON shape).