> For the complete documentation index, see [llms.txt](https://documentation.immuta.com/saas/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.immuta.com/saas/govern/secure-your-data/data-consumers/assume-an-intent.md).

# Assume an Intent

{% hint style="info" %}
**Public preview**: This feature is being released incrementally to customers on a rolling basis. If the feature is not available in your tenant yet, contact your Immuta representative to enable it.
{% endhint %}

[Intents](/saas/govern/secure-your-data/intents.md) enforce permissions based on your specific intent for accessing data. Instead of basing access decisions solely on who you are, intents allow the policy decision to be based on what you are doing and why you need access.

Immuta generates a role or group in your data platform for each intent-group pair that is created in Immuta. In the example below, a governor creates a Clinical trial intent and assigns the group `Analysts` to it. Then, Immuta generates a Clinical trial intent group in Databricks that members of the group `Analysts` can assume to query data under that intent.

<figure><img src="https://1751699907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWBda5Pt4s8apEhzXGl7%2Fuploads%2FaubAicpoHKpOymJlTJUl%2Fintents-diagram.png?alt=media&amp;token=93cba713-15a5-45ce-becb-b1c581c127a8" alt=""><figcaption></figcaption></figure>

In order to act under an intent, you must assume the Immuta-generated role or group in your data platform.

## Assume the Immuta-generated role

1. Click the <i class="fa-shield">:shield:</i> **Policies** icon in the navigation menu and select **Intents**.
2. Click the **Intent** you want to assume.
3. Click the **External Mapping** tab and find the group you are a member of (you might be a member of more than one group assigned to the intent). Copy the **Role** name that corresponds with that group.
4. Navigate to your data platform and assume that role or group to act under the intent.

Once you assume the intent in your data platform, the intent attributes replace your birthright attributes. See the [Intents reference guide](/saas/govern/secure-your-data/intents/intents-reference-guide.md#policy-enforcement-with-intents) for details about how this affects your access to data.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.immuta.com/saas/govern/secure-your-data/data-consumers/assume-an-intent.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
