bot.desk.session

Generated at from openvibe-contracts v0.419.0 and openvibe-sdk v0.161.0.

Not grantable to apps (active, first-party).

OpenVibe.Run's sessions on machines (the Desks plan's D6): lease one desk for one session and act on it, with a Run service token naming the session's person in X-OV-Subject. POST /api/v1/machines/:id/desk-leases (bot.desk-lease-create-request@1, answered by bot.desk-lease@1) starts a browser desk on the person's own machine where they let agents use it, or on a desk host whose owner offers its desks to other people and whose Link sandboxes every desk; POST /api/v1/machines/:id/desk-leases/:desk/commands carries screen, input and browser (bot.command@1 without desk) to that desk alone; DELETE /api/v1/machines/:id/desk-leases/:desk stops it. Bot takes it only from Run, never reaches another desk or the machine itself, and on a shared host keeps even its owner off a leased desk.

Owner
bot (token audience openvibe.bot)
Version
1.0
Status
active
Visibility
first-party
Resource constraints
none
Quota class
bot-control
Permissions
bot:desk:session
Input
bot.desk-lease-create-request@1
Output
bot.desk-lease@1
Events
bot.command.refused
Implemented by
  • POST /api/v1/machines/:id/desk-leases
  • GET /api/v1/machines/:id/desk-leases/:desk
  • POST /api/v1/machines/:id/desk-leases/:desk/commands (bot.command@1, answered by bot.command-result@1)
  • DELETE /api/v1/machines/:id/desk-leases/:desk

These routes in the API explorer