Test access to managed account

post

https://example.com/beyondtrust/api/public/v3/accesspolicies/test

Tests access to a managed account and returns a list of Password Safe access policies that are available in the request window.

Required Permission(s)

Requestor role for the managed account being tested

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The request model definition being tested

DurationMinutes

int32

(minutes: 1-525600) The request duration

AccessPolicyScheduleID

int32 | null

ID of the Access policy schedule. Auto-selects best schedule if omitted

ConflictOption

string | null

Conflict handling when an active request already exists for the same user, system, and account. Use 'reuse' to return the existing request; use 'renew' to create a new request

TicketSystemID

int32 | null

ID of the ticket system. Uses default if omitted

TicketNumber

string | null

Associated ticket number. Can be required if ticket system is marked as required in the access policy used

RotateOnCheckin

boolean

Defaults to true

Rotate credentials on check-in/expiry if supported by policy

AccessType

string | null

Type of access requested(View | RDP | SSH | App)

SystemID

int32

ID of the managed system to request

AccountID

int32

ID of the managed account to request

ApplicationID

int32 | null

ID of the application for application-based requests

Reason

string | null

Reason for the request

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

200Request successful. Access policies in response body.