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

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

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

Lists all endpoints for a specific Amazon Secure Agent.

## Path parameters

- `agentRuntimeId` string, required

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListAgentRuntimeEndpointsResponse
  - `runtimeEndpoints` AgentRuntimeEndpoint[], required — The list of AgentCore Runtime endpoints.
    - `name` string, password, required — The name of the agent runtime endpoint.
    - `liveVersion` string — The live version of the agent runtime endpoint. This is the version that is currently serving requests.
    - `targetVersion` string — The target version of the agent runtime endpoint. This is the version that the endpoint is being updated to.
    - `agentRuntimeEndpointArn` string, required — The Amazon Resource Name (ARN) of the agent runtime endpoint.
    - `agentRuntimeArn` string, required — The Amazon Resource Name (ARN) of the agent runtime associated with the endpoint.
    - `status` 'CREATING' | 'CREATE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'READY' | 'DELETING', required — The current status of the agent runtime endpoint.
    - `id` string, required — The unique identifier of the agent runtime endpoint.
    - `description` string — The description of the agent runtime endpoint.
    - `createdAt` string, date-time, required — The timestamp when the agent runtime endpoint was created.
    - `lastUpdatedAt` string, date-time, required — The timestamp when the agent runtime endpoint was last updated.
  - `nextToken` string — A token to retrieve the next page of results.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — 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)