# Desativar projeto

Fonte: https://apiwpp.com/docs/api/projetos/desativar-projeto
Seção: Projetos
Atualizado em: 2026-09-28

`DELETE /tenants/{id}`

Desativa o projeto (`isActive: false`) e desconecta todas as conexões dele, com as sessões preservadas. Nada é apagado: nem as conexões, nem os templates, nem o histórico. Escopo necessário: `connections:write`.

## Cabeçalhos

| Nome | Obrigatório | Descrição |
| --- | --- | --- |
| `Authorization` | sim | `Bearer <chave de API>`; ou envie a chave em `X-Api-Key`. |

## Parâmetros de caminho

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | `string · uuid` | sim | Identificador do projeto (`tenantId`). |

## Exemplo de requisição

### cURL

```bash
curl -X DELETE \
  https://api.apiwpp.com/tenants/$TENANT_ID \
  -H "Authorization: Bearer $API_KEY"
```

### Node.js

```javascript
const res = await fetch(`https://api.apiwpp.com/tenants/${tenantId}`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
  },
})
const data = await res.json()
```

### PHP

```php
$response = Http::withToken($apiKey)
    ->delete("https://api.apiwpp.com/tenants/{$tenantId}");
```

### Python

```python
import requests

response = requests.delete(
    f"https://api.apiwpp.com/tenants/{tenant_id}",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
```

## Respostas

| Código | Erro | Descrição |
| --- | --- | --- |
| 200 |  | O projeto foi desativado: `{"deleted": true}`. |
| 400 | `FST_ERR_VALIDATION` | `id` não é um UUID; `message` diz o que está errado. |
| 401 |  | Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. A chave de um projeto desativado também responde `401`. |
| 403 |  | A chave não tem o escopo `connections:write`; a mensagem de erro cita o escopo que falta. |
| 404 |  | O projeto não existe ou não é de quem chama (`Tenant not found`): uma chave de API alcança só o próprio projeto, e o de outra pessoa responde igual a um que não existe. |
| 429 |  | Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de `Retry-After`. Veja [Limites](https://apiwpp.com/docs/referencia/limites). Cabeçalhos: `Retry-After`. |

### 200 OK

```json
{
  "deleted": true
}
```

## Detalhes

Um projeto inativo não recebe webhooks, e as chaves de API dele deixam de autenticar (`401`), inclusive a que fez esta chamada. As conexões são desconectadas logo depois da resposta, sem que ela espere.

Só a plataforma reativa um projeto (`isActive` é só dela): fale com o suporte. Reativado, as chaves voltam a valer, e as sessões guardadas reconectam os números sem QR code novo.

Guia: [Projetos e conexões](https://apiwpp.com/docs/guias/projetos-e-conexoes).
