Excluir conexão
DELETE/tenants/{id}/connections/{connId}
Faz o logout do número (o aparelho conectado sai da lista do celular) e exclui a conexão com a sessão, os templates e o histórico. Não pode ser desfeito. Escopo necessário: connections:write.
Parâmetros de caminho
idstring · uuidobrigatórioIdentificador do projeto (tenantId).
connIdstring · uuidobrigatórioIdentificador da conexão (o número) no projeto.
Respostas
| Código | Erro e descrição |
|---|---|
| 200 | A conexão foi excluída: {"ok": true}. |
| 400 | FST_ERR_VALIDATIONid ou connId 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 ou a conexão não existe, ou não é de quem chama (Tenant not found, Connection not found). A conexão precisa ser do projeto do caminho. |
| 409 | Não foi possível fazer o logout do número, então a conexão não foi excluída: tente de novo. |
| 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 |
| 503 | A instância do gateway que roda a conexão está mudando (um reinício, um failover) ou não responde: espere os segundos de Retry-After e tente de novo.Cabeçalho: Retry-After |
Detalhes
Quando não é possível fazer o logout do número, nada é excluído: a resposta é 409, e basta tentar de novo. Excluída, a conexão deixa de ocupar um dos números contratados pela organização.
Funciona mesmo quando a assinatura da organização não está em dia: excluir só reduz o uso. Para só parar a conexão e guardar a sessão, use POST /tenants/{id}/connections/{connId}/disconnect.
Guia: Projetos e conexões
Esta página ajudou? · Atualizado em 28 set 2026