---
title: "Toggle Share"
method: POST
path: "/api/watchlist/share"
tags: ["watchlist"]
---

# Toggle Share

`POST /api/watchlist/share`

## Request

- Base URL: `https://api.equity-rank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.equity-rank.com/api/watchlist/share`
- Auth: HTTP bearer

SHARE-01 + SHARE-05: toggle the user's `public.watchlists` row to shared/unshared.
On enabling, generates a 12-char URL-safe slug if one does not yet exist.
On disabling, sets is_shared=false (slug remains in DB to preserve uniqueness).
Targets `public.watchlists` (plural) — the user-keyed table extended by 16-01.

## Request body

- ShareToggleRequest
  - `is_shared` boolean, required
  - `name` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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