AWS Step Functions · Schema
DescribeStateMachineForExecutionOutput
Amazon Web ServicesiPaaSOrchestrationServerlessWorkflowsState Machines
Properties
| Name | Type | Description |
|---|---|---|
| stateMachineArn | string | The Amazon Resource Name (ARN) of the state machine associated with the execution. |
| name | string | The name of the state machine associated with the execution. |
| definition | string | The Amazon States Language definition of the state machine. See Amazon States Language. |
| roleArn | string | The Amazon Resource Name (ARN) of the IAM role of the State Machine for the execution. |
| updateDate | string | The date and time the state machine associated with an execution was updated. For a newly created state machine, this is the creation date. |
| loggingConfiguration | object | |
| tracingConfiguration | object | |
| mapRunArn | string | The Amazon Resource Name (ARN) of the Map Run that started the child workflow execution. This field is returned only if the executionArn is a child workflow execution that was started by a Distributed |
| label | string | A user-defined or an auto-generated string that identifies a Map state. This field is returned only if the executionArn is a child workflow execution that was started by a Distributed Map state. |
| revisionId | string | The revision identifier for the state machine. The first revision ID when you create the state machine is null. Use the state machine revisionId parameter to compare the revision of a state machine wi |
| encryptionConfiguration | object | |
| variableReferences | object | A map of state name to a list of variables referenced by that state. States that do not use variable references will not be shown in the response. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/aws-step-functions/json-schema/aws-step-functions-describe-state-machine-for-execution-output-schema.json",
"title": "DescribeStateMachineForExecutionOutput",
"x-generated": "2026-11-11",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/aws-step-functions-state-machines-api-openapi.yml#/components/schemas/DescribeStateMachineForExecutionOutput",
"type": "object",
"properties": {
"stateMachineArn": {
"type": "string",
"description": "The Amazon Resource Name (ARN) of the state machine associated with the execution."
},
"name": {
"type": "string",
"description": "The name of the state machine associated with the execution."
},
"definition": {
"type": "string",
"description": "The Amazon States Language definition of the state machine. See Amazon States Language."
},
"roleArn": {
"type": "string",
"description": "The Amazon Resource Name (ARN) of the IAM role of the State Machine for the execution."
},
"updateDate": {
"type": "string",
"format": "date-time",
"description": "The date and time the state machine associated with an execution was updated. For a newly created state machine, this is the creation date."
},
"loggingConfiguration": {
"$ref": "#/$defs/LoggingConfiguration"
},
"tracingConfiguration": {
"$ref": "#/$defs/TracingConfiguration"
},
"mapRunArn": {
"type": "string",
"description": "The Amazon Resource Name (ARN) of the Map Run that started the child workflow execution. This field is returned only if the executionArn is a child workflow execution that was started by a Distributed Map state."
},
"label": {
"type": "string",
"description": "A user-defined or an auto-generated string that identifies a Map state. This field is returned only if the executionArn is a child workflow execution that was started by a Distributed Map state."
},
"revisionId": {
"type": "string",
"description": "The revision identifier for the state machine. The first revision ID when you create the state machine is null. Use the state machine revisionId parameter to compare the revision of a state machine with the configuration of the state machine used for executions without performing a diff of the properties, such as definition and roleArn."
},
"encryptionConfiguration": {
"$ref": "#/$defs/EncryptionConfiguration"
},
"variableReferences": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "A map of state name to a list of variables referenced by that state. States that do not use variable references will not be shown in the response."
}
},
"required": [
"stateMachineArn",
"name",
"definition",
"roleArn",
"updateDate"
],
"$defs": {
"CloudWatchLogsLogGroup": {
"type": "object",
"properties": {
"logGroupArn": {
"type": "string",
"description": "The ARN of the the CloudWatch log group to which you want your logs emitted to. The ARN must end with :*"
}
}
},
"EncryptionConfiguration": {
"type": "object",
"properties": {
"kmsKeyId": {
"type": "string",
"description": "An alias, alias ARN, key ID, or key ARN of a symmetric encryption KMS key to encrypt data. To specify a KMS key in a different Amazon Web Services account, you must use the key ARN or alias ARN."
},
"kmsDataKeyReusePeriodSeconds": {
"type": "integer",
"description": "Maximum duration that Step Functions will reuse data keys. When the period expires, Step Functions will call GenerateDataKey. Only applies to customer managed keys."
},
"type": {
"type": "string",
"enum": [
"AWS_OWNED_KEY",
"CUSTOMER_MANAGED_KMS_KEY"
],
"description": "Encryption type"
}
},
"required": [
"type"
]
},
"LogDestination": {
"type": "object",
"properties": {
"cloudWatchLogsLogGroup": {
"$ref": "#/$defs/CloudWatchLogsLogGroup"
}
}
},
"LoggingConfiguration": {
"type": "object",
"properties": {
"level": {
"type": "string",
"enum": [
"ALL",
"ERROR",
"FATAL",
"OFF"
],
"description": "Defines which category of execution history events are logged."
},
"includeExecutionData": {
"type": "boolean",
"description": "Determines whether execution data is included in your log. When set to false, data is excluded."
},
"destinations": {
"type": "array",
"items": {
"$ref": "#/$defs/LogDestination"
},
"description": "An array of objects that describes where your execution history events will be logged. Limited to size 1. Required, if your log level is not set to OFF."
}
}
},
"TracingConfiguration": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean",
"description": "When set to true, X-Ray tracing is enabled."
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/aws-step-functions-describe-state-machine-for-execution-output"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.