Takeover action from Service Desk

Release Time
06/07/2018
Views
7623 times
Category
ITSM
Tags

An interface with which to generate the takeover link. 

Scheme

https

Host

Valid ITSM host (example: subdomain-msp.cmdm.comodo.com )

Path 
/api/rest/v1/web-rtc/remote-control  – the actual path

/api/rest/v1/web-rtc/ccv  – deprecated
 

Method POST
Content-Type JSON (application/json)

 

Request Headers

Key Value Description
x-auth-type 2 Authentication type identifier
x-auth-token sso-token Authentication SSO token

Request Parameters

Name Type Required Description Limitation

mdmTokens

 JSON Array required Array of devices mdm-tokens count - min 1, max 10

mdmTokens[]

 String required Device mdm-token  

Response Parameters

Name Type Required Description Limitation
status Integer required Device status

Possible values are:

  • 1 - device is online and not deleted
  • 2 - device is offline
  • 3 - device is deleted
  • 4 - Device is not support Takeover
  • 5 - Token out of scope
  • 6 - Forbidden by Access Scope
  • 7 - CRC disabled on portal
message String optional CRC or CCV link for Windows XP/Server 2003 Meet when status = 1

See the below link for details:

Execution

Sample execution can be handled via Postman Application. 

Header part can be handled via Postman Application

Success Output

Error Output