Delete Form DELETE

Permanently delete a form. Its public link stops working at once. Messages the form already produced are kept.

Endpoint

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

Authentication

Required

Include one of these headers in your request:

• Token: <your-api-key> — Get it from API Keys
• Authorization: Bearer <jwt-token> — From Login

Request

Path Parameters

Parameter	Type	Required	Description
tid	string	✅	Form identifier

Example Request

cURL

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

Response

Success Response

200 OK

{ "data": "success" }

Not reversible

A deleted form cannot be restored, and its link cannot be reissued. To stop responses without losing the form, set is_active to false with Update Form.

Error Responses

Status	Description
401	Unauthorized — Invalid or missing token
404	Form not found, or it belongs to another account
500	Failed to delete form