scrapewise_update_matcher_history_settings
Sets runsKept: how many of the group's newest finished matching runs keep their list of matched and
to-review pairs (the list scrapewise_get_matcher_run_pairs reads). Older runs stay in the history with
their counts; only their pair list is removed. It does not start a run and does not change any match.
Args:
- id (string, path, required): the group's id.
- idempotency_key (string, query): REQUIRED for AI-agent keys. A new value for each new change; the
same value only to retry that same change.
- body: {"runsKept": n}, n a whole number from 1 to 10. Without a change the group keeps 10.
- customerRef (string, query, optional): admin key in Take Over only: that customer's
customerUniqueRef.
Returns:
{runsKept}. scrapewise_get_matcher_config_status shows it as runsKept.
Examples:
- Use when: "keep only the last 3 runs of group {id}" -> {"runsKept": 3}.
- Don't use when: you want to see a past run's pairs -> scrapewise_get_matcher_run_pairs.
Error Handling:
Nothing was changed in each.
- 400 FIELD_INVALID (field runsKept): missing, or not from 1 to 10.
- 400 IDEMPOTENCY_KEY_REQUIRED: an AI-agent key sent no idempotency_key.
- 404 NotFound: an unknown group or another customer's group, or the setting is not offered yet.
- 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>",
"idempotency_key": "<idempotency_key>"
},
"name": "scrapewise_update_matcher_history_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | the group's id. | |
| body | No | {"runsKept": n}, n a whole number from 1 to 10. Without a change the group keeps 10. | |
| 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 change, the same value only to retry it. |