GET · Relations

Bi-temporal entity-to-entity edges extracted from memory content.

GET /api/relations

Returns extracted relationships between entities — "Sarah works at Stripe", "Project Atlas depends on Postgres", and so on. Relations are bi-temporal: each row carries valid_from and valid_to so historical facts ("Sarah used to work at Stripe") are preserved.

curl "https://www.mnueron.com/api/relations?from=01HQ…&asOf=2026-01-01" \
  -H "Authorization: Bearer $MNUERON_API_TOKEN"

Query

ParamTypeDefaultNotes
fromuuidSource entity id
touuidTarget entity id
predicatestringe.g. works_at, depends_on, mentioned_in
asOfISO dateOnly return relations valid at this date
limitint2001..1000

Response

{
  "relations": [
    {
      "id": "01HQ…",
      "from_entity_id": "01HQ…",
      "to_entity_id": "01HR…",
      "predicate": "works_at",
      "memory_id": "01HM…",
      "confidence": 0.91,
      "valid_from": "2025-06-01",
      "valid_to": null,
      "recorded_at": 1737070000000
    }
  ]
}

Reading relations is available on every tier. Writing relations happens automatically as a side effect of entity extraction on paid plans / BYOK — there's no direct write endpoint today.

Last updated 2026-05-24edit