Semantic Query
Semantic Query
Infer and return the structural schema of data sources
Call this once when a user connects a data source.
Returns the full Algenta structural schema: column roles, detected formulas, cardinality, and query_hints the LLM should use when calling POST /v1/query.
The schema is also embedded as Arrow metadata in the returned Parquet bytes (parquet_b64), which the LLM agent can store and reuse — no re-profiling on subsequent queries.
Flow:
- User connects data source
- Call POST /v1/sources/schema — ~1-2s, runs once
- LLM reads schema JSON and query_hints
- User asks questions → LLM produces structured intent → POST /v1/query (~200ms, cached)
post/v1/sources/schema
Request
- Base URL: https://api.algenta.ai
- URL: https://api.algenta.ai/v1/sources/schema
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Request body
Response
Successful Response
object required
Changes
No recorded changes to this operation across all 1 revision of this API.