API: Actors

Cloud requires the Growth or Scale person_profile entitlement; on-prem requires person_profile in the current verified signed-license feature subset. Case-sensitive prefix search of at least three Unicode characters over actor_id and user_id. In the persisted identity model a non-empty user_id is also the canonical actor_id; no unbounded substring scan is performed. Results are ordered by actor_id and cursor-paginated. If both dates are omitted, the last 30 calendar days in the project's timezone are used; the maximum range is 400 calendar days. Supplying only one date is a validation error. Every ClickHouse query remains scoped by project, both effective time bounds and a finite limit.

Cloud requires the Growth or Scale person_profile entitlement; on-prem requires person_profile in the current verified signed-license feature subset. Reads the exact persisted actor_id used by funnel membership; linked aliases are display metadata and are never merged into the timeline at read time. Summary fields are calculated over the effective bounded date range and are independent of the optional event filter. The timeline is newest-first with a stable (event_time,event_id) cursor and is read through the existing by_actor projection. Every project member, including viewer, receives only response-time sanitized traits and properties; PII-bearing property names are omitted, and raw props, URL and referrer are never returned. If both dates are omitted, the last 30 calendar days in the project's timezone are used; the maximum range is 400 calendar days. Supplying only one date is a validation error. A foreign project or actor is not disclosed and returns 404.