Get Take Control Connection: get_take_control_connection

Service name: get_take_control_connection

URL

https://SERVER/api/?apikey=yourAPItoken&service=get_take_control_connection

&required_parameters=required_parameters

[&optional_parameters=optional_parameters]

Description

Creates a Take Control Connection file for use in devices running Take Control (TeamViewer) only.

Parameters

Post Variable

Description

Type

Required

Options

Default

describe

Optional. Returns a description of the service.

boolean

no

true

0

deviceid

The deviceid of the target device for the Take Control session.

integer

yes

0

0

Example Service Call =get_take_control_connection

https://SERVER/api/?apikey=yourAPItoken&service=get_take_control_connection&deviceid=DEVICEID

Example Response

Success returns a file otherwise returns an error message

Fields Description

No xml returned on success, file returned on success

 

Example Associated Service Calls
Parameter Call URL Format
DeviceID list_devices_at_client

https://SERVER/api/?apikey=yourAPItoken&service=list_devices_at_client&clientid=CLIENTID&devicetype=server

list_servers

https://SERVER/api/?apikey=yourAPItoken&service=list_servers&siteid=SITEID

list_workstations

https://SERVER/api/?apikey=yourAPItoken&service=list_workstations&siteid=SITEID

SiteID list_sites https://SERVER/api/?apikey=yourAPItoken&service=list_sites&clientid=CLIENTID
ClientID list_clients https://SERVER/api/?apikey=yourAPItoken&service=list_clients

Initiate Take Control Connection from MAX Service Desk, Autotask and other helpdesk software

The get_take_control_connection API call can be used in MAX Service Desk, Autotask via LiveLinks and in other helpdesk software to initiate a connection to the target remote device without logging into the monitoring Dashboard; reducing the time taken to access the device and begin investigating issues. Please note that the TeamViewer Integration is only available for Windows devices.

User Audit Report

The get_take_control_connection API call automatically generates an entry in the User Audit Report against the Agent Key for the account.

Action

Date/Time

Details

Username

[Added]

25 Mar 2015 10:49:54

Take Control Session: Client: Demo Client, Site: Demo Site, Device: USDEMOSERVER

agent_key@login.it

Where do you want to go now?