Microsoft Entra ID Governance
Governance

Activate Microsoft Entra roles in PIM

In brief

The documentation explains how eligible users activate roles through the Microsoft Entra admin center or Azure mobile app, including verification, scope, timing, reason, and approval steps.

What Entra admins need to know

Administrators can use this guidance to help users activate roles when needed; no administrator action is specified.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

new file mode 100644

title: Activate Microsoft Entra roles in PIM description: Learn how to activate eligible Microsoft Entra roles with Privileged Identity Management (PIM) to perform administrative tasks when needed. ms.author: tamimsangrar ms.reviewer: ilyal ms.date: 11/17/2026 ms.topic: how-to ai-usage: ai-assisted ms.custom: - sfi-ga-nochange - sfi-image-nochange - msecd-doc-authoring-1032 zone_pivot_groups: pim-entra-role-activation-methods #customer intent: As a user with eligible Microsoft Entra role assignments, I want to activate my roles so that I can perform administrative tasks when needed.

Activate a Microsoft Entra role in PIM

Microsoft Entra Privileged Identity Management (PIM) simplifies how enterprises manage privileged access to resources in Microsoft Entra ID and other Microsoft online services like Microsoft 365 or Microsoft Intune.

If you have an eligible administrative role assignment, activate it when you need to perform privileged actions. For example, a user who manages Exchange Online might be eligible for Exchange Online Administrator rather than have permanent Global Administrator access.

Choose the method you will use to activate your Microsoft Entra role assignment.

::: zone pivot="entra-admin-center"

Activate a role in the Microsoft Entra admin center

When you need to assume a Microsoft Entra role, you can request activation by opening My roles in Privileged Identity Management.

  1. Sign in to the Microsoft Entra admin center as a user who has an eligible role assignment.

  2. Browse to ID Governance > Privileged Identity Management > My roles. For information about how to add the Privileged Identity Management tile to your dashboard, see Start using Privileged Identity Management.

  3. Select Microsoft Entra roles to see a list of your eligible Microsoft Entra roles.

    Screenshot of the My roles page showing roles you can activate.

  4. In the Microsoft Entra roles list, find the role you want to activate.

    Screenshot of the Microsoft Entra roles list showing eligible roles.

  5. Select Activate to open the Activate pane.

    Screenshot of Microsoft Entra role activation details showing duration and scope.

  6. Select Additional verification required and follow the instructions to provide security verification. You are required to authenticate only once per session.

    Screenshot of the security verification screen for role activation.

  7. After multifactor authentication, select Activate before proceeding.

    Screenshot of the identity verification prompt before role activation.

  8. If you want to specify a reduced scope, select Scope to open the filter pane. On the filter pane, you can specify the Microsoft Entra resources that you need access to. It's a best practice to request access to the fewest resources that you need.

  9. If necessary, specify a custom activation start time. The Microsoft Entra role would be activated after the selected time.

  10. In the Reason box, enter the reason for the activation request.

  11. Select Activate.

    If the role requires approval to activate, a notification appears in the upper right corner of your browser informing you the request is pending approval.

    Screenshot of the notification that a role activation request is pending approval.

View the status of activation requests

You can view the status of your pending requests to activate.

  1. Sign in to the Microsoft Entra admin center as at least a Privileged Role Administrator.

  2. Browse to ID Governance > Privileged Identity Management > My requests.

  3. When you select My requests you see a list of your Microsoft Entra role and Azure resource role requests.

    :::image type="content" source="./media/pim-how-to-activate-role/my-requests-page.png" alt-text="Screenshot of My requests - Microsoft Entra ID page showing your pending requests" lightbox="./media/pim-how-to-activate-role/my-requests-page.png":::

  4. Scroll to the right to view the Request Status column.

Cancel a pending request in the Microsoft Entra admin center

