# Deletar instancia

`DELETE /instance/admin`

Pasta: **Admininstração**

## Autenticação

```http
admintoken: {{adminToken}}
```

## Descrição

# Deletar instância (admin)

Remove permanentemente uma instância pelo `id` ou `token`. Use na administração quando a exclusão não puder depender do token da própria instância.

## Endpoint

`DELETE {{baseUrl}}/instance/admin`

## Autenticação

Envie o token de administrador no header `admintoken: {{adminToken}}`.

## Parâmetros

Informe **um** destes (query string ou JSON no body):

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `id` | string | Condicional | ID da instância. |
| `token` | string | Condicional | Token da instância. |

## Exemplo de Requisição

```bash
curl --request DELETE '{{baseUrl}}/instance/admin?id={{instanceID}}' \
  --header 'admintoken: {{adminToken}}'
```

## Resposta de Sucesso

```json
{
  "success": true
}
```

## Erros comuns

- `401 Unauthorized`: `admintoken` ausente ou inválido.
- `400 Bad Request`: nem `id` nem `token` foram enviados.
- `404 Not Found`: instância não encontrada.

## Observações

- A operação encerra a sessão e apaga dados associados da instância.
- Preferência de resolução: query `token` → query `id` → body JSON `token`/`id`.

## Query

- `id` = `{{instanceID}}`

## cURL

```bash
curl -X DELETE "{{baseUrl}}/instance/admin" \
  -H "admintoken: {{adminToken}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=admininstracao/deletar-instancia)