---
title: "Get Share Link"
method: GET
path: "/v1/external/notes/{noteGuid}/share-link"
tags: ["Note Share Link"]
---

# Get Share Link

`GET /v1/external/notes/{noteGuid}/share-link`

## Request

- Base URL: `https://api.tiro.ooo`
- URL: `https://api.tiro.ooo/v1/external/notes/{noteGuid}/share-link`
- Auth: HTTP bearer

Retrieve the current share link for a note.

- Returns 404 if no share link exists
- `sharePassword` is always `null` for security

## Path parameters

- `noteGuid` string, required

## Response `200`

Share link details

- ShareLinkResponse
  - `shareId` string, required: Unique share link identifier
  - `shareUrl` string, uri, required: Full URL for accessing the shared note
  - `sharePassword` string, nullable: Share link password. - Only returned on PUT with `usePassword: true` - Always `null` in GET responses
  - `hasPassword` boolean, required: Whether the share link has a password

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - insufficient permissions
- `404`: Not found. The note has no share link, the note does not exist, or the note is outside the read scope of the API key used. A system key reads only notes in a folder shared with all workspace members, and returns `404` (not `403`) for anything outside that scope so the response does not reveal whether the note exists.

---

[API](https://skmtc.dev/tiro/apis/tiro-api-2.md) · [All operations](https://skmtc.dev/tiro/apis/tiro-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tiro/apis/tiro-api-2/revisions/dc1a260c6771?raw)