Skip to main content
POST
/
api
/
kb
/
documents
Create a document
curl --request POST \
  --url https://api.morphic.io/api/kb/documents \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "content_markdown": "# Getting Started\n\nWelcome to our knowledge base.",
  "title": "Getting Started Guide",
  "type": "page",
  "visibility": "public"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "type": "<string>",
  "title": "<string>",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slug": "<string>",
  "content": {},
  "content_markdown": "<string>",
  "visibility": "private",
  "parent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "position": 0,
  "children_count": 123
}

Authorizations

​
X-API-Key
string
header
required

API key (sk_xxx) from Developer Settings. No X-Account-ID needed.

Headers

​
x-account-id
string | null

Body

application/json
​
title
string
required

Document title

Maximum string length: 255
​
type
string
default:page

'folder' (no content) or 'page' (has content)

Maximum string length: 20
​
slug
string | null

URL-friendly slug (auto-generated if not provided)

Maximum string length: 255
​
content
Content · object

BlockNote block structure (JSON); null for folders

​
content_markdown
string | null

Rendered markdown for AI context; null for folders

​
visibility
string
default:private

Document visibility: 'private' or 'public'

​
parent_id
string<uuid> | null

Parent document ID for hierarchy

​
position
integer
default:0

Position for ordering

Response

Successful Response

​
id
string<uuid>
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
type
string
required
​
title
string
required

Document title

Maximum string length: 255
​
account_id
string<uuid>
required
​
slug
string | null

URL-friendly slug (auto-generated if not provided)

Maximum string length: 255
​
content
Content · object

BlockNote block structure (JSON); null for folders

​
content_markdown
string | null

Rendered markdown for AI context; null for folders

​
visibility
string
default:private

Document visibility: 'private' or 'public'

​
parent_id
string<uuid> | null
​
position
integer
default:0

Position for ordering

​
children_count
integer | null

For folders, number of direct children (only in list/get)