Request (POST)

ℹ️

APIs: POST Requests

Parameters

  • AccessType (optional, default: View): The type of access requested (View, RDP, SSH).
  • SystemId: ID of the managed system to request.
  • AccountId: ID of the managed account to request.
  • DurationMinutes: The request duration (in minutes).
  • Reason (optional): The reason for the request.
  • AccessPolicyScheduleID (optional): The schedule ID of an access policy to use for the request. If omitted, automatically selects the best schedule.
  • ConflictOption (optional, default: renew): The conflict resolution option to use if an existing request is found for the same user, system, and account (reuse, renew). If omitted and a conflicting request is found, returns a 409 error.
    • Reuse: Return an existing, approved request ID for the same user/system/account/access type (if one exists). If the request does not already exist, create a new request using the request body details.
    • Renew: Cancel any existing approved requests for the same user/ system/account and create a new request using the request body details.

Example

psrun2 $(cat conn) Request 1 1 120 "Request reason"

©2003-2025 BeyondTrust Corporation. All Rights Reserved. Other trademarks identified on this page are owned by their respective owners. BeyondTrust is not a chartered bank or trust company, or depository institution. It is not authorized to accept deposits or trust accounts and is not licensed or regulated by any state or federal banking authority.