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

# Delete key

`POST /v2/pix/keys/delete`

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 — Pix key value.
  - `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` — Access token is missing or invalid
- `403` — The request has been lost
- `404` — Not Found
- `409` — Conflict
- `429` — Too many reqquests
- `500` — Internal Server Error
- `502` — Bad Gateway
- `503` — Service Unavailable
- `504` — Gateway timeout

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/versions/935b62e16de4/schema)