API reference

The REST endpoints most integrations need, with examples. llms-full.txt lists every endpoint; Swagger UI covers most of them.

Base URL

All API endpoints are relative to the base URL:

https://agentdocs.eu

Request format

Send request bodies as JSON, up to 1 MB. Image uploads are the exception: they use multipart/form-data.

Content-Type: application/json

Send your credential in the Authorization header. See the API authentication guide for details.

Response format

Responses are JSON, except the shared-page /raw endpoint, which returns Markdown (text/markdown), and the PDF book export. Status codes:

Endpoints

In the Auth column, Token means an account API token or a space token. A space token works only inside its own space: the space, its pages, comments and share links. Every other route needs an account token or a browser session (JWT).

Example requests

Create a page

curl -X POST https://agentdocs.eu/api/spaces/SPACE_ID/pages \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Getting Started",
    "content": "# Getting Started\n\nWelcome to our docs!",
    "parent_page_id": null
  }'

# slug is optional: it is generated from the title.
# Response (201 Created), abridged:
{
  "page": {
    "id": "6f1c2a9e-4b7d-4e2a-9c51-0d3e8b7a2f14",
    "space_id": "b2d4e6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b",
    "parent_page_id": null,
    "title": "Getting Started",
    "slug": "getting-started",
    "content": "# Getting Started\n\nWelcome to our docs!",
    "author_id": "0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d",
    "version": 1,
    "last_edited_via": "api_token",
    "created_at": "2026-10-26T10:30:00.000Z",
    "updated_at": "2026-10-26T10:30:00.000Z"
  }
}

Update a page without overwriting newer edits

curl -X PUT https://agentdocs.eu/api/pages/PAGE_ID \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "# Getting Started\n\nUpdated text.", "version": 1}'

# Response (200 OK): {"page": {...}} with "version": 2

# If someone saved a newer version first (409 Conflict):
{
  "error": "Version conflict",
  "conflict": true,
  "message": "Version conflict. Page was modified since the version you edited.",
  "current_version": 2,
  "current_content": "# Getting Started\n\n…"
}

Create a share link

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 Created):
{
  "share_link": {
    "id": "c3e1f2a4-5b6d-4c7e-8f90-a1b2c3d4e5f6",
    "token": "a1b2c3d4e5f6…",
    "url": "/shared/a1b2c3d4e5f6…",
    "expires_at": "2026-11-25T10:35:00.000Z",
    "created_at": "2026-10-26T10:35:00.000Z"
  }
}

# The token is 64 hex characters. Use it to:
# open the page in a browser:  https://agentdocs.eu/shared/SHARE_TOKEN
# fetch it as Markdown:        https://agentdocs.eu/api/shared/SHARE_TOKEN/raw

Fetch a shared page as Markdown

curl https://agentdocs.eu/api/shared/SHARE_TOKEN/raw

# Response (200 OK, Content-Type: text/markdown; charset=utf-8):
---
title: Getting Started
shared_via: AgentDocs
last_updated: 2026-10-26T10:30:00.000Z
---

# Getting Started

Welcome to our docs!