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

> Perform bulk actions on multiple sources.
**Available actions:**
- `enable`: Enable sources (re-parses/re-indexes if needed)
- `disable`: Disable sources from retrieval and LLM context
- `reindex`: Re-index sources in the search engine
- `reparse`: Re-parse sources (optionally with a specific job_version)
- `add-to-topic`: Add sources to a topic (requires topic_uuid)
- `remove-from-topic`: Remove sources from a topic (requires topic_uuid)
- `delete`: Permanently delete sources




## OpenAPI

````yaml /api-reference/knowledge-agent/source-api.json post /sources/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:
  /sources/bulk-action/:
    post:
      tags:
        - Sources - Bulk Actions
      summary: Bulk Actions on Sources
      description: |
        Perform bulk actions on multiple sources.
        **Available actions:**
        - `enable`: Enable sources (re-parses/re-indexes if needed)
        - `disable`: Disable sources from retrieval and LLM context
        - `reindex`: Re-index sources in the search engine
        - `reparse`: Re-parse sources (optionally with a specific job_version)
        - `add-to-topic`: Add sources to a topic (requires topic_uuid)
        - `remove-from-topic`: Remove sources from a topic (requires topic_uuid)
        - `delete`: Permanently delete sources
      operationId: sources_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/BulkActionRequestRequest'
            examples:
              EnableSources:
                value:
                  action: enable
                  source_names:
                    - document.pdf
                    - datasheet.pdf
                summary: Enable sources
                description: >-
                  Enable disabled sources, re-parsing or re-indexing if
                  necessary
              DisableSources:
                value:
                  action: disable
                  source_names:
                    - document.pdf
                    - datasheet.pdf
                summary: Disable sources
                description: Disable sources from retrieval and LLM context
              ReindexSources:
                value:
                  action: reindex
                  source_names:
                    - document.pdf
                summary: Reindex sources
                description: Re-index sources in the search engine
              ReparseSources:
                value:
                  action: reparse
                  source_names:
                    - document.pdf
                summary: Reparse sources
                description: Re-parse sources with optional job version
              AddSourcesToTopic:
                value:
                  action: add-to-topic
                  source_names:
                    - document.pdf
                    - datasheet.pdf
                  topic_uuid: 660e8400-e29b-41d4-a716-446655440099
                summary: Add sources to topic
                description: Add multiple sources to a specific topic
              RemoveSourcesFromTopic:
                value:
                  action: remove-from-topic
                  source_names:
                    - document.pdf
                  topic_uuid: 660e8400-e29b-41d4-a716-446655440099
                summary: Remove sources from topic
                description: Remove multiple sources from a specific topic
              DeleteSources:
                value:
                  action: delete
                  source_names:
                    - document.pdf
                    - datasheet.pdf
                summary: Delete sources
                description: Permanently delete sources
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/BulkActionRequestRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/BulkActionRequestRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkActionResponse'
              examples:
                EnableSources:
                  value:
                    action: enable
                    source_names:
                      - document.pdf
                      - datasheet.pdf
                  summary: Enable sources
                  description: >-
                    Enable disabled sources, re-parsing or re-indexing if
                    necessary
                DisableSources:
                  value:
                    action: disable
                    source_names:
                      - document.pdf
                      - datasheet.pdf
                  summary: Disable sources
                  description: Disable sources from retrieval and LLM context
                ReindexSources:
                  value:
                    action: reindex
                    source_names:
                      - document.pdf
                  summary: Reindex sources
                  description: Re-index sources in the search engine
                ReparseSources:
                  value:
                    action: reparse
                    source_names:
                      - document.pdf
                  summary: Reparse sources
                  description: Re-parse sources with optional job version
                AddSourcesToTopic:
                  value:
                    action: add-to-topic
                    source_names:
                      - document.pdf
                      - datasheet.pdf
                    topic_uuid: 660e8400-e29b-41d4-a716-446655440099
                  summary: Add sources to topic
                  description: Add multiple sources to a specific topic
                RemoveSourcesFromTopic:
                  value:
                    action: remove-from-topic
                    source_names:
                      - document.pdf
                    topic_uuid: 660e8400-e29b-41d4-a716-446655440099
                  summary: Remove sources from topic
                  description: Remove multiple sources from a specific topic
                DeleteSources:
                  value:
                    action: delete
                    source_names:
                      - document.pdf
                      - datasheet.pdf
                  summary: Delete sources
                  description: Permanently delete sources
          description: ''
        '400':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
          description: ''
        '404':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
          description: ''
      security:
        - cookieAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    BulkActionRequestRequest:
      type: object
      description: Request schema for source bulk actions.
      properties:
        action:
          allOf:
            - $ref: '#/components/schemas/BulkActionRequestActionEnum'
          description: |-
            Action to perform on the sources

            * `enable` - enable
            * `disable` - disable
            * `reindex` - reindex
            * `reparse` - reparse
            * `add-to-topic` - add-to-topic
            * `remove-from-topic` - remove-from-topic
            * `delete` - delete
        source_names:
          type: array
          items:
            type: string
            minLength: 1
          description: >-
            List of source names to perform the action on (e.g.,
            ['document.pdf', 'datasheet.pdf'])
        topic_uuid:
          type: string
          format: uuid
          description: Topic UUID (required for add-to-topic and remove-from-topic actions)
        job_version:
          type: string
          minLength: 1
          description: Job version (optional, for reparse action)
      required:
        - action
        - source_names
    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
    BulkActionRequestActionEnum:
      enum:
        - enable
        - disable
        - reindex
        - reparse
        - add-to-topic
        - remove-from-topic
        - delete
      type: string
      description: |-
        * `enable` - enable
        * `disable` - disable
        * `reindex` - reindex
        * `reparse` - reparse
        * `add-to-topic` - add-to-topic
        * `remove-from-topic` - remove-from-topic
        * `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.

````