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 or null for root). 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; URL-encode them in paths when needed.