---
title: "Update Share Link"
method: POST
path: "/api/workspaces/{workspace_id}/share-link"
tags: ["workspaces"]
---

# Update Share Link

`POST /api/workspaces/{workspace_id}/share-link`

## Path parameters

- `workspace_id` string, required

## Request body

- ShareLinkRequest
  - `mode` 'restricted' | 'org' | 'public', required

## Response `200`

Successful Response

- ShareLinkResponse
  - `mode` 'restricted' | 'org' | 'public', required
  - `secret` string, nullable, required
  - `published` boolean
  - `enabled` boolean, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `d7f2f3b8e82d` — 1 info
  - added the optional property `published` to the response with the `200` status
- **2026-09-18** `abf76937a751` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-11** `b6d2db8786ed` — 4 info
  - api operation id `enable_share_link_api_workspaces__workspace_id__share_link_post` removed and replaced with `update_share_link_api_workspaces__workspace_id__share_link_post`
  - added optional request body
  - added the required property `mode` to the response with the `200` status
  - the response required property `enabled` became read-only for the status `200`
- **2026-09-10** `3a8d4a28ae93` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/changes/api/workspaces/:workspace_id/share-link/post.md)

---

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