# Voltai Documentation

## Docs

- [Chat Query](https://docs.voltai.ai/api-reference/knowledge-agent/chat-query.md): Ask a question to the Voltai agent and continue an existing thread with `chat_id`.
- [Chat Sessions](https://docs.voltai.ai/api-reference/knowledge-agent/chat-sessions.md): Check floating-session usage and which user IDs are in an active 5-minute window.
- [Chunk retrieval](https://docs.voltai.ai/api-reference/knowledge-agent/retrieve-chunks.md): Search indexed sources with keyword or semantic search and receive ranked chunks (text, page, bounding boxes).
- [Basic Operations Guide](https://docs.voltai.ai/api-reference/knowledge-agent/source-api-basic-operations.md): How to perform common Sources & Topics API workflows.
- [Parts Explorer API overview](https://docs.voltai.ai/api-reference/parts-explorer/overview.md): Parts Agent endpoints for comparison, search, selection, and per-part data. JWT-authenticated.
- [Schematic API overview](https://docs.voltai.ai/api-reference/schematic/overview.md): Upload schematics, inspect parts and BOM, chat, and run reviews. JWT-authenticated.
- [Bulk Actions on Sources](https://docs.voltai.ai/api-reference/sources--bulk-actions/bulk-actions-on-sources.md): 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_ve…
- [Bulk Create Sources from S3 Folder](https://docs.voltai.ai/api-reference/sources--bulk-ingest/bulk-create-sources-from-s3-folder.md): Discover supported files under an S3 folder, map topic paths from folder hierarchy, and run bulk S3 ingestion.
- [Create Sources from ZIP](https://docs.voltai.ai/api-reference/sources--bulk-ingest/create-sources-from-zip.md): Upload a ZIP file, ingest supported files, assign topics from ZIP folder paths, and queue parse jobs.
- [Create Source](https://docs.voltai.ai/api-reference/sources/create-source.md): Create a new source by uploading a file
- [Delete Source](https://docs.voltai.ai/api-reference/sources/delete-source.md): Delete a source by name
- [Get Ingestion Job Progress](https://docs.voltai.ai/api-reference/sources/get-ingestion-job-progress.md): Check the progress of an async ingestion job by job_id. Works for both ZIP and S3 folder ingestion.
- [Get Source](https://docs.voltai.ai/api-reference/sources/get-source.md): Get a specific source by name (e.g., 'document.pdf')
- [List Sources](https://docs.voltai.ai/api-reference/sources/list-sources.md): List and query sources with filtering and pagination
- [Partial Update Source](https://docs.voltai.ai/api-reference/sources/partial-update-source.md): Partially update a source by name. Only provided fields will be updated.
- [Update Source](https://docs.voltai.ai/api-reference/sources/update-source.md): Update a source by name. All fields are optional - only provided fields will be updated.
- [Bulk Actions on Topics](https://docs.voltai.ai/api-reference/topics--bulk-actions/bulk-actions-on-topics.md): Perform bulk create, bulk create-topic-paths, update, or delete actions on topics.
- [Get Topic Sources](https://docs.voltai.ai/api-reference/topics--tree-&-sources/get-topic-sources.md): Get all sources associated with a specific topic
- [Get Topic Tree](https://docs.voltai.ai/api-reference/topics--tree-&-sources/get-topic-tree.md): Get the hierarchical topic tree for the organization
- [Create Topic](https://docs.voltai.ai/api-reference/topics/create-topic.md): Create a new topic, or create from a single root-to-leaf topic_path.
- [Delete Topic](https://docs.voltai.ai/api-reference/topics/delete-topic.md): Delete a topic and its subtopics (cascade delete)
- [Get Topic](https://docs.voltai.ai/api-reference/topics/get-topic.md): Get a specific topic by UUID with full details including path
- [List Topics](https://docs.voltai.ai/api-reference/topics/list-topics.md): List and query topics with filtering and pagination. Use parent_topic=null to get root topics.
- [Partial Update Topic](https://docs.voltai.ai/api-reference/topics/partial-update-topic.md): Partially update a topic
- [Update Topic](https://docs.voltai.ai/api-reference/topics/update-topic.md): Update a topic (rename and/or change parent)
- [Authentication](https://docs.voltai.ai/widget/authentication.md): User authentication modes and bot protection
- [Events](https://docs.voltai.ai/widget/configuration/events.md): React to widget state changes and chat activity
- [Functions](https://docs.voltai.ai/widget/configuration/functions.md): Control the widget programmatically with SDK methods
- [Hide Elements](https://docs.voltai.ai/widget/configuration/hide.md): Hide specific UI elements in the widget
- [Positioning](https://docs.voltai.ai/widget/configuration/positioning.md): Control where the widget button and desktop panel appear
- [Sizing](https://docs.voltai.ai/widget/configuration/sizing.md): Configure the widget's default size and enable user resizing
- [Styling](https://docs.voltai.ai/widget/configuration/styling.md): Customize the widget's appearance to match your brand
- [Text](https://docs.voltai.ai/widget/configuration/text.md): Customize the widget's text content
- [Examples](https://docs.voltai.ai/widget/examples.md): Common patterns and use cases
- [Getting Started](https://docs.voltai.ai/widget/getting-started.md): Add the Voltai Widget to your website in minutes
- [Introduction](https://docs.voltai.ai/widget/introduction.md): Embed an AI-powered chat widget on your website

## OpenAPI Specs

- [chat-query](https://docs.voltai.ai/api-reference/knowledge-agent/chat-query.json)
- [retrieval](https://docs.voltai.ai/api-reference/knowledge-agent/retrieval.json)
- [source-api](https://docs.voltai.ai/api-reference/knowledge-agent/source-api.json)
- [openapi](https://docs.voltai.ai/api-reference/openapi.json)