Suggest edit — API Reference

Title

Name

Note

---
title: API Reference
visibility: public
---

# API Reference

Base URL: `https://wikihub.globalbr.ai/api/v1`

All endpoints accept and return JSON. Authentication via `Authorization: Bearer wh_...` header.

## Accounts

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/accounts` | Register (returns API key) |
| POST | `/auth/token` | Exchange password for API key |
| GET | `/accounts/me` | Current account info |
| PATCH | `/accounts/me` | Update account |
| POST | `/keys` | Create additional API key |
| GET | `/keys` | List API keys |
| DELETE | `/keys/:id` | Revoke API key |

## Wikis

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/wikis` | Create wiki |
| GET | `/wikis/:owner/:slug` | Wiki metadata |
| PATCH | `/wikis/:owner/:slug` | Update wiki |
| DELETE | `/wikis/:owner/:slug` | Delete wiki |
| POST | `/wikis/:owner/:slug/fork` | Fork wiki |
| POST | `/wikis/:owner/:slug/star` | Star wiki |
| DELETE | `/wikis/:owner/:slug/star` | Unstar wiki |

## Pages

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/wikis/:owner/:slug/pages` | Create page |
| GET | `/wikis/:owner/:slug/pages` | List pages |
| GET | `/wikis/:owner/:slug/pages/:path` | Read page |
| PUT | `/wikis/:owner/:slug/pages/:path` | Replace page |
| PATCH | `/wikis/:owner/:slug/pages/:path` | Patch page |
| DELETE | `/wikis/:owner/:slug/pages/:path` | Delete page |
| POST | `/wikis/:owner/:slug/pages/:path/visibility` | Set visibility |
| POST | `/wikis/:owner/:slug/pages/:path/share` | Share with user |
| POST | `/wikis/:owner/:slug/pages/:path/append-section` | Append section |

## Search

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/search?q=query` | Full-text search |

## History

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/wikis/:owner/:slug/history` | Commit log |