---
title: "Delete an alias"
method: DELETE
path: "/v2/agent_aliases/{alias_key}"
tags: ["Agent Aliases"]
---

# Delete an alias

`DELETE /v2/agent_aliases/{alias_key}`

Deletes an alias. The underlying agents the alias points at are not affected. Returns 409 if any live resources still reference this alias.

## Path parameters

- `alias_key` string, required — The unique key that identifies an alias. Alias keys are independent of agent keys. The same string can exist as both an alias key and an agent key in the same customer account. Calls to `/v2/agent_aliases/{key}/...` target the alias. Calls to `/v2/agents/{key}/...` target the agent.

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Response `204`

The alias is deleted.

## Other responses

- `403` — Permissions do not allow deleting this alias.
- `404` — Alias not found.
- `409` — The alias has live references (e.g. connectors) that prevent deletion.

---

[API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/versions/fca567a46b3a/schema)