---
title: "Enable public sharing (mint a read-only share token)"
method: POST
path: "/projects/{id}/share"
---

# Enable public sharing (mint a read-only share token)

`POST /projects/{id}/share`

## Request

- Base URL: `https://craaft.io/api/v1`
- URL: `https://craaft.io/api/v1/projects/{id}/share`
- Auth: HTTP bearer

Generates a fresh public token; revoking and re-enabling mints a new
one. The read-only board is then reachable at `/share/{publicToken}`.

## Response `200`

Sharing enabled

- object
  - `publicToken` string, required

## Other responses

- `404`: Resource doesn't exist or caller isn't a member of its workspace

---

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