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


circle-info

The External Dataset API provides full access to your datasets including semantic search, creation, cloning, and reindexing. Use the query endpoint for RAG-style retrieval without needing to create an agent.

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

Last updated