Entities

Bitemporal sweep over an entity’s memory

fact.recorded / fact.retracted events on the TRANSACTION-time axis — when the graph learned and unlearned things, not when they were true; each recorded event also carries validFrom, the valid-time instant, for readers that want the world’s order. since / until page the window; recordedAt cuts to events known by T. userId is honoured only while READ_SURFACE_USER_SCOPE is on (this surface predates migration 0055 and otherwise pins userId IS NONE); a user-bound token is pinned to its own end user, and a mismatch is 403.

Required scope: brain:read.

get/v1/entities/{id}/timeline

Request

  • Base URL: https://brain.inite.ai
  • URL: https://brain.inite.ai/v1/entities/{id}/timeline
  • Auth: HTTP bearer

Path parameters

idstring required

Entity id — short or fully-qualified.

Query parameters

sincestring

ISO-8601 lower bound on recordedAt.

untilstring

ISO-8601 upper bound on recordedAt.

recordedAtstring

Only events known by this instant.

userIdstring

Per-user scope (READ_SURFACE_USER_SCOPE only).

Response

The event sweep.

entityIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.