v1

Get Profile

The assembled profile of one end user: the active typed facts known about them, self-facts first, grouped by predicate family. Deterministic (no model call). user_id is required: a profile is per-end-user (this is what distinguishes it from the flat GET /v1/facts list). as_of gives the point-in-time profile ("what was true on 2026-03-01"), known_as_of the profile as the store knew it then ("what we knew on 2026-03-01").

get/v1/profile

Request

  • Base URL: https://api.korely.ai
  • URL: https://api.korely.ai/v1/profile
  • Auth: HTTP bearer

Query parameters

user_idstring required

End user to build the profile for.

agent_idstring nullable

Filter to one agent namespace.

as_ofstring nullable

ISO date/datetime: the profile as it was on that date.

known_as_ofstring nullable

ISO date/datetime: the facts as the store knew them then: learned by then, with the ends learned by then, true at as_of (default: that same moment). A move made in September and told in October: as_of September returns the new address, known_as_of September the old one.

exclude_sessionsboolean

Leave out the facts only work sessions state (memories written with kind: session, what a coding assistant's hooks save). Default false.

Response

Successful Response

user_idstring required
as_ofstring nullable required
known_as_ofstring nullable
by_familyobject required
totalinteger required
truncatedboolean required

Changes

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