From f43502b4dfedf4e0b1cfae39b937008e37d0440d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 6 Nov 2026 00:44:49 +0000 Subject: [PATCH] docs: document data retention for analytics, assistant and audit logs --- analytics/assistant.mdx | 2 ++ analytics/index.mdx | 2 ++ dashboard/audit-logs.mdx | 2 +- mint-instructions/access/team.mdx | 2 +- mint-instructions/publish/analytics.mdx | 2 +- 5 files changed, 7 insertions(+), 3 deletions(-) diff --git a/analytics/assistant.mdx b/analytics/assistant.mdx index c59574ea26..39aeffa5dc 100644 --- a/analytics/assistant.mdx +++ b/analytics/assistant.mdx @@ -17,6 +17,8 @@ The **Assistant** view of the [analytics](https://app.mintlify.com/analytics) pa Mintlify replaces email addresses and phone numbers in assistant conversations with `[REDACTED_EMAIL]` and `[REDACTED_PHONE]` before showing them in the dashboard. The same redaction applies to [CSV exports](/analytics/export) and the [analytics API](/api/analytics/assistant-conversations). +Mintlify keeps assistant conversations for 365 days, then deletes them. + Review assistant analytics to: - **Monitor assistant usage**: Observe changes in assistant usage to understand how users engage with your content. diff --git a/analytics/index.mdx b/analytics/index.mdx index 85d0cb0bf5..748813862b 100644 --- a/analytics/index.mdx +++ b/analytics/index.mdx @@ -48,6 +48,8 @@ Analytics data typically appears within a few minutes of an interaction. Very re Use the range selector in an analytics view to adjust the time period for the displayed data. Select a preset, like **Last 7 days** or **All time**, or a custom range on the calendar. Exports also use the selected time range. +Mintlify keeps analytics data for 365 days, so **All time** shows up to the last 365 days of data. To keep a longer record, [export](/analytics/export) your analytics or [stream analytics events](/analytics/streaming) to your own storage. + ## Filter by page or path Use the **Filter** menu to scope the dashboard to a single page or path. When you select a path, the analytics page displays data for every page under that path. For example, if you filter to `docs/authentication`, the analytics page displays data for every page in the `docs/authentication/*` path. The Assistant and Search views always show site-wide data. diff --git a/dashboard/audit-logs.mdx b/dashboard/audit-logs.mdx index 81cdcdcccb..9aa8eb498d 100644 --- a/dashboard/audit-logs.mdx +++ b/dashboard/audit-logs.mdx @@ -19,7 +19,7 @@ Use audit logs to monitor and track actions performed by members of your organiz Only organization admins can view and export audit logs. -Navigate to the [Audit log](https://app.mintlify.com/settings/organization/audit-logs) page of your dashboard to view audit logs. Mintlify retains audit log entries for up to one year. You can view and export entries from the last 90 days. Export logs to CSV regularly to keep a longer record. +Navigate to the [Audit log](https://app.mintlify.com/settings/organization/audit-logs) page of your dashboard to view audit logs. Mintlify retains audit log entries for 455 days. You can view and export entries from the last 90 days. Export logs to CSV regularly to keep a longer record. Click any log entry to open its details, including: diff --git a/mint-instructions/access/team.mdx b/mint-instructions/access/team.mdx index e731ab5af0..3de8d1e0b9 100644 --- a/mint-instructions/access/team.mdx +++ b/mint-instructions/access/team.mdx @@ -30,7 +30,7 @@ Use this to add teammates, set roles, SSO, SCIM, session or IP policies, audit l 7. Session and network policies (Enterprise, admin): **Security** page, **Policies** section. - **Idle session timeout** and **Maximum session lifetime**: each 5 minutes to 14 days, own toggle, click **Save**. Session ends at whichever limit hits first. Off: idle timeout falls back to 14 days, max lifetime has no limit. Lowering max lifetime ends older sessions on their next request. - **Allowed IP addresses**: IPv4/IPv6 or CIDR (`203.0.113.7`, `10.0.0.0/8`), press Enter, **Add and enable** on the first entry. Applies to dashboard and editor, including SSO sign-ins, not the published docs site. Empty list means open. -8. Audit logs (Enterprise, admins only): **Audit log** page (https://app.mintlify.com/settings/organization/audit-logs). Retained up to one year; view and export the last 90 days. Filter by date and category; SSO, SCIM and automation events appear under **All categories**. **Export CSV** emails a download link. Streaming: **Stream configuration**, **Configure**, **Add destination**, Amazon S3 (bucket, region, access key ID, secret, optional prefix; needs `s3:PutObject`) or Datadog (site and API key, not an application key). +8. Audit logs (Enterprise, admins only): **Audit log** page (https://app.mintlify.com/settings/organization/audit-logs). Retained 455 days; view and export the last 90 days. Filter by date and category; SSO, SCIM and automation events appear under **All categories**. **Export CSV** emails a download link. Streaming: **Stream configuration**, **Configure**, **Add destination**, Amazon S3 (bucket, region, access key ID, secret, optional prefix; needs `s3:PutObject`) or Datadog (site and API key, not an application key). 9. Contacts: **General** page (https://app.mintlify.com/settings/organization/general). Admins set **Security contact email** (Enterprise) and **Admin contact emails** (billing alerts, deployment notifications). 10. Personal settings (each member, own account only): - Profile (https://app.mintlify.com/settings/account): name, picture, **Starting page**, theme, **Always open in desktop app**, connect GitHub (signs web editor commits as you). diff --git a/mint-instructions/publish/analytics.mdx b/mint-instructions/publish/analytics.mdx index a71d701b61..6369185153 100644 --- a/mint-instructions/publish/analytics.mdx +++ b/mint-instructions/publish/analytics.mdx @@ -31,7 +31,7 @@ Use this for docs performance questions, data-driven fixes, or adding analytics, ## Dashboard views (tell the user, you cannot click them) -At https://app.mintlify.com/analytics: Traffic (visitors, views, referrals, popular pages, human vs agent traffic, agent breakdown by provider), Assistant (categories, topics, satisfaction, transcripts), Search (volume, frequent queries, CTR), User engagements (CTA clicks, actions, user flow, search and assistant funnels), Feedback, and Savings (Enterprise only). Filter by time range or by page/path (Assistant and Search are always site-wide). +At https://app.mintlify.com/analytics: Traffic (visitors, views, referrals, popular pages, human vs agent traffic, agent breakdown by provider), Assistant (categories, topics, satisfaction, transcripts), Search (volume, frequent queries, CTR), User engagements (CTA clicks, actions, user flow, search and assistant funnels), Feedback, and Savings (Enterprise only). Filter by time range or by page/path (Assistant and Search are always site-wide). Mintlify keeps analytics data and assistant conversations for 365 days, so **All time** covers at most the last 365 days. - CSV export: select **Export to CSV**, pick traffic, referrals, assistant conversations, searches, or feedback; Mintlify emails a link. Uses the selected time range. Assistant exports include `resolutionStatus` (`answered`/`unanswered`) and `feedback`. - S3 streaming (Enterprise only): org admins configure destinations, categories, and projects at https://app.mintlify.com/settings/organization/streaming. Nothing streams until at least one category and one project are selected.