Share Links & Permissions

Share links let you give anyone access to a document without requiring a Notebind account. This is the primary mechanism for getting feedback from human reviewers.

Creating a share link

Via API

curl -X POST https://notebind.com/api/documents/DOC_ID/share \
  -H "Authorization: Bearer nb_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"permission": "comment"}'

Via CLI

notebind share DOC_ID --permission comment

Via web app

Open a document in the Notebind editor and click the Share button.

Permission levels

Each share link has one of three permission levels:

View

The recipient can read the document and see existing comments, but cannot interact.

Best for: stakeholders who need to see the document but not provide feedback.

Comment

The recipient can read the document, see existing comments, and leave new comments. They cannot modify the document content.

Best for: reviewers who should provide feedback without changing the text.

Edit

The recipient can read, comment, edit the document content, and create suggestions. They cannot change the title, delete the document, or manage share links.

Best for: collaborators who need to make direct changes.

Permission matrix

Action	View	Comment	Edit
Read document	Yes	Yes	Yes
List comments	Yes	Yes	Yes
List suggestions	Yes	Yes	Yes
Create comments	-	Yes	Yes
Resolve comments	-	Yes	Yes
Edit document content	-	-	Yes
Create suggestions	-	-	Yes
Change title	-	-	-
Delete document	-	-	-
Manage share links	-	-	-

Expiration

Share links can optionally expire:

curl -X POST https://notebind.com/api/documents/DOC_ID/share \
  -H "Authorization: Bearer nb_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "permission": "comment",
    "expires_at": "2026-04-01T00:00:00.000Z"
  }'

After expiration, the link returns a 404 page. Set expires_at to null (or omit it) for links that never expire.

Revoking a share link

To immediately revoke access:

curl -X DELETE "https://notebind.com/api/documents/DOC_ID/share?link_id=LINK_ID" \
  -H "Authorization: Bearer nb_sk_YOUR_KEY"

Revocation is immediate — anyone with the token loses access.

Anonymous contributions

Note

Comments and suggestions created via share links are anonymous (author_id: null). The contributor’s identity is not tracked.

This means:

• Anonymous comments show no author name in the UI
• Share users can delete their own anonymous comments but not comments by authenticated users
• There is no way to attribute anonymous feedback to a specific person

Multiple links per document

You can create multiple share links for the same document with different permissions:

• A view link for executives
• A comment link for reviewers
• An edit link for co-authors

Each link has its own token and can be revoked independently.

Share link URL format

https://notebind.com/share/{token}

The token is a 32-character hex string. The share page renders the document with controls matching the permission level (e.g., comment form for comment permission, editor toolbar for edit permission).