Create Access Request

Create an access request for one or more identities.

Required User Roles:

• ORG_ADMIN
• USER

Required permissions:

• idn:access-request:manage
• idn:access-request-self:manage

For more information about the user roles refer to the User Level Permissions.

External Documentation

To learn more, visit the SailPoint documentation.

​

Basic Parameters

Parameter	Description
Comment	The comment for the requested item. Note: Comment is required when the request is of type Revoke Access.
Remove Date	Select an expiration date and time when access will be automatically removed. Note: * The system may take up to 24 hours to complete the removal after the date is reached. * You can extend access or remove an existing expiration date using a GRANT_ACCESS request type. * You can shorten access or add an expiration date using either GRANT_ACCESS or REVOKE_ACCESS requests.
Request Type	Select the access request type.
Requested For	A comma-separated list of identity IDs to request access for. Note: if the request type is REVOKE_ACCESS, only one identity ID is allowed.
Requested Item ID	The ID of the Role, Access Profile or Entitlement included in the request.
Requested Item Type	Select the type of the item being requested.

​

Advanced Parameters

Parameter	Description
Client Metadata	The key-value metadata to attach to the access request. A free-form field for adding custom information to the request, which the system stores for you but does not process. For example: { “requestedAppId”:“2c91808f78”, “requestedAppName”:“test-app” }

​

Example Output

{
	"newRequests": [
		{
			"requestedFor": "899fd612ecfc4cf3bf48f14d0afdef89",
			"requestedItemsDetails": [
				{
					"type": "ENTITLEMENT",
					"id": "779c6fd7171540bba1184e5946112c28"
				}
			],
			"attributesHash": -1928438224,
			"accessRequestIds": [
				"5d3118c518a44ec7805450d53479ccdb"
			]
		}
	],
	"existingRequests": [
		{
			"requestedFor": "899fd612ecfc4cf3bf48f14d0afdef89",
			"requestedItemsDetails": [
				{
					"type": "ROLE",
					"id": "779c6fd7171540bbc1184e5946112c28"
				}
			],
			"attributesHash": 2843118224,
			"accessRequestIds": [
				"5d3118c518a44ec7805450d53479ccdc"
			]
		}
	]
}