---
title: "PUT /runtimes/{agentRuntimeId}/runtime-endpoints/"
method: PUT
path: "/runtimes/{agentRuntimeId}/runtime-endpoints/"
---

# PUT /runtimes/{agentRuntimeId}/runtime-endpoints/

`PUT /runtimes/{agentRuntimeId}/runtime-endpoints/`

Creates an AgentCore Runtime endpoint.

## Path parameters

- `agentRuntimeId` string, required

## Request body

- object
  - `name` string, password, required — The name of the AgentCore Runtime endpoint.
  - `agentRuntimeVersion` string — The version of the AgentCore Runtime to use for the endpoint.
  - `description` string — The description of the AgentCore Runtime endpoint.
  - `clientToken` string — A unique, case-sensitive identifier to ensure idempotency of the request.
  - `tags` object — 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 `202`

Success

- CreateAgentRuntimeEndpointResponse
  - `targetVersion` string, required — The target version of the AgentCore Runtime for the endpoint.
  - `agentRuntimeEndpointArn` string, required — The Amazon Resource Name (ARN) of the AgentCore Runtime endpoint.
  - `agentRuntimeArn` string, required — The Amazon Resource Name (ARN) of the AgentCore Runtime.
  - `agentRuntimeId` string — The unique identifier of the AgentCore Runtime.
  - `endpointName` string, 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.
  - `createdAt` string, date-time, required — The timestamp when the AgentCore Runtime endpoint was created.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — AccessDeniedException
- `482` — ConflictException
- `483` — ValidationException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore-control.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore-control/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore-control/versions/0ebde766792b/schema)