v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1426173136.4 KB

Deletes a state machine. This is an asynchronous operation: It sets the state machine's status to DELETING and begins the deletion process.

If the given state machine Amazon Resource Name (ARN) is a qualified state machine ARN, it will fail with ValidationException.

A qualified state machine ARN refers to a Distributed Map state defined within a state machine. For example, the qualified state machine ARN arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel refers to a Distributed Map state with a label mapStateLabel in the state machine named stateMachineName.

For EXPRESS state machines, the deletion will happen eventually (usually less than a minute). Running executions may emit logs after DeleteStateMachine API is called.

post/#X-Amz-Target=AWSStepFunctions.DeleteStateMachine

Headers

X-Amz-Target'AWSStepFunctions.DeleteStateMachine' required

Request body

stateMachineArnstring required

The Amazon Resource Name (ARN) of the state machine to delete.

Response

Success

DeleteStateMachineOutput required