analytics_person_timeline

Tool

analytics_person_timeline

Return one resolved person's profile and their chronological activity across every identity-bearing semantic entity of the current product.

Return one resolved person's profile and their chronological activity across every identity-bearing semantic entity of the current product. Address the person either by person_id or by any single identifier (email, phone, users_id, anonymous_id), which is normalised exactly as the identity graph normalised it. Deterministic: no LLM, and only catalog-declared columns are returned. Prefer this over analytics_query_run whenever the question is about one specific person.

Behavior

HTTP: POST /analytics/persons/timeline

Arguments

Name	Type	Required	Description
to	string	—	Inclusive last day (UTC); unbounded when omitted
from	string	—	Inclusive first day (UTC); unbounded when omitted
limit	integer	—	Maximum events to return, newest first
person_id	string	—	Graph person id, when already known
identifier	object	—	Any single identifier belonging to the person

Response

Field	Type	Always
meta	object	•
events	array	•
person	object	•
truncated	boolean	•

Try it

Return one resolved person's profile and their chronological activity across every identity-bearing semantic entity of the current product.

When to use

Example

Ask your agent something like this:

Return one resolved person's profile and their chronological activity across every identity-bearing semantic entity of the current product.

The agent will invoke analytics_person_timeline with these arguments:

{}