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
Advanced (Pro, Team, Enterprise plans)
  • 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: Free

Query 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 credit

Batch query dataset (Advanced tier)

POST /api/v1/ext/datasets/query/batch

Run multiple semantic queries in a single request.

Cost: 1 credit per query

Reindex dataset embeddings

POST /api/v1/ext/datasets/reindex

Rebuilds dataset embeddings to refresh search accuracy after updates or structural changes.

Cost: 2 credits