Ir para o conteúdo

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 API
  • Authorization: Bearer <jwt-token> — Do Login

Requisição ​

Parâmetros de caminho ​

ParâmetroTipoObrigatórioDescrição
tidstring✅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 ​

StatusDescrição
401Não autorizado — Token inválido ou ausente
404Formulário não encontrado, ou pertence a outra conta
500Falha ao excluir o formulário

Documentação do Pocket Alert