Sign in

v1

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

Creates an AgentCore Runtime endpoint.

put/runtimes/{agentRuntimeId}/runtime-endpoints/

Path parameters

agentRuntimeIdstring required

The unique identifier of the AgentCore Runtime to create an endpoint for.

Request body

namestring password required

The name of the AgentCore Runtime endpoint.

agentRuntimeVersionstring

The version of the AgentCore Runtime to use for the endpoint.

descriptionstring

The description of the AgentCore Runtime endpoint.

clientTokenstring

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

tagsobject

A map of tag keys and values to assign to the agent runtime endpoint. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

Response

Success

targetVersionstring required

The target version of the AgentCore Runtime for the endpoint.

agentRuntimeEndpointArnstring required

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

agentRuntimeArnstring required

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

agentRuntimeIdstring

The unique identifier of the AgentCore Runtime.

endpointNamestring password

The name of the AgentCore Runtime endpoint.

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

The current status of the AgentCore Runtime endpoint.

createdAtstring date-time required

The timestamp when the AgentCore Runtime endpoint was created.