---
title: "Update collection private link"
method: PUT
path: "/account/collections/{collection_id}/private_links/{link_id}"
tags: ["collections"]
---

# Update collection private link

`PUT /account/collections/{collection_id}/private_links/{link_id}`

## Request

- Base URL: `https://api.figshare.com/v2`
- URL: `https://api.figshare.com/v2/account/collections/{collection_id}/private_links/{link_id}`
- Auth: OAuth 2
  - Authorization code: `https://figshare.com/account/applications/authorize`
  - Token URL: `https://api.figshare.com/v2/token` scopes: `all`
- TypeScript: <https://skmtc.dev/figshare/apis/figshare-api/docs/account/collections/:collection_id/private_links/:link_id/put.ts> (a function with typed inputs; its response is checked against the schema)

Update existing private link for this collection

## Path parameters

- `collection_id` integer, required
- `link_id` string, required

## Request body

- CollectionPrivateLinkCreator
  - `expires_date` string: Date when this private link should expire - optional. By default private links expire in 365 days.

## Response `205`

Reset Content

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-03-27** `5806e3dd43b2`: 2 breaking, 2 info
  - added the new path request parameter `collection_id`
  - added the new path request parameter `link_id`
  - added optional request body
  - added the media type `application/json` for the response with the status `403`

[Operation history](https://skmtc.dev/figshare/apis/figshare-api/changes/account/collections/:collection_id/private_links/:link_id/put.md)

---

[API](https://skmtc.dev/figshare/apis/figshare-api.md) - [All operations](https://skmtc.dev/figshare/apis/figshare-api/llms.txt) - [OpenAPI document](https://skmtc.dev/figshare/apis/figshare-api/revisions/9dfb419f4430?raw)