> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voltai.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Topic

> Create a new topic, or create from a single root-to-leaf topic_path.



## OpenAPI

````yaml /api-reference/knowledge-agent/source-api.json post /topics/
openapi: 3.0.3
info:
  title: Arcturus Source API
  version: 1.0.0
  description: API for managing sources and topics
servers:
  - url: https://api-prod.voltai.ai/source/api/
    description: Production
security: []
tags:
  - name: Sources
    description: Source CRUD operations
  - name: Sources - Bulk Actions
    description: Bulk operations on sources
  - name: Topics
    description: Topic CRUD operations
  - name: Topics - Tree & Sources
    description: Topic hierarchy and source listings
  - name: Topics - Bulk Actions
    description: Bulk operations on topics
  - name: Sources - Bulk Ingest
    description: Bulk ingestion of sources
paths:
  /topics/:
    post:
      tags:
        - Topics
      summary: Create Topic
      description: Create a new topic, or create from a single root-to-leaf topic_path.
      operationId: topics_create
      parameters:
        - in: query
          name: organization_name
          schema:
            type: string
          description: Organization name (required for multi-tenant API keys)
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TopicCreateOrPathRequestRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/TopicCreateOrPathRequestRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/TopicCreateOrPathRequestRequest'
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Topic'
          description: ''
      security:
        - cookieAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    TopicCreateOrPathRequestRequest:
      type: object
      description: Request schema for topic create or create-from-path behavior.
      properties:
        name:
          type: string
          minLength: 1
          description: Name of the topic
        topic_path:
          type: array
          items:
            type: string
            minLength: 1
          description: >-
            Single root-to-leaf topic path. If provided, missing topics are
            created along the path.
        parent_topic_uuid:
          type: string
          format: uuid
          nullable: true
          description: >-
            UUID of parent topic (null for root topics). Used for single-topic
            create.
        is_published:
          type: boolean
          default: true
          description: Whether the topic is published
        description:
          type: string
          description: Topic description
        is_popular:
          type: boolean
          description: Whether the topic is popular
        is_default:
          type: boolean
          description: Whether the topic is default
    Topic:
      type: object
      properties:
        name:
          type: string
          maxLength: 128
        uuid:
          type: string
          format: uuid
        is_popular:
          type: boolean
        is_default:
          type: boolean
        is_published:
          type: boolean
        sub_topics:
          type: string
          readOnly: true
        path:
          type: string
          readOnly: true
        part_markdown:
          type: string
          readOnly: true
      required:
        - name
        - part_markdown
        - path
        - sub_topics
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: sessionid
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        API key for authentication. Get your API key from the organization
        settings.

````