# Create a noindex docs-preview share link
POST /api/runs/{runId}/docs-preview/share
Creates or reuses a Sourced-hosted public noindex share URL for a generated docs preview. Uploaded source inputs remain authenticated-only and are not exposed through public docs URLs.
## Request
```bash
curl -X POST 'https://sourced.sh/api/runs/{runId}/docs-preview/share' \
  -H 'Authorization: Bearer $SOURCED_API_KEY'
```
## Parameters

- runId (path, required): Run identifier.

## Responses

### 201

Docs-preview share link created or reused.
### 401


### 402


### 403


### 404


### 410

The docs-preview artifact expired.
### 422

The run is not ready to share as a docs preview.
