AWS Step Functions · Schema
UpdateStateMachineInput
Amazon Web ServicesiPaaSOrchestrationServerlessWorkflowsState Machines
Properties
| Name | Type | Description |
|---|---|---|
| stateMachineArn | string | The Amazon Resource Name (ARN) of the state machine. |
| 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. |
| loggingConfiguration | object | |
| tracingConfiguration | object | |
| publish | boolean | Specifies whether the state machine version is published. The default is false. To publish a version after updating the state machine, set publish to true. |
| versionDescription | string | An optional description of the state machine version to publish. You can only specify the versionDescription parameter if you've set publish to true. |
| encryptionConfiguration | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/aws-step-functions/json-schema/aws-step-functions-update-state-machine-input-schema.json",
"title": "UpdateStateMachineInput",
"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/UpdateStateMachineInput",
"type": "object",
"properties": {
"stateMachineArn": {
"type": "string",
"description": "The Amazon Resource Name (ARN) of the state machine."
},
"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."
},
"loggingConfiguration": {
"$ref": "#/$defs/LoggingConfiguration"
},
"tracingConfiguration": {
"$ref": "#/$defs/TracingConfiguration"
},
"publish": {
"type": "boolean",
"description": "Specifies whether the state machine version is published. The default is false. To publish a version after updating the state machine, set publish to true."
},
"versionDescription": {
"type": "string",
"description": "An optional description of the state machine version to publish. You can only specify the versionDescription parameter if you've set publish to true."
},
"encryptionConfiguration": {
"$ref": "#/$defs/EncryptionConfiguration"
}
},
"required": [
"stateMachineArn"
],
"$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-update-state-machine-input"
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.