scrapewise_delete_scraper_site
Permanently removes a Site (the URL inventory backing a fixed-URL-list scraper)
and cascades to delete every Link attached to it. The scraper itself is NOT
deleted — only the Site bound to it. Use to wipe a scraper's URL list when
re-populating, or as part of a hermetic eval-environment teardown.
Idempotent: deleting a site that's already gone returns 204 No Content rather
than 404 (ADR-013 destructive idempotency — agent retries are safe).
Args:
- siteId (string, path param, required): the Site's MongoDB ObjectId. Get
via `scrapewise_get_scraper_site` (which returns the site for a scraper).
Returns:
204 No Content. Empty body. Verify via a follow-up `scrapewise_get_scraper_site`
call returning null.
Examples:
- Use when: "wipe the URL list of scraper {id}" → fetch site id via
scrapewise_get_scraper_site, then call this op.
- Use when: tearing down an eval-environment site before re-seeding fresh URLs.
- Don't use when: you want to delete the scraper itself → use
scrapewise_delete_scraper (or its preview/commit pair).
- Don't use when: you want to remove specific URLs (not the whole site) → no
per-link delete API today; re-PUT a smaller SiteDTO.
Error Handling:
- 204 on success OR on idempotent-retry of an already-deleted site.
- 400 if siteId is not a valid ObjectId.
- 401 Unauthorized.
- 500 INTERNAL.[runtime hint] This tool returns JSON-as-text — its response shape is dynamic (per-scraper itemsConfig, file binary, etc.) so the MCP outputSchema is omitted. Do not rely on the presence of any specific field in the response; treat the result as a string-or-object blob and parse defensively.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"siteId": "<siteId>"
},
"name": "scrapewise_delete_scraper_site"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siteId | Yes | the Site's MongoDB ObjectId. Get via `scrapewise_get_scraper_site` (which returns the site for a scraper). |