API Reference
External Dataset API
Full CRUD and semantic search: basic and advanced tiers.
External Dataset API
Full CRUD + Semantic Search (Basic & Advanced)
The External Dataset API gives you full programmatic access to your datasets, including semantic search, dataset management, and indexing operations.
You can query knowledge directly without creating an agent, making it ideal for backend integrations, automation, and custom AI workflows.
Tier access
Basic (Free, Basic plans)- List datasets
- View dataset information
- Run semantic queries
- Create datasets
- Deep query capabilities
- Cross-dataset queries
- Clone datasets
- Reindex embeddings
- Batch queries
Available endpoints
List accessible datasets
GET /api/v1/ext/datasets/
Returns the dataset this API key has access to.
Cost: FreeQuery dataset (semantic search)
POST /api/v1/ext/datasets/query
Run a semantic search query against your dataset and retrieve relevant results (RAG-style retrieval).
Cost: 1 creditBatch query dataset (Advanced tier)
POST /api/v1/ext/datasets/query/batch
Run multiple semantic queries in a single request.
Cost: 1 credit per queryReindex dataset embeddings
POST /api/v1/ext/datasets/reindex
Rebuilds dataset embeddings to refresh search accuracy after updates or structural changes.
Cost: 2 credits