Zum Inhalt springen

Formular löschen DELETE ​

Lösche ein Formular dauerhaft. Sein öffentlicher Link funktioniert sofort nicht mehr. Nachrichten, die das Formular bereits erzeugt hat, bleiben erhalten.

Endpunkt ​

DELETE https://api.pocketalert.app/v1/forms/{tid}

Authentifizierung ​

Erforderlich

Füge einen dieser Header in deine Anfrage ein:

Anfrage ​

Pfadparameter ​

ParameterTypErforderlichBeschreibung
tidstring✅Formular-Kennung

Beispielanfrage ​

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'}
)

Antwort ​

Erfolgreiche Antwort ​

200 OK

json
{ "data": "success" }

Nicht rückgängig machbar

Ein gelöschtes Formular kann nicht wiederhergestellt werden, und sein Link kann nicht neu ausgegeben werden. Um Antworten zu stoppen, ohne das Formular zu verlieren, setze is_active mit Formular aktualisieren auf false.

Fehlerantworten ​

StatusBeschreibung
401Nicht autorisiert — Token ungültig oder fehlt
404Formular nicht gefunden oder gehört zu einem anderen Konto
500Formular konnte nicht gelöscht werden

Pocket Alert Dokumentation