# AWS Step Functions API

> AWS Step Functions API on Apizie: 34 endpoints (Creates an activity. An activity is a task that you write in any programming language and host on any…, Creates a state machine. A state machine consists of a collection of states that can do work ( Task states),…, Creates an alias for a state machine that points to one or two versions of the same state machine. You can…, Deletes an activity., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:amazonaws-states/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-states`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://apizie.tech/api/cloud/amazonaws-states
- OpenAPI: https://apizie.tech/api/cloud/amazonaws-states/openapi.json

Step Functions Step Functions is a service that lets you coordinate the components of distributed applications and microservices using visual workflows. You can use Step Functions to build applications from individual…

## Endpoints

### Creates an activity. An activity is a task that you write in any programming language and host on any…
`POST https://apizie.tech/v1/cloud:amazonaws-states/create-activity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a state machine. A state machine consists of a collection of states that can do work ( Task states),…
`POST https://apizie.tech/v1/cloud:amazonaws-states/create-state-machine` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates an alias for a state machine that points to one or two versions of the same state machine. You can…
`POST https://apizie.tech/v1/cloud:amazonaws-states/create-state-machine-alias` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes an activity.
`POST https://apizie.tech/v1/cloud:amazonaws-states/delete-activity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a state machine. This is an asynchronous operation: It sets the state machine's status to DELETING…
`POST https://apizie.tech/v1/cloud:amazonaws-states/delete-state-machine` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a state machine alias . After you delete a state machine alias, you can't use it to start…
`POST https://apizie.tech/v1/cloud:amazonaws-states/delete-state-machine-alias` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a state machine version . After you delete a version, you can't call StartExecution using that…
`POST https://apizie.tech/v1/cloud:amazonaws-states/delete-state-machine-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes an activity. This operation is eventually consistent. The results are best effort and may not…
`POST https://apizie.tech/v1/cloud:amazonaws-states/describe-activity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Provides information about a state machine execution, such as the state machine associated with the…
`POST https://apizie.tech/v1/cloud:amazonaws-states/describe-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Provides information about a Map Run's configuration, progress, and results. For more information, see…
`POST https://apizie.tech/v1/cloud:amazonaws-states/describe-map-run` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Provides information about a state machine's definition, its IAM role Amazon Resource Name (ARN), and…
`POST https://apizie.tech/v1/cloud:amazonaws-states/describe-state-machine` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Returns details about a state machine alias . Related operations: CreateStateMachineAlias…
`POST https://apizie.tech/v1/cloud:amazonaws-states/describe-state-machine-alias` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Provides information about a state machine's definition, its execution role ARN, and configuration. If a Map…
`POST https://apizie.tech/v1/cloud:amazonaws-states/describe-state-machine-for-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Used by workers to retrieve a task (with the specified activity ARN) which has been scheduled for execution…
`POST https://apizie.tech/v1/cloud:amazonaws-states/get-activity-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Returns the history of the specified execution as a list of events. By default, the results are returned in…
`POST https://apizie.tech/v1/cloud:amazonaws-states/get-execution-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists the existing activities. If nextToken is returned, there are more results available. The value of…
`POST https://apizie.tech/v1/cloud:amazonaws-states/list-activities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists all executions of a state machine or a Map Run. You can list all executions related to a state machine…
`POST https://apizie.tech/v1/cloud:amazonaws-states/list-executions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists all Map Runs that were started by a given state machine execution. Use this API action to obtain Map…
`POST https://apizie.tech/v1/cloud:amazonaws-states/list-map-runs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists aliases for a specified state machine ARN. Results are sorted by time, with the most recently created…
`POST https://apizie.tech/v1/cloud:amazonaws-states/list-state-machine-aliases` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists versions for the specified state machine Amazon Resource Name (ARN). The results are sorted in…
`POST https://apizie.tech/v1/cloud:amazonaws-states/list-state-machine-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists the existing state machines. If nextToken is returned, there are more results available. The value of…
`POST https://apizie.tech/v1/cloud:amazonaws-states/list-state-machines` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### List tags for a given resource. Tags may only contain Unicode letters, digits, white space, or these…
`POST https://apizie.tech/v1/cloud:amazonaws-states/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a version from the current revision of a state machine. Use versions to create immutable snapshots…
`POST https://apizie.tech/v1/cloud:amazonaws-states/publish-state-machine-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Used by activity workers and task states using the callback pattern to report that the task identified by…
`POST https://apizie.tech/v1/cloud:amazonaws-states/send-task-failure` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Used by activity workers and task states using the callback pattern to report to Step Functions that the…
`POST https://apizie.tech/v1/cloud:amazonaws-states/send-task-heartbeat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Used by activity workers and task states using the callback pattern to report that the task identified by…
`POST https://apizie.tech/v1/cloud:amazonaws-states/send-task-success` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Starts a state machine execution. A qualified state machine ARN can either refer to a Distributed Map state…
`POST https://apizie.tech/v1/cloud:amazonaws-states/start-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Starts a Synchronous Express state machine execution. StartSyncExecution is not available for STANDARD…
`POST https://apizie.tech/v1/cloud:amazonaws-states/start-sync-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Stops an execution. This API action is not supported by EXPRESS state machines.
`POST https://apizie.tech/v1/cloud:amazonaws-states/stop-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Add a tag to a Step Functions resource. An array of key-value pairs. For more information, see Using Cost…
`POST https://apizie.tech/v1/cloud:amazonaws-states/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Remove a tag from a Step Functions resource
`POST https://apizie.tech/v1/cloud:amazonaws-states/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates an in-progress Map Run's configuration to include changes to the settings that control maximum…
`POST https://apizie.tech/v1/cloud:amazonaws-states/update-map-run` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates an existing state machine by modifying its definition , roleArn , or loggingConfiguration . Running…
`POST https://apizie.tech/v1/cloud:amazonaws-states/update-state-machine` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the configuration of an existing state machine alias by modifying its description or…
`POST https://apizie.tech/v1/cloud:amazonaws-states/update-state-machine-alias` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

## Example
```
curl "https://apizie.tech/v1/cloud:amazonaws-states/create-activity" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS Step Functions API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:amazonaws-states/create-activity with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS Step Functions API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AWS Step Functions itself also needs your own key from amazonaws.com.

### Can AI agents use the AWS Step Functions API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-states.

### What is the status of the AWS Step Functions API?
Needs your own provider key (bring your own key)