---
title: "POST /agents/{agentId}/agentaliases/"
method: POST
path: "/agents/{agentId}/agentaliases/"
---

# POST /agents/{agentId}/agentaliases/

`POST /agents/{agentId}/agentaliases/`

Lists the aliases of an agent and information about each one.

## Path parameters

- `agentId` string, required

## Request body

- object
  - `maxResults` integer — The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.
  - `nextToken` string — If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.

## Response `200`

Success

- ListAgentAliasesResponse
  - `agentAliasSummaries` AgentAliasSummary[], required — A list of objects, each of which contains information about an alias of the agent.
    - `agentAliasId` string, required — Contains details about
    - `agentAliasName` string, required — The name of the alias.
    - `description` string — The description of the alias.
    - `routingConfiguration` AgentAliasRoutingConfigurationListItem[] — Contains details about the version of the agent with which the alias is associated.
      - `agentVersion` string — The version of the agent with which the alias is associated.
      - `provisionedThroughput` string — Information on the Provisioned Throughput assigned to an agent alias.
    - `agentAliasStatus` 'CREATING' | 'PREPARED' | 'FAILED' | 'UPDATING' | 'DELETING' | 'DISSOCIATED', required — The status of the alias.
    - `createdAt` string, date-time, required — The time at which the alias of the agent was created.
    - `updatedAt` string, date-time, required — The time at which the alias was last updated.
    - `aliasInvocationState` 'ACCEPT_INVOCATIONS' | 'REJECT_INVOCATIONS' — The invocation state for the agent alias. If the agent alias is running, the value is <code>ACCEPT_INVOCATIONS</code>. If the agent alias is paused, the value is <code>REJECT_INVOCATIONS</code>. Use the <code>UpdateAgentAlias</code> operation to change the invocation state.
  - `nextToken` string — If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — InternalServerException
- `484` — ResourceNotFoundException

---

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