DatumForms.
Join the panel Sign in Create a survey

DATUMFORMS DOCUMENTATION

Replace a supplementary list after reviewing removals

Make the active list match a complete incoming file using an explicit removal review.

For researchers and administrators

Updated 15 November 2026

On this page

Before you start

Use an ordinary reference-list survey and a complete file with a stable identity question. API keys need imports:write and imports:replace.

Open: API integration → /api/csv-import.

Steps

  1. Prepare the request with mode: replace, question_refs, identity_question_ref and the complete expected_rows count.
  2. Upload and complete the file, then read the review summary. Check inserts, updates and every proposed removal against the source.
  3. Apply with the returned review_token and confirm_removals: true only after the complete list is approved.
  4. Poll to completion and reconcile the active list with the incoming identity set.

Check the result

The approved replacement changes the active list through the existing import workflow. Historical survey responses remain interpretable by their original versions.

Troubleshooting

If the underlying list changes after preview, applying is refused; obtain a fresh preview. Do not use replacement mode for an incremental file or to alter managed panel answers.

Next steps

Maintain a reference list.

Need help with this task? Contact DatumForms. Include the article URL and the step you reached.

Tracking preferences

Essential functions stay on. Choose whether to allow optional tracking on this website. You can change your choices in the footer at any time.

Read our privacy policy