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
- Prepare the request with mode: replace, question_refs, identity_question_ref and the complete expected_rows count.
- Upload and complete the file, then read the review summary. Check inserts, updates and every proposed removal against the source.
- Apply with the returned review_token and confirm_removals: true only after the complete list is approved.
- 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.