---
title: "Create a session share (link or targeted user)"
method: POST
path: "/session-sharing/create"
tags: ["Session Sharing"]
---

# Create a session share (link or targeted user)

`POST /session-sharing/create`

Mints a share grant for a live terminal/RDP/VNC/Telnet session. Caller must own the live session.

## Request body

- object
  - `hostId` integer, required
  - `sessionId` string, required
  - `tabInstanceId` string
  - `protocol` 'ssh' | 'rdp' | 'vnc' | 'telnet', required
  - `shareType` 'link' | 'user', required
  - `targetUserId` string
  - `permissionLevel` 'read-only' | 'read-write', required
  - `expiryHours` number

## Response `200`

Share created

## Other responses

- `400` — Invalid request
- `403` — Sharing disabled, or caller does not own the session
- `500` — Server error

---

[API](https://skmtc.dev/termix/apis/termix-api.md) · [All operations](https://skmtc.dev/termix/apis/termix-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/termix/termix-api/revisions/f4ef343eff1b/schema)