> For the complete documentation index, see [llms.txt](https://docs.material.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.material.security/whats-new/version-1.66.md).

# Version 1.66

Version 1.66 brings the OAuth Security report to every Advanced customer, with a date range you choose. You can now search messages through the Material MCP server, look up tenants through the API, and sort, filter, and search more of your lists.

***

## :tada: New

### See OAuth app risk over time with the OAuth Security report

The OAuth Security report shows how the OAuth Agent audited, classified, and resolved your connected apps, and which apps can reach your sensitive data.

To view it, from the left navigation expand **OAuth Security**, then click **Report**.

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2FAHDK0JlHdrZS0pticeL0%2Fimage.png?alt=media&amp;token=6156f5e7-7c13-4329-98b3-280c9eadc7d6" alt="OAuth Security report showing the selected date range and report sections"><figcaption></figcaption></figure>

Choose **Last Month**, **Last 3 Months**, **Last Year**, or **All Time** to change the period. The report opens on **Last 3 Months**. Every section follows your choice:

* Overview
* Audited apps
* Issue resolution
* Active app blast radius
* Auto-response

Links from the report keep the range you picked, so the list you open matches the numbers you saw. The report header shows the exact dates it covers.

The report also includes these improvements:

#### Clearer OAuth Security report results

* **Audited apps** lists apps whose classification changed first, then Malicious and Suspicious apps, then Unnecessary and Overprivileged apps, then Safe apps. Audits with no classification no longer count as a change.
* **Active app blast radius** shows suggested classifications the same way the OAuth apps list does, and leaves out apps with no access to sensitive messages or files.
* Summary sentences are easier to read and only mention what happened in the period you chose.

#### See scope levels before you revoke access

When you revoke an app's access for selected accounts, the window now shows how many of those accounts granted each scope level before you remove access.

#### See which scopes changed on an app's timeline

Scope change events on an app's timeline now list the specific scopes that were added or lost. Hover over the scope count to see them.

#### Clearer inherit and override choices in OAuth settings

With a tenant selected, OAuth Security settings now show **Inherit from global setting (currently On)** or **(currently Off)**, and **Set for** followed by the tenant's name, so you can see what the tenant gets before you change it.

{% hint style="info" %}
The OAuth Security report is available on the Advanced plan. Learn more about [OAuth Security](https://docs.material.security/workspace-protections/oauth-security.md).
{% endhint %}

***

### Search messages through the Material MCP server and API

#### Search with the Material MCP

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2Fd6g92xC9YfX0AVwb6jFs%2Fimage.png?alt=media&amp;token=6c84f29e-04ad-4346-9007-591ae7a541b8" alt="AI assistant searching messages through the Material MCP server"><figcaption></figcaption></figure>

You can now ask an AI assistant [connected to the Material MCP server](https://docs.material.security/reference/material-mcp-server#how-to-connect) to search your messages. The server adds three tools:

* `search_messages` starts a message search
* `get_message_search` returns the results
* `get_message_search_reference` gives the assistant the MQL fields, operators, and your sensitive categories, so it can turn your question into a valid search

Message searches via all sources (including the Material MCP server) are subject to a daily quota. See [Message Search](https://docs.material.security/working-with-issues/explorer/message-search) for details.

#### More detail in message search API results

* Message search results now include `messageId`, `subject`, `to`, `cc`, and `bcc`, so you don't need to fetch each message. Add `include=attachments` to get each message's attachment count.
* Invalid MQL now returns a 400 error that points to where the problem is, and Material checks your query before it counts toward your quota.

{% hint style="warning" %}
Two changes may affect existing scripts:

* An unknown `include` value now returns a 400 error that lists the valid values, instead of being ignored.
* Message search now rejects MQL functions that the Material UI doesn't support, such as `length()`.
  {% endhint %}

{% hint style="info" %}
Searches you run in the Material UI, through the API, and through the Material MCP server all count toward the same quota.
{% endhint %}

***

### Mark messages suspicious through the API and MCP

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2FRXQ8CgJwCI8f8pYwvjiM%2Fimage.png?alt=media&amp;token=ed821bec-36ec-446b-9f9d-5f4100d09758" alt=""><figcaption></figcaption></figure>

When Material misses a message, you can now mark it suspicious through the v1 API or the Material MCP server.

* `POST /messages/mark-suspicious` marks up to 200 messages at a time. Each message joins an email threat issue classified Malicious, either a new issue or the one it's already in.
* `GET /messages/mark-suspicious/{id}` shows which issue each message was added to.
* The MCP server adds matching `mark_messages_suspicious` and `get_mark_messages_suspicious` tools.

Your API token needs permission to flag messages and read issues, and it must belong to an account with a mailbox. Material records that account as the one who marked the messages.

{% hint style="warning" %}
Each issue gets the default response for Malicious from your Issue Triage settings, and that response may delete the message. You can't choose a different response when you mark a message. To change it, update the issue afterward.
{% endhint %}

***

### Look up tenants through the API and MCP

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2Fvg1om7Qsdx0OFkEQB7Rg%2Fimage.png?alt=media&amp;token=11e623e5-28be-48bd-b4a6-5320f16ea2b9" alt=""><figcaption></figcaption></figure>

The v1 API and the Material MCP server can now tell you which tenants you have access to, so you can match the tenant IDs that other responses return.

* `GET /tenants` and `GET /tenants/{id}` list your tenants or return one. The MCP server adds matching `list_tenants` and `get_tenant` tools.
* Accounts now include a `tenantId`.
* `GET /accounts` and the `list_accounts` tool accept a `tenant` filter that returns only that tenant's accounts.
* The tenant on an issue now includes its `id`.

{% hint style="info" %}
Learn more about the [Material API](https://docs.material.security/reference).
{% endhint %}

***

## ✨ Enhancements

### Email Identity Protection setup

To make setup easier, the Email Identity Protection settings page now explains why server-side routing is needed, then walks you through each step. To open it, from the left navigation expand **Email Identity Protection**, then click **Settings**.

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2F9IMSvawNJ0OjuyV9dpBp%2Fimage.png?alt=media&amp;token=d0244b6e-802f-419f-8419-f9cf9ab02a9e" alt="Email Identity Protection settings with server-side routing setup steps"><figcaption></figcaption></figure>

{% hint style="info" %}
Learn more about [enabling Email Identity Protection](https://docs.material.security/getting-started/deployment-guides/deploy-account-takeover-resilience-ator/enable-identity-protection.md).
{% endhint %}

***

### Google Drive Security

#### Syncing and protection settings in one place

File syncing and protection settings for My Drives and shared drives now live together in the **Syncing and Protection** section. To find it, from the left navigation expand **Google Drive Security**, then click **Settings**.

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2FCsUxaGZ5dpr1MGypYFN0%2Fimage.png?alt=media&amp;token=1a2c708c-0b3e-4dea-8f59-b30e5ec97333" alt=""><figcaption></figcaption></figure>

* Turning on syncing or protection opens a short setup window. Choose whether it's on by default, then pick the accounts, groups, or shared drives to include or leave out.

{% hint style="info" %}
You can still override My Drive syncing and remediation in account or group settings, using **File Sync** and **File Remediation**. Shared drives aren't tied to an account or group, so you manage them only in **Syncing and Protection**. Learn more about [enabling Google Drive Security](https://docs.material.security/getting-started/deployment-guides/your-first-30-days/2-enable-file-security.md).
{% endhint %}

#### Know when Google Drive syncing is complete

When Material finishes syncing six months of Google Drive history for a tenant, Tenant Admins receive a one-time email. The email includes file counts and the number of sensitive files shared publicly, externally, or company-wide.

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2FGTfMCIrDQIBmlwbbjZdH%2Fimage.png?alt=media&amp;token=359a404e-ffdb-4428-acb3-caa1d46f0a95" alt="Email notification confirming Google Drive history syncing is complete"><figcaption></figcaption></figure>

***

### Sort, filter, and search more lists

More lists across Material now support sorting, filtering, and search:

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2Fh4KBid5UNxKIrphAKtNt%2Fimage.png?alt=media&amp;token=53e2af12-2ca2-4d60-a37f-36d33da532f5" alt="Material list with sorting, filtering, and search controls"><figcaption></figcaption></figure>

| List                                                              | What you can do                                                                                                                                          |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Admin Accounts** (**Settings** > **Admin Accounts**)            | Sort by account and filter by role. The CSV download and **View in Explorer** link use the same filter.                                                  |
| **API tokens** (**Integrations** > **API and MCP**)               | Filter by **Status**, **Created By**, or **Current roles**                                                                                               |
| **Challenge bypasses** (**Settings** > **End-user Verification**) | Sort and search by entity, filter by **Entity type** or **Created by**, and see every bypass in one list, with the same batch actions bar as other lists |
| **Detections**                                                    | The **Has active issues** filter now finds every matching detection, and you can sort the list                                                           |
| **Message attachments**                                           | Sort the **Attachments** tab by any column                                                                                                               |
| **OAuth app Accounts tab**                                        | Sorting now applies to every page of results, and you can filter by VIP                                                                                  |
| **Sensitive Categories**                                          | Filter by **Severity**, and your search stays in place when you reload the page or share the link                                                        |
| **Simulations**                                                   | Sort accounts when you add recipients, sort enrolled groups by **Name** or **Members**, and filter recipients by **Status** or **Result**                |

***

### Issues and messages

We made a few improvements to issues and message views:

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2FH8QCf3SHDDBCtykD7XBh%2Fimage.png?alt=media&amp;token=9f93a127-388e-4cec-a3fe-e869053ff164" alt="Email threat issue with Change status available in the actions"><figcaption></figcaption></figure>

Improvements include:

* **Change status is always in reach:** **Change status** now always appears on the actions bar when you select email threat issues, next to **Change classification** and **Change response**.
* **Issue changes show up everywhere right away**: when you change an issue in one view, such as setting an email threat issue to Safe, every other view, including the Issues list, shows the change right away. You don't need to reload the page.
* **Custom views remember column order**: when you drag columns into a new order in a custom issue view, including grouped views, the order now saves with the view, and links you share keep it.
* **Automatically handle issues:** You can now select both **Delete** and **Resolve** in remediation settings and detection response steps.

***

### Administration and reports

#### Compare purchased and assigned licenses

The **How are licenses assigned?** chart on the Usage page now shows how many licenses of each type you've assigned compared to how many you purchased, and highlights any type that's over. To view it, from the top toolbar click **Settings** > **Usage**.

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2FNXZZUeYWvCCNpzDjBbG3%2Fimage.png?alt=media&amp;token=4e3d9e3a-5242-40ea-9a1c-8e842fa9dec3" alt="Usage page chart comparing purchased and assigned licenses"><figcaption></figcaption></figure>

If you've assigned well over the number of licenses you purchased, a banner in the left navigation lets you know and links to the Usage page.

{% hint style="info" %}
Learn more about [managing licenses](https://docs.material.security/administration/manage-licenses.md).
{% endhint %}

#### Improved Email Redaction report

To view the Email Redaction report, from the left navigation expand **Email Redaction**, then click **Report**.

<figure><img src="https://3411262179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FksjM8NywYRSHu1IlfxdP%2Fuploads%2FBx2h2GlNXtTjWrmYbNGL%2Fimage.png?alt=media&amp;token=f176ab26-fdea-47f1-940f-a2623e03e9f7" alt="Email Redaction report with movement and top accounts charts"><figcaption></figcaption></figure>

Improvements include:

* The movement chart names the four busiest external domains and groups the rest.
* **Top accounts with sensitive messages** replaces the separate origin and destination rankings, and shows each account's current Email Redaction setting.
* Report tables line up their headers and rows the same way across the Email Redaction, Google Drive Security, and Email Identity Protection reports.

#### Two sync columns on the Accounts list

The **Last Sync** column on the Accounts list is now **Last Mailbox Sync**. You can also show a new **Last Directory Sync** column, which is hidden by default. The CSV export includes both, with matching headers.

#### A Report item for User Reports

**User Reports** now has a **Report** item, so you can open the Email Threats report without leaving the User Reports section.

***

### Broader built-in email threat coverage

Material's built-in email threat detection now catches more:

* Business email compromise that uses proposal lures, fake file shares, or fake calendar invite links
* Abuse of legitimate survey, website, and app-testing services to deliver email threats
* Donation scams
* Brand impersonation
* Messages built with known attack kits

Existing coverage was also tuned to catch more callback lures, fake password resets, and voicemail lures, and to cut down false positives.

{% hint style="success" %}
Built-in detection coverage updates roll out continuously, independent of the release cycle.
{% endhint %}

***

## 🐛 Fixes

<details>

<summary>Google Drive Security</summary>

* File responses that remove internal access no longer show "Failed to update permissions" when every share was removed as expected.
* File responses that change internal access while external access is set to **No change** now apply the internal change.
* With a tenant selected, saving a file detection response and choosing **Apply to open issues** now keeps the response you saved.
* Files with many permissions now open quickly, even when your tenant has many trusted entities.

</details>

<details>

<summary>Email threats and responses</summary>

* If you set an issue's classification back to **Unknown**, Material keeps your choice instead of changing it back.
* Protected links in calendar invites now open their destination correctly.
* The **Routing** tab in message details now lists the most recent hops first.

</details>

<details>

<summary>Email Bomb Protection</summary>

* Emails that Material sends you about an email bomb attack, such as integration notifications, are no longer moved to the Surge folder.
* When an email bomb attack starts in Microsoft 365, Material now moves every matching message to the Surge folder.

</details>

<details>

<summary>Accounts and syncing</summary>

* Gmail activity now syncs completely during periods of very high activity.
* New Gmail accounts start syncing new mail right away on tenants that use **Require mailbox for license assignment**.
* When you update many accounts at once, Material retries updates that conflict with a background sync, and the result message now matches what was saved.
* Clicking **Save** twice on an account setting no longer shows an error. The **Share issue**, **Block Sender**, and **Add Trusted Sender** windows now show whether the save worked, and stay open so you can retry if it didn't.
* After you grant additional Microsoft permissions, the **Action Required** banner clears right away.

</details>

<details>

<summary>Shared instances</summary>

* An account's blast radius now shows its sensitive messages and files when you select a tenant. It appears after the next daily refresh.
* The **Admin Accounts** page no longer reloads repeatedly.
* The reporter acknowledgement setting now shows whether acknowledgements are actually being sent.

</details>

<details>

<summary>Dedicated instances</summary>

* Signing in through a SAML identity provider connected to a single tenant now works when roles are assigned per tenant.

</details>

<details>

<summary>Navigation and search</summary>

* Navigation results in the search you open with ⌘K now match the left navigation, so you only see pages you can open.

</details>

<details>

<summary>Settings, reports, and API</summary>

* You can select exceptions again when you set a default locking grace period in group settings.
* The Email Redaction report now loads reliably.
* Enabling a detection your plan doesn't include through the API now returns a 403 error instead of saving the change.

</details>

***

## :books: New and Updated Documentation

**New**

* [Message Search](https://docs.material.security/working-with-issues/explorer/message-search.md): Search messages across every mailbox in **Quick**, **Prompt**, or **Query** mode, with a full reference of MQL fields and operators. [Email Threat Issue Search](https://docs.material.security/email-protections/email-threats/issues/email-threat-issue-search.md) now explains what the issue search bar covers and points you to message search for message content.
* [Example Notifications](https://docs.material.security/working-with-issues/respond/example-notifications.md): Example screenshots of the notifications your users see, ready to use with the [Communication Templates](https://docs.material.security/getting-started/deployment-guides/communication-templates.md).

<details>

<summary>Updated</summary>

* [8: Enable Google Drive Security](https://docs.material.security/getting-started/deployment-guides/your-first-30-days/2-enable-file-security.md): Roll out File Remediation to specific accounts or groups before you enable it for everyone.
* [1: Connect & Sync](https://docs.material.security/getting-started/deployment-guides/your-first-30-days/1-connect-and-sync.md): Check sync progress for each mailbox from the **Last Mailbox Sync** column on the Accounts list.
* [Set up a notification](https://docs.material.security/getting-started/deployment-guides/your-first-30-days/6-enable-email-remediation/set-up-a-notification.md): Updated steps to create a notification from an integration, with separate steps for Slack, email, and webhooks.
* [Email Threat Settings](https://docs.material.security/email-protections/email-threats/settings.md): Which link and attachment clicks Material can see, and which detections create issues when users click them.
* [Custom Detections](https://docs.material.security/detections/detections-overview/custom-detections.md): Which fields message detections can match, and what happens when a detection matches too many messages or files.
* [Messaging and Ticketing Integrations](https://docs.material.security/integrations/integration-fundamentals/messaging-and-ticketing-integrations.md): Download a full-size Material app icon for your Slack app.
* [How to Assign Roles](https://docs.material.security/administration/admin-roles/how-to-assign-roles.md), [Sensitive Categories](https://docs.material.security/detections/sensitive-categories.md), [Response and Remediation](https://docs.material.security/email-protections/email-threats/issues/issue-details/response-and-remediation.md), [Configure Default Auto-Responses](https://docs.material.security/working-with-issues/respond/configure-default-responses.md), [OAuth Response](https://docs.material.security/workspace-protections/oauth-security/oauth-remediation-responses.md), and [OAuth FAQ](https://docs.material.security/workspace-protections/oauth-security/oauth-faq.md): Updated for version 1.65, including enrolling admins from Admin Accounts, sensitive exemptions, suggested classifications on email threat issues, custom file remediation email subjects, and the new OAuth default responses.
* [Authentication](https://docs.material.security/reference/api-v1/authentication): Choose an expiration when you create an API token, and set a maximum API token lifetime.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.material.security/whats-new/version-1.66.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
