Approve or decline multiple JIT elevate requests in bulk

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Approve or decline multiple JIT elevate requests in bulk.

Request URL

https://{server-hostname}:8383/dcapi/appctrl/jitpolicy/status/{actionType}

Scope

AppControl.UPDATECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Path Parameters

actionTypestringMandatory

Type denoted 5 - Decline, 6 - Approve the JIT Elevation request.

- Request Body

application/json
JSON object
Hide Sub-Attributes
selectedIdsJSON objectMandatory

Object containing the list of policy IDs to approve or decline

Show Sub-Attributes
idsarrayMandatory

Array of policy IDs to be bulk approved or declined

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request PUT \
  --url https://appdomain/dcapi/appctrl/jitpolicy/status/{actionType} \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: application/json' \
  --data '{"selectedIds":{"ids":[902]}}'
Show full

Sample Request Body

Bulk approve/decline JIT elevate requests

Copied!
  {
    "selectedIds": {
      "ids": [
        902
      ]
    }
  }
                
Show full

Response Parameters

- HTTP code 200

Response Body - application/json
JSON object
Hide Sub-Attributes
messagestring

Human-readable status message describing the result of the bulk operation

statusboolean

Whether the bulk approve/decline operation succeeded (true) or failed (false)

- HTTP code 400

Response Body - application/json
JSON object
Hide Sub-Attributes
errorCodestring

Error code: INVALID_REQUEST for validation failures

errorMessagestring

Detailed validation error message

- HTTP code 401

Response Body - application/json
JSON object
Hide Sub-Attributes
errorCodestring

Error code: INVALID_REQUEST for validation failures

errorMessagestring

Detailed validation error message

- HTTP code 500

Response Body - application/json
JSON object
Hide Sub-Attributes
errorCodestring

Internal error code: INTERNAL_ERROR when exception occurs while approve/decline jit policies

errorMessagestring

Detailed message: Exception Occurred While approve/decline jit policies

Possible Response Codes

200HTTP code
400HTTP code
401HTTP code
500HTTP code

Sample Response: HTTP 200

JIT elevate requests approved successfully

Copied!
  {
    "message": "Bulk approve successfully for 1 policies",
    "status": true
  }
                
Show full

JIT elevate requests approved successfully

Copied!
  {
    "message": "Bulk decline successfully for 1 policies",
    "status": true
  }
                
Show full

JIT elevate requests partially approved/decline

Copied!
  {
    "message": "Bulk approve was successfully for 1 policies. The following policies could not be processed because the agent was unavailable: JIT For Oracle VirtualBox, JIT For VLC media player",
    "status": false
  }
                
Show full

Sample Response: HTTP 400

Authentication credentials missing or invalid

Copied!
  {
    "errorMessage": "Authentication credentials are missing or invalid",
    "errorCode": "UNAUTHORIZED"
  }
                
Show full

Sample Response: HTTP 401

Invalid request parameters

Copied!
  {
    "errorMessage": "Unable to access the requested policy IDs : [1000000]",
    "errorCode": "1001"
  }
                
Show full

Sample Response: HTTP 500

Internal error while approve/decline jit request

Copied!
  {
    "errorMessage": "Exception Occurred While approve/decline jit policies",
    "errorCode": "INTERNAL_ERROR"
  }
                
Show full

Duration: 1 minute | Threshold: 50 | Lock period: 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.