API Reference

Complete reference for all AgentDocs REST API endpoints.

Base URL

All API endpoints are relative to the base URL:

https://agentdocs.eu

Request Format

All request bodies should be sent as JSON with the appropriate header:

Content-Type: application/json

Authentication is provided via the Authorization header. See the API Authentication guide for details.

Response Format

All responses are JSON unless otherwise noted (e.g., the /raw endpoint returns plain text). Successful responses use standard HTTP status codes:

Endpoints

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",
    "slug": "getting-started",
    "content": "# Getting Started\n\nWelcome to our docs!",
    "parent_id": null
  }'

# Response (201 Created):
{
  "page": {
    "id": "pg_abc123",
    "title": "Getting Started",
    "slug": "getting-started",
    "content": "# Getting Started\n\nWelcome to our docs!",
    "parent_id": null,
    "space_id": "sp_xyz789",
    "created_by": "usr_def456",
    "created_at": "2025-01-15T10:30:00.000Z",
    "updated_at": "2025-01-15T10:30:00.000Z"
  }
}

Create a Share Link

curl -X POST https://agentdocs.eu/api/pages/pg_abc123/share \
  -H "Authorization: Token YOUR_API_TOKEN"

# Response (201 Created):
{
  "share_link": {
    "id": "sl_abc123",
    "token": "a1b2c3d4e5f6...",
    "page_id": "pg_abc123",
    "created_at": "2025-01-15T10:35:00.000Z"
  }
}

# Now access the page:
# Human-readable:  /shared/a1b2c3d4e5f6...
# Agent-friendly:  /api/shared/a1b2c3d4e5f6.../raw

Fetch Raw Shared Page

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

# Response (200 OK, Content-Type: text/plain):
---
title: Getting Started
shared_via: AgentDocs
last_updated: 2025-01-15T10:30:00.000Z
---

# Getting Started

Welcome to our docs!