If you don't require activation of a role that requires approval, you can cancel a pending request at any time.

  1. Sign in to the Microsoft Entra admin center as at least a Privileged Role Administrator.

  2. Browse to ID Governance > Privileged Identity Management > My requests.

  3. For the role that you want to cancel, select the Cancel link.

    When you select Cancel, the request is canceled. To activate the role again, you have to submit a new request for activation.

    Screenshot of the My requests list with the Cancel action highlighted.

::: zone-end

::: zone pivot="my-access"

Activate a Microsoft Entra role in My Access portal (Preview)

Use Roles under My Access in the My Access portal to activate an eligible Microsoft Entra role assignment.

Microsoft Entra role assignment activation through the My Access portal is in preview. You activate an existing eligible role assignment to obtain temporary role access for your signed-in identity.

  1. Sign in to the My Access portal in the tenant where you have an eligible role assignment.

  2. Under My Access, select Roles, and then select Entra roles.

  3. Find and select the eligible Microsoft Entra role assignment that you need for your task.

    :::image type="content" source="media/pim-how-to-activate-role/my-access-entra-roles.png" alt-text="Screenshot of My Access Microsoft Entra roles showing an eligible role assignment and its Activate action." lightbox="media/pim-how-to-activate-role/my-access-entra-roles.png":::

  4. Review the activation details and complete the activation requirements shown for your role assignment.

  5. Select Activate to submit your activation request. If approval is required, wait for approval before using the role.

View and cancel a pending request in My Access

If you no longer need a pending role assignment activation, cancel the request in the My Access portal.

  1. Under My Access, select Roles, and then select Entra roles.
  2. In the Assignment status dropdown, select Pending.
  3. Find the request you no longer need, and select Cancel.

::: zone-end

::: zone pivot="api"

Activate a role using Microsoft Graph API

Use Microsoft Graph to list your eligible role assignments and submit a role activation request. The examples show a request that lists eligibility and an activation request with justification, schedule, and ticket information. For API permissions and resource details, see Overview of role management through the privileged identity management (PIM) API.

Get all eligible roles that you can activate

The following request lists your eligible role assignments. It doesn't return eligible role assignments obtained through group membership.

HTTP request

GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleEligibilityScheduleRequests/filterByCurrentUser(on='principal')

HTTP response

The sample response shows one role assignment. The response can include multiple eligible role assignments.

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(unifiedRoleEligibilityScheduleRequest)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.unifiedRoleEligibilityScheduleRequest",
            "id": "50d34326-f243-4540-8bb5-2af6692aafd0",
            "status": "Provisioned",
            "createdDateTime": "2022-04-12T18:26:08.843Z",
            "completedDateTime": "2022-04-12T18:26:08.89Z",
            "approvalId": null,
            "customData": null,
            "action": "adminAssign",
            "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
            "roleDefinitionId": "8424c6f0-a189-499e-bbd0-26c1753c96d4",
            "directoryScopeId": "/",
            "appScopeId": null,
            "isValidationOnly": false,
            "targetScheduleId": "50d34326-f243-4540-8bb5-2af6692aafd0",
            "justification": "Assign Attribute Assignment Admin eligibility to myself",
            "createdBy": {
                "application": null,
                "device": null,
                "user": {
                    "displayName": null,
                    "id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
                }
            },
            "scheduleInfo": {
                "startDateTime": "2022-04-12T18:26:08.8911834Z",
                "recurrence": null,
                "expiration": {
                    "type": "afterDateTime",
                    "endDateTime": "2024-04-10T00:00:00Z",
                    "duration": null
                }
            },
            "ticketInfo": {
                "ticketNumber": null,
                "ticketSystem": null
            }
        }
    ]
}

Self-activate a role eligibility with justification

Submit a role activation request for an existing eligible role assignment. The sample includes a justification, activation schedule, and ticket information.

HTTP request

POST https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignmentScheduleRequests

{
    "action": "selfActivate",
    "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
    "roleDefinitionId": "8424c6f0-a189-499e-bbd0-26c1753c96d4",
    "directoryScopeId": "/",
    "justification": "I need access to the Attribute Administrator role to manage attributes to be assigned to restricted AUs",
    "scheduleInfo": {
        "startDateTime": "2022-04-14T00:00:00.000Z",
        "expiration": {
            "type": "AfterDuration",
            "duration": "PT5H"
        }
    },
    "ticketInfo": {
        "ticketNumber": "CONTOSO:Normal-67890",
        "ticketSystem": "MS Project"
    }
}

HTTP response

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#roleManagement/directory/roleAssignmentScheduleRequests/$entity",
    "id": "911bab8a-6912-4de2-9dc0-2648ede7dd6d",
    "status": "Granted",
    "createdDateTime": "2022-04-13T08:52:32.6485851Z",
    "completedDateTime": "2022-04-14T00:00:00Z",
    "approvalId": null,
    "customData": null,
    "action": "selfActivate",
    "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
    "roleDefinitionId": "8424c6f0-a189-499e-bbd0-26c1753c96d4",
    "directoryScopeId": "/",
    "appScopeId": null,
    "isValidationOnly": false,
    "targetScheduleId": "911bab8a-6912-4de2-9dc0-2648ede7dd6d",
    "justification": "I need access to the Attribute Administrator role to manage attributes to be assigned to restricted AUs",
    "createdBy": {
        "application": null,
        "device": null,
        "user": {
            "displayName": null,
            "id": "071cc716-8147-4397-a5ba-b2105951cc0b"
        }
    },
    "scheduleInfo": {
        "startDateTime": "2022-04-14T00:00:00Z",
        "recurrence": null,
        "expiration": {
            "type": "afterDuration",
            "endDateTime": null,
            "duration": "PT5H"
        }
    },
    "ticketInfo": {
        "ticketNumber": "CONTOSO:Normal-67890",
        "ticketSystem": "MS Project"
    }
}

::: zone-end

::: zone pivot="azure-mobile-app"

Activate PIM roles using the Azure mobile app

Use the Azure mobile app on iOS or Android to activate eligible Microsoft Entra role assignments and view their status.

  1. Download the Azure mobile app for iOS or Android. You can also select Open in mobile from Privileged Identity Management > My roles > Microsoft Entra roles to download it.

    :::image type="content" source="./media/pim-how-to-activate-role/open-mobile.png" alt-text="Screenshot shows how to download the mobile app." lightbox="./media/pim-how-to-activate-role/open-mobile.png":::

  2. Open the Azure mobile app and sign in. Select the Privileged Identity Management card and select My Microsoft Entra roles to view your eligible and active role assignments.

    :::image type="content" source="./media/pim-how-to-activate-role/mobile-app-select-part-1.png" alt-text="Screenshots of the mobile app showing how a user would view available roles." lightbox="./media/pim-how-to-activate-role/mobile-app-select-part-1.png":::

  3. Select the role assignment, and then select Action > Activate in its details. Complete the activation requirements, enter any required details, and select Activate at the bottom.

    :::image type="content" source="./media/pim-how-to-activate-role/mobile-app-select-part-2.png" alt-text="Screenshot of the mobile app showing a user how to fill out the required information." lightbox="./media/pim-how-to-activate-role/mobile-app-select-part-2.png":::

  4. View the status of your activation requests and your role assignments under My Microsoft Entra roles.

    :::image type="content" source="./media/pim-how-to-activate-role/mobile-app-select-part-3.png" alt-text="Screenshot of the mobile app showing the user's role status." lightbox="./media/pim-how-to-activate-role/mobile-app-select-part-3.png":::

::: zone-end

Deactivate a role assignment

When a role assignment is activated, you see a Deactivate option in the portal for the role assignment. Also, you can't deactivate a role assignment within five minutes after activation.

To deactivate your active role assignment by using Microsoft Graph, create a role assignment schedule request with action set to selfDeactivate. For the request format and permissions, see Create roleAssignmentScheduleRequests.

Related content

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…