AgentDocsDocs
Log in

Sharing pages

Give anyone read access to a page with a link. No account needed.

Share links

Share links let you share any page with anyone — no login required. Each share link contains a unique, cryptographically random token that grants read-only access to a specific page.

Anyone who has a share link can read the page, signed in or not, until the link expires or you revoke it. Use share links for pages that may be public. To give an agent private access to a space, use a space token or the MCP server instead (see Working with agents).

A share link URL looks like:

https://agentdocs.eu/shared/abc123def456...

The token at the end is a secure, randomly generated string. Anyone with this URL can view the page contents — but they cannot edit, delete, or access any other pages.

Creating share links

To create a share link in the web app:

From the page tree

Open the space, hover over the page in the page tree, click ⋯ and choose "Share" from the menu. In the dialog, choose an expiry (7, 30, 90 or 365 days, or Never; 30 days is preselected) and click Create share link. The link is created and its URL is copied to your clipboard.

You need edit access to the space to create or revoke share links. Viewers can see that a page has share links, but not the links themselves.

Agents and scripts can create a link with the API or the share_page MCP tool. Set expires_in_days (or an ISO 8601 expires_at) to make it expire; without either, the link never expires.

# Create a share link via API
curl -X POST https://agentdocs.eu/api/pages/PAGE_ID/share \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"expires_in_days": 30}'

# Response (201):
# {
#   "share_link": {
#     "id": "...",
#     "token": "abc123def456...",
#     "url": "/shared/abc123def456...",
#     "expires_at": "2026-11-25T10:30:00.000Z",
#     "created_at": "2026-10-26T10:30:00.000Z"
#   }
# }

Two URLs for each link

Each share link has two URLs:

Human-readable URL

/shared/:token

Opens the rendered page in a browser. Send this URL to people. The page is drawn with JavaScript, so tools that fetch the URL without running scripts get no page text; give them the raw URL below.

Agent-friendly raw URL

/api/shared/:token/raw

Returns the page as Markdown with YAML frontmatter, for agents and scripts. In the share dialog, click the button ("Raw Markdown") to copy this URL.

🤖 For AI agents: Always use the/api/shared/:token/rawendpoint. It returns clean Markdown that agents can parse directly, without any HTML, JavaScript, or styling. Read more in the Working with agents guide.

Managing share links

Viewing a page's share links

To see a page's share links, open its share dialog (page tree → ⋯ → Share). Each link shows when it was created and, if set, when it expires. The buttons next to a link copy the page URL, copy the raw Markdown URL (🤖), or revoke the link. Expired links stay in the list until you revoke them.

Revoking a share link

To revoke a share link, click the "Revoke" button (trash icon) next to the link in the share dialog, or use the API:

# Find the link's id
curl https://agentdocs.eu/api/pages/PAGE_ID/shares \
  -H "Authorization: Token YOUR_API_TOKEN"

# Revoke (delete) it
curl -X DELETE https://agentdocs.eu/api/pages/PAGE_ID/shares/SHARE_LINK_ID \
  -H "Authorization: Token YOUR_API_TOKEN"

Revoking deletes the link straight away. Anyone who opens the old URL sees "Page not found", and the raw URL returns 404. The same happens when a link expires. A revoked link cannot be restored; create a new one instead.

Security

  • Share links grant read-only access — recipients cannot edit the page.
  • Links are tied to a specific page. Recipients cannot navigate to other pages in the space or workspace.
  • The share token is a long, random string that is practically impossible to guess.
  • Revoking a link immediately cuts off access. No caching or grace period.
  • A share link always shows the current version of the page. Readers see new edits when they reload.
  • Links stop working while their page is in the trash, and work again if it is restored. Deleting a page permanently also deletes its links.

What readers see

When someone opens a share link, they see a read-only version of the page:

  • The page title and content rendered as formatted HTML
  • A "Shared via AgentDocs" label
  • The date the page was last updated
  • No editing controls, sidebars, or navigation to other pages

Shared pages use the dark theme unless the reader has picked another AgentDocs theme in that browser. Code blocks are shown in a monospace font without syntax colouring. On wide screens, a table of contents appears beside the page.

Next: Working with agents
AgentDocs v1.1.0 · b55b6f7