Eliminar formulario DELETE
Elimina un formulario de forma permanente. Su enlace público deja de funcionar de inmediato. Los mensajes que el formulario ya ha generado se conservan.
Endpoint
DELETE https://api.pocketalert.app/v1/forms/{tid}Autenticación
Obligatoria
Incluye una de estas cabeceras en tu solicitud:
Token: <your-api-key>— Obtenla en Claves de APIAuthorization: Bearer <jwt-token>— Desde Iniciar sesión
Solicitud
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tid | string | ✅ | Identificador del formulario |
Ejemplo de solicitud
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'}
)Respuesta
Respuesta de éxito
200 OK
json
{ "data": "success" }No reversible
Un formulario eliminado no se puede restaurar y su enlace no se puede volver a emitir. Para dejar de aceptar respuestas sin perder el formulario, establece is_active en false con Actualizar formulario.
Respuestas de error
| Estado | Descripción |
|---|---|
401 | No autorizado: token no válido o ausente |
404 | Formulario no encontrado, o pertenece a otra cuenta |
500 | No se pudo eliminar el formulario |