-
Notifications
You must be signed in to change notification settings - Fork 44
Description
Hi,
We found that many of the operations that relates to roleManagement/directory/roleAssignmentApprovals/ are marked for deprecation, but we can't find any suitable replacement for approving or denying role assignments in Entra ID Privileged Identity Management.
More to that, we also can't find any related announcement in Microsoft Graph changelog.
The Entra ID documentation also doesn't state anything about the deprecation of those paths and still indicates to use them for our use case.
Am I reading the deprecation notice wrong in the SDK and in the OpenAPI.yaml for the beta API. Is there any planned replacement for the same operation?
Here is an exemple of operation that is marked for deprecation with a removal date of 2025-12-01'
Thank you or your input on this :)
/roleManagement/directory/roleAssignmentApprovals/{approval-id}/steps/{approvalStep-id}':
description: Provides operations to manage the steps property of the microsoft.graph.approval entity.
get:
tags:
- roleManagement.rbacApplication
summary: Get steps from roleManagement
description: Used to represent the decision associated with a single step in the approval process configured in approvalStage.
operationId: roleManagement.directory.roleAssignmentApprovals.GetSteps
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.approvalStep'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-12-01'
date: '2025-01-01'
version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
- roleManagement.rbacApplication
summary: Update the navigation property steps in roleManagement
operationId: roleManagement.directory.roleAssignmentApprovals.UpdateSteps
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.approvalStep'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.approvalStep'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-12-01'
date: '2025-01-01'
version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
- roleManagement.rbacApplication
summary: Delete navigation property steps for roleManagement
operationId: roleManagement.directory.roleAssignmentApprovals.DeleteSteps
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-12-01'
date: '2025-01-01'
version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
parameters:
- name: approval-id
in: path
description: The unique identifier of approval
required: true
schema:
type: string
x-ms-docs-key-type: approval
- name: approvalStep-id
in: path
description: The unique identifier of approvalStep
required: true
schema:
type: string
x-ms-docs-key-type: approvalStep
x-ms-docs-grouped-path:
- '/roleManagement/enterpriseApps/{rbacApplication-id}/roleAssignmentApprovals/{approval-id}/steps/{approvalStep-id}'
- '/roleManagement/entitlementManagement/roleAssignmentApprovals/{approval-id}/steps/{approvalStep-id}'