Update Entitlement Privileges

A user???s entitlements are updated via a request. The URI /requests POST allows for the addition of an entitlement. The URI /requests DELETE withdraws an entitlement request that has not been approved yet. The actual update occurs when the request is approved.

cURL Example for Requesting an Entitlement

curl  -H "Content-Type: application/json"  -H "X-Requested-By: <anyvalue>"  -X POST  -u username:password  -d @post.json https://pseudo.com/iam/governance/selfservice/api/v1/requests

POST Request Body

{
  "requests" :[
		{
			"reqJustification" : "Request entitlement for sub-ordinates",
			"reqBeneficiaryList":
			[
				{
					"id": "1001"
				}
			],
			"reqTargetEntities":
			[
				{
					"entityId": "42",
					"entityType": "entitlement",
					"startDate" : "2019-07-01T18:30:00Z",
					"endDate" : "2019-10-25T18:30:00Z"
				}
			]
		}
	]
}

POST Response Body

{
    "links": [
        {
            "rel": "self",
            "href": "https://pseudo.com/iam/governance/adminservice/api/v1/requests"
        }
    ],
    "requests": [
        {
            "links": [
                {
                    "rel": "self",
                    "href": "https://pseudo.com/iam/governance/adminservice/api/v1/requests/2004"
                }
            ],
            "id": "2004",
            "reqStatus": "Request Created",
            "status": "SUCCESS"
        }
    ]
}

cURL Example for Withdrawing Entitlement Request

curl  -H "Content-Type: application/json"  -H "X-Requested-By: <anyvalue>"  -X  DELETE  -u  username:password  -d  @post.json https://pseudo.com/iam/governance/selfservice/api/v1/requests/2004

Delete Response Body

{
    "links": [
        {
            "rel": "self",
            "href": "https://pseudo.com/iam/governance/selfservice/api/v1/requests/2004"
        }
    ],
    "id": "2004",
    "status": "withdrawn"
}