# Revogar credencial

`DELETE /v1/cofre/credenciais/{credencial_id}`

Revoga a credencial e apaga usuário e senha do cofre.

## Parâmetros

| Nome | Onde | Tipo | Obrigatório | Descrição |
|---|---|---|---|---|
| `credencial_id` | caminho | uuid | sim | Id da credencial |

## Respostas

| HTTP | Significa |
|---|---|
| 204 | Sem conteúdo |
| 422 | Corpo ou parâmetros com formato inválido (`detail` lista os campos) |

## Erros

Recusas vêm como `{"detail": {"erro": "<código>", "mensagem": "…"}}`.

| HTTP | `erro` | Significa |
|---|---|---|
| 401 | — | Chave ausente ou inválida |
| 404 | `nao_encontrado` | A Conexão não existe nesta Conta (ou foi revogada) |
| 502 | `cofre_indisponivel` | O cofre não respondeu agora. Tente de novo em instantes |

## Exemplos de requisição

### Bash

```bash
curl -X DELETE 'https://sync.lops.com.br/v1/cofre/credenciais/5b1e7c2a-3f4d-4c8e-9a1b-2d6f0e8c7a15' \
  -H "Authorization: Bearer $SYNC_CHAVE"
```

### JavaScript

```javascript
const resposta = await fetch("https://sync.lops.com.br/v1/cofre/credenciais/5b1e7c2a-3f4d-4c8e-9a1b-2d6f0e8c7a15", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.SYNC_CHAVE}`,
  },
});
console.log(resposta.status); // 204
```

### Python

```python
import os

import requests

resposta = requests.delete(
    "https://sync.lops.com.br/v1/cofre/credenciais/5b1e7c2a-3f4d-4c8e-9a1b-2d6f0e8c7a15",
    headers={"Authorization": f"Bearer {os.environ['SYNC_CHAVE']}"},
)
print(resposta.status_code)  # 204
```

### PHP

```php
<?php
$ch = curl_init('https://sync.lops.com.br/v1/cofre/credenciais/5b1e7c2a-3f4d-4c8e-9a1b-2d6f0e8c7a15');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SYNC_CHAVE'),
    ],
]);
$corpo = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
var_dump($status, json_decode($corpo, true));
```
