Read one relation's history

GET/relations/{relationId}/history

Scopegraph:readRoleCurrent memberBilling1 credit per call

The version log for a single edge: who changed it, what, why, before and after state, and the edge that replaced it.

Path parameters

relationIduuidrequired

Response

200 · application/json

…RelationVersion[]

PreviousAdd, replace or retire a relationNextQuote a compute run

curl --fail-with-body "https://app.ghostgtm.ai/api/v1/relations/8a7b6c5d-4e3f-4a2b-9c1d-0e9f8a7b6c5d/history" \
  -H "Authorization: Bearer $GHOST_API_KEY"

Response200

[
  {
    "id": "v2",
    "relation_id": "8a7b6c5d-4e3f-4a2b-9c1d-0e9f8a7b6c5d",
    "version_no": 2,
    "action": "retire",
    "actor_kind": "api_key",
    "actor_id": "key_3e…",
    "source": "api_key:key_3e…",
    "reason": "Account moved segments",
    "before_state": {
      "superseded_at": null
    },
    "after_state": {
      "superseded_at": "2026-09-09T09:00:00.000Z"
    },
    "replaced_by_relation_id": null,
    "created_at": "2026-09-09T09:00:00.000Z"
  }
]

Try itGET /relations/{relationId}/history

API keyrelationIdpath

Sends to app.ghostgtm.ai/api/v1 · 1 credit per call