Desativar projeto
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.
Parâmetros de caminho
idstring · uuidobrigatórioIdentificador do projeto (tenantId).
Respostas
| Código | Erro e descrição |
|---|---|
| 200 | O projeto foi desativado: {"deleted": true}. |
| 400 | FST_ERR_VALIDATIONid 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.Cabeçalho: Retry-After |
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
Esta página ajudou? · Atualizado em 28 set 2026