API reference / Apps
List PostHog events
The events the workspace's PostHog project recorded in the last days, busiest first (at most 50), with how often and by how many people. Start here to learn the event names. Read only. Needs PostHog connected.
get
/api/v1/apps/posthog/eventsOther ways to call it
CLI
troopy posthog eventsMCP tool
troopy_posthog_eventsRate limit30 calls in 60 seconds, for each key
Query parameters
daysintegerDays back from today, at most 90
Default 30 · At least 1 · At most 90
searchstringPart of the event's name
At most 100 characters
Response
200 · application/jsondata*array<object>4 properties
event*stringtotal*numberTimes it happened in the period
users*numberDistinct people who did it (anonymous visitors count until they are identified)
lastSeen*string | nullErrors
400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.