Relationship Intelligence

Remove a person

Confirm remove sends reason user_action. The server stores that reason, deletes the person and every derived row, and writes suppression anchors so the next sync cannot recreate them.

delete/v1/relationship-persons/{personId}

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/relationship-persons/{personId}
Auth: HTTP bearer

Path parameters

personIdstring uuid required

Person id.

Request body

reason'user_action' | 'subject_request' required

Why this person was removed.

Example request

{
  "reason": "user_action"
}

Response

Removal receipt.

attributesDeletedinteger required

Attribute rows deleted.

completedAtstring date-time required

Completion time.

identitiesDeletedinteger required

Identity rows deleted.

interactionStatsDeletedinteger required

Interaction stat rows deleted.

mergeCandidatesDeletedinteger required

Merge candidates deleted.

personIdstring uuid required

Removed person id.

personsDeletedinteger required

Person rows deleted.

reason'user_action' | 'subject_request' required

Why this person was removed.

receiptIdstring uuid required

Receipt id.

requestedAtstring date-time required

Request time.

suppressedIdentitiesinteger required

Suppression anchors written.

Example response

{
  "attributesDeleted": 1,
  "completedAt": "2026-07-31T14:01:00Z",
  "identitiesDeleted": 1,
  "interactionStatsDeleted": 1,
  "personId": "1b8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "personsDeleted": 1,
  "reason": "user_action",
  "receiptId": "fb8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "requestedAt": "2026-07-31T14:00:00Z",
  "suppressedIdentities": 1
}

Changes

No operation changes recorded.