Create Group Role Assignment
POST {{apiPath}}/environments/{{envID}}/groups/{{groupID}}/roleAssignments
The POST /environments/{{envID}}/groups/{{groupID}}/roleAssigments operation creates an admin role assigment for the designated user group.
The request must assign both the role and the scope for the role assignment operation to succeed.
Prerequisites
- See Create Group to create a user group.
- To get role IDs, see Read All Roles.
| Property | Type | Required? |
|---|---|---|
role.id | String | Required |
scope.id | String | Required |
scope.type | String | Required |
See the Group Role Assignments data model for full property descriptions.
Request Body
{"role"=>{"id"=>"{{roleID}}"}, "scope"=>{"id"=>"{{envID}}", "type"=>"environment"}}
RESPONSES
status: Created
{"_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/groups/dd146851-c2b3-4628-a77e-75f5a479a0ed/roleAssignments/71b8a194-15d5-4081-9633-e3696f0b1991"},"group":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/groups/dd146851-c2b3-4628-a77e-75f5a479a0ed"},"environment":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"}},"id":"71b8a194-15d5-4081-9633-e3696f0b1991","scope":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6","type":"ENVIRONMENT"},"role":{"id":"29ddce68-cd7f-4b2a-b6fc-f7a19553b496"},"environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"readOnly":false,"group":{"id":"dd146851-c2b3-4628-a77e-75f5a479a0ed"}}