---
title: "Delete key"
method: POST
path: "/v2/pix/keys/delete"
tags: ["Keys"]
---

# Delete key

`POST /v2/pix/keys/delete`

## Request

- Base URL: `https://sandbox.pismolabs.io/pix-dict`
- URL: `https://sandbox.pismolabs.io/pix-dict/v2/pix/keys/delete`
- Auth: HTTP bearer

Deletes a user DICT key entry.

On PSP timeout, a `202 Accepted` response is returned and the process continues asynchronously, eventually emitting a success or error event.

This endpoint generates a <a href="https://developers.pismo.io/events/docs/pix-dict-key-status-change-1" >Pix key status changed</a> event.

## Headers

- `Authorization` string, required
- `Idempotency-Key` string, required

## Request body

- PresenterDeleteRequest
  - `key` string, required: Value, based on a key's type, used to encrypt Pix key.
  - `key_type` 'CPF' | 'CNPJ' | 'PHONE' | 'EMAIL' | 'EVP', required: User information that can be used to create a Pix key: * `CPF` - Cadastro de Pessoas Fisicas (Indiviual Taxpayer Registry) number. Similar to a Social Security number in the US. * `CNPJ` - Cadastro Nacional de Pessoa Juridica (National Registry of Legal Entities) number. Unique ID for legal entities, such as companies and organizations, in Brazil * `EMAIL` - Email * `PHONE` - Phone number * `EVP` - Endereco de pagamento virtual (virtual payment address). A randomly-generated UUID number.
  - `reason` 'USER_REQUESTED' | 'ACCOUNT_CLOSURE' | 'RECONCILIATION' | 'FRAUD' | 'RFB_VALIDATION', required: Delete key reason for request.

## Response `202`

Accepted

- MessageMessage
  - `code` string: Error code
  - `details` MessageDetailMessage
    - `external` MessageExternalMessage[]
      - `code` string, required: Error code
      - `message` string, required: Error message
    - `parameters` MessageParameterMessage[]
      - `field` string, required: Parameter in error
      - `message` string, required: Error message
    - `payload` MessagePayloadMessage[]
      - `field` string, required: Field in error
      - `message` string, required: Error messsage
  - `message` string: Error message

## Other responses

- `204`: No Content
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too many requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/pismo/apis/instant-payments-pix-management.md) - [All operations](https://skmtc.dev/pismo/apis/instant-payments-pix-management/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/instant-payments-pix-management/revisions/eb540c289547?raw)