Request Password Approval by the Admin

POST

This API raises a request for password access in PAM360, which should be approved by an admin. The response confirms that the request has been successfully submitted and shows its current status.

Request URL

https://<Hostname-or-IP-address-of-PAM360-server>:<Port>/restapi/json/v1/accounts/<ACCOUNTID>/requestpassword

ParameterDescriptionValues

ACCOUNTID

The ID of the account for which the password needs to be fetched.
Type : Long
Mandatory : Yes

Default Value : N/A

Header Parameters

{
"AUTHTOKEN" : "<<Authtoken-generated-from-PAM360>>",
"orgName"   : "<<org display name>>"
}

ParameterDescriptionValues

AUTHTOKEN

Authentication token for the user to authorize the API request.
Type : String
Mandatory : Yes

Default Value : N/A

orgName

Organization name available in PAM360.
Type : String
Mandatory : No

Default Value : The organization to which the user belongs.

Body Parameters

INPUT_DATA={
  "operation":{
    "Details":{
      "REASON": "Testing",
      "ACCESS": "later",
      "STARTTIME": "09/01/2026 17:50",
      "ENDTIME": "12/01/2026 17:50",
      "REMAINDERTIME": 45,
      "RESOURCES_TO_BE_ACCESSED_OPTION": "3",
      "SELECTED_RESOURCEIDS": ["301","601"]
    }
  }
}

ParametersDescriptionValues

REASON

Reason for requesting access to the selected resources.
Type : String
Mandatory : No

Default Value : N/A

ACCESS

Type or timing of access.
Type : String
Mandatory : No

Default Value : now
Allowed Values : now, later

STARTTIME

Start date and time for the access window.
Type : Integer
Mandatory : No

Default Value : N/A
Allowed Values : (DD/mm/yyyy HH:mm)

ENDTIME

End date and time for the access window.
Type : Integer
Mandatory : No

Default Value : N/A
Allowed Values : (DD/mm/yyyy HH:mm)

REMAINDERTIME

Time in minutes to remind the user or admins about the pending access request.
Type : Integer
Mandatory : No

Default Value : N/A
Allowed Values : A non-zero numeric value less than 60.

RESOURCES_TO_BE_
ACCESSED_OPTION

Specifies which Windows domain resources the user can access: the current resource, all shared resources, or selected shared resources.
Type : String
Mandatory : No
Supported Version : 8400

Default Value : N/A
Allowed Values : 1, 2, 3

SELECTED_RESOURCEIDS

List of specific resource IDs selected for access when RESOURCES_TO_BE_ACCESSED_OPTION is "3".
Type : String array
Mandatory : No
Supported Version : 8400

Default Value : N/A

Sample Request

cURLPythonPowerShell
curl -X POST "https://<Hostname-or-IP-address-of-PAM360-server>:<Port>/restapi/json/v1/accounts/901/requestpassword" -H "AUTHTOKEN:<<Authtoken-generated-from-PAM360>>" -H "Content-Type:application/json" -d "INPUT_DATA={\"operation\":{\"Details\":{\"REASON\":\"Testing\",\"ACCESS\":\"later\",\"STARTTIME\":\"09/01/2026 17:50\",\"ENDTIME\":\"12/01/2026 17:50\",\"REMINDERTIME\":45,\"RESOURCES_TO_BE_ACCESSED_OPTION\":\"3\",\"SELECTED_RESOURCEIDS\":[\"301\",\"601\"]}}}"
import requests
import json

url = "https://<Hostname-or-IP-address-of-PAM360-server>:<Port>/restapi/json/v1/accounts/901/requestpassword"

headers = {
    "AUTHTOKEN": "<<Authtoken-generated-from-PAM360>>",
    "Content-Type": "application/x-www-form-urlencoded"
}

payload = {
    "operation": {
        "Details": {
            "REASON": "Testing",
            "ACCESS": "later",
            "STARTTIME": "09/01/2026 17:50",
            "ENDTIME": "12/01/2026 17:50",
            "REMINDERTIME": 45,
            "RESOURCES_TO_BE_ACCESSED_OPTION": "3",
            "SELECTED_RESOURCEIDS": ["301", "601"]
        }
    }
}

# BODY DATA
data = {
    "INPUT_DATA": json.dumps(payload)
}

response = requests.post(
    url,
    headers=headers,
    data=data,
    verify=True
)

print("Status Code:", response.status_code)
print("Response:", response.text)
$url = "https://<Hostname-or-IP-address-of-PAM360-server>:<Port>/restapi/json/v1/accounts/901/requestpassword"
$headers = @{
    "AUTHTOKEN"    = "<<Authtoken-generated-from-PAM360>>"
    "Content-Type" = "application/x-www-form-urlencoded"
}

$body = @"
INPUT_DATA={
  "operation": {
    "Details": {
      "REASON":"Testing",
      "ACCESS":"later",
      "STARTTIME":"09/01/2026 17:50",
      "ENDTIME":"12/01/2026 17:50",
      "REMINDERTIME":45,
      "RESOURCES_TO_BE_ACCESSED_OPTION":"3",
      "SELECTED_RESOURCEIDS":["301","601"]
    }
  }
}
"@

$response = Invoke-RestMethod -Uri $url -Method 'POST' -Headers $headers -Body $body
$response | ConvertTo-Json

Sample Response

{
    "operation": {
        "result": {
            "message": "Password request raised successfully",
            "status": "Success",
            "statusCode": 20000
        },
        "Details": {
            "STATUS": "[Waiting for Approval]"
        },
        "name": "REQUEST PASSWORD"
    }
}



Top