---
search:
  tags:
    - edge
    - POST
seo:
  description: >-
    A link to the sandbox's desktop at https://<sandbox>-desktop.<sandbox…
    Reference for the POST /v1/sandboxes/{sandbox}/desktop endpoint in the
    pols.so API.
sidebar:
  label: Get a link to the sandbox's desktop in the browser
  badge: POST
title: Get a link to the sandbox's desktop in the browser
type: openapi-operation
---
A link to the sandbox's desktop at
`https://<sandbox>-desktop.<sandbox domain>/#<token>`. The page
shows the desktop as video over WebRTC where the host has it and
falls back to noVNC when WebRTC cannot connect (for example where
UDP is blocked); `?viewer=novnc` before the `#` opens it with
noVNC. The token is in the URL fragment, which browsers do not
send to servers: the edge's desktop page reads it and presents it
when it opens the desktop's connection, so it appears in no
request URL and sets no cookie. The link opens and reconnects the desktop until
`expires_at` (12 hours), while the sandbox keeps running and the
API key that made it is not revoked; stopping the sandbox ends it,
even after a resume. The sandbox must be running. Whoever has the
link can use the desktop's mouse and keyboard: treat it like a
password.

`POST /v1/sandboxes/{sandbox}/desktop`