Close Access Request
POST {{baseUrl}}/access-requests/close
This endpoint closes access requests that are stuck in a pending state. It can be used throughout a request's lifecycle even after the approval state, unlike the Cancel Access Request endpoint. A token with ORG_ADMIN authority is required.
To find pending access requests with the UI, navigate to Search and use this query: status: Pending AND Access Request
. Use the Column Chooser to select 'Tracking Number', and use the 'Download' button to export a CSV containing the tracking numbers.
To find pending access requests with the API, use the List Account Activities endpoint.
Input the IDs from either source.
To track the status of endpoint requests, navigate to Search and use this query: name:Close Identity Requests
. Search will include Close Identity Requests Started
audits when requests are initiated and Close Identity Requests Completed
audits when requests are completed. The completion audit will list the identity request IDs that finished in error.
This API triggers the Provisioning Completed event trigger for each access request that is closed.
Request Body
{"accessRequestIds"=>["2c90ad2a70ace7d50170acf22ca90010"], "executionStatus"=>"Terminated", "completionStatus"=>"Failure", "message"=>"The IdentityNow Administrator manually closed this request."}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
X-SailPoint-Experimental | boolean | (Required) Use this header to enable this experimental API. | |
Content-Type | string | ||
Accept | string |