Excluir formulário DELETE
Exclui um formulário permanentemente. O link público dele deixa de funcionar imediatamente. As mensagens que o formulário já gerou são mantidas.
Endpoint
DELETE https://api.pocketalert.app/v1/forms/{tid}Autenticação
Obrigatório
Inclua um destes cabeçalhos na sua requisição:
Token: <your-api-key>— Obtenha em Chaves de APIAuthorization: Bearer <jwt-token>— Do Login
Requisição
Parâmetros de caminho
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tid | string | ✅ | Identificador do formulário |
Exemplo de requisição
bash
curl -X DELETE "https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9" \
-H "Token: your-api-key"javascript
await fetch('https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9', {
method: 'DELETE',
headers: { 'Token': 'your-api-key' }
});python
import requests
requests.delete(
'https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9',
headers={'Token': 'your-api-key'}
)Resposta
Resposta de sucesso
200 OK
json
{ "data": "success" }Não reversível
Um formulário excluído não pode ser restaurado, e o link dele não pode ser emitido novamente. Para parar de receber respostas sem perder o formulário, defina is_active como false com Atualizar formulário.
Respostas de erro
| Status | Descrição |
|---|---|
401 | Não autorizado — Token inválido ou ausente |
404 | Formulário não encontrado, ou pertence a outra conta |
500 | Falha ao excluir o formulário |