DELETE /api/v1/watchlist/lists/:listId
Delete a watchlist and all its items (cascade delete). The default watchlist cannot be deleted.
Authentication: Required
Cache: None
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
listId | number | Yes | List ID |
Sample Request
curl -X DELETE -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.grails.app/api/v1/watchlist/lists/2"Response
// 200 OK
{
"success": true,
"data": {
"message": "List deleted"
},
"meta": {
"timestamp": "2026-04-08T00:00:00.000Z",
"version": "1.0.0"
}
}Error Responses
| Status | Code | Description |
|---|---|---|
| 400 | CANNOT_DELETE_DEFAULT | The default watchlist cannot be deleted |
| 403 | FORBIDDEN | List belongs to another user |
| 404 | NOT_FOUND | List not found |
Last updated on