/api/connect/shortcut

Connect to a session started from a bookmark Id, or start a new session if there is none available

Method

POST

Parameters

  • id — Bookmark id of the shortcut
  • params (optional) — Object of key/value pairs to pass as user params to the session

Result

JSON Connect Object. See /api/connect for more details

Notes

The shortcut api assumes 0 or 1 sessions are running with the same bookmark id

If multiple sessions are found, the api will choose 1 session to connect to.  The methods for choosing the session is as follows

  • If sessions > 1  and if clients == 0,  choose the newest lastDisconnect 
  • If sessions > 1  and if clients == 0 and no session has a valid lastDisconnect choose the oldest started 
  • If sessions > 1  and If clients > 0, choose the oldest lastConnect