Skip to main content
Nowledge MemNowledge Mem

Remove an identity profile

POST
/identity/profiles/remove

Use the target server's normal authentication and an explicit exact Space ID. No cross-Space fallback is performed. Requires a human actor with current write authority and the profile's current revision. Starting a removal also requires labs.identityGraph.enabled to be true (default false); turning it off does not block status, retries or background recovery for an already committed removal. The profile leaves active identity lists, candidates and context, and its AI Identity or member link is released; the linked AI Identity or member itself is unchanged. A permanent minimal tombstone retains the non-reusable ID, removal attribution and scoped source-matching evidence so historical references remain resolvable. Display names, aliases, context and card are cleared, while scoped former names and source IDs may remain as discovery-suppression evidence. Consuming that evidence in automatic discovery is a separate capability; this endpoint alone does not prevent rediscovery. Memories and their original text are retained; cleanup updates identity ledgers and support links. Human-confirmed mentions keep their attribution to the removed profile; machine-linked mentions become unresolved. complete: false means cleanup is pending or skipped_sources could not be rewritten; repair those sources and repeat the request. This request does not invoke a model.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/identity/profiles/remove" \  -H "Content-Type: application/json" \  -d '{    "space_id": "string",    "id": "string",    "expected_revision": 0  }'
{  "id": "string",  "revision": 1,  "complete": true,  "skipped_sources": 0}