Bulk update records
bulk_update_recordsApply one field, status, or publish change to many records in a single call, targeting IDs or filter matches with validation and pagination.
Instructions
Apply one change (field values, status and/or published) to many records of a model in a single call: the records named by ids, or every record matching filter with allMatching. Each record is validated, audited and announced to webhooks like update_record. Handles up to 200 records per call; a non-null nextCursor means more records match - pass it back with the same arguments to continue. Returns updated, unchanged (records already at the requested status and visibility, with no data to write), failedCount, a sample of failures (id + reason) and nextCursor.
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": {
"modelIdOrSlug": "<modelIdOrSlug>"
},
"name": "bulk_update_records"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Explicit record ids (from list_records), at most 200 | |
| data | No | Field values written to every selected record, keyed by the model's field keys and merged like update_record: fields you don't pass are unchanged, and a translatable field takes a language map whose missing languages are kept. | |
| cursor | No | nextCursor from the previous call, to continue the same run | |
| filter | No | Same grammar as list_records: per key scalar equality, $in, $gte/$lte, $regex (literal substring); 'status' filters the record status | |
| status | No | New status for every selected record (validated against the model's statusField transitions) | |
| published | No | Publish (true) or unpublish (false) every selected record; an unpublished record stays off every public read until published again | |
| allMatching | No | Target every record matching filter (all of the model's records when filter is omitted); ignores ids | |
| modelIdOrSlug | Yes | The model's id or slug (from list_models) |