---
title: "Show public link"
method: GET
path: "/documents/{document}/public-link"
tags: ["Document Operations"]
---

# Show public link

`GET /documents/{document}/public-link`

<small>Requires an API token with the **Document Reader** role.</small>

Returns the [document's](/#documents) active [public link](/#shareable-links), if there is one. A document
has at most one active public link at a time.

Returns a `404` response when the document has no active public link, including when a previous link has
expired or was deleted.

## Path parameters

- `document` string, required

## Response `200`

`ShareableLinkResource`

- object
  - `data` ShareableLinkResource, required
    - `uuid` string, required
    - `url` string, required — The link URL. Treat it like a secret: anyone who has the URL can access the document with it
    - `expires_at` string, date-time, nullable, required — When the link stops working. `null` means the link never expires
    - `message` string, nullable, required — A personal message shown when the link is opened. Always `null` for public links
    - `created_at` string, date-time, nullable, required

## Other responses

- `401` — Unauthenticated
- `403` — Authorization error
- `404` — Not found

---

[API](https://skmtc.dev/fynk/apis/fynk-api-reference.md) · [All operations](https://skmtc.dev/fynk/apis/fynk-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fynk/fynk-api-reference/revisions/9657a6757f59/schema)