Удаление формы DELETE
Безвозвратно удаляет форму. Её публичная ссылка сразу перестаёт работать. Сообщения, которые форма уже отправила, сохраняются.
Эндпоинт
DELETE https://api.pocketalert.app/v1/forms/{tid}Аутентификация
Обязательно
Добавьте в запрос один из этих заголовков:
Token: <your-api-key>— получите его в API-ключахAuthorization: Bearer <jwt-token>— из входа
Запрос
Параметры пути
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
tid | string | ✅ | Идентификатор формы |
Пример запроса
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'}
)Ответ
Успешный ответ
200 OK
json
{ "data": "success" }Не обратимо
Удалённую форму нельзя восстановить, а её ссылку нельзя выпустить заново. Чтобы прекратить приём ответов без потери формы, установите is_active в false с помощью обновления формы.
Ошибки
| Статус | Описание |
|---|---|
401 | Не авторизован — токен неверный или отсутствует |
404 | Форма не найдена или принадлежит другому аккаунту |
500 | Не удалось удалить форму |