API version reference and change log
Version reference
API Version | BeyondTrust Version |
---|---|
1.24.1 | 24.x |
1.23.1 | 23.x |
1.22.2 | 22.2.x, 22.3.x |
1.22.1 | 22.1.x |
1.21.1 | 21.3.x |
1.21.0 | 21.1.x, 21.2.x |
1.19.2 | 19.2.x, 20.1.x |
1.19.0 | 19.1.x |
1.18.0 | 18.2.x |
1.16.0 | 17.1.x |
1.15.1 | 16.2.x |
1.15.0 | 16.1.x |
1.13.1 | 15.2.x |
1.13.0 | 15.1.x |
1.12.0 | 14.2.x, 14.3.x |
1.11.0 | 14.1.x |
1.10.0 | 13.1.x |
1.9.0 | 12.3.x |
1.8.0 | 12.2.x |
1.7.1 | 12.1.4+ |
1.7.0 | 12.1.x |
1.6.0 | 11.1.x |
1.5.0 | 10.6.x |
1.4.2 | 10.5.2+ |
1.4.1 | 10.5.1 |
1.4.0 | 10.5.0 |
1.3.2 | 10.4.1+ |
1.3.0 | 10.4.0 |
1.2.2 | 10.3.4+ |
1.2.1 | 10.3.2, 10.3.3 |
1.2.0 | 10.3.0, 10.3.1 |
1.1.1 | 10.2.5+ |
1.1.0 | 10.2.(0-4) |
1.0.0 | 10.1.x |
API changelog
API version 1.24.1 for RS 24.3.x
- Reporting API
- Added JumpItem query.
- Command API
- Removed company_name from the get_api_info response.
- Added public_site=[string] as an optional parameter for create_virtual_customer.
API version 1.24.1 for RS 24.1.x
- Configuration API:
- Force the logging out of users - great if building API connectors leveraging anomaly detection.
- List user group policy membership, making it easier to control access programmatically.
API version 1.23.1 for RS 23.3.x
- Configuration API:
- Added "Windows Local" and "Domain" accounts and attributes to the Vault Account configuration API (GET).
- Added an endpoint filter to the Vault Account configuration API (GET).
API version 1.22.2 for RS 22.1.x
- Reporting API:
- Added Syslog query. This downloads a ZIP file containing all Syslog files available on the appliance. Syslog files include all changes made on the /login administrative interface within the last 30 days.
API version 1.22.2 for RS 22.3.x
- Configuration API:
- Added GET, PATCH, and DELETE APIs for the Protocol Tunnel Jump Item type.
- Added GET and PATCH APIs to allow administrators to update the available groups for existing SAML Security Provider resources.
API version 1.22.2 for RS 22.2.x
- Version update
- Configuration API:
- Enhanced Group Policy Configuration APIs (GET, POST, and PATCH) to allow administrators to read and set access permission settings.
API version 1.22.1 for RS 22.1.x
- Version update
- Expanded EndpointLicenseUsage to make it possible to download a ZIP file containing detailed information (English only) on BeyondTrust license usage.
API version 1.21.1 for RS 21.3.x
- Version update
- Expanded the current send_chat_message Command API operation to send a chat message to Team Chats.
- Added an API that copies the existing Jump Client resource with the given .
- Added command API: set_rep_status to set the status for representatives logged into the representative console.
API version 1.19.2 for RS 19.2.x and 20.1.x
- Added Configuration API
API version 1.19.0 for RS 19.1.x
- Version update
API version 1.18.0 for RS 18.2.x
- Added web_console as a client type.
API version 1.16.0 for RS 17.1.x
- Use OAuth 2.0 authentication for the real-time state API and endpoint credential manager connections.
- When importing a Jump Item several changes have been made:
- Specify a name for Jump Items.
- Import VNC Jump Items.
- Specify a local address for Protocol Tunnel Jump Items.
- For Web Jump Items, set if the certificate should be verified.
- API Command: import_jump_shortcut
API version 1.15.1 for RS 16.2.x
- Granularly define the accounts used for API access to the specific roles they serve. Additionally, OAuth 2.0 authentication is now used for authenticating API accounts.
- Reporting API
- Command API
- Backup API
- Specify the timezone offset of a generated session so that the customer client can be downloaded from the nearest traffic node of an Atlas cluster, resulting in faster session start times.
- Session Generation API
API version 1.15.0 for RS 16.1.x
- Import multiple shortcuts using the import_jump_shortcuts command.
- API Command: import_jump_shortcut
- Use the Presentation Archive API to view presentation event data.
- Download Reports with PresentationSession
- Download Reports with PresentationSessionListing
- PresentationRecording has been deprecated in favor of PresentationSessionRecording. PresentationRecording is still available for backward compatibility.
- Download Reports with PresentationSessionRecording PresentationRecording
- A JavaScript library with the ability to interact with the BeyondTrust real-time state API has been implemented.
- JavaScript Library for the Real-Time State API
API version 1.13.1 for RS 15.2.x
- Use the Archive API to view session event data.
- Download Reports with Archive
- View the Company API Name in the XML output of the get_api_info Command API operation.
- API Command: get_api_info
API version 1.13.0 for RS 15.1.x
- Use BeyondTrust Representative Console Scripts to start sessions through Jumpoints, start RDP sessions, or start Shell Jump sessions.
- API Script Command: push_and_start_remote
- API Script Command: start_rdp_session
- API Script Command: start_shell_jump_session
- Add custom session attributes to sessions started with a BeyondTrust Representative Console Script.
- API Script Command: generate_session_key
- API Script Command: push_and_start_local
- API Script Command: start_vpro_session
- View real-time data for support center activity in your organization.
- Real-Time State API
- View archives of the system state of your BeyondTrust Appliance B Series to analyze support center activity in your organization.
- Download Reports with ArchiveListing
- Download Reports with Archive
API version 1.12.0 for RS 14.2.x and 14.3.x
- The file extension .ns has been deprecated from the API calls. It is still available for backward compatibility.
- https://support.example.com/api/command.ns is now https://support.example.com/api/command
- https://support.example.com/api/client_script.ns is now https://support.example.com/api/client_script
- https://support.example.com/api/start_session.ns is now https://support.example.com/api/start_session
- https://support.example.com/api/reporting.ns is now https://support.example.com/api/reporting
- https://support.example.com/api/backup.ns is now https://support.example.com/api/backup
- Use two new API commands to help automate failover.
- API Command: check_health
- API Command: set_failover_role
- Set custom session attributes when starting or during a session. Customer details, skills, and custom fields can now be added to sessions regardless of session start type (session key, rep selection, issue submission). Additionally, certain fields have been deprecated in favor of a more consistent format. All fields are still available for backward compatibility. Deprecated fields are noted in their respective sections.
- API Command: generate_session_key
- API Command: set_session_attributes
- Session Generation API
- Start Sessions with Session Key Acceptance
- Start Sessions with Click-To-Chat or Collaborative Browser Sharing
- Start Sessions with External Keys (TicketID)
- Retrieve custom session attributes during a session.
- API Command: get_session_attributes
API version 1.11.0 for RS 14.1.x
Use three new commands to view information about your BeyondTrust Appliance B Series and connected software clients.
- API Command: get_appliances
- API Command: get_connected_client_list
- API Command: get_connected_clients
Download reports of license usage data.
- Download Reports with LicenseUsage
Command and reporting APIs return XML that declare a namespace.
- Reporting API: https://www.beyondtrust.com/namespaces/API/reporting
- Command API: https://www.beyondtrust.com/namespaces/API/command
Note
The above namespaces are returned XML data and are not functional URLs.
Specify the language to use for the customer client.
- Session Generation API
- Start Sessions with Click-To-Chat
Updated 10 days ago