How to Delete Task
Cancel or delete tasks from WaveSpeedAI.
Endpoint
DELETE https://api.wavespeed.ai/api/v3/predictions/{task-id}Request
curl --location --request DELETE 'https://api.wavespeed.ai/api/v3/predictions/pred_abc123' \
--header 'Authorization: Bearer ${WAVESPEED_API_KEY}'Response
{
"code": 200,
"message": "success",
"data": {
"id": "pred_abc123",
"status": "deleted"
}
}When to Delete
| Scenario | Recommendation |
|---|---|
| Task stuck | Delete and retry |
| No longer needed | Delete to clean up |
| Wrong parameters | Delete and resubmit |
Important Notes
- Completed tasks: Outputs remain accessible until the 7-day retention period expires
- Processing tasks: Cancellation may not stop generation immediately
- Billing: Partial refunds may apply for cancelled tasks
Python Example
import os
import requests
api_key = os.environ.get("WAVESPEED_API_KEY")
def delete_task(task_id):
response = requests.delete(
f"https://api.wavespeed.ai/api/v3/predictions/{task_id}",
headers={"Authorization": f"Bearer {api_key}"}
)
return response.json()
# Delete a task
result = delete_task("pred_abc123")
print(result)Batch Deletion
Delete multiple tasks:
task_ids = ["pred_1", "pred_2", "pred_3"]
for task_id in task_ids:
delete_task(task_id)
print(f"Deleted {task_id}")Error Responses
| Code | Description |
|---|---|
| 404 | Task not found |
| 401 | Invalid API key |
| 403 | Not authorized to delete |