---
title: "Create a remote access link for a desktop computer"
method: POST
path: "/computer/{computerId}/session/create"
tags: ["Computer"]
---

# Create a remote access link for a desktop computer

`POST /computer/{computerId}/session/create`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/computer/{computerId}/session/create`
- Auth: HTTP bearer

Mints a short-lived, signed link that opens the computer's desktop in a browser over web VNC. The link is a credential; share it only with people who should see and control the computer.

## Path parameters

- `computerId` string, required: The ID of the desktop computer

## Request body

- object
  - `durationInSeconds` integer: How long the link stays valid, in seconds (60 to 3600, default 600)

## Response `200`

The link was created

- object
  - `url` string, required: The link to the computer's desktop
  - `expiresAt` string, date-time, required: When the link stops working

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)