Overcast is alpha — behaviour and APIs may change between releases. Pin your version and read the changelog before upgrading.

overcast

Step Functions operations

Every Step Functions operation Overcast declares — 37 of 37 implemented — with status, behaviour notes and a link to the AWS API reference for each.

All 37 listed operations are implemented. Back to Step Functions.

Summary

Category✅ Supported
State machines7
Versions and aliases8
Executions8
Map runs3
Activities and task tokens8
Tags3

Endpoints

State machines

OperationStatusNotesAWS Docs
CreateStateMachine✅ SupportedValidates the ASL; idempotent — returns existing if name+def match; publish/versionDescription publish version 1docs
DescribeStateMachine✅ SupportedReturns revisionId once the state machine has been updated; a version ARN describes that version (its definition, role, description and revisionId)docs
ListStateMachines✅ SupportedSorted by name; maxResults/nextToken paginationdocs
DeleteStateMachine✅ SupportedAlso deletes the state machine’s versions and aliasesdocs
UpdateStateMachine✅ SupportedDefinition/roleArn/loggingConfiguration/tracingConfiguration; a change starts a new revision (revisionId); publish/versionDescription publish it as a versiondocs
DescribeStateMachineForExecution✅ SupportedReports the version’s definition for an execution that ran a version (the current definition if that version was since deleted)docs
ValidateStateMachineDefinition✅ SupportedThe same structural validation CreateStateMachine applies, as OK/FAIL with one ERROR diagnostic (code, message, location where known); no WARNING-level static analysisdocs

Versions and aliases

OperationStatusNotesAWS Docs
PublishStateMachineVersion✅ SupportedVersion ARN is :, numbers never reused; idempotent per revision; revisionId (or INITIAL) mismatch is ConflictExceptiondocs
ListStateMachineVersions✅ SupportedNewest first; maxResults/nextToken paginationdocs
DeleteStateMachineVersion✅ SupportedConflictException while an alias routes to the version; deleting a missing version succeedsdocs
CreateStateMachineAlias✅ SupportedAlias ARN is :; 1–2 versions with weights summing to 100; idempotent on name+description+routingdocs
DescribeStateMachineAlias✅ Supporteddocs
UpdateStateMachineAlias✅ Supporteddescription and/or routingConfiguration; takes effect immediately (no eventual-consistency window)docs
DeleteStateMachineAlias✅ Supporteddocs
ListStateMachineAliases✅ SupportedMost recent first; a version ARN lists the aliases routing to it; maxResults/nextToken paginationdocs

Executions

OperationStatusNotesAWS Docs
StartExecution✅ SupportedInterprets the ASL; returns while the execution is RUNNING, as AWS does; accepts a version or alias ARN (an alias picks a version at random by weight); a standard workflow’s RUNNING and terminal status transitions each emit a Step Functions Execution Status Change event to the default EventBridge busdocs
StartSyncExecution✅ SupportedEXPRESS only — same interpreter, run to completion before returning; accepts a version or alias ARN; EXPRESS executions do not emit EventBridge events, matching AWSdocs
DescribeExecution✅ SupportedReal status, output, error and cause; redriveCount/redriveStatus; mapRunArn for a distributed Map child; stateMachineVersionArn/stateMachineAliasArn for an execution started through a version or aliasdocs
ListExecutions✅ SupportedstatusFilter, redriveFilter, mapRunArn (a distributed Map’s child executions) and maxResults/nextToken pagination; a version or alias ARN lists the executions that ran through itdocs
GetExecutionHistory✅ SupportedAWS’s event vocabulary for every state type, with causal previousEventId linkage (each Parallel branch and Map iteration chains back to its own start event); readable while RUNNING; reverseOrder, includeExecutionData, maxResults/nextTokendocs
StopExecution✅ SupportedInterrupts a running execution; it reaches ABORTED asynchronously; a standard workflow’s ABORTED transition emits a Step Functions Execution Status Change event to the default EventBridge busdocs
RedriveExecution✅ SupportedStandard executions that FAILED, TIMED_OUT or were ABORTED within 14 days; resumes at the state that did not succeed, and inside a Parallel or Map re-runs only the branches, iterations or map-run children that did not succeed; history continues after ExecutionRedrivendocs
TestState✅ SupportedOne state, alone or named from a whole definition; a single attempt (RETRIABLE / CAUGHT_ERROR); mock result or errorOutput; variables and context; DEBUG inspectionDatadocs

Map runs

OperationStatusNotesAWS Docs
ListMapRuns✅ Supporteddocs
DescribeMapRun✅ SupportedLive item and child-execution counts while the run is in progress; redriveCount and redriveDate once the parent is redrivendocs
UpdateMapRun✅ SupportedmaxConcurrency and the failure tolerances; applies to children not yet started on a running Map Rundocs

Activities and task tokens

OperationStatusNotesAWS Docs
CreateActivity✅ SupportedIdempotent on the name, as AWS documentsdocs
DescribeActivity✅ Supporteddocs
DeleteActivity✅ Supporteddocs
ListActivities✅ SupportedmaxResults/nextToken paginationdocs
GetActivityTask✅ SupportedLong-polls up to 60 seconds for a scheduled taskdocs
SendTaskSuccess✅ SupportedCompletes an activity task or a .waitForTaskToken task; tokens live while their execution doesdocs
SendTaskFailure✅ Supporteddocs
SendTaskHeartbeat✅ SupportedResets HeartbeatSeconds; a missed heartbeat is States.HeartbeatTimeoutdocs

Tags

OperationStatusNotesAWS Docs
TagResource✅ SupportedState machines and activities; a version or alias ARN is InvalidArn, as on AWSdocs
UntagResource✅ Supporteddocs
ListTagsForResource✅ Supporteddocs