Copy files to R2 and link them (paid)
nc_filesCopies every file and image the loaded data points at from the source's storage into the customer's R2 bucket, stored under its content hash (the same file is stored once). Records old URL to new key in the file_map table, fills each file field's key column, and keeps the old URL in its legacy column. Links inside text are copied too; rewriting the text is off unless rewrite_text is true, and the originals are backed up. Only the source platform's own storage is copied unless allow_hosts adds more. Resumable: each call does a bounded batch and returns status partial until done. 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_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bucket | No | R2 bucket for the files. Default: the staging bucket. | |
| job_id | Yes | ||
| rewrite | No | Fill the key columns once a file is copied. Default true. | |
| 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_bytes | No | Largest file to copy. Default 50 MB. | |
| max_files | No | Files per call. Default 15. | |
| r2_bucket | No | An R2 bucket in that account, for staging and schema files. | |
| url_prefix | No | Prefix for rewritten text links. Default /files/. | |
| allow_hosts | No | Extra hosts to copy from, for example images.example.com. Links to other hosts are listed, not copied. | |
| 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. | |
| retry_failed | No | Try again the files that failed or were skipped earlier. | |
| rewrite_text | No | Also replace links inside text values with url_prefix plus the new key. Originals go to text_url_backup. Default false. | |
| cf_account_id | No | The customer's Cloudflare account id. | |
| 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. |