Wiki API
Org wikis with markdown pages, collections, tags, and projects — plus AI-assisted authoring: generate pages from prompts or knowledge-substrate entities, and regenerate them as the underlying knowledge changes.
Token tier: API keys accepted
Wiki routes accept sk_live_ keys (verified live — a fresh org
gets an empty list / 404 rather than a permission error).
Pages
| Method | Path | SDK (client.wiki) |
|---|---|---|
| GET | /v1/wiki/pages | listPages |
| POST | /v1/wiki/pages | createPage |
| PUT | /v1/wiki/pages/{id} | updatePage |
| DELETE | /v1/wiki/pages/{id} | deletePage |
| GET | /api/wiki/pages/{id}/raw | getRawPage |
AI-assisted authoring
| Method | Path | SDK (client.wiki) |
|---|---|---|
| POST | /v1/wiki/pages/from-prompt | createPromptPage |
| POST | /v1/wiki/pages/from-entity | createEntityPage |
| PUT | /v1/wiki/pages/{id}/prompt | updatePrompt |
| POST | /v1/wiki/pages/{id}/regenerate | regenerate |
| POST | /v1/wiki/pages/{id}/generate-narrative | generateNarrative |
Collections, tags & projects
| Method | Path | SDK (client.wiki) |
|---|---|---|
| GET | /v1/wiki/collections | listCollections |
| POST | /v1/wiki/collections | createCollection |
| PUT | /v1/wiki/collections/{id} | updateCollection |
| DELETE | /v1/wiki/collections/{id} | deleteCollection |
| POST | /v1/wiki/collections/{id}/pages | addPageToCollection |
| GET | /v1/wiki/tags | listTags |
| POST | /v1/wiki/pages/{id}/tags | addTagsToPage |
| GET | /v1/wiki/projects | listProjects |
| POST | /v1/wiki/projects | createProject |
Agent tools
A small read/search surface designed for AI agents: page reads, substrate
claim search, canonical-entity lookup, predicates, and generation history
(searchClaims, getCanonicalEntity,
listPredicates, readPageTool, listPagesTool,
pageGenerationHistory under /v1/wiki/agent-tools/…).
SDK Examples
// Create a freeform markdown page
const page = await client.wiki.createPage({
slug: 'runbook-deploys',
title: 'Deploy Runbook',
body_markdown: '# Deploys\n\n1. Push to main…',
});
// Generate a page from a prompt (AI-authored, grounded on the org's knowledge)
const generated = await client.wiki.createPromptPage({
slug: 'arch-overview',
title: 'Architecture Overview',
prompt: 'Summarize our service architecture for new engineers',
});
// List pages
const pages = await client.wiki.listPages();
let page = client.wiki().create_page(&CreateWikiPageRequest {
slug: "runbook-deploys".into(),
title: "Deploy Runbook".into(),
body_markdown: "# Deploys\n\n1. Push to main…".into(),
..Default::default()
}).await?;
let pages = client.wiki().list_pages(None).await?;