Verify the target against the source (paid)
nc_verifyChecks the loaded data and says pass or fail: row counts per type against the source's count now, a checksum sample (default 500 records per type, sha256 of the canonical JSON of the mapped columns, read back from D1), broken foreign keys, and that every copied file exists in R2. Writes verification.md to the customer's R2. Reads the source and the target; changes nothing. Each call does a bounded part and returns partial until done. nc_cutover refuses to run unless the last verification passed and nothing changed after it. Paid: needs a pass for the app, or the free trial for plans up to 1,000 records.
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": {
"job_id": "<job_id>"
},
"name": "nc_verify"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| types | No | Data type keys to verify. Default: all. | |
| job_id | Yes | ||
| sample | No | Records to checksum per type. Default 500. | |
| restart | No | Start a new verification instead of continuing the open one. | |
| upgrade | No | Set true to pay the difference to the next pass that fits, only when the app is past its pass's (or free trial's) record or file limit. | |
| go_ahead | No | Set true only when a charge applies, once the owner has seen the estimate and agreed to it. Not needed under the free trial or a pass that already covers the app. Needed again after a pass has expired. | |
| max_cost | No | Work per call. Default 120. | |
| r2_bucket | No | An R2 bucket in that account, for staging and schema files. | |
| skip_source | No | Do not count the source's records (no token). Counts are then compared with what the export reported. | |
| cf_api_token | No | A Cloudflare API token with D1 edit permission on that account. Sealed in the job, deleted when it ends. Prefer nc_connect with job_id: the owner types tokens on a secure page. Only pass it here if nc_connect is not available. | |
| cf_account_id | No | The customer's Cloudflare account id. | |
| data_api_token | No | The source app's Data API token, if it is not held for this job any more. Prefer nc_connect with job_id: the owner types tokens on a secure page. Only pass it here if nc_connect is not available. | |
| r2_access_key_id | No | Access key id of an R2 API token that can read and write that bucket. Prefer nc_connect with job_id: the owner types tokens on a secure page. Only pass it here if nc_connect is not available. | |
| r2_secret_access_key | No | Its secret. Sealed in the job, deleted when it ends. Prefer nc_connect with job_id: the owner types tokens on a secure page. Only pass it here if nc_connect is not available. | |
| accept_unmapped_files | No | Accept that some rows keep a source file URL with no copy (links to other hosts, files that could not be copied). Without it they fail the verification. |