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

# bot.machine.watch\_link · OpenVibe.Services

HTML: [bot.machine.watch\_link · OpenVibe.Services](https://openvibe.services/docs/capabilities/bot.machine.watch_link)

# `bot.machine.watch_link`

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).

A watch link to a person's own machine desk (plan L55): the owner's agent (OpenVibe.Actor) asks Bot for a link that shows the desk it works on (the private desk or its own desk-<name>, never the owner's own screen), live, inside a chat turn. POST /api/v1/machines/:id/watch-links (bot.watch-link-request@1, answered by bot.watch-link-result@1) makes one for the machine the named person owns — never another person's (404) — and it lives for 5 to 240 minutes. The page needs no sign-in (the token is the credential), may sit in a frame on openvibe.chat or openvibe.actor, and carries the mouse and keyboard only when the caller asks for it. Only the owner's agent may make one: the capability alone would let any service that holds it name any person.

- Owner: bot (token audience `openvibe.bot`)
- Version: 1.0
- Status: active
- Visibility: first-party
- Resource constraints: owner
- Quota class: bot-machine
- Permissions: bot:machine:watch\_link
- Input: [bot.watch-link-request@1](/docs/contracts/bot.watch-link-request)
- Output: bot.watch-link-result@1
- Events: —
- Implemented by: - `POST /api/v1/machines/:id/watch-links`

[These routes in the API explorer](/docs/api/bot#cap-bot.machine.watch_link)