---
title: "Create Share Link"
method: POST
path: "/api/computers/{computer_id}/share-links"
tags: ["computers-dashboard"]
---

# Create Share Link

`POST /api/computers/{computer_id}/share-links`

## Request

- Base URL: `https://api.maritime.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maritime.sh/api/computers/{computer_id}/share-links`
- Auth: HTTP bearer

## Path parameters

- `computer_id` string, required

## Request body

- ShareLinkCreateRequest
  - `mode` 'watch' | 'control'
  - `ttlS` integer, required

## Response `201`

Successful Response

- ShareLinkCreatedOut: A new share link. ``url`` carries the secret and is returned only once.
  - `id` string, required
  - `mode` 'watch' | 'control', required
  - `createdAt` string, date-time, required
  - `expiresAt` string, date-time, required
  - `url` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/maritime/apis/maritime-api.md) - [All operations](https://skmtc.dev/maritime/apis/maritime-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maritime/apis/maritime-api/revisions/acd712090ad6?raw)