Skip to content
finwave Docs

Ensure Individuals

In this guide you will learn:

  • What “Ensure Individuals” does and why it matters
  • When to run it in the onboarding workflow
  • How to interpret the results

What it does

Section titled “What it does”

Ensure Individuals is a pre-sync step that creates individual records on the finwave server for every individual ID found in your manifest. This ensures that when encounters are uploaded, the server already knows about each individual and can link images correctly for downstream identification matching.

Without this step, encounters referencing unknown individuals would still upload successfully, but the individual associations might be delayed until the server creates them on the fly during ingestion.

When to run it

Section titled “When to run it”

Run Ensure Individuals once before your first sync for a manifest. You do not need to run it again unless you add new individual IDs to your manifest (for example, by re-materializing with updated data).

The button appears on each manifest row in the sync page. Click it to start the process.

How it works

Section titled “How it works”
  1. The desktop app scans all approved encounters in the manifest and collects unique individual IDs.
  2. For each individual, it sends a request to the finwave server to create or confirm the record.
  3. Progress is shown inline: 12 / 45 -- Nebula (current count, total, and the individual being processed).

Interpreting results

Section titled “Interpreting results”

When the process finishes, you see a summary:

  • X individuals found — Total unique IDs in your manifest.
  • Y already existed — These were already on the server (no action needed).
  • Z created — New individual records created on the server.
  • W failed — Could not be created (check the error details below the summary).
Section titled “Related”