Approve or reject a pending PAM request
Used by a privileged account to approve, close, or reject a request to elevate to a PAM role.
Note
The URLs in this article are relative to the hostname that's chosen during API deployment, such as https://api.contoso.com.
Request
| Method | Request URL |
|---|---|
| POST | /api/pamresources/pamrequeststoapprove({approvalId)/Approve /api/pamresources/pamrequeststoapprove({approvalId)/Reject |
URL parameters
| Parameter | Description |
|---|---|
| approvalId | The identifier (GUID) of the approval object in PAM, specified as guid'xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. |
Query parameters
| Parameter | Description |
|---|---|
| v | Optional. The API version. If not included, the current (most recently released) version of the API is used. For more information, see Versioning in PAM REST API service details. |
Request Headers
For common request headers, see HTTP request and response headers in PAM REST API service details.
Request body
None.
Response
This section describes the response.
Response codes
| Code | Description |
|---|---|
| 200 | OK |
| 401 | Unauthorized |
| 403 | Forbidden |
| 408 | Request Timeout |
| 500 | Internal Server Error |
| 503 | Service Unavailable |
Response headers
For common request headers, see HTTP request and response headers in PAM REST API service details.
Response body
None.
Example
This section provides an example to approve a request to elevate to a PAM role.
Example: Request
POST /api/pamresources/pamrequeststoapprove(guid'5dbd9d0c-0a9d-4f75-8cbd-ff6ffdc00143')/Approve HTTP/1.1
Example: Response
HTTP/1.1 200 OK