---
title: Create link to share
description: POST /nd/api/share/open_link_share: Create link sharing interface description, including path, method, parameters and return information.
slug: api-post-nd-api-share-open-link-share
lang: en
category: Sharing API
category_order: 8
order: 129
api_method: POST
api_path: /nd/api/share/open_link_share
api_label: Create link to share
keywords:
  - API
  - Create link to share
  - /nd/api/share/open_link_share
---

# Create link to share

`POST /nd/api/share/open_link_share`

## POST body parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `file_id` | `string` | Required file/folder ID |
| `link_role_id` | `string` | Sharing role ID |
| `is_https` | `number` | Whether to return an HTTPS URL |
| `anonymousVisit` | `number` | 1 allows anonymous access, 0 disallows; source default 1 |

## Response

Fields listed in the source: `code`, `success`, `share_url`, `password`.

Opening sharing generates a new link and invalidates the previous one. Enterprise policies and file permissions still apply. Do not repeat this operation on a live share without confirmation.

## Calling the Endpoint

Use `Authorization: Bearer <access_token>`. GET parameters belong in the URL query; normal business POST requests use JSON. Check HTTP status and then the business result. Confirm array serialization and ambiguous types with the deployment instead of inventing fields.

[Authentication](developer-api-auth.md) · [API overview](developer-api-overview.md)