Skip to main content
POST
/
topics
Create Topic
curl --request POST \
  --url https://api-prod.voltai.ai/source/api/topics/ \
  --header 'Content-Type: application/json' \
  --cookie sessionid= \
  --data '
{
  "name": "<string>",
  "topic_path": [
    "<string>"
  ],
  "parent_topic_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_published": true,
  "description": "<string>",
  "is_popular": true,
  "is_default": true
}
'
{
  "name": "<string>",
  "sub_topics": "<string>",
  "path": "<string>",
  "part_markdown": "<string>",
  "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_popular": true,
  "is_default": true,
  "is_published": true
}

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

​
is_popular
boolean

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
​
path
string
required
​
part_markdown
string
required
​
uuid
string<uuid>
​
is_popular
boolean
​
is_default
boolean
​
is_published
boolean