Grails API Documentation

DELETE /api/v1/watchlist/bulk

Remove multiple watchlist entries by their IDs. Only entries belonging to the authenticated user (via list ownership) are deleted.

Authentication: Required

Cache: None

Request Body

Field	Type	Required	Description
`ids`	number[]	Yes	Watchlist entry IDs to remove (1–100)

Sample Request


curl -X DELETE -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  https://api.grails.app/api/v1/watchlist/bulk \
  -d '{ "ids": [1, 2, 3, 4, 5] }'

Response


// 200 OK
{
  "success": true,
  "data": {
    "removed": 5
  },
  "meta": {
    "timestamp": "2026-04-08T00:00:00.000Z",
    "version": "1.0.0"
  }
}

Error Responses

Status	Code	Description
400	`VALIDATION_ERROR`	Invalid request body