---
title: "POST /#X-Amz-Target=PaymentCryptographyControlPlane.DeleteAlias"
method: POST
path: "/#X-Amz-Target=PaymentCryptographyControlPlane.DeleteAlias"
---

# POST /#X-Amz-Target=PaymentCryptographyControlPlane.DeleteAlias

`POST /#X-Amz-Target=PaymentCryptographyControlPlane.DeleteAlias`

Deletes the alias, but doesn't affect the underlying key.

Each key can have multiple aliases. To get the aliases of all keys, use the [UpdateAlias](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_UpdateAlias.html) operation. To change the alias of a key, first use [DeleteAlias](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_DeleteAlias.html) to delete the current alias and then use [CreateAlias](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateAlias.html) to create a new alias. To associate an existing alias with a different key, call [UpdateAlias](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_UpdateAlias.html).

**Cross-account use:** This operation can't be used across different Amazon Web Services accounts.

**Related operations:**

*   [CreateAlias](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateAlias.html)
    
*   [GetAlias](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_GetAlias.html)
    
*   [ListAliases](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListAliases.html)
    
*   [UpdateAlias](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_UpdateAlias.html)

## Headers

- `X-Amz-Target` 'PaymentCryptographyControlPlane.DeleteAlias', required

## Request body

- DeleteAliasInput
  - `AliasName` string, required — A friendly name that you can use to refer Amazon Web Services Payment Cryptography key. This value must begin with <code>alias/</code> followed by a name, such as <code>alias/ExampleAlias</code>.

## Response `200`

Success

- DeleteAliasOutput

## Other responses

- `480` — ServiceUnavailableException
- `481` — ValidationException
- `482` — ConflictException
- `483` — AccessDeniedException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — InternalServerException

---

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