# RuntimeEndpointProps

Properties for creating a Bedrock Agent Core Runtime Endpoint resource.

Extends: RuntimeEndpointProps
Used as props by: RuntimeEndpoint

- Source: [`aws-bedrockagentcore/lib/runtime/runtime-endpoint.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0/packages/aws-cdk-lib/aws-bedrockagentcore/lib/runtime/runtime-endpoint.ts#L19)
- Type last changed: v2.255.0 · 19 May 2026

## Example

```ts
// Reference an existing runtime by its ID
const existingRuntimeId = "abc123-runtime-id"; // The ID of an existing runtime

// Create a standalone endpoint
const endpoint = new agentcore.RuntimeEndpoint(this, "MyEndpoint", {
  endpointName: "production",
  agentRuntimeId: existingRuntimeId,
  agentRuntimeVersion: "1", // Specify which version to use
  description: "Production endpoint for existing runtime"
});
```

## Properties

- `agentRuntimeId`: string (required) — The ID of the agent runtime to associate with this endpoint This is the unique identifier of the runtime resource Pattern: ^[a-zA-Z][a-zA-Z0-9_]{0,99}-[a-zA-Z0-9]{10}$.

- `agentRuntimeVersion`: string = "1" — The version of the agent runtime to use for this endpoint If not specified, the endpoint will point to version "1" of the runtime.

  Pattern: ^([1-9][0-9]{0,4})$

- `description`: string — Optional description for the agent runtime endpoint Length Minimum: 1 , Maximum: 256.

  **Default:** No description

- `endpointName`: string — The name of the agent runtime endpoint Valid characters are a-z, A-Z, 0-9, _ (underscore) Must start with a letter and can be up to 48 characters long Pattern: ^[a-zA-Z][a-zA-Z0-9_]{0,47}$.

  **Default:** auto generate

- `tags`: { [key: string]: string } — Tags for the agent runtime endpoint A list of key:value pairs of tags to apply to this RuntimeEndpoint resource Pattern: ^[a-zA-Z0-9\s._:/=+@-]*$.

  **Default:** {} - no tags