---
title: "Manage Network Identity Resolution"
method: POST
path: "/api/network/identity-resolution/manage"
tags: ["network"]
---

# Manage Network Identity Resolution

`POST /api/network/identity-resolution/manage`

## Request

- Base URL: `https://api.vruum.ai`
- URL: `https://api.vruum.ai/api/network/identity-resolution/manage`
- Auth: `HTTPBearer` (a scheme the document does not define)

Preview or apply one durable identity-resolution decision.

``commit=false`` is mandatory preview mode and performs no write. Re-submit
the reviewed action with ``commit=true`` to merge prospect rows, merge one
owned source identity, add/remove a company affiliation, or classify an
email mailbox. Decisions are tenant-scoped, attributed to the caller, and
survive future syncs. Required active-projection rebuilds run asynchronously.

## Request body

- union
  - NetworkIdentityMergeAction
    - `action` 'merge_identity', required
    - `source_identity_ref` string, required
    - `target_entity_ref` string, nullable
    - `target_person_ref` string, nullable
    - `reason` string, required
    - `commit` boolean
  - NetworkPeopleMergeAction
    - `action` 'merge_people', required
    - `source_person_ref` string, required
    - `surviving_person_ref` string, required
    - `reason` string, required
    - `commit` boolean
  - NetworkPeopleReviewDecisionAction
    - `action` 'review_people', required
    - `source_person_ref` string, required
    - `surviving_person_ref` string, required
    - `decision` 'not_duplicate', required
    - `reason` string, required
    - `commit` boolean
  - NetworkAffiliationDecisionAction
    - `action` 'set_affiliation', required
    - `target_entity_ref` string, nullable
    - `target_person_ref` string, nullable
    - `company_ref` string, required
    - `decision` 'add' | 'remove'
    - `affiliation_kind` 'employment' | 'advisory' | 'membership' | 'other'
    - `title` string, nullable
    - `basis` 'manual' | 'email_domain' | 'source_claim' | 'company_name'
    - `reason` string, required
    - `commit` boolean
  - NetworkMailboxDecisionAction
    - `action` 'classify_mailbox', required
    - `source_identity_ref` string, required
    - `classification` 'person' | 'shared_mailbox' | 'automated', required
    - `reason` string, required
    - `commit` boolean

## Response `200`

Successful Response

- ManageNetworkIdentityResolutionResponse
  - `status` 'preview' | 'applied', required
  - `change` object, required
  - `projection_run_id` string, nullable
  - `next_actions` string[]

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error

---

[API](https://skmtc.dev/vruum/apis/vruum-public-api.md) · [All operations](https://skmtc.dev/vruum/apis/vruum-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vruum/apis/vruum-public-api/revisions/b8ada111c30a?raw)