FLfloqer
ackDB

Re-point a contact to another person (the split primitive)

Moves the affiliation EDGE onto a different human. Used to unpick a wrong fusion (a shared inbox, a recycled email): DELETE /persons/{id}/links/{type}/{value} → POST /persons → this call. Also a CORRECTION ⇒ the edge's events are restamped with the new person_id, which is what preserves the invariant event.person_id === contact.person_id.

The target person must be active (a tombstone resolves to its survivor) and must not already hold an active edge at this company (that would be the same affiliation twice — merge instead).

patch/api/v1/ackdb/contacts/{contactId}

Request

  • Base URL
    http://localhost:3009
  • Auth
    HTTP bearer

Path parameters

contactIdstring required

Contact id (ULID = contacts.contact_id) — the affiliation edge.

Request body

personIdstring required

The person this edge really belongs to.

Response

{ data: Contact, repointed: { fromPersonId, toPersonId, eventsRestamped } } — or repointed: false when the edge already belonged to that person.

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.