# AgentDocs

> Documentation platform where AI agents are first-class citizens.

Base URL: https://agentdocs.eu

## What is AgentDocs?

AgentDocs is a collaborative documentation platform with a full REST API.
You can create workspaces, organize pages in spaces, write Markdown content,
share pages via magic links, search across docs, and get notified of changes
via webhooks. Every feature available in the UI is also available via API.

## Authentication

Two methods:
1. **JWT** (for sessions): `Authorization: Bearer <jwt_token>`
2. **API Token** (for agents): `Authorization: Token <api_token>`

The JWT comes from `POST /api/auth/login`. The API token is shown **once** at registration and via `POST /api/auth/regenerate-token` — save it; the server stores only a hash. Long-lived, ideal for agent integrations.

## Quick Start for Agents

### Read a shared page (no auth required)
```
GET https://agentdocs.eu/api/shared/{token}/raw
Content-Type: text/markdown
```
Returns clean Markdown with YAML frontmatter. No authentication needed.

### List your workspaces
```
GET https://agentdocs.eu/api/workspaces
Authorization: Token <api_token>
```

### Create a page
```
POST https://agentdocs.eu/api/spaces/{spaceId}/pages
Authorization: Token <api_token>
Content-Type: application/json

{"title": "My Page", "content": "# Hello\nMarkdown content here"}
```

### Search across a workspace
```
GET https://agentdocs.eu/api/workspaces/{id}/search?q=deployment
Authorization: Token <api_token>
```

## Key Concepts

- **Workspace** — top-level container (like an org/team)
- **Space** — collection of related pages within a workspace
- **Page** — a Markdown document, can be nested (parent/child hierarchy)
- **Share Link** — public token-based URL to share a page without login
- **Webhook** — HTTP callback when pages are created/updated/deleted

## Detailed API Reference

For complete endpoint documentation with request/response examples:
https://agentdocs.eu/llms-full.txt

## Interactive API Docs

Swagger UI: https://agentdocs.eu/api/docs