scrapewise_update_matcher_fresh_undo
Undoes "start fresh" (manualMatches=FRESH) of a finished matching run of the group: the review decisions
made before that run count again in the review list and in the next run. It does not start a run and
does not change any match result now. Only the newest start fresh of the setup can be undone. Calling it
again answers the same (nothing changes twice).
Args:
- id (string, path, required): the group's id.
- runId (string, path, required): the run that started fresh (history row with freshCurrent=true).
- idempotency_key (string, query): REQUIRED for AI-agent keys. A new value for each new undo; the same
value only to retry it.
- customerRef (string, query, optional): admin key in Take Over only: that customer's
customerUniqueRef.
Returns:
{runId, configId, cutoffAt, undone: true, undoneAt}.
Examples:
- Use when: "bring back my review decisions in group {id}" after a run that started fresh.
- Don't use when: you want to know which run started fresh -> scrapewise_get_matcher_history
(freshCurrent, freshUndone).
Error Handling:
Nothing was changed in each.
- 400 IDEMPOTENCY_KEY_REQUIRED: an AI-agent key sent no idempotency_key.
- 404 NotFound: no such run in this group, or this run did not start fresh.
- 409 FRESH_NOT_CURRENT: a newer start fresh is in place; only the newest can be undone.
- 409 TAKE_OVER_ACTIVE: end Take Over or send customerRef.
- 401 Unauthorized; 403 for a read-only key or a plan without matching.[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": {
"id": "<id>",
"runId": "<runId>",
"idempotency_key": "<idempotency_key>"
},
"name": "scrapewise_update_matcher_fresh_undo"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | the group's id. | |
| runId | Yes | the run that started fresh (history row with freshCurrent=true). | |
| customerRef | No | Admin keys in Take Over only: the customerUniqueRef of the customer the admin works for. Required then; leave it out otherwise. | |
| idempotency_key | Yes | Required for AI-agent keys: a new value per new undo, the same value only to retry it. |