List end user events for alias
GET/v2/agent_aliases/:alias_key/end_user_sessions/:session_key/events
Lists the visible events in a session the caller owns, addressed by the alias it was created through, with optional pagination.
An administrator calling this operation is bound to the sessions it owns like every other caller; the operator endpoints are the administrative view of an alias's sessions.
Returns 403 if the session belongs to a different principal. The response only includes event types curated as end-user-safe.
Anonymous widget visitors authenticate by presenting X-Visitor-Id instead of an Authorization credential; the platform mints an identity holding agent_end_user on the addressed alias, which satisfies this operation's role requirement.
Request
Responses
- 200
- 401
- 403
- 404
The session's visible events.
The request carries no valid credential — no Authorization, and for anonymous callers a missing, malformed, or badly signed X-Visitor-Id.
The session does not belong to the caller, or permissions do not allow reading its events. For an anonymous visitor, also returned when the session's connector no longer admits anonymous visitors. Also returned when the request Origin is not in the connector's allowed_origins. Origin checks apply only while the connector remains enabled; disabling or deleting it preserves the other admission and ownership checks.
Alias or session not found.