Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
kb_id
string
required

Body

application/json
sql
string
required

SQL query to execute against the knowledge base. Use $1, $2, etc. for parameter placeholders.

explain
boolean

When true, runs EXPLAIN ANALYZE and includes the query plan in the response.

params
any[]

Optional query parameters bound to SQL placeholders ($1, $2, …).

Response

200 - application/json

Query results as JSON