v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

Updates an existing Amazon Secure Agent.

put/runtimes/{agentRuntimeId}/

Path parameters

agentRuntimeIdstring required

The unique identifier of the AgentCore Runtime to update.

Request body

roleArnstring required

The updated IAM role ARN that provides permissions for the AgentCore Runtime.

descriptionstring password

The updated description of the AgentCore Runtime.

environmentVariablesobject

Updated environment variables to set in the AgentCore Runtime environment.

clientTokenstring

A unique, case-sensitive identifier to ensure idempotency of the request.

Response

Success

agentRuntimeArnstring required

The Amazon Resource Name (ARN) of the updated AgentCore Runtime.

agentRuntimeIdstring required

The unique identifier of the updated AgentCore Runtime.

agentRuntimeVersionstring required

The version of the updated AgentCore Runtime.

createdAtstring date-time required

The timestamp when the AgentCore Runtime was created.

lastUpdatedAtstring date-time required

The timestamp when the AgentCore Runtime was last updated.

status'CREATING' | 'CREATE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'READY' | 'DELETING' required

The current status of the updated AgentCore Runtime.