GET / PATCH / DELETE · Entity

GET /api/entities/:id

Fetch a single entity. Pass ?include_memories=1 to additionally return up to 100 linked memories.

curl "https://www.mnueron.com/api/entities/01HQ…?include_memories=1" \
  -H "Authorization: Bearer $MNUERON_API_TOKEN"

Response

{
  "id": "01HQ…",
  "display_name": "Sarah Chen",
  "entity_type": "person",
  "aliases": ["sarah", "S. Chen"],
  "mention_count": 14,
  "first_seen_at": 1735000000000,
  "last_seen_at": 1737070000000,
  "metadata": {},
  "memories": [
    { "id": "01HQ…", "content": "...", "namespace": "work",
      "created_at": ..., "linked_via": "extraction" }
  ]
}

PATCH /api/entities/:id

Rename, retype, edit aliases or metadata. All fields optional.

curl -X PATCH https://www.mnueron.com/api/entities/01HQ… \
  -H "Authorization: Bearer $MNUERON_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "Sarah K. Chen",
    "aliases": ["sarah", "S. Chen", "SKC"],
    "metadata": { "company": "Stripe" }
  }'

Field	Type	Notes
`display_name`	string
`entity_type`	string	Same enum as `?type` above
`aliases`	string[]	Replaces the array
`metadata`	object	OBJECT-merge: existing keys are preserved, new keys overwrite. Pass `null` to clear

DELETE /api/entities/:id

Removes the entity row. CASCADE-deletes the memory_entities edges (the memories themselves aren't touched). Returns { "ok": true }.