Update Grant

PUT {{apiPath}}/environments/{{envID}}/applications/{{appID}}/grants/{{grantID}}

To update a property value associated with a selected application resource grant, use the PUT /environments/{{envID}}/applications/{{appID}}/grants/{{grantID}} operation to modify the attribute values for the specified grant resource. For example, you can change the scopes attribute value to add another OIDC scope ID.

The resource.id property must be include in the request body, and must be the same resource.id as that associated with the specified grant.

Prerequisites

See the Application Resource Grants for complete descriptions.

PropertyTypeRequired?
resource.idStringN/A
scopes.idString[]Required

Request Body

{"resource"=>{"id"=>"{{resourceID}}"}, "scopes"=>[{"id"=>"{{scopeID}}"}, {"id"=>"{{scopeID_2}}"}]}

RESPONSES

status: OK

{"_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/applications/cad1c86d-a6c8-4e61-b15f-8ff452698fa8/grants/90c0b478-27fb-4dea-abfb-88ff342bf973"},"environment":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"application":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/applications/cad1c86d-a6c8-4e61-b15f-8ff452698fa8"},"resource":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/resources/e303cdcd-2fce-4181-90a9-ff945280ae4a"}},"id":"90c0b478-27fb-4dea-abfb-88ff342bf973","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"resource":{"id":"e303cdcd-2fce-4181-90a9-ff945280ae4a"},"application":{"id":"cad1c86d-a6c8-4e61-b15f-8ff452698fa8"},"scopes":[{"id":"c61ff2ab-a737-4414-980b-623ffb940615"},{"id":"b59704a4-09d8-472c-ac67-2dd8174d772f"}],"createdAt":"2019-08-13T19:39:58.450Z","updatedAt":"2021-09-24T15:43:19.846Z"}