> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paradime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS Step Functions CLI

> Trigger AWS Step Functions state machine executions and list their run status from Paradime Bolt using the paradime run aws-step-functions CLI commands.

The Paradime SDK provides CLI commands to interact with AWS Step Functions, allowing you to trigger state machine executions and list their status with real-time monitoring capabilities.

<Warning>
  🔑 **AWS Credentials Required**

  AWS credentials are read from environment variables or the AWS credential chain:

  * `AWS_ACCESS_KEY_ID`
  * `AWS_SECRET_ACCESS_KEY`
  * `AWS_SESSION_TOKEN` (optional, for temporary credentials)
  * `AWS_REGION`

  You can also pass credentials explicitly with the `--aws-access-key-id`, `--aws-secret-access-key`, `--aws-session-token`, and `--aws-region` flags.
</Warning>

### Trigger Executions

Trigger one or more AWS Step Functions state machine executions.

```bash theme={"system"}
paradime run aws-stepfunctions-trigger --state-machine-arns arn:aws:states:us-east-1:123456789012:stateMachine:MyStateMachine
```

**Options**

| Flag                      | Type              | Description                                                                               |
| ------------------------- | ----------------- | ----------------------------------------------------------------------------------------- |
| `--aws-access-key-id`     | Optional, TEXT    | AWS Access Key ID for authentication. Can also use AWS credential chain.                  |
| `--aws-secret-access-key` | Optional, TEXT    | AWS Secret Access Key for authentication. Can also use AWS credential chain.              |
| `--aws-session-token`     | Optional, TEXT    | Optional AWS Session Token for temporary credentials.                                     |
| `--aws-region`            | Optional, TEXT    | AWS region name (e.g., us-east-1, us-west-2). Defaults to default region from AWS config. |
| `--state-machine-arns`    | Required, TEXT    | Comma-separated Step Functions state machine ARN(s) to execute.                           |
| `--input-data`            | Optional, TEXT    | JSON input data to pass to the state machines (optional).                                 |
| `--wait` / `--no-wait`    | Optional, Flag    | Wait for executions to complete before returning. Default: `--wait`.                      |
| `--timeout`               | Optional, INTEGER | Maximum time to wait in minutes. Default: 1440 (24 hours).                                |
| `--json`                  | Optional, Flag    | Output results as JSON. Default: `False`.                                                 |
| `--help`                  | Optional, Flag    | Show the help message and exit.                                                           |

### List State Machines

List all AWS Step Functions state machines with their status.

```bash theme={"system"}
paradime run aws-stepfunctions-list
```

**Options**

| Flag                      | Type           | Description                                                                               |
| ------------------------- | -------------- | ----------------------------------------------------------------------------------------- |
| `--aws-access-key-id`     | Optional, TEXT | AWS Access Key ID for authentication. Can also use AWS credential chain.                  |
| `--aws-secret-access-key` | Optional, TEXT | AWS Secret Access Key for authentication. Can also use AWS credential chain.              |
| `--aws-session-token`     | Optional, TEXT | Optional AWS Session Token for temporary credentials.                                     |
| `--aws-region`            | Optional, TEXT | AWS region name (e.g., us-east-1, us-west-2). Defaults to default region from AWS config. |
| `--json`                  | Optional, Flag | Output results as JSON. Default: `False`.                                                 |
| `--help`                  | Optional, Flag | Show the help message and exit.                                                           |

## Examples

```bash theme={"system"}
# Trigger a single state machine execution (using AWS credential chain)
paradime run aws-stepfunctions-trigger --state-machine-arns arn:aws:states:us-east-1:123456789012:stateMachine:MyStateMachine

# Trigger multiple executions with JSON input data
paradime run aws-stepfunctions-trigger --state-machine-arns arn:...,arn:... --input-data '{"key":"value"}'

# List all state machines
paradime run aws-stepfunctions-list
```


## Related topics

- [AWS Lambda CLI](/developers/paradime-cli/aws-lambda-cli.md)
- [AWS Glue CLI](/developers/paradime-cli/aws-glue-cli.md)
- [AWS ECS CLI](/developers/paradime-cli/aws-ecs-cli.md)
- [GCP Cloud Function CLI](/developers/paradime-cli/gcp-cloud-function-cli.md)
- [AWS Secret Manager](/integrations/aws-secret-manager.md)