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

# DELETE /agents/{agentId}/agentaliases/{agentAliasId}/

`DELETE /agents/{agentId}/agentaliases/{agentAliasId}/`

Deletes an alias of an agent.

## Path parameters

- `agentId` string, required
- `agentAliasId` string, required

## Response `202`

Success

- DeleteAgentAliasResponse
  - `agentId` string, required — The unique identifier of the agent that the alias belongs to.
  - `agentAliasId` string, required — The unique identifier of the alias that was deleted.
  - `agentAliasStatus` 'CREATING' | 'PREPARED' | 'FAILED' | 'UPDATING' | 'DELETING' | 'DISSOCIATED', required — The status of the alias.

## 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)