---
title: "Update personal link"
method: PATCH
path: "/documents/{document}/users/{documentUser}/personal-link"
tags: ["Document Operations"]
---

# Update personal link

`PATCH /documents/{document}/users/{documentUser}/personal-link`

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

Updates the [document user's](/#document-users) active [personal link](/#shareable-links). The link URL
never changes; to get a fresh URL, delete the link and create a new one.

Returns a `404` response when the user has no active personal link.

## Path parameters

- `document` string, required
- `documentUser` string, required

## Request body

- UpdatePersonalLinkRequest
  - `expires_at` string, date-time, nullable — When the link stops working. Pass `null` for a link that never expires
  - `message` string, nullable — A personal message shown to the user when they open the link. Pass `null` to remove the message

## 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
- `422` — Validation error

---

[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)