durable-execution-sdk-js.durablecontext.createcallback_1.md

Home > @aws/durable-execution-sdk-js > DurableContext > createCallback

DurableContext.createCallback() method

Creates a callback that external systems can complete

Signature:

createCallback<TOutput = string>(config?: CreateCallbackConfig<TOutput>): DurablePromise<CreateCallbackResult<TOutput>>;

Parameters

Parameter	Type	Description
config	CreateCallbackConfig<TOutput>	(Optional) Optional configuration for timeout and serialization

Returns:

DurablePromise<CreateCallbackResult<TOutput>>

Tuple of [promise that resolves when callback is submitted, callback ID]

Exceptions

{CallbackError} When callback fails, times out, or external system reports failure (thrown by the returned promise)

Example

const [promise, callbackId] = await context.createCallback({
  timeout: { minutes: 30 }, // 30 minutes
});
await notifyExternalSystem(callbackId);
const result = await promise;