---
id: "en/api-post-nd-api-share-set-share-password"
title: "Set link sharing password"
language: "en"
description: "POST /nd/api/share/set_share_password: Set the link sharing password. Interface description, including path, method, parameters and return information."
canonical_url: "https://www.babel.cc/public/babelwiki/en/api-post-nd-api-share-set-share-password.html"
markdown_url: "https://www.babel.cc/public/babelwiki/ai/en/api-post-nd-api-share-set-share-password.md"
alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/api-post-nd-api-share-set-share-password.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/api-post-nd-api-share-set-share-password.md"}
reading_note: "文档记录不等于当前部署能力；以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明，勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts."
---

# Set link sharing password

| Properties | Values |
| --- | --- |
| HTTP method | `POST` |
| Interface path | `/nd/api/share/set_share_password` |
| Category | Share API |

## Interface description

Interface path: `/nd/api/share/set_share_password`

HTTP method: `POST`


**HTTP method:** `POST`

File link sharing is turned on, set a password for link sharing.
#### POST request body parameters

| Parameter | Type | Description (source requirements, defaults and scope) |
| --- | --- | --- |
| `file_id` | `string` | pre-shared file id (required) |
| `password` | `string` | password for link sharing |
| `is_https` | `number` | Whether the returned share_url protocol is https |

#### Return field description

```json
{"code":0,"success":true, "share_url": "https://share.example.com/share.do?s=<SHARE_ID>"}
```

## Call instructions

- Before calling, you need to complete [Get token](https://www.babel.cc/public/babelwiki/en/api-post-api-token-do.html) or the corresponding login-free authentication, and carry `Authorization: Bearer <access_token>` in the request header.
- If there are differences in parameters and return fields due to deployment versions, the actual private cloud API documents and joint debugging results should prevail.
- Category: Sharing API.