---
title: "Create a page"
method: POST
path: "/api/wiki"
---

# Create a page

`POST /api/wiki`

## Request

- Base URL: `https://radix.wiki`
- URL: `https://radix.wiki/api/wiki`
- Auth: HTTP bearer

Some tag paths are $XRD-balance-gated or author-only; required metadata keys vary by tag path (errors name any missing). Slug derives from the title when omitted.

## Request body

- object
  - `title` string, required
  - `tagPath` string, required: Valid tag path (see GET /api/mcp get_categories, or llms.txt)
  - `content` Block[], required
    - `id` string, uuid, required
    - `type` 'content' | 'banner' | 'columns' | 'recentPages' | 'pageList' | 'assetPrice' | 'networkChart' | 'rssFeed' | 'codeTabs' | 'linkGrid' | 'tipJar' | 'references' | 'infobox' | 'stats' | 'testimonial', required
    - `text` string: Semantic HTML (content blocks)
  - `metadata` object: Include `excerpt` (≤160 chars)
  - `slug` string
  - `bannerImage` string, uri

## Response `201`

Page created

- Page
  - `id` string
  - `title` string
  - `tagPath` string
  - `slug` string
  - `content` Block[]
    - `id` string, uuid, required
    - `type` 'content' | 'banner' | 'columns' | 'recentPages' | 'pageList' | 'assetPrice' | 'networkChart' | 'rssFeed' | 'codeTabs' | 'linkGrid' | 'tipJar' | 'references' | 'infobox' | 'stats' | 'testimonial', required
    - `text` string: Semantic HTML (content blocks)
  - `metadata` object
  - `version` string: Semantic version, bumped server-side per edit
  - `updatedAt` string, date-time

## Other responses

- `400`: Invalid blocks, tag path, or missing required metadata
- `401`: Missing or invalid bearer token
- `403`: Balance-gated or author-only path

---

[API](https://skmtc.dev/radix/apis/radix-wiki-api.md) · [All operations](https://skmtc.dev/radix/apis/radix-wiki-api/llms.txt) · [OpenAPI document](https://skmtc.dev/radix/apis/radix-wiki-api/revisions/2489ffad8c96?raw)