---
title: "Create Share Link"
method: POST
path: "/api/projects/{project_id}/share-link"
---

# Create Share Link

`POST /api/projects/{project_id}/share-link`

## Request

- Base URL: `https://api.yourbeckett.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.yourbeckett.com/api/projects/{project_id}/share-link`
- Auth: none declared

Generate public share link (owner only).

Accepts optional ttl_days (1..365). Default None → link never expires,
matching prior behavior. Out-of-range values rejected by Pydantic (422).

## Path parameters

- `project_id` string, uuid, required

## Request body

- CreateShareLinkRequest: Optional body for POST /api/projects/{project_id}/share-link. ttl_days: if set, the new link expires at NOW() + ttl_days. Default None = never expires. Bounds 1..365 prevent nonsensical or indefinite-but-slightly-less-than-permanent values.
  - `ttl_days` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/yourbeckett/apis/beckett-platform.md) · [All operations](https://skmtc.dev/yourbeckett/apis/beckett-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/yourbeckett/apis/beckett-platform/revisions/a1cb8f2c8961?raw)