Bulk-edit fields across many donors (async)
Queues a bulkEditDonors job for each targeted donor that applies the supplied field/value updates (admin name is captured for the activity log). Use donor_ids as an array of IDs to target a specific set, or the literal string all (with hysform_id) to operate on every donor of that form. The handler returns immediately once the jobs are dispatched; updates land asynchronously through the queue worker. Requires permission: donors_manage.
Authorizations
Passport bearer token authentication for legacy admin sessions.
Body
Either an array of donor IDs or the literal string all. Validation rule: required.
Map of field name to new value to apply to every targeted donor. Keys may be standardized columns (e.g. first_name, phone) or custom keys defined in the donor form's json_fields schema. When clear_fields is true, clear_field_keys drives which fields are cleared; values may still carry real entries for the other, non-cleared selected fields in the same request, and a key present in both is cleared.
When true, clears every field listed in clear_field_keys in addition to applying any other entered values.
false
Field keys to set empty when clear_fields is true.
Required and must be true when values.type changes donor profile type.
true
Required when donor_ids is all — the donor form whose donors should be selected.
42
Legacy client hint ignored by the controller; donor selection is scoped to the authenticated client.
207
Response
Bulk-edit jobs dispatched.
"Donors are being edited"