# StepFunctionsIntegration

Options to integrate with various StepFunction API.

- Source: [`aws-apigateway/lib/integrations/stepfunctions.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-apigateway/lib/integrations/stepfunctions.ts#L101)
- Type last changed: v2.1.0 · 8 Dec 2021

## Example

```ts
   const stateMachine = new stepfunctions.StateMachine(this, 'MyStateMachine', {
      stateMachineType: stepfunctions.StateMachineType.EXPRESS,
      definition: stepfunctions.Chain.start(new stepfunctions.Pass(this, 'Pass')),
   });

   const api = new apigateway.RestApi(this, 'Api', {
      restApiName: 'MyApi',
   });
   api.root.addMethod('GET', apigateway.StepFunctionsIntegration.startExecution(stateMachine));
```

## Initializer

```ts
new StepFunctionsIntegration()
```

## Methods

- `startExecution(stateMachine: IStateMachine, options?: StepFunctionsExecutionIntegrationOptions): AwsIntegration` (static) — Integrates a Synchronous Express State Machine from AWS Step Functions to an API Gateway method.

  ```ts
     const stateMachine = new stepfunctions.StateMachine(this, 'MyStateMachine', {
        stateMachineType: stepfunctions.StateMachineType.EXPRESS,
        definition: stepfunctions.Chain.start(new stepfunctions.Pass(this, 'Pass')),
     });

     const api = new apigateway.RestApi(this, 'Api', {
        restApiName: 'MyApi',
     });
     api.root.addMethod('GET', apigateway.StepFunctionsIntegration.startExecution(stateMachine));
  ```