# Requesting Access with Teams

{% hint style="success" %}
We launched the Access Assistant MCP Server - request the access you need from your favorite AI Tool - Claude, Copilot, VSCode, and others. Learn more [here](/docs/access-requests-and-approvals/apono-assist-mcp-server.md).
{% endhint %}

If your admin has integrated Apono with Teams, you can use Teams to request, view, and receive permission to services, databases, and applications that are centrally managed through Apono.

Requesting access with Teams offers several benefits:

* Streamline access requests to resources without navigating complex IT systems
* Centralize access visibility to view pending approvals and current permissions
* Improve security and compliance with centrally managed access
* Enhance collaboration by enabling approvers to grant or deny requests directly in Teams

***

### Prerequisites

<table><thead><tr><th width="210">Item</th><th>Description</th></tr></thead><tbody><tr><td><strong>Apono Account</strong></td><td><p>Access to Apono</p><p>You can verify that you have access by going to the <a href="https://portal.apono.io/">Apono Portal</a> or contacting your administrator to obtain a user account.</p></td></tr><tr><td><strong>Access Flow Grantee</strong></td><td><p>Inclusion in at least one access flow</p><p>Contact your administrator for more information.</p></td></tr><tr><td><strong>Apono Teams</strong></td><td><p>Apono Teams app installed from the Apono Catalog<br></p><p>Contact your administrator for more information.</p></td></tr></tbody></table>

***

### Request new access

You can request access to specific resources, an app, or a bundle in Teams.

{% hint style="success" %}
**Need access? Just ask** [**Apono Assist**](/docs/access-requests-and-approvals/apono-assist.md)**.**

Describe your goal in plain language, and Apono Assist will suggest the right resources or access options.

If you prefer to select resources manually, follow the steps on the tabs below.
{% endhint %}

{% tabs %}
{% tab title="Request by Resource" %}

<figure><img src="/files/G684hbuWaFbjKvW8NqfA" alt=""><figcaption></figcaption></figure>

A resources request lets you select specific resources and permissions from all available items across cloud environments. Upon submission, Apono separates the form into individual requests based on each resource's access flow.

Follow these steps to request access to resources:

1. In the Teams menu, click **My Requests > New Request**. The **New Request** page appears.
2. Click the **All Resources** tab. The resources fields appear below.
3. From the **Request on Behalf of** dropdown menu, select the individual to receive access. By default, your user profile is selected.
4. Under **How would you like to access resources?**, click **By Resource**. The **Request by Resource** fields appear.
5. (Optional) In the **Search** field, enter the name of a resource.
6. (Optional) Apply one or both filters to refine the list of resources.
   1. From the **Resource Type** dropdown menu, select one or several resource types to filter the list of resources.
   2. From the **Permission** dropdown menu, select one or several permissions to filter the list of resources.
7. Select one or several resources. You can select a **maximum of 1,000** resources.

{% hint style="success" %}
If you require access to all available resources, click **Select all**.
{% endhint %}

8. Click **Next**. The **Complete Additional Details** page appears.
9. Choose a **Duration** from the dropdown menu to set the access period.
10. (If applicable) Select the **Ticket Type** associated with your request as defined in your organization’s ticketing system.
11. (If applicable) Enter the unique **Ticket ID** from your organization’s ticketing system to link the request to the tracked task.
12. Under **Why do you need this access?** enter a reason why you are requesting access to the resource.

{% hint style="info" %}
A clear explanation helps approvers understand your request, speeds up approvals, and ensures the access can be audited later.

As you type, Apono provides real-time feedback to help you improve your justification. It evaluates whether you have:

* Described the task you are working on
* Explained why this level of access is required
* Included a relevant ticket ID

<img src="/files/dhgdUbksNnzUGHfmw3ey" alt="" data-size="original">

When your justification meets these requirements, the indicator will turn green.
{% endhint %}

13. Click **Submit** **Request**. The request will appear with its [status](#access-statuses) on the **My Requests** tab.

You will receive a notification through Teams that the request has been submitted.

{% hint style="success" %}
After a request has expired or been revoked, you can mark it as a [favorite](/docs/access-requests-and-approvals/favorites.md#backstage-and-teams).
{% endhint %}
{% endtab %}

{% tab title="Request by App" %}

<figure><img src="/files/LqYe7hPL9f8ZzrdbAFpl" alt=""><figcaption></figcaption></figure>

Follow these steps to request access to an integration:

1. In the Teams menu, click **My Requests > New Request**. The **New Request** page appears.
2. Click the **All Resources** tab. The resources fields appear below.
3. From the **Request on Behalf of** dropdown menu, select the individual to receive access. By default, your user profile is selected.
4. Under **How would you like to access resources?**, click **By App**. The **Request by App** fields appear.
5. Select an **Integration**.
6. Select a **Resource Type**. The available options depend upon the selected integration.
7. Select one or more **Resources**. The available options depend upon the selected resource type.
8. Select one or more **Permission** options. The available options depend upon the selected resources. You are only able to request permissions defined by your admin’s access flow.
9. Click **Next**. The **Complete Additional Details** page appears.
10. Choose a **Duration** from the dropdown menu to set the access period.
11. (If applicable) Select the **Ticket Type** associated with your request as defined in your organization’s ticketing system.
12. (If applicable) Enter the unique **Ticket ID** from your organization’s ticketing system to link the request to the tracked task.
13. Under **Why do you need this access?** enter a reason why you are requesting access to the resource.

{% hint style="info" %}
A clear explanation helps approvers understand your request, speeds up approvals, and ensures the access can be audited later.

As you type, Apono provides real-time feedback to help you improve your justification. It evaluates whether you have:

* Described the task you are working on
* Explained why this level of access is required
* Included a relevant ticket ID

<img src="/files/dhgdUbksNnzUGHfmw3ey" alt="" data-size="original">

When your justification meets these requirements, the indicator will turn green.
{% endhint %}

14. Click **Submit** **Request**. The request will appear with its [status](#access-statuses) on the **My Requests** tab.

You will receive a notification through Teams that the request has been submitted.

{% hint style="success" %}
After a request has expired or been revoked, you can mark it as a [favorite](/docs/access-requests-and-approvals/favorites.md#backstage-and-teams).
{% endhint %}
{% endtab %}

{% tab title="Request by Bundle" %}

<figure><img src="/files/PS8jmJRHQMukxbRXJdRS" alt=""><figcaption></figcaption></figure>

Follow these steps to request access to a bundle:

1. In the Teams menu, click **My Requests > New Request**. The **New Request** page appears.
2. Click the **Bundles** tab. The bundle fields appear below.
3. From the **Request on Behalf of** dropdown menu, select the individual to receive access. By default, your user profile is selected.
4. (Optional) Under **Request a bundle**, in the **Search** field, enter the full or partial bundle name. The list updates to show matching bundle cards and the total number of results.
5. Select a bundle card.

{% hint style="success" %}
You can select specific resources within a bundle:

1. On a bundle card, click <img src="/files/JM9qPKgJc5PZ04Zzra06" alt="" data-size="line"> (Resources icon). The resources form appears, filtered for the bundle.

2. Select one or several resources.

3. (Optional) Click **Show selected** to display only the selected resources.
   {% endhint %}

4. Click **Next**. The **Complete Additional Details** page appears.

5. Choose a **Duration** from the dropdown menu to set the access period.

6. (If applicable) Select the **Ticket Type** associated with your request as defined in your organization’s ticketing system.

7. (If applicable) Enter the unique **Ticket ID** from your organization’s ticketing system to link the request to the tracked task.

8. Under **Why do you need this access?** enter a reason why you are requesting access to the resource.

{% hint style="info" %}
A clear explanation helps approvers understand your request, speeds up approvals, and ensures the access can be audited later.

As you type, Apono provides real-time feedback to help you improve your justification. It evaluates whether you have:

* Described the task you are working on
* Explained why this level of access is required
* Included a relevant ticket ID

<img src="/files/dhgdUbksNnzUGHfmw3ey" alt="" data-size="original">

When your justification meets these requirements, the indicator will turn green.
{% endhint %}

11. Click **Submit** **Request**. The request will appear with its [status](#access-statuses) on the **My Requests** tab.

You will receive a notification through Teams that the request has been submitted.

{% hint style="success" %}
After a request has expired or been revoked, you can mark it as a [favorite](/docs/access-requests-and-approvals/favorites.md#backstage-and-teams).
{% endhint %}
{% endtab %}
{% endtabs %}

***

### Extend existing access duration

If the **Extend** option is enabled for an access request, it becomes active when your access is nearing expiration. After clicking the **Extend** button, the duration of your existing access is increased, based on settings defined by your administrator.

Extending access will not interrupt your work. You will not be prompted to do any of the following when extending access:

* Re-authenticate with credentials or MFA
* Create a new user
* Start a new session

If this option is not available, or you have reached the maximum number of extensions, you must submit a new access request to continue accessing the resource.

<figure><img src="/files/WNmzYDfsgGKGjRV1MU2d" alt="" width="563"><figcaption></figcaption></figure>

Follow these steps to extend access:

1. On the **My Requests** page, in the row of the request, click **Extend**. The **Extend this request?** pop-up window appears.

{% hint style="success" %}
If you are [viewing the request](#view-requests), you can click **Extend** on the details panel.

You will also receive a notification on the **Activity** page. Clicking on the notification will open the request details where you can also click **Extend**.
{% endhint %}

2. Click **Extend**. The duration of your resource access is increased.

***

### Request access again

If your access has expired, been revoked, or been rejected, you can request the same access again from one of the following locations.

{% tabs %}
{% tab title="My Access" %}

<figure><img src="/files/l1Ty998qzy0J7aTYULCl" alt="My Access Widgets"><figcaption></figcaption></figure>

{% hint style="info" %}
Only the three most recent closed requests and favorites appear on the **My Access** page.
{% endhint %}

Follow this step to request access to a resource, an app, or a bundle:

1. On the **My Access** page, click <img src="/files/wXYQ1kdopcOtzuZMkMSF" alt="" data-size="line"> (Request again icon) next to a request under **Recent Requests** or **Favorites**.
   {% endtab %}

{% tab title="My Requests" %}

<figure><img src="/files/clecws28SzwYabGBpQV8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If someone else has made a request on your behalf and you lack permission to request access for yourself, only the requester can request access again for you.
{% endhint %}

Follow these steps to request access to a resource, an app, or a bundle:

1. On the **My Requests** tab, from the **Status** dropdown menu, select none, one, or several options to filter the list of requests.
2. In the row of your desired request, click **Request again**. A pop-up window appears.
3. Enter a **Justification** explaining why you are resubmitting the request.
4. Click **Submit**. The request will appear with its [status](#access-statuses) on the **My Requests** tab.
   {% endtab %}

{% tab title="Favorites" %}

<figure><img src="/files/YJ5cWVBZziFkH6jxvjLM" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Only requests marked as [favorites](/docs/access-requests-and-approvals/favorites.md) appear on this tab.
{% endhint %}

Follow these steps to request access to a resource, an app, or a bundle:

1. On the **Favorites** tab, in the row of your desired request, click **Request again**. A pop-up window appears.
2. Enter a **Justification** explaining why you are resubmitting the request.
3. Click **Submit**. The request will appear with its [status](#access-statuses) on the **My Requests** tab.
   {% endtab %}

{% tab title="Delegated Requests" %}

<figure><img src="/files/Y2HXAM5miD9wtoTPD7JK" alt=""><figcaption></figcaption></figure>

Follow these steps to request access to a resource, an app, or a bundle for a grantee:

1. On the **Delegated Requests** page, from the **Status** dropdown menu, select one or more options to filter the list of requests.
2. In the row of your desired request, click **Request again**. A pop-up window appears.
3. Enter a **Justification** explaining why you are resubmitting the request.
4. Click **Submit**. The request will appear with its status on the **Delegated Requests** page.
   {% endtab %}
   {% endtabs %}

You will also receive a notification through Teams.

***

### View requests

You can view your open and closed requests.

{% tabs %}
{% tab title="My Requests" %}

<figure><img src="/files/SWyH2Utc2AkjvdpegyUs" alt=""><figcaption></figcaption></figure>

Follow these steps to view your requests:

1. On the **My Requests** tab, from the **Status** dropdown menu, select one or more options to filter the list of requests.

{% hint style="success" %}
You can also use the request status widgets to quickly identify the number of requests in **Active**, **Pending Approval**, or **Pending MFA** status.

<img src="/files/ho6S1p7CK0DElsnj79ts" alt="" data-size="original">

Clicking one or more widgets will filter the list to show only requests with that status.
{% endhint %}

2. Click a request. A panel appears displaying the details of the access request.

{% hint style="info" %}
For requests with the **Rejected** status, you can view the **Rejection Reason** under **Approvals**.
{% endhint %}

3. Under **Access to**, click **View resources** to display the resources to which the request grants access.
4. (Optional) For requests with the **Active** [status](#access-statuses), click **Use access** to open the **My Access** page.
5. (Optional) Click [**Request again**](#request-access-again) to resubmit the request.
6. At the top right of the panel, click **X** to close the panel.
7. (Optional) Click the ⭐ icon on the request card to mark this request as a favorite.

{% hint style="info" %}
You can only favorite requests that you have submitted for yourself.
{% endhint %}
{% endtab %}

{% tab title="Delegated Requests" %}

<figure><img src="/files/Y2HXAM5miD9wtoTPD7JK" alt=""><figcaption></figcaption></figure>

Follow these steps to view and track the statuses all the requests you have made on behalf of grantees:

1. On the **Delegated Requests** page, from the **Status** dropdown menu, select none, one, or several options to filter the list of requests.
2. Click a request card. A panel appears displaying the details of the access request.

{% hint style="info" %}
For requests with the **Rejected** status, you can view the **Rejection Reason** under **Approvals**.
{% endhint %}

3. Under **Access to**, click **View resources** to display the resources to which the request grants access.
4. (Optional) Click [**Request again**](#request-access-again) to resubmit the request.
5. At the top right of the panel, click **X** to close the panel.
   {% endtab %}
   {% endtabs %}

***

### Revoke an access request

{% tabs %}
{% tab title="My Requests" %}
{% hint style="info" %}
If someone else has made a request on your behalf, only the requester can revoke the request.
{% endhint %}

Follow these steps to revoke your access:

1. On the **My Requests** tab, from the **Status** dropdown menu, select none, one, or more options to filter the list of requests.
2. Click a request card. A panel appears displaying the details of the access request.
3. Click **Revoke access**. A confirmation window appears.
4. Click **Yes**.
   {% endtab %}

{% tab title="Delegated Requests" %}
Follow these steps to revoke access from a grantee for whom you requested access:

1. On the **Delegated Requests** page, from the **Status** dropdown menu, select none, one, or more options to filter the list of requests.
2. Click a request card. A panel appears displaying the details of the access request.
3. Click **Revoke access**. A confirmation window appears.
4. Click **Yes**.
   {% endtab %}
   {% endtabs %}

***

### Access Statuses

<table><thead><tr><th width="215">Status</th><th>Description</th></tr></thead><tbody><tr><td><strong>Pending Approval</strong></td><td>The request is waiting for the approver to approve or reject the request.</td></tr><tr><td><strong>Granting</strong></td><td>The request has been approved. Apono is provisioning the access.</td></tr><tr><td><strong>Active</strong></td><td><p>Access has been provisioned. You can access the resource.</p><p>Follow these steps to access the resource:</p><ol><li>On the <strong>My Access</strong> page, click <strong>Access Details</strong> for the resource. A pop-up window appears.</li><li>Follow the instructions to access the resource.</li></ol><p>Requests in this status appear on the <strong>My Requests</strong> tab. You will also receive a notification through Teams.</p></td></tr><tr><td><strong>Rejected</strong></td><td><p>The request has been rejected either automatically or by approvers.</p><p><br>Hover over the status to read the rejection reason written by the approver.</p></td></tr><tr><td><strong>Revoking</strong></td><td>An admin has initiated removing your resource access.</td></tr><tr><td><strong>Revoked</strong></td><td>An admin has removed your resource access.</td></tr><tr><td><strong>Failed</strong></td><td><p>An error has occurred with your request. Contact your admin.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>Requests pending approval for over 7 days become Failed automatically.</p></div></td></tr></tbody></table>


---

# Agent Instructions: 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:

```
GET https://docs.apono.io/docs/access-requests-and-approvals/teams/requesting-access-with-teams.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.