---
title: "bot.desk.session · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/bot.desk.session"
updated: null
---

# bot.desk.session · OpenVibe.Services

HTML: [bot.desk.session · OpenVibe.Services](https://openvibe.services/docs/capabilities/bot.desk.session)

# `bot.desk.session`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/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](/docs/contracts/bot.desk-lease-create-request)
- 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](/docs/api/bot#cap-bot.desk.session)