How to Delete Task
Delete one or more prediction jobs by their IDs.
Warning: Deleted predictions cannot be recovered. Only predictions owned by your account can be deleted.
Endpoint
POST https://api.wavespeed.ai/api/v3/predictions/deleteRequest
curl --location --request POST 'https://api.wavespeed.ai/api/v3/predictions/delete' \
--header 'Authorization: Bearer ${WAVESPEED_API_KEY}' \
--header 'Content-Type: application/json' \
--data-raw '{
"ids": ["247ae6a651", "8f5f0bdc7b3742"]
}'Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ids | array | Yes | List of prediction IDs to delete |
Response
{
"code": 200,
"message": "success",
"data": {
"deleted_count": 2
}
}Response Fields
| Field | Type | Description |
|---|---|---|
code | integer | HTTP status code (200 for success) |
message | string | Status message |
data.deleted_count | integer | Number of predictions deleted |
Python Example
import os
import requests
api_key = os.environ.get("WAVESPEED_API_KEY")
def delete_tasks(task_ids):
response = requests.post(
"https://api.wavespeed.ai/api/v3/predictions/delete",
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
},
json={"ids": task_ids}
)
return response.json()
# Delete a single task
result = delete_tasks(["pred_abc123"])
print(f"Deleted: {result['data']['deleted_count']}")
# Delete multiple tasks
result = delete_tasks(["pred_1", "pred_2", "pred_3"])
print(f"Deleted: {result['data']['deleted_count']}")Notes
- Multiple predictions can be deleted in a single request
- Invalid or non-existent IDs will be ignored
- Avoid deleting running predictions unless necessary
When to Delete
| Scenario | Recommendation |
|---|---|
| Task stuck | Delete and retry |
| No longer needed | Delete to clean up |
| Wrong parameters | Delete and resubmit |
Error Responses
| Code | Description |
|---|---|
| 401 | Invalid API key |
| 400 | Invalid request (missing ids) |