Skip to main content
POST
Create Topic

Authorizations

sessionid
string
cookie
required

Query Parameters

organization_name
string
required

Organization name (required for multi-tenant API keys)

Body

Request schema for topic create or create-from-path behavior.

name
string

Name of the topic

Minimum string length: 1
topic_path
string[]

Single root-to-leaf topic path. If provided, missing topics are created along the path.

Minimum string length: 1
parent_topic_uuid
string<uuid> | null

UUID of parent topic (null for root topics). Used for single-topic create.

is_published
boolean
default:true

Whether the topic is published

description
string

Topic description

Whether the topic is popular

is_default
boolean

Whether the topic is default

Response

201 - application/json
name
string
required
Maximum string length: 128
sub_topics
string
required
read-only
path
string
required
read-only
part_markdown
string
required
read-only
uuid
string<uuid>
is_default
boolean
is_published
boolean