> ## 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.

# Bulk Actions on Topics

> Perform bulk create, bulk create-topic-paths, update, or delete actions on topics.



## OpenAPI

````yaml /api-reference/knowledge-agent/source-api.json post /topics/bulk-action/
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/bulk-action/:
    post:
      tags:
        - Topics - Bulk Actions
      summary: Bulk Actions on Topics
      description: >-
        Perform bulk create, bulk create-topic-paths, update, or delete actions
        on topics.
      operationId: topics_bulk_action_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/TopicBulkActionRequestRequest'
            examples:
              CreateTopics:
                value:
                  action: create
                  topics:
                    - name: Power Management
                summary: Create topics
              UpdateTopics:
                value:
                  action: update
                  topics:
                    - uuid: 660e8400-e29b-41d4-a716-446655440001
                      name: Updated Name
                summary: Update topics
              DeleteTopics:
                value:
                  action: delete
                  topic_uuids:
                    - 660e8400-e29b-41d4-a716-446655440001
                summary: Delete topics
              CreateTopicsFromPaths:
                value:
                  action: create-topic-paths
                  topic_paths:
                    - - Semiconductors
                      - Power Management
                      - PMIC
                    - - Semiconductors
                      - Microcontrollers
                      - ARM Cortex-M
                summary: Create topics from paths
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/TopicBulkActionRequestRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/TopicBulkActionRequestRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkActionResponse'
              examples:
                CreateTopics:
                  value:
                    action: create
                    topics:
                      - name: Power Management
                  summary: Create topics
                UpdateTopics:
                  value:
                    action: update
                    topics:
                      - uuid: 660e8400-e29b-41d4-a716-446655440001
                        name: Updated Name
                  summary: Update topics
                DeleteTopics:
                  value:
                    action: delete
                    topic_uuids:
                      - 660e8400-e29b-41d4-a716-446655440001
                  summary: Delete topics
                CreateTopicsFromPaths:
                  value:
                    action: create-topic-paths
                    topic_paths:
                      - - Semiconductors
                        - Power Management
                        - PMIC
                      - - Semiconductors
                        - Microcontrollers
                        - ARM Cortex-M
                  summary: Create topics from paths
          description: ''
        '400':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
          description: ''
      security:
        - cookieAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    TopicBulkActionRequestRequest:
      type: object
      description: Request schema for topic bulk actions.
      properties:
        action:
          allOf:
            - $ref: '#/components/schemas/TopicBulkActionRequestActionEnum'
          description: |-
            Action to perform on topics.

            * `create` - create
            * `create-topic-paths` - create-topic-paths
            * `update` - update
            * `delete` - delete
        topics:
          type: array
          items:
            type: object
            additionalProperties: {}
          description: >-
            List of topic objects for create/update. Update objects must include
            'uuid'.
        topic_uuids:
          type: array
          items:
            type: string
            format: uuid
          description: List of topic UUIDs to delete.
        topic_paths:
          type: array
          items:
            type: array
            items:
              type: string
              minLength: 1
          description: List of topic paths. Required for create-topic-paths action.
      required:
        - action
    BulkActionResponse:
      type: object
      description: Reusable response schema for bulk actions.
      properties:
        message:
          type: string
        deleted_count:
          type: integer
        created_count:
          type: integer
        existing_count:
          type: integer
        processed_paths:
          type: integer
        updated_count:
          type: integer
        deleted_subtopics:
          type: integer
        error_count:
          type: integer
        errors:
          type: array
          items:
            type: object
            additionalProperties: {}
      required:
        - message
    TopicBulkActionRequestActionEnum:
      enum:
        - create
        - create-topic-paths
        - update
        - delete
      type: string
      description: |-
        * `create` - create
        * `create-topic-paths` - create-topic-paths
        * `update` - update
        * `delete` - delete
  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.

````