Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

feat(workflows): add the transactional email log tab (#127747)

Daniel Marchuk746bb5acfdb9
diff --git a/frontend/src/products.tsx b/frontend/src/products.tsx
index 7182eea5faf7..c2ea23c82d9b 100644
--- a/frontend/src/products.tsx
+++ b/frontend/src/products.tsx
@@ -402,6 +402,7 @@ export const productRoutes: Record<string, [string, string]> = {
'/transactional/reputation': ['Transactional', 'transactional'],
'/transactional/settings': ['Transactional', 'transactional'],
'/transactional/new': ['Transactional', 'transactional'],
+ '/transactional/log': ['Transactional', 'transactional'],
'/transactional/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],
'/broadcasts/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],
'/broadcasts/new': ['Broadcast', 'broadcast'],
@@ -2068,6 +2069,7 @@ export const productUrls = {
broadcastNew: (): string => '/broadcasts/new',
transactional: (tab?: MessagingNavTabKey): string => `/transactional${tab ? `/${tab}` : ''}`,
transactionalNew: (): string => '/transactional/new',
+ transactionalLog: (): string => '/transactional/log',
transactionalTemplate: (id: string): string => `/transactional/library/templates/${id}`,
broadcastsTemplate: (id: string): string => `/broadcasts/library/templates/${id}`,
}
diff --git a/frontend/src/scenes/hog-functions/invocations/HogInvocations.tsx b/frontend/src/scenes/hog-functions/invocations/HogInvocations.tsx
index fef7c2dd3a37..717c56a8013b 100644
--- a/frontend/src/scenes/hog-functions/invocations/HogInvocations.tsx
+++ b/frontend/src/scenes/hog-functions/invocations/HogInvocations.tsx
@@ -25,14 +25,11 @@ import api from 'lib/api'
import { CopyToClipboardInline } from 'lib/components/CopyToClipboard'
import { DateFilter } from 'lib/components/DateFilter/DateFilter'
import { TZLabel } from 'lib/components/TZLabel'
-import { dayjs } from 'lib/dayjs'
import { Link } from 'lib/lemon-ui/Link'
-import { CUSTOM_OPTION_KEY } from 'lib/utils/dateFilters'
-import { DATE_TIME_FORMAT, formatDateRange } from 'lib/utils/datetime'
import { escapeHogQLString, hogql } from 'lib/utils/hogql'
import { urls } from 'scenes/urls'
-import { DateMappingOption, HogFunctionTypeType, PersonType } from '~/types'
+import { HogFunctionTypeType, PersonType } from '~/types'
import { PersonDisplay } from 'products/persons/frontend/components/PersonDisplay'
import { asDisplay } from 'products/persons/frontend/person-utils'
@@ -53,6 +50,7 @@ import {
isRerunnableHogFunctionType,
isRerunWrapperKind,
} from './hogInvocationsLogic'
+import { INVOCATIONS_DATE_OPTIONS } from './invocationsDateOptions'
import { InvocationsSparkline } from './InvocationsSparkline'
const STATUS_OPTIONS: { value: RunStatus; label: string }[] = [
@@ -62,58 +60,6 @@ const STATUS_OPTIONS: { value: RunStatus; label: string }[] = [
{ value: 'canceled', label: 'Canceled' },
]
-/**
- * Preset windows mirroring the Logs viewer — covers minute-level scoping
- * (5m / 30m / 1h) plus the longer windows the table already supported.
- * Pairs with `allowTimePrecision` + `allowFixedRangeWithTime` so custom
- * ranges accept minute-precision timestamps.
- */
-const INVOCATIONS_DATE_OPTIONS: DateMappingOption[] = [
- { key: CUSTOM_OPTION_KEY, values: [] },
- {
- key: 'Last 5 minutes',
- values: ['-5M'],
- getFormattedDate: (date) => date.subtract(5, 'minute').format(DATE_TIME_FORMAT),
- defaultInterval: 'minute',
- },
- {
- key: 'Last 30 minutes',
- values: ['-30M'],
- getFormattedDate: (date) => date.subtract(30, 'minute').format(DATE_TIME_FORMAT),
- defaultInterval: 'minute',
- },
- {
- key: 'Last 1 hour',
- values: ['-1h'],
- getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(1, 'h'), date),
- defaultInterval: 'hour',
- },
- {
- key: 'Last 4 hours',
- values: ['-4h'],
- getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(4, 'h'), date),
- defaultInterval: 'hour',
- },
- {
- key: 'Last 24 hours',
- values: ['-24h'],
- getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(24, 'h'), date.endOf('d')),
- defaultInterval: 'hour',
- },
- {
- key: 'Last 7 days',
- values: ['-7d'],
- getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(7, 'd'), date.endOf('d')),
- defaultInterval: 'day',
- },
- {
- key: 'Last 30 days',
- values: ['-30d'],
- getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(30, 'd'), date.endOf('d')),
- defaultInterval: 'day',
- },
-]
-
const tagTypeForStatus = (status: RunStatus): LemonTagProps['type'] => {
switch (status) {
case 'succeeded':
diff --git a/frontend/src/scenes/hog-functions/invocations/invocationsDateOptions.ts b/frontend/src/scenes/hog-functions/invocations/invocationsDateOptions.ts
new file mode 100644
index 000000000000..bee2bfdabdf8
--- /dev/null
+++ b/frontend/src/scenes/hog-functions/invocations/invocationsDateOptions.ts
@@ -0,0 +1,57 @@
+import { dayjs } from 'lib/dayjs'
+import { CUSTOM_OPTION_KEY } from 'lib/utils/dateFilters'
+import { DATE_TIME_FORMAT, formatDateRange } from 'lib/utils/datetime'
+
+import { DateMappingOption } from '~/types'
+
+/**
+ * Preset windows mirroring the Logs viewer — covers minute-level scoping
+ * (5m / 30m / 1h) plus the longer windows the table already supported.
+ * Pairs with `allowTimePrecision` + `allowFixedRangeWithTime` so custom
+ * ranges accept minute-precision timestamps.
+ */
+export const INVOCATIONS_DATE_OPTIONS: DateMappingOption[] = [
+ { key: CUSTOM_OPTION_KEY, values: [] },
+ {
+ key: 'Last 5 minutes',
+ values: ['-5M'],
+ getFormattedDate: (date) => date.subtract(5, 'minute').format(DATE_TIME_FORMAT),
+ defaultInterval: 'minute',
+ },
+ {
+ key: 'Last 30 minutes',
+ values: ['-30M'],
+ getFormattedDate: (date) => date.subtract(30, 'minute').format(DATE_TIME_FORMAT),
+ defaultInterval: 'minute',
+ },
+ {
+ key: 'Last 1 hour',
+ values: ['-1h'],
+ getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(1, 'h'), date),
+ defaultInterval: 'hour',
+ },
+ {
+ key: 'Last 4 hours',
+ values: ['-4h'],
+ getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(4, 'h'), date),
+ defaultInterval: 'hour',
+ },
+ {
+ key: 'Last 24 hours',
+ values: ['-24h'],
+ getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(24, 'h'), date.endOf('d')),
+ defaultInterval: 'hour',
+ },
+ {
+ key: 'Last 7 days',
+ values: ['-7d'],
+ getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(7, 'd'), date.endOf('d')),
+ defaultInterval: 'day',
+ },
+ {
+ key: 'Last 30 days',
+ values: ['-30d'],
+ getFormattedDate: (date: dayjs.Dayjs) => formatDateRange(date.subtract(30, 'd'), date.endOf('d')),
+ defaultInterval: 'day',
+ },
+]
diff --git a/products/workflows/frontend/Transactional/TransactionalScene.tsx b/products/workflows/frontend/Transactional/TransactionalScene.tsx
index 1ff7688fefdb..724efbb4fd2f 100644
--- a/products/workflows/frontend/Transactional/TransactionalScene.tsx
+++ b/products/workflows/frontend/Transactional/TransactionalScene.tsx
@@ -25,9 +25,12 @@ import {
MessagingNavTabKey,
isMessagingSetupTab,
} from '../messagingTabs'
+import { TransactionalEmailLog } from './log/TransactionalEmailLog'
import { TransactionalEmailsTable } from './TransactionalEmailsTable'
import { TransactionalEmailWizard } from './wizard/TransactionalEmailWizard'
+type TransactionalTab = 'transactional' | 'log'
+
export const scene: SceneExport = {
component: TransactionalScene,
productKey: ProductKey.WORKFLOWS,
@@ -39,11 +42,14 @@ export function TransactionalScene(): JSX.Element {
const todayRailNav = useFeatureFlag('TODAY_RAIL_NAV')
// The tab routes are literal paths, so the tab is the last path segment rather than a route param.
const lastSegment = location.pathname.split('/').pop() ?? ''
- const currentTab: MessagingNavTabKey | 'transactional' = MESSAGING_NAV_TAB_KEYS.includes(
+ const currentTab: MessagingNavTabKey | TransactionalTab = MESSAGING_NAV_TAB_KEYS.includes(
lastSegment as MessagingNavTabKey
)
? (lastSegment as MessagingNavTabKey)
- : 'transactional'
+ : lastSegment === 'log'
+ ? lastSegment
+ : 'transactional'
+ const isTransactionalTab = currentTab === 'transactional' || currentTab === 'log'
if (!showTransactional) {
return <NotFound object="page" />
@@ -60,7 +66,7 @@ export function TransactionalScene(): JSX.Element {
description="Send emails from your code with one API call"
resourceType={{ type: 'transactional' }}
actions={
- currentTab === 'transactional' ? (
+ isTransactionalTab ? (
<AccessControlAction
resourceType={AccessControlResourceType.Workflow}
minAccessLevel={AccessControlLevel.Editor}
@@ -90,8 +96,8 @@ export function TransactionalScene(): JSX.Element {
}
/>
<EmailSuspensionBanner />
- <LemonTabs<'transactional' | 'library' | 'messaging-setup'>
- activeKey={currentTab === 'transactional' || currentTab === 'library' ? currentTab : 'messaging-setup'}
+ <LemonTabs<TransactionalTab | 'library' | 'messaging-setup'>
+ activeKey={isTransactionalTab || currentTab === 'library' ? currentTab : 'messaging-setup'}
tabs={[
{
label: 'Transactional emails',
@@ -99,6 +105,12 @@ export function TransactionalScene(): JSX.Element {
link: urls.transactional(),
content: <TransactionalEmailsTable />,
},
+ {
+ label: 'Log',
+ key: 'log',
+ link: urls.transactionalLog(),
+ content: <TransactionalEmailLog />,
+ },
{
label: 'Templates',
key: 'library',
diff --git a/products/workflows/frontend/Transactional/log/TransactionalEmailLog.tsx b/products/workflows/frontend/Transactional/log/TransactionalEmailLog.tsx
new file mode 100644
index 000000000000..d8c2a2c7ec98
--- /dev/null
+++ b/products/workflows/frontend/Transactional/log/TransactionalEmailLog.tsx
@@ -0,0 +1,208 @@
+import { useActions, useValues } from 'kea'
+
+import { IconCursorClick, IconEye, IconRefresh, IconSearch } from '@posthog/icons'
+import { LemonBanner, LemonButton, LemonInput, LemonSelect, LemonTag, Tooltip } from '@posthog/lemon-ui'
+
+import { DateFilter } from 'lib/components/DateFilter/DateFilter'
+import { TZLabel } from 'lib/components/TZLabel'
+import { LemonTable } from 'lib/lemon-ui/LemonTable'
+import { INVOCATIONS_DATE_OPTIONS } from 'scenes/hog-functions/invocations/invocationsDateOptions'
+
+import type { TransactionalEmailLogEntryApi } from 'products/messaging/frontend/generated/api.schemas'
+
+import { messageTemplatesLogic } from '../../TemplateLibrary/messageTemplatesLogic'
+import { EMAIL_STATUS_DESCRIPTION, EMAIL_STATUS_LABEL, EMAIL_STATUS_TAG, emailReasonText } from './emailLogStatus'
+import { DEFAULT_LOG_FILTERS, LOG_RETENTION_DAYS, transactionalEmailLogLogic } from './transactionalEmailLogLogic'
+
+/** Lets a long address wrap before its domain instead of mid-word. */
+function EmailAddress({ address }: { address: string }): JSX.Element {
+ if (!address) {
+ return <span className="text-secondary">Unknown recipient</span>
+ }
+ const at = address.lastIndexOf('@')
+ if (at <= 0) {
+ return <span className="break-all">{address}</span>
+ }
+ return (
+ <span className="break-words">
+ {address.slice(0, at)}
+ <wbr />
+ {address.slice(at)}
+ </span>
+ )
+}
+
+const STATUS_OPTIONS = (['delivered', 'sent', 'queued', 'bounced', 'complained', 'failed'] as const).map((status) => ({
+ value: status,
+ label: EMAIL_STATUS_LABEL[status],
+}))
+
+export function TransactionalEmailLog(): JSX.Element {
+ const { emails, pageLoading, pageFailed, filters, isFiltered, pagination } = useValues(transactionalEmailLogLogic)
+ const { setFilters, setPage, refresh, loadEmails } = useActions(transactionalEmailLogLogic)
+ const { transactionalTemplates } = useValues(messageTemplatesLogic)
+
+ const emailOptions = transactionalTemplates
+ .filter((template) => template.transactional_hog_flow_id)
+ .map((template) => ({
+ value: template.transactional_hog_flow_id as string,
+ label: template.name || 'Unnamed email',
+ }))
+
+ return (
+ <div className="flex flex-col gap-2">
+ <div className="flex flex-wrap items-center gap-2 justify-between">
+ <div className="flex items-center gap-2 flex-1 min-w-60">
+ <LemonInput
+ type="search"
+ size="small"
+ placeholder="Search by recipient or message ID"
+ fullWidth
+ value={filters.search}
+ onChange={(search) => setFilters({ search })}
+ prefix={<IconSearch />}
+ allowClear
+ data-attr="transactional-email-log-search"
+ />
+ </div>
+ <div className="flex items-center gap-2 flex-wrap">
+ <LemonSelect
+ size="small"
+ dropdownMatchSelectWidth={false}
+ value={filters.workflowId}
+ onChange={(workflowId) => setFilters({ workflowId })}
+ options={[{ value: null, label: 'All emails' }, ...emailOptions]}
+ data-attr="transactional-email-log-email-filter"
+ />
+ <LemonSelect
+ size="small"
+ dropdownMatchSelectWidth={false}
+ value={filters.status}
+ onChange={(status) => setFilters({ status })}
+ options={[{ value: null, label: 'Any status' }, ...STATUS_OPTIONS]}
+ data-attr="transactional-email-log-status-filter"
+ />
+ <DateFilter
+ size="small"
+ dateFrom={filters.dateFrom}
+ dateTo={filters.dateTo ?? undefined}
+ onChange={(dateFrom, dateTo) =>
+ setFilters({ dateFrom: dateFrom || DEFAULT_LOG_FILTERS.dateFrom, dateTo: dateTo || null })
+ }
+ dateOptions={INVOCATIONS_DATE_OPTIONS}
+ allowTimePrecision
+ allowFixedRangeWithTime
+ allowedRollingDateOptions={['minutes', 'hours', 'days', 'weeks']}
+ max={LOG_RETENTION_DAYS}
+ use24HourFormat
+ data-attr="transactional-email-log-date-filter"
+ />
+ <LemonButton
+ type="secondary"
+ size="small"
+ icon={<IconRefresh />}
+ loading={pageLoading}
+ onClick={() => refresh()}
+ data-attr="transactional-email-log-refresh"
+ >
+ Refresh
+ </LemonButton>
+ </div>
+ </div>
+ {pageFailed && (
+ <LemonBanner
+ type="error"
+ action={{
+ children: 'Try again',
+ onClick: () => loadEmails(),
+ 'data-attr': 'transactional-email-log-retry',
+ }}
+ >
+ The log couldn't load. Check your connection and try again.
+ </LemonBanner>
+ )}
+ <LemonTable<TransactionalEmailLogEntryApi>
+ dataSource={emails}
+ loading={pageLoading}
+ rowKey="message_id"
+ pagination={{
+ ...pagination,
+ onBackward:
+ pagination.currentPage && pagination.currentPage > 1
+ ? () => setPage(filters.page - 1)
+ : undefined,
+ onForward: pagination.entryCountIsLowerBound ? () => setPage(filters.page + 1) : undefined,
+ }}
+ nouns={['send', 'sends']}
+ data-attr="transactional-email-log-table"
+ columns={[
+ {
+ title: 'Recipient',
+ key: 'recipient',
+ render: (_, email) => (
+ <span className="ph-no-capture">
+ <EmailAddress address={email.recipient} />
+ </span>
+ ),
+ },
+ {
+ title: 'Email',
+ key: 'template',
+ render: (_, email) => (
+ <span className="whitespace-nowrap">
+ {email.template_name || <span className="text-secondary">Deleted email</span>}
+ </span>
+ ),
+ },
+ {
+ title: 'Status',
+ key: 'status',
+ width: 0,
+ render: (_, email) => (
+ <Tooltip title={emailReasonText(email.reason) ?? EMAIL_STATUS_DESCRIPTION[email.status]}>
+ <LemonTag type={EMAIL_STATUS_TAG[email.status]} className="whitespace-nowrap">
+ {EMAIL_STATUS_LABEL[email.status]}
+ </LemonTag>
+ </Tooltip>
+ ),
+ },
+ {
+ title: 'Engagement',
+ key: 'engagement',
+ width: 0,
+ render: (_, email) =>
+ email.opened || email.clicked ? (
+ <div className="flex items-center gap-1">
+ {email.opened && (
+ <LemonTag icon={<IconEye />} className="whitespace-nowrap">
+ Opened
+ </LemonTag>
+ )}
+ {email.clicked && (
+ <LemonTag icon={<IconCursorClick />} className="whitespace-nowrap">
+ Clicked
+ </LemonTag>
+ )}
+ </div>
+ ) : null,
+ },
+ {
+ title: 'Sent',
+ key: 'created_at',
+ width: 0,
+ render: (_, email) => <TZLabel time={email.created_at} className="whitespace-nowrap" />,
+ },
+ ]}
+ emptyState={
+ pageFailed
+ ? "The log couldn't load"
+ : filters.page > 1
+ ? 'No more sends past this page. Go back a page to see the rest.'
+ : isFiltered
+ ? 'No sends match these filters'
+ : 'No transactional emails sent in this period. Sends from your code show up here within a few seconds.'
+ }
+ />
+ </div>
+ )
+}
diff --git a/products/workflows/frontend/Transactional/log/emailLogStatus.ts b/products/workflows/frontend/Transactional/log/emailLogStatus.ts
new file mode 100644
index 000000000000..86da28a3766b
--- /dev/null
+++ b/products/workflows/frontend/Transactional/log/emailLogStatus.ts
@@ -0,0 +1,60 @@
+import type { LemonTagType } from '@posthog/lemon-ui'
+
+import type {
+ EmailDeliveryStatusEnumApi,
+ EmailLogEventKindEnumApi,
+} from 'products/messaging/frontend/generated/api.schemas'
+
+export const EMAIL_STATUS_LABEL: Record<EmailLogEventKindEnumApi, string> = {
+ queued: 'Queued',
+ sent: 'Sent',
+ delivered: 'Delivered',
+ bounced: 'Bounced',
+ complained: 'Marked as spam',
+ failed: 'Failed',
+ opened: 'Opened',
+ clicked: 'Clicked',
+}
+
+export const EMAIL_STATUS_TAG: Record<EmailDeliveryStatusEnumApi, LemonTagType> = {
+ queued: 'default',
+ sent: 'primary',
+ delivered: 'success',
+ bounced: 'danger',
+ complained: 'danger',
+ failed: 'danger',
+}
+
+export const EMAIL_STATUS_DESCRIPTION: Record<EmailDeliveryStatusEnumApi, string> = {
+ queued: 'Waiting to go out.',
+ sent: "Handed to the email provider. It shows as delivered once the recipient's mail server accepts it.",
+ delivered: "The recipient's mail server accepted the email.",
+ bounced: "The recipient's mail server refused the email.",
+ complained: 'The recipient marked the email as spam.',
+ failed: 'The email was not sent.',
+}
+
+const REASON_TEXT: Record<string, string> = {
+ hard: "Hard bounce: the address doesn't exist or can't receive email",
+ soft: 'Soft bounce: the mailbox was full or the server was busy',
+ unknown: "The mail server didn't say why it bounced",
+ provider_error: 'The email provider returned an error',
+ provider_rejected: 'The email provider refused the email after accepting it',
+ recipient_suppressed: 'The recipient is on the suppression list',
+ sending_paused: 'Sending is paused for this email',
+ sending_suspended: 'Email sending is suspended for this project',
+ recipient_unreachable: "The recipient's address can't receive email",
+ missing_recipient: 'The send had no recipient address',
+ recipient_opted_out: 'The recipient opted out',
+ frequency_capped: 'The recipient hit a frequency cap',
+ canceled: 'The send was canceled',
+ workflow_unavailable: 'The transactional email was deleted before it went out',
+ attachments_missing: "The email's attachments couldn't be found",
+}
+
+export function emailReasonText(reason: string | null | undefined): string | null {
+ if (!reason) {
+ return null
+ }
+ return REASON_TEXT[reason] ?? `The send stopped with an error (${reason})`
+}
diff --git a/products/workflows/frontend/Transactional/log/transactionalEmailLogLogic.ts b/products/workflows/frontend/Transactional/log/transactionalEmailLogLogic.ts
new file mode 100644
index 000000000000..46f7b8d10a44
--- /dev/null
+++ b/products/workflows/frontend/Transactional/log/transactionalEmailLogLogic.ts
@@ -0,0 +1,277 @@
+import { MakeLogicType, actions, afterMount, connect, kea, listeners, path, reducers, selectors } from 'kea'
+import { loaders } from 'kea-loaders'
+import { actionToUrl, router, urlToAction } from 'kea-router'
+
+import { dayjs } from 'lib/dayjs'
+import { PaginationManual } from 'lib/lemon-ui/PaginationControl'
+import { dateStringToDayJs } from 'lib/utils/dateFilters'
+import { projectLogic } from 'scenes/projectLogic'
+
+import { transactionalEmailLogList } from 'products/messaging/frontend/generated/api'
+import type {
+ EmailDeliveryStatusEnumApi,
+ TransactionalEmailLogEntryApi,
+} from 'products/messaging/frontend/generated/api.schemas'
+
+export const LOG_PAGE_SIZE = 50
+/** The log keeps sends for 30 days, so a wider range can't find more. */
+export const LOG_RETENTION_DAYS = 30
+
+// pinned: URL search params of the Log tab - renaming breaks shared links
+const URL_PARAMS = ['search', 'status', 'email', 'date_from', 'date_to', 'page'] as const
+
+export interface TransactionalEmailLogFilters {
+ search: string
+ status: EmailDeliveryStatusEnumApi | null
+ // The workflow behind the transactional email, which the log filters on.
+ workflowId: string | null
+ dateFrom: string
+ dateTo: string | null
+ page: number
+}
+
+export const DEFAULT_LOG_FILTERS: TransactionalEmailLogFilters = {
+ search: '',
+ status: null,
+ workflowId: null,
+ dateFrom: '-7d',
+ dateTo: null,
+ page: 1,
+}
+
+interface LogPage {
+ results: TransactionalEmailLogEntryApi[]
+ hasMore: boolean
+ // Every page of one listing reads the same window, so sends that arrive later don't shift the offsets.
+ dateFrom: string
+ dateTo: string
+ filters: TransactionalEmailLogFilters
+}
+
+// Generated by kea-typegen. Update if you're an agent, ignore if you're human.
+export interface transactionalEmailLogLogicValues {
+ currentProjectId: number | null // projectLogic
+ emails: TransactionalEmailLogEntryApi[]
+ filters: TransactionalEmailLogFilters
+ isFiltered: boolean
+ page: LogPage | null
+ pageFailed: boolean
+ pageLoading: boolean
+ pagination: PaginationManual
+}
+
+// Generated by kea-typegen. Update if you're an agent, ignore if you're human.
+export interface transactionalEmailLogLogicActions {
+ loadEmails: ({ fresh }?: { fresh?: boolean }) => {
+ fresh?: boolean
+ }
+ loadEmailsFailure: (
+ error: string,
+ errorObject?: any
+ ) => {
+ error: string
+ errorObject?: any
+ }
+ loadEmailsSuccess: (
+ page: LogPage,
+ payload?: {
+ fresh?: boolean
+ }
+ ) => {
+ page: LogPage
+ payload?: {
+ fresh?: boolean
+ }
+ }
+ refresh: () => {
+ value: true
+ }
+ setFilters: (filters: Partial<TransactionalEmailLogFilters>) => {
+ filters: Partial<TransactionalEmailLogFilters>
+ }
+ setFiltersFromUrl: (filters: TransactionalEmailLogFilters) => {
+ filters: TransactionalEmailLogFilters
+ }
+ setPage: (page: number) => {
+ page: number
+ }
+}
+
+// Generated by kea-typegen. Update if you're an agent, ignore if you're human.
+export interface transactionalEmailLogLogicMeta {
+ __keaTypeGenInternalSelectorTypes: {
+ emails: (page: LogPage | null) => TransactionalEmailLogEntryApi[]
+ isFiltered: (filters: TransactionalEmailLogFilters) => boolean
+ pagination: (page: LogPage | null, filters: TransactionalEmailLogFilters) => PaginationManual
+ }
+}
+
+export type transactionalEmailLogLogicType = MakeLogicType<
+ transactionalEmailLogLogicValues,
+ transactionalEmailLogLogicActions,
+ Record<string, any>,
+ transactionalEmailLogLogicMeta
+>
+
+export const transactionalEmailLogLogic = kea<transactionalEmailLogLogicType>([
+ path(['products', 'workflows', 'frontend', 'Transactional', 'log', 'transactionalEmailLogLogic']),
+ connect(() => ({ values: [projectLogic, ['currentProjectId']] })),
+ actions({
+ setFilters: (filters: Partial<TransactionalEmailLogFilters>) => ({ filters }),
+ setFiltersFromUrl: (filters: TransactionalEmailLogFilters) => ({ filters }),
+ setPage: (page: number) => ({ page }),
+ refresh: true,
+ }),
+ reducers({
+ pageFailed: [
+ false,
+ {
+ loadEmails: () => false,
+ loadEmailsSuccess: () => false,
+ loadEmailsFailure: () => true,
+ },
+ ],
+ filters: [
+ DEFAULT_LOG_FILTERS as TransactionalEmailLogFilters,
+ {
+ // Any other filter change starts the listing over from its first page.
+ setFilters: (state, { filters }) => ({ ...state, page: 1, ...filters }),
+ setFiltersFromUrl: (_, { filters }) => filters,
+ setPage: (state, { page }) => ({ ...state, page }),
+ refresh: (state) => ({ ...state, page: 1 }),
+ },
+ ],
+ }),
+ loaders(({ values }) => ({
+ page: [
+ null as LogPage | null,
+ {
+ loadEmails: async ({ fresh }: { fresh?: boolean } = {}, breakpoint) => {
+ await breakpoint(300)
+ const filters = values.filters
+ const previous = values.page
+ const window =
+ !fresh && previous && sameListing(previous.filters, filters)
+ ? { dateFrom: previous.dateFrom, dateTo: previous.dateTo }
+ : logWindow(filters)
+ const results = await fetchPage(values.currentProjectId, filters, window)
+ breakpoint()
+ return results
+ },
+ },
+ ],
+ })),
+ selectors({
+ emails: [(s) => [s.page], (page: LogPage | null): TransactionalEmailLogEntryApi[] => page?.results ?? []],
+ isFiltered: [
+ (s) => [s.filters],
+ (filters: TransactionalEmailLogFilters): boolean =>
+ !!filters.search.trim() || !!filters.status || !!filters.workflowId,
+ ],
+ pagination: [
+ (s) => [s.page, s.filters],
+ (page: LogPage | null, filters: TransactionalEmailLogFilters): PaginationManual => {
+ const seen = (filters.page - 1) * LOG_PAGE_SIZE + (page?.results.length ?? 0)
+ return {
+ controlled: true,
+ pageSize: LOG_PAGE_SIZE,
+ currentPage: filters.page,
+ // The log doesn't count every match, so while more pages exist the total reads as "N+".
+ entryCount: page?.hasMore ? seen + 1 : seen,
+ entryCountIsLowerBound: !!page?.hasMore,
+ }
+ },
+ ],
+ }),
+ listeners(({ actions }) => ({
+ setFilters: () => actions.loadEmails(),
+ setFiltersFromUrl: () => actions.loadEmails(),
+ setPage: () => actions.loadEmails(),
+ refresh: () => actions.loadEmails({ fresh: true }),
+ })),
+ // A search can be a recipient's address, and pageviews record the URL, so the search stays out of it.
+ actionToUrl(({ values }) => {
+ const toUrl = (): [string, Record<string, any>, Record<string, any>, { replace: boolean }] => {
+ const { status, workflowId, dateFrom, dateTo, page } = values.filters
+ const searchParams: Record<string, any> = { ...router.values.searchParams }
+ URL_PARAMS.forEach((key) => delete searchParams[key])
+ if (status) {
+ searchParams.status = status
+ }
+ if (workflowId) {
+ searchParams.email = workflowId
+ }
+ if (dateFrom !== DEFAULT_LOG_FILTERS.dateFrom) {
+ searchParams.date_from = dateFrom
+ }
+ if (dateTo) {
+ searchParams.date_to = dateTo
+ }
+ if (page > 1) {
+ searchParams.page = page
+ }
+ return [router.values.location.pathname, searchParams, router.values.hashParams, { replace: true }]
+ }
+ return { setFilters: toUrl, setPage: toUrl, refresh: toUrl }
+ }),
+ urlToAction(({ actions, values }) => ({
+ '/transactional/log': (_, searchParams) => {
+ const page = Number(searchParams.page)
+ const filters: TransactionalEmailLogFilters = {
+ search: values.filters.search,
+ status: (searchParams.status as EmailDeliveryStatusEnumApi | undefined) ?? null,
+ workflowId: searchParams.email ? String(searchParams.email) : null,
+ dateFrom: searchParams.date_from ? String(searchParams.date_from) : DEFAULT_LOG_FILTERS.dateFrom,
+ dateTo: searchParams.date_to ? String(searchParams.date_to) : null,
+ page: Number.isInteger(page) && page > 1 ? page : 1,
+ }
+ if (values.page === null || JSON.stringify(filters) !== JSON.stringify(values.filters)) {
+ actions.setFiltersFromUrl(filters)
+ }
+ },
+ })),
+ afterMount(({ actions, values }) => {
+ if (values.page === null) {
+ actions.loadEmails()
+ }
+ }),
+])
+
+/** The window a date filter covers, clamped to what the log keeps. */
+export function logWindow(filters: Pick<TransactionalEmailLogFilters, 'dateFrom' | 'dateTo'>): {
+ dateFrom: string
+ dateTo: string
+} {
+ const now = dayjs()
+ const oldest = now.subtract(LOG_RETENTION_DAYS, 'day')
+ const from = dateStringToDayJs(filters.dateFrom) ?? now.subtract(7, 'day')
+ const to = (filters.dateTo ? dateStringToDayJs(filters.dateTo) : null) ?? now
+ return {
+ dateFrom: (from.isBefore(oldest) ? oldest : from).toISOString(),
+ dateTo: (to.isAfter(now) ? now : to).toISOString(),
+ }
+}
+
+function sameListing(a: TransactionalEmailLogFilters, b: TransactionalEmailLogFilters): boolean {
+ return JSON.stringify({ ...a, page: 0 }) === JSON.stringify({ ...b, page: 0 })
+}
+
+async function fetchPage(
+ projectId: number | null,
+ filters: TransactionalEmailLogFilters,
+ { dateFrom, dateTo }: { dateFrom: string; dateTo: string }
+): Promise<LogPage> {
+ if (projectId === null) {
+ return { results: [], hasMore: false, dateFrom, dateTo, filters }
+ }
+ const response = await transactionalEmailLogList(String(projectId), {
+ search: filters.search.trim() || undefined,
+ status: filters.status ?? undefined,
+ workflow_id: filters.workflowId ?? undefined,
+ date_from: dateFrom,
+ date_to: dateTo,
+ limit: LOG_PAGE_SIZE,
+ offset: (filters.page - 1) * LOG_PAGE_SIZE,
+ })
+ return { results: [...response.results], hasMore: response.has_more, dateFrom, dateTo, filters }
+}
diff --git a/products/workflows/manifest.tsx b/products/workflows/manifest.tsx
index 17631e7ce21b..955d4a39455d 100644
--- a/products/workflows/manifest.tsx
+++ b/products/workflows/manifest.tsx
@@ -93,6 +93,7 @@ export const manifest: ProductManifest = {
'/transactional/reputation': ['Transactional', 'transactional'],
'/transactional/settings': ['Transactional', 'transactional'],
'/transactional/new': ['Transactional', 'transactional'],
+ '/transactional/log': ['Transactional', 'transactional'],
// A template opened from a section's Templates tab stays in that section.
'/transactional/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],
'/broadcasts/library/templates/:id': ['WorkflowsLibraryTemplate', 'workflowsLibraryTemplate'],
@@ -115,6 +116,7 @@ export const manifest: ProductManifest = {
broadcastNew: (): string => '/broadcasts/new',
transactional: (tab?: MessagingNavTabKey): string => `/transactional${tab ? `/${tab}` : ''}`,
transactionalNew: (): string => '/transactional/new',
+ transactionalLog: (): string => '/transactional/log',
transactionalTemplate: (id: string): string => `/transactional/library/templates/${id}`,
broadcastsTemplate: (id: string): string => `/broadcasts/library/templates/${id}`,
},
diff --git a/services/mcp/src/tools/links/app-url-manifest.json b/services/mcp/src/tools/links/app-url-manifest.json
index d63025f465d9..1c7c27229d20 100644
--- a/services/mcp/src/tools/links/app-url-manifest.json
+++ b/services/mcp/src/tools/links/app-url-manifest.json
@@ -1854,6 +1854,11 @@
"params": [],
"scope": "project"
},
+ "transactionalLog": {
+ "template": "/transactional/log",
+ "params": [],
+ "scope": "project"
+ },
"transactionalNew": {
"template": "/transactional/new",
"params": [],
diff --git a/services/mcp/tests/unit/__snapshots__/tool-schemas/generate-app-url.json b/services/mcp/tests/unit/__snapshots__/tool-schemas/generate-app-url.json
index e9105c22d238..edd47b3767ca 100644
--- a/services/mcp/tests/unit/__snapshots__/tool-schemas/generate-app-url.json
+++ b/services/mcp/tests/unit/__snapshots__/tool-schemas/generate-app-url.json
@@ -13,7 +13,7 @@
"type": "object"
},
"url": {
- "description": "A path template copied verbatim from the catalog below (e.g. `/persons/{uuid}`). Its `{placeholders}` are filled from `params`. These slugs come from PostHog's canonical route table, so they are always correct — never pass a path that is not in this list.\n\n/account-connected/{kind}\n/account/credential-review\n/account/social-connected\n/activity-logs\n/activity/{tab}\n/agentic/account-mismatch\n/agentic/authorize\n/ai\n/ai-enrichment\n/ai-evals/evaluations\n/ai-evals/evaluations/offline/datasets/{id}\n/ai-evals/evaluations/offline/experiments\n/ai-evals/evaluations/offline/experiments/{experimentId}\n/ai-evals/evaluations/offline/experiments?tab=datasets\n/ai-evals/evaluations/scorers\n/ai-evals/evaluations/scorers/{scorerId}\n/ai-evals/evaluations/scorers/{scorerId}/offline\n/ai-evals/evaluations/templates\n/ai-evals/evaluations/{id}\n/ai-evals/taggers\n/ai-evals/taggers/{id}\n/ai-observability/clusters\n/ai-observability/clusters/{runId}/{clusterId}\n/ai-observability/dashboard\n/ai-observability/errors\n/ai-observability/generations\n/ai-observability/playground\n/ai-observability/reviews\n/ai-observability/self-driving\n/ai-observability/sentiment\n/ai-observability/sessions\n/ai-observability/sessions/{id}\n/ai-observability/tools\n/ai-observability/traces\n/ai-observability/traces/{id}\n/ai-observability/users\n/ai/history\n/alerts\n/analytics\n/analytics/all\n/analytics/mine\n/analytics/product-analytics\n/analytics/spaces\n/application-observability\n/approvals/{id}\n/autoresearch\n/autoresearch/new\n/autoresearch/{id}\n/bi\n/bi/new\n/bi/{insightShortId}\n/billing/authorization_status\n/broadcasts\n/broadcasts/library/templates/{id}\n/broadcasts/new\n/broadcasts/{id}\n/business-knowledge\n/business-knowledge/playground\n/business-knowledge/settings\n/business-knowledge/{id}\n/canvas\n/canvases\n/canvases/new\n/canvases/{id}\n/cli/authorize\n/cli/live\n/code-review\n/code/canvas/{channelId}/{dashboardId}\n/code/channel/{channelId}\n/code/loop/{loopId}\n/code/task/{taskId}\n/cohorts\n/cohorts/{id}\n/cohorts/{id}/calculation-history\n/connect/vercel/link\n/coupons/{campaign}\n/create-organization\n/cross-project-dashboards\n/cross-project-dashboards/{id}\n/customer_analytics\n/customer_analytics/accounts\n/customer_analytics/accounts/by-external-id/{externalId}\n/customer_analytics/accounts/{accountId}\n/customer_analytics/announcements\n/customer_analytics/configuration\n/customer_analytics/dashboard\n/customer_analytics/feature-requests\n/customer_analytics/feed\n/customer_analytics/journeys\n/customer_analytics/journeys/new\n/customer_analytics/journeys/templates\n/customer_analytics/journeys/{id}/edit\n/customer_analytics/notes\n/customer_analytics/tasks\n/dashboard\n/dashboard/templates/{templateId}/copy-to-project\n/dashboard/{id}\n/dashboard/{id}/sharing\n/dashboard/{id}/subscriptions\n/dashboard/{id}/subscriptions/{subscriptionId}\n/dashboard/{id}/tiles/{tileId}\n/data-catalog\n/data-catalog/metrics/{name}\n/data-catalog/new-metric\n/data-management/actions\n/data-management/actions/new\n/data-management/actions/new/\n/data-management/actions/{id}\n/data-management/annotations\n/data-management/annotations/{id}\n/data-management/core-events\n/data-management/database\n/data-management/destinations\n/data-management/event-filtering\n/data-management/events\n/data-management/events/{id}\n/data-management/events/{id}/edit\n/data-management/history\n/data-management/ingestion-warnings\n/data-management/ingestion-warnings-v2\n/data-management/managed-viewsets\n/data-management/materialized-columns\n/data-management/properties\n/data-management/properties/{id}\n/data-management/properties/{id}/edit\n/data-management/revenue\n/data-management/schema\n/data-management/sources\n/data-management/sources/{id}/schemas\n/data-management/sources/{sourceId}/schemas/{schemaId}\n/data-management/transformations\n/data-management/variables\n/data-management/variables/{id}\n/data-management/variables/{id}/edit\n/data-management/warehouse-destinations\n/data-management/warehouse-properties\n/data-ops\n/data-warehouse/connect\n/data-warehouse/new-source\n/debug\n/debug/hog\n/debug/precompute\n/device\n/early_access_features\n/early_access_features/{id}\n/embedded/{token}\n/endpoints\n/endpoints/{name}\n/engineering-analytics/authors\n/engineering-analytics/authors/{handle}\n/engineering-analytics/deploys\n/engineering-analytics/overview\n/engineering-analytics/pull-requests\n/engineering-analytics/repos/{repoOwner}/{repoName}/actions/runs/{runId}\n/engineering-analytics/repos/{repoOwner}/{repoName}/actions/workflows/{workflowName}\n/engineering-analytics/repos/{repoOwner}/{repoName}/pull-requests/{number}\n/engineering-analytics/repos/{repoOwner}/{repoName}/pull-requests/{number}/ci-explorer\n/engineering-analytics/teams\n/engineering-analytics/teams/{ownerTeam}\n/engineering-analytics/tests\n/engineering-analytics/workflows\n/error-tracking\n/error-tracking/alerts/new/{templateId}\n/error-tracking/alerts/{id}\n/error-tracking/fingerprint/{fingerprint}\n/error-tracking/{id}\n/etl\n/events/{id}/{timestamp}\n/experiments\n/experiments/shared-metrics\n/experiments/shared-metrics/{id}\n/experiments/staff\n/experiments/{id}\n/exports\n/feature-flags\n/feature-flags/new\n/feature-flags/staff\n/feature-flags/staff/cohorts\n/feature-flags/templates\n/feature-flags/{id}\n/files\n/functions/new/{templateId}\n/functions/{id}\n/games/368hedgehogs\n/games/flappyhog\n/games/shipit\n/groups/{groupTypeIndex}\n/groups/{groupTypeIndex}/new\n/groups/{groupTypeIndex}/{groupKey}\n/health\n/health/alerts\n/health/pipeline-status\n/health/sdk-health\n/health/{category}\n/heatmaps\n/heatmaps/new\n/heatmaps/recording\n/heatmaps/{id}\n/home\n/identity-matching\n/inbox\n/inbox/reports/triage\n/inbox/scout-trials\n/inbox/scouts/findings\n/inbox/scouts/runs\n/inbox/scouts/scratchpad\n/inbox/scouts/{skillName}\n/inbox/{tab}/{reportId}\n/insights\n/insights/new\n/insights/quick-start\n/insights/{id}\n/insights/{id}/edit\n/insights/{id}/sharing\n/insights/{id}/subscriptions\n/insights/{id}/subscriptions/{subscriptionId}\n/insights/{insightShortId}/alerts\n/instance/async_migrations\n/instance/async_migrations/future\n/instance/async_migrations/settings\n/instance/dead_letter_queue\n/instance/kafka_inspector\n/instance/metrics\n/instance/settings\n/instance/staff_users\n/instance/status\n/integrations/slack/{integrationId}/setup\n/integrations/stripe/confirm-install\n/integrations/vercel/link-error\n/integrations/{kind}/callback\n/integrations/{slug}\n/legal\n/legal/new/{type}\n/login\n/login/2fa\n/login/2fa_setup\n/logs\n/logs/alerts/{alertId}/notifications/{hogFunctionId}\n/logs/alerts/{id}\n/logs/drop-rules/new\n/logs/drop-rules/{id}\n/logs/retention-rules/new\n/logs/retention-rules/{id}\n/managed_migrations\n/managed_migrations/new\n/marketing\n/mcp-analytics\n/mcp-analytics/activity\n/mcp-analytics/dashboard\n/mcp-analytics/intent-clustering\n/mcp-analytics/missing-capabilities\n/mcp-analytics/notifications\n/mcp-analytics/sessions\n/mcp-analytics/tool-quality\n/mcp-analytics/tool-quality/{toolName}\n/mcp-registry\n/mcp-servers\n/mcp-servers/agent/{id}\n/mcp-servers/member/{id}\n/mcp-servers/server/{id}\n/mcp-servers/{tab}\n/metrics\n/metrics/dashboard-review\n/models\n/models/{id}\n/move-to-cloud\n/my-tickets\n/notebooks\n/notebooks/widgets/{widgetId}\n/notebooks/{shortId}\n/oauth/authorize\n/onboarding\n/organization-deactivated\n/organization-pending-deletion\n/organization/billing\n/organization/billing/overview\n/organization/billing/real-time-usage\n/organization/confirm-creation\n/organization/create-project\n/organization/legal\n/organization/startups\n/person/{id}\n/persons\n/persons/{uuid}\n/pipeline/batch-exports/new/{service}\n/pipeline/batch-exports/{id}\n/pipeline/new/\n/pipeline/plugins/{id}\n/platform-alerts\n/platform-alerts/{id}\n/preflight\n/product_tours\n/product_tours/{id}\n/project-pending-deletion\n/prompt-management/prompts\n/prompt-management/prompts/{name}\n/pulse\n/replay-vision\n/replay-vision/new/goal\n/replay-vision/observations/{observationId}\n/replay-vision/{id}/budget\n/replay-vision/{id}/configure\n/replay-vision/{id}/details\n/replay-vision/{id}/goal\n/replay-vision/{id}/overview\n/replay-vision/{id}/triggers\n/replay/file-playback\n/replay/home\n/replay/kiosk\n/replay/playlists/{id}\n/replay/settings\n/replay/{id}\n/reset\n/reset/{userUuid}/{token}\n/reset_2fa/{userUuid}/{token}\n/resource-transfer/{resourceKind}/{resourceId}\n/sessions/{id}\n/settings/environment-approvals\n/settings/organization-authentication/{feature}/{configId}\n/settings/project\n/settings/user-feature-previews\n/shared/{token}\n/shared_dashboard/{shareToken}\n/signup\n/signup/{id}\n/site/{url}\n/skills\n/skills/community\n/skills/{categoryTab}\n/skills/{name}\n/slack-task-context\n/spaces\n/spaces/new\n/spaces/{id}\n/spaces/{id}/canvases\n/spaces/{id}/new\n/spaces/{id}/settings\n/sql\n/stamphog\n/stamphog/digests\n/stamphog/install/callback\n/stamphog/runs\n/startups\n/streamlit-apps\n/streamlit-apps/new\n/streamlit-apps/{id}\n/streamlit-apps/{id}/edit\n/subscriptions\n/subscriptions/new\n/subscriptions/{id}\n/subscriptions/{id}/edit\n/support\n/support/settings\n/support/tickets\n/support/tickets/{ticketId}\n/surveys\n/surveys/form/new\n/surveys/guided/new\n/surveys/{id}\n/tasks\n/tasks/new\n/tasks/{taskId}\n/terminal\n/themes/custom-css\n/toolbar\n/tools\n/tracing\n/tracing/retention-rules/new\n/tracing/retention-rules/{id}\n/transactional\n/transactional/library/templates/{id}\n/transactional/new\n/unsubscribe\n/uptime-monitoring\n/verify_email\n/visual-review\n/visual-review/repos/{repoOwner}/{repoName}/flakiness\n/visual-review/repos/{repoOwner}/{repoName}/runs\n/visual-review/repos/{repoOwner}/{repoName}/runs/{runId}\n/visual-review/repos/{repoOwner}/{repoName}/snapshots\n/visual-review/repos/{repoOwner}/{repoName}/{runType}/snapshots/{identifier}\n/visual-review/runs/{runId}\n/visual-review/settings\n/web\n/web-scripts\n/web-scripts/new\n/web/agents\n/web/bots\n/web/content-autopilot\n/web/health\n/web/live\n/web/marketing\n/web/page-performance\n/web/page-reports\n/web/recap\n/web/session-attribution-explorer\n/web/web-vitals\n/welcome\n/wizard/runs\n/workflows\n/workflows/channels/email/{id}\n/workflows/library/messages/{id}\n/workflows/library/templates/new\n/workflows/library/templates/{id}\n/workflows/new/workflow\n/workflows/{id}/{tab}\n/workload-trust-policy-requests/{id}",
+ "description": "A path template copied verbatim from the catalog below (e.g. `/persons/{uuid}`). Its `{placeholders}` are filled from `params`. These slugs come from PostHog's canonical route table, so they are always correct — never pass a path that is not in this list.\n\n/account-connected/{kind}\n/account/credential-review\n/account/social-connected\n/activity-logs\n/activity/{tab}\n/agentic/account-mismatch\n/agentic/authorize\n/ai\n/ai-enrichment\n/ai-evals/evaluations\n/ai-evals/evaluations/offline/datasets/{id}\n/ai-evals/evaluations/offline/experiments\n/ai-evals/evaluations/offline/experiments/{experimentId}\n/ai-evals/evaluations/offline/experiments?tab=datasets\n/ai-evals/evaluations/scorers\n/ai-evals/evaluations/scorers/{scorerId}\n/ai-evals/evaluations/scorers/{scorerId}/offline\n/ai-evals/evaluations/templates\n/ai-evals/evaluations/{id}\n/ai-evals/taggers\n/ai-evals/taggers/{id}\n/ai-observability/clusters\n/ai-observability/clusters/{runId}/{clusterId}\n/ai-observability/dashboard\n/ai-observability/errors\n/ai-observability/generations\n/ai-observability/playground\n/ai-observability/reviews\n/ai-observability/self-driving\n/ai-observability/sentiment\n/ai-observability/sessions\n/ai-observability/sessions/{id}\n/ai-observability/tools\n/ai-observability/traces\n/ai-observability/traces/{id}\n/ai-observability/users\n/ai/history\n/alerts\n/analytics\n/analytics/all\n/analytics/mine\n/analytics/product-analytics\n/analytics/spaces\n/application-observability\n/approvals/{id}\n/autoresearch\n/autoresearch/new\n/autoresearch/{id}\n/bi\n/bi/new\n/bi/{insightShortId}\n/billing/authorization_status\n/broadcasts\n/broadcasts/library/templates/{id}\n/broadcasts/new\n/broadcasts/{id}\n/business-knowledge\n/business-knowledge/playground\n/business-knowledge/settings\n/business-knowledge/{id}\n/canvas\n/canvases\n/canvases/new\n/canvases/{id}\n/cli/authorize\n/cli/live\n/code-review\n/code/canvas/{channelId}/{dashboardId}\n/code/channel/{channelId}\n/code/loop/{loopId}\n/code/task/{taskId}\n/cohorts\n/cohorts/{id}\n/cohorts/{id}/calculation-history\n/connect/vercel/link\n/coupons/{campaign}\n/create-organization\n/cross-project-dashboards\n/cross-project-dashboards/{id}\n/customer_analytics\n/customer_analytics/accounts\n/customer_analytics/accounts/by-external-id/{externalId}\n/customer_analytics/accounts/{accountId}\n/customer_analytics/announcements\n/customer_analytics/configuration\n/customer_analytics/dashboard\n/customer_analytics/feature-requests\n/customer_analytics/feed\n/customer_analytics/journeys\n/customer_analytics/journeys/new\n/customer_analytics/journeys/templates\n/customer_analytics/journeys/{id}/edit\n/customer_analytics/notes\n/customer_analytics/tasks\n/dashboard\n/dashboard/templates/{templateId}/copy-to-project\n/dashboard/{id}\n/dashboard/{id}/sharing\n/dashboard/{id}/subscriptions\n/dashboard/{id}/subscriptions/{subscriptionId}\n/dashboard/{id}/tiles/{tileId}\n/data-catalog\n/data-catalog/metrics/{name}\n/data-catalog/new-metric\n/data-management/actions\n/data-management/actions/new\n/data-management/actions/new/\n/data-management/actions/{id}\n/data-management/annotations\n/data-management/annotations/{id}\n/data-management/core-events\n/data-management/database\n/data-management/destinations\n/data-management/event-filtering\n/data-management/events\n/data-management/events/{id}\n/data-management/events/{id}/edit\n/data-management/history\n/data-management/ingestion-warnings\n/data-management/ingestion-warnings-v2\n/data-management/managed-viewsets\n/data-management/materialized-columns\n/data-management/properties\n/data-management/properties/{id}\n/data-management/properties/{id}/edit\n/data-management/revenue\n/data-management/schema\n/data-management/sources\n/data-management/sources/{id}/schemas\n/data-management/sources/{sourceId}/schemas/{schemaId}\n/data-management/transformations\n/data-management/variables\n/data-management/variables/{id}\n/data-management/variables/{id}/edit\n/data-management/warehouse-destinations\n/data-management/warehouse-properties\n/data-ops\n/data-warehouse/connect\n/data-warehouse/new-source\n/debug\n/debug/hog\n/debug/precompute\n/device\n/early_access_features\n/early_access_features/{id}\n/embedded/{token}\n/endpoints\n/endpoints/{name}\n/engineering-analytics/authors\n/engineering-analytics/authors/{handle}\n/engineering-analytics/deploys\n/engineering-analytics/overview\n/engineering-analytics/pull-requests\n/engineering-analytics/repos/{repoOwner}/{repoName}/actions/runs/{runId}\n/engineering-analytics/repos/{repoOwner}/{repoName}/actions/workflows/{workflowName}\n/engineering-analytics/repos/{repoOwner}/{repoName}/pull-requests/{number}\n/engineering-analytics/repos/{repoOwner}/{repoName}/pull-requests/{number}/ci-explorer\n/engineering-analytics/teams\n/engineering-analytics/teams/{ownerTeam}\n/engineering-analytics/tests\n/engineering-analytics/workflows\n/error-tracking\n/error-tracking/alerts/new/{templateId}\n/error-tracking/alerts/{id}\n/error-tracking/fingerprint/{fingerprint}\n/error-tracking/{id}\n/etl\n/events/{id}/{timestamp}\n/experiments\n/experiments/shared-metrics\n/experiments/shared-metrics/{id}\n/experiments/staff\n/experiments/{id}\n/exports\n/feature-flags\n/feature-flags/new\n/feature-flags/staff\n/feature-flags/staff/cohorts\n/feature-flags/templates\n/feature-flags/{id}\n/files\n/functions/new/{templateId}\n/functions/{id}\n/games/368hedgehogs\n/games/flappyhog\n/games/shipit\n/groups/{groupTypeIndex}\n/groups/{groupTypeIndex}/new\n/groups/{groupTypeIndex}/{groupKey}\n/health\n/health/alerts\n/health/pipeline-status\n/health/sdk-health\n/health/{category}\n/heatmaps\n/heatmaps/new\n/heatmaps/recording\n/heatmaps/{id}\n/home\n/identity-matching\n/inbox\n/inbox/reports/triage\n/inbox/scout-trials\n/inbox/scouts/findings\n/inbox/scouts/runs\n/inbox/scouts/scratchpad\n/inbox/scouts/{skillName}\n/inbox/{tab}/{reportId}\n/insights\n/insights/new\n/insights/quick-start\n/insights/{id}\n/insights/{id}/edit\n/insights/{id}/sharing\n/insights/{id}/subscriptions\n/insights/{id}/subscriptions/{subscriptionId}\n/insights/{insightShortId}/alerts\n/instance/async_migrations\n/instance/async_migrations/future\n/instance/async_migrations/settings\n/instance/dead_letter_queue\n/instance/kafka_inspector\n/instance/metrics\n/instance/settings\n/instance/staff_users\n/instance/status\n/integrations/slack/{integrationId}/setup\n/integrations/stripe/confirm-install\n/integrations/vercel/link-error\n/integrations/{kind}/callback\n/integrations/{slug}\n/legal\n/legal/new/{type}\n/login\n/login/2fa\n/login/2fa_setup\n/logs\n/logs/alerts/{alertId}/notifications/{hogFunctionId}\n/logs/alerts/{id}\n/logs/drop-rules/new\n/logs/drop-rules/{id}\n/logs/retention-rules/new\n/logs/retention-rules/{id}\n/managed_migrations\n/managed_migrations/new\n/marketing\n/mcp-analytics\n/mcp-analytics/activity\n/mcp-analytics/dashboard\n/mcp-analytics/intent-clustering\n/mcp-analytics/missing-capabilities\n/mcp-analytics/notifications\n/mcp-analytics/sessions\n/mcp-analytics/tool-quality\n/mcp-analytics/tool-quality/{toolName}\n/mcp-registry\n/mcp-servers\n/mcp-servers/agent/{id}\n/mcp-servers/member/{id}\n/mcp-servers/server/{id}\n/mcp-servers/{tab}\n/metrics\n/metrics/dashboard-review\n/models\n/models/{id}\n/move-to-cloud\n/my-tickets\n/notebooks\n/notebooks/widgets/{widgetId}\n/notebooks/{shortId}\n/oauth/authorize\n/onboarding\n/organization-deactivated\n/organization-pending-deletion\n/organization/billing\n/organization/billing/overview\n/organization/billing/real-time-usage\n/organization/confirm-creation\n/organization/create-project\n/organization/legal\n/organization/startups\n/person/{id}\n/persons\n/persons/{uuid}\n/pipeline/batch-exports/new/{service}\n/pipeline/batch-exports/{id}\n/pipeline/new/\n/pipeline/plugins/{id}\n/platform-alerts\n/platform-alerts/{id}\n/preflight\n/product_tours\n/product_tours/{id}\n/project-pending-deletion\n/prompt-management/prompts\n/prompt-management/prompts/{name}\n/pulse\n/replay-vision\n/replay-vision/new/goal\n/replay-vision/observations/{observationId}\n/replay-vision/{id}/budget\n/replay-vision/{id}/configure\n/replay-vision/{id}/details\n/replay-vision/{id}/goal\n/replay-vision/{id}/overview\n/replay-vision/{id}/triggers\n/replay/file-playback\n/replay/home\n/replay/kiosk\n/replay/playlists/{id}\n/replay/settings\n/replay/{id}\n/reset\n/reset/{userUuid}/{token}\n/reset_2fa/{userUuid}/{token}\n/resource-transfer/{resourceKind}/{resourceId}\n/sessions/{id}\n/settings/environment-approvals\n/settings/organization-authentication/{feature}/{configId}\n/settings/project\n/settings/user-feature-previews\n/shared/{token}\n/shared_dashboard/{shareToken}\n/signup\n/signup/{id}\n/site/{url}\n/skills\n/skills/community\n/skills/{categoryTab}\n/skills/{name}\n/slack-task-context\n/spaces\n/spaces/new\n/spaces/{id}\n/spaces/{id}/canvases\n/spaces/{id}/new\n/spaces/{id}/settings\n/sql\n/stamphog\n/stamphog/digests\n/stamphog/install/callback\n/stamphog/runs\n/startups\n/streamlit-apps\n/streamlit-apps/new\n/streamlit-apps/{id}\n/streamlit-apps/{id}/edit\n/subscriptions\n/subscriptions/new\n/subscriptions/{id}\n/subscriptions/{id}/edit\n/support\n/support/settings\n/support/tickets\n/support/tickets/{ticketId}\n/surveys\n/surveys/form/new\n/surveys/guided/new\n/surveys/{id}\n/tasks\n/tasks/new\n/tasks/{taskId}\n/terminal\n/themes/custom-css\n/toolbar\n/tools\n/tracing\n/tracing/retention-rules/new\n/tracing/retention-rules/{id}\n/transactional\n/transactional/library/templates/{id}\n/transactional/log\n/transactional/new\n/unsubscribe\n/uptime-monitoring\n/verify_email\n/visual-review\n/visual-review/repos/{repoOwner}/{repoName}/flakiness\n/visual-review/repos/{repoOwner}/{repoName}/runs\n/visual-review/repos/{repoOwner}/{repoName}/runs/{runId}\n/visual-review/repos/{repoOwner}/{repoName}/snapshots\n/visual-review/repos/{repoOwner}/{repoName}/{runType}/snapshots/{identifier}\n/visual-review/runs/{runId}\n/visual-review/settings\n/web\n/web-scripts\n/web-scripts/new\n/web/agents\n/web/bots\n/web/content-autopilot\n/web/health\n/web/live\n/web/marketing\n/web/page-performance\n/web/page-reports\n/web/recap\n/web/session-attribution-explorer\n/web/web-vitals\n/welcome\n/wizard/runs\n/workflows\n/workflows/channels/email/{id}\n/workflows/library/messages/{id}\n/workflows/library/templates/new\n/workflows/library/templates/{id}\n/workflows/new/workflow\n/workflows/{id}/{tab}\n/workload-trust-policy-requests/{id}",
"type": "string"
}
},