Role Based Access Control - Create Role Assignment
Create role assignment.
Creates a new role assignment. PRIVATE PREVIEW https://aka.ms/PowerPlatform/RBAC .
POST https://api.powerplatform.com/authorization/roleAssignments?api-version=2022-03-01-previewURI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
api-version
|
query | True |
string |
The API version. |
Request Body
| Name | Type | Description |
|---|---|---|
| principalId |
string |
The ID of the principal to assign |
| roleDefinitionId |
string |
The ID of the role definition |
| scope |
string |
The assignment scope |
Responses
| Name | Type | Description |
|---|---|---|
| 201 Created |
Role assignment created. |
|
| 400 Bad Request |
Bad Request - The body is invalid. |
|
| 401 Unauthorized |
Unauthorized - Invalid credentials or missing authentication. |
|
| 404 Not Found |
Not Found - The specified resource does not exist. |
|
| 500 Internal Server Error |
Internal Server Error - Unexpected server error. |
Security
oauth2
Microsoft Entra ID OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com
Scopes
| Name | Description |
|---|---|
| .default | .default |
Definitions
| Name | Description |
|---|---|
|
Role |
Request to assign a role to a principal. |
|
Role |
The role assignments. |
| Value |
RoleAssignmentRequest
Request to assign a role to a principal.
| Name | Type | Description |
|---|---|---|
| principalId |
string |
The ID of the principal to assign |
| roleDefinitionId |
string |
The ID of the role definition |
| scope |
string |
The assignment scope |
RoleAssignmentResponse
The role assignments.
| Name | Type | Description |
|---|---|---|
| value |
Value[] |
Value
| Name | Type | Description |
|---|---|---|
| id |
string |
Role definition ID |
| name |
string |
Role definition name |
| permissions |
string[] |