Open a takeover desktop

Opens the takeover holder’s live desktop. This is the computer stream (see computerStream for the fuse-vnc/1 handshake; the stream is raw RFB) with a recording on it. While the takeover is held this is the only desktop stream the environment serves: the plain computer stream and the agent’s computer actions answer 423. The Go SDK (Environments.TakeoverDesktop) and the CLI (fuse hitl takeover --via desktop) speak it.

It needs hitl:takeover, and the caller must be the takeover’s holder (the master token skips the holder check). Start the takeover first with POST /v1/environments/{vmId}?action=takeover and via desktop; a human claiming an agent’s pending request keeps the via the agent asked for.

Recorded. The session is kept as an input-action log read off the viewer’s half of the stream (each pointer button change with its coordinates, named keys and chords such as Return or ctrl+c, a count of printable keys typed but never the keys themselves, and the byte size of each clipboard paste but never its text) plus a screenshot at the start and every 10 seconds. When the stream closes the recording is sealed with TOKEN_ENCRYPTION_KEY (stored unencrypted, with a warning, when the orchestrator has none) and linked from a takeover_session audit row by recording_id. Screenshots stop at 32 MiB and the log at 50,000 entries, and the recording is marked truncated; the view keeps working.

curl -X GET "http://localhost:8080/v1/interventions/string/desktop" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("http://localhost:8080/v1/interventions/string/desktop", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "http://localhost:8080/v1/interventions/string/desktop",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

{
  "error": {
    "code": "not_found",
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "string",
    "details": {}
  }
}