Run a read-only query on a knowledge store
Runs one statement as a read-only role through the deployment’s portal. The audit log records the statement.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
id
Deployment ID
name
Knowledge entry name
Request
This endpoint expects an object.
sql
One SQL statement, at most 4096 bytes. It runs read-only, for at most 5 seconds, and returns at most 500 rows or 1 MiB.
Response
OK
columns
duration_ms
error
row_count
rows
Cells as Postgres prints them, null for NULL
truncated
True when the row or byte limit cut the result short
Errors
400
Bad Request Error
404
Not Found Error
409
Conflict Error
504
Gateway Timeout Error