Skip to main content
Use the Source API reference for request/response details, parameters, and examples. Send X-API-KEY on every request; add ?organization_name=YourOrg. Base URL is typically https://api-prod.voltai.ai/source/api.

​
1. Create a topic

Use POST /topics to create a root topic, a child (with parent_topic_uuid), or a full path in one call (topic_path). Store the returned uuid for later.

​
2. Find a topic

Topics are identified by UUID. Use GET /topics with search or topic_path to resolve a name or path to a UUID, or GET /topics/tree to load the full tree.

​
3. Add a source to a topic

Either POST /sources (multipart upload with topic_uuids) or POST /sources/bulk-action with action: "add-to-topic" to attach existing sources to a topic.

​
4. Change topic structure

Use PATCH /topics/ to rename or move a topic (set parent_topic_uuid; send the string "null" to move it to the root, because the current PATCH handler leaves the parent unchanged for JSON null). Use DELETE /topics/ to remove a topic and its subtopics.

​
5. Bulk actions on topics

Use POST /topics/bulk-action with action: "create", "create-topic-paths", "update", or "delete" to create, update, or delete multiple topics.

​
6. Change a source’s topics

Use PATCH /sources/ with topic_uuids to set a source’s topic list. Use POST /sources/bulk-action with action: "remove-from-topic" to remove sources from a topic. List endpoints support page and page_size. Source names must match exactly. Detail routes accept names without slashes; use bulk source_names for names containing slashes, including encoded slashes.

​
7. Search and retrieve chunks

Use POST /retrieve/ for keyword or semantic search over indexed content without using the chat agent. The API returns ranked chunks with text, page, and bounding boxes. API keys with granular permissions need the retrieval scope for this endpoint.