{"deleted": N}, or 400 Bad Request if no filter is given or a timestamp is malformed.Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
DELETE /tasks - hard-delete tasks matching a filter across all statuses.
DELETE /tasks
| Query param | Description |
|---|---|
url | Delete tasks targeting this exact URL. |
status | Delete only tasks in this lifecycle status (pending, running, succeeded, failed, cancelled). |
before | Delete tasks scheduled before this time (RFC3339). |
after | Delete tasks scheduled after this time (RFC3339). |
# Everything for one URL
curl -X DELETE "http://localhost:8080/tasks?url=https://example.com/webhook" \
-H "X-API-Key: your-secret"
# Combine filters
curl -X DELETE "http://localhost:8080/tasks?url=https://example.com/webhook&before=2025-05-26T15:00:00Z" \
-H "X-API-Key: your-secret"
# Purge every failed task
curl -X DELETE "http://localhost:8080/tasks?status=failed" \
-H "X-API-Key: your-secret"
{"deleted": N}, or 400 Bad Request if no filter is given or a timestamp is malformed.