mintlify · Nov 6, 2026
diff --git 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
@@ -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
@@ -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
@@ -8,7 +8,7 @@

 If you meant who can read the published docs site (login, password, groups), run `mint instructions access` instead.

 Use this to add teammates, set roles, SSO, SCIM, session or IP policies, audit logs, contacts, notifications, or the desktop app. All of it is configured in the dashboard (https://app.mintlify.com). You cannot set any of it from the repo, `docs.json`, or the `mint` CLI. Give the user exact steps and links.

 ## Workflow

@@ -19,18 +19,18 @@
   - Editor: everything a viewer can, plus edit in the web editor, publish, create/rename/delete pages, reorder navigation, upload media, trigger, roll back and promote deployments, create/delete API keys, configure integrations, assistant and add-ons, make changes with the Slack agent, accept or reject suggestions, invite editors and viewers.
   - Admin: everything, plus update roles, invite admins, delete users, billing, SSO, SCIM, IP allowlist and session lifetimes, audit logs, security contact, custom domain, Git source, custom subpath, delete a project, agent publishing setting, delete organization, delete any comment.
   - Change a role: **Members** page, **Role** dropdown (saves immediately, applies on next dashboard load). You cannot change your own role. **Managed by SSO** rows change in the IdP.
 4. Offboard: **Members** page, actions menu. **Remove member** deletes membership, access and their keys. **Revoke credentials** keeps membership and revokes any of: Sessions, CLI tokens, API keys, Discovery API keys, M2M clients, Connected apps. Not reversible; you cannot revoke your own.
 5. SSO (Enterprise, admin): **Security** page (https://app.mintlify.com/settings/organization/access), **SSO** section. Each button opens the Admin Portal, which has the identity provider steps.
   - First **Verify email domains**: add your team's email domain and its DNS record in the Admin Portal. **Set up SSO** stays disabled until a domain shows **Verified**.
   - Then **Set up SSO** and follow the Admin Portal steps. When connected, the section shows **SAML SSO** with a **Connected** badge. **Manage SSO** reopens the portal.
   - After you connect SSO, Mintlify sends anyone signing in with a verified-domain email to the IdP. Test sign-in from the login page and from the IdP in a private window.
   - First SSO sign-in adds the user to the organization with the role the IdP assigns, or editor if none.
   - Existing SSO or SCIM set up before the Admin Portal: reconnect by November 20, 2026 from the dashboard banner's **Set up now** (admins only). See https://www.mintlify.com/docs/help-center/reconnect-existing-sso-and-scim.
 6. SCIM (Enterprise, admin): **Security** page, **SCIM** section, **Set up directory sync**, follow the Admin Portal steps. **Manage directory** reopens the portal. Roles follow the IdP's role assignments; provisioned members show **Managed by SSO** on **Members**, so change their roles in the IdP.
 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).
@@ -41,7 +41,7 @@

 - Never claim you configured members, roles, SSO, SCIM or policies. Hand the user the steps; an admin must do the admin-only ones.
 - Dashboard roles do not gate Git. Anyone with write access to the repo can push, and pushes to the deploy branch deploy regardless of role. Lock down the repo separately.
 - Before an IP allowlist, confirm the admin's current IP (shown in **Policies**) is on it, or they lock themselves out.

 ## Examples

@@ -59,6 +59,6 @@

 - `mint instructions access` (docs-site reader access)
 - https://www.mintlify.com/docs/dashboard/roles
 - https://www.mintlify.com/docs/dashboard/sso
 - https://www.mintlify.com/docs/dashboard/scim
 - https://www.mintlify.com/docs/dashboard/network-access
diff --git a/mint-instructions/publish/analytics.mdx b/mint-instructions/publish/analytics.mdx
@@ -7,12 +7,12 @@
 ---
 Use this for docs performance questions, data-driven fixes, or adding analytics, chat, or consent tooling to the site. Analytics and feedback require a Pro or Enterprise plan.

 ## Workflow: read the data

 1. Run `mint status` to confirm you are logged in (`mint login` if not).
 2. Pick the subdomain and range. Shared flags on every subcommand: `--subdomain`, `--from YYYY-MM-DD`, `--to YYYY-MM-DD` (defaults: last 7 days to today), `--format table|plain|json|graph`. Output defaults to `json` in AI or CI environments. Persist defaults with `mint config set subdomain <sub>` (also `dateFrom`, `dateTo`).
 3. Run the subcommand that answers the question:
   - `mint analytics stats [--page <path>]`: views, visitors, searches, feedback, assistant usage. Human and agent traffic are reported separately.
   - `mint analytics search [--query <substring>] [--page <path>]`: queries with hit counts, click-through rate, top clicked page, last searched date.
   - `mint analytics feedback [--type page|code] [--page <path>]`: individual entries by default, `--type page` aggregates by page, `--type code` keeps only code snippet feedback.
   - `mint analytics conversation list [--page <path>]`: recent assistant conversations (timestamp, first query, category). `--page` filters to conversations whose sources reference that page.
@@ -31,15 +31,15 @@
 
 ## 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.
 
 ## Feedback

 - Enable feedback types in the dashboard: **Site** settings (https://app.mintlify.com/settings/project/site), **Feedback** section: thumbs rating, edit suggestions and raise issues (public repos only), contextual feedback (optional email), code snippet feedback.
 - Agent feedback (beta): agents connected to the site's search MCP server call the `submit_feedback` tool with a page path and a problem description. Each accepted submission records as unhelpful feedback on that page and shows in **Detailed feedback** (filter Type: Agent feedback). Web search and web fetch tools do not reach this tool. The path must match a page or a redirect source, or the call errors.
 - The analytics feedback API endpoint returns agent feedback with `source=agent` (https://www.mintlify.com/docs/api/analytics/feedback).
 - Assistant thumbs ratings are separate (Assistant satisfaction), not page feedback.

 ## Rules
@@ -85,8 +85,8 @@
 }
 ```

 - `cookies`: telemetry is disabled for visitors whose local storage lacks that key/value.
 - Transcend: analytics and feedback load only after consent for the purpose (default `Analytics`). Mintlify's own banner is hidden.
 - Osano has no docs.json key. Create `osano.js` in the content directory (auto-included on every page):

 ```js
@@ -112,4 +112,4 @@
 - https://www.mintlify.com/docs/analytics
 - https://www.mintlify.com/docs/optimize/feedback
 - https://www.mintlify.com/docs/integrations/analytics/overview
 - https://www.mintlify.com/docs/cli/commands