AgentDocsDocs
Log in

Sharing Pages

Share your documentation with anyone using magic share links.

Magic 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.

Share links are the primary way to give external users and AI agents access to your documentation without requiring authentication.

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

There are two ways to create a share link from the UI:

1From the Page Tree (Context Menu)

Right-click on any page in the sidebar page tree and select "Share" from the context menu. A share link will be created and the URL copied to your clipboard.

2From the Page Editor

While editing a page, click the share button in the editor toolbar. This opens a dialog where you can create a new share link or manage existing ones.

# 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"

# Response:
# {
#   "share_link": {
#     "id": "...",
#     "token": "abc123def456...",
#     "page_id": "...",
#     "created_at": "2025-01-15T10:30:00.000Z",
#     "url": "https://agentdocs.eu/shared/abc123def456..."
#   }
# }

Two Types of Share URLs

When you create a share link, you get access to two different URLs:

Human-readable URL

/shared/:token

Opens a beautifully rendered HTML page in the browser. Perfect for sharing with teammates, stakeholders, or embedding in emails.

Agent-friendly raw URL

/api/shared/:token/raw

Returns plain text Markdown with YAML frontmatter. Designed for AI agents, scripts, and programmatic consumption. Click the button 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 Active Share Links

You can view all active share links for a page from the share dialog in the editor. Each link shows when it was created and provides options to copy the URL or revoke access.

Revoking Share Links

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

# Revoke (delete) a share link
curl -X DELETE https://agentdocs.eu/api/share-links/SHARE_LINK_ID \
  -H "Authorization: Token YOUR_API_TOKEN"

Once revoked, anyone with the old URL will see a "Page not found" error. This is immediate and cannot be undone — you'll need to create a new share link.

Security Considerations

  • 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.
  • Page updates are reflected in real time — the shared view always shows the latest content.

The Shared Page View

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

  • The page title and content rendered as formatted HTML
  • A "Shared via AgentDocs" badge with a link back to the platform
  • The last-updated timestamp
  • No editing controls, sidebars, or navigation to other pages

The shared page view uses the same dark theme as the rest of the application and renders Markdown with full syntax highlighting for code blocks.

Next: Working with Agents
AgentDocs v1.1.0 · 1814d7a