Developer Documentation
REST API Reference
Execute natural language database queries, retrieve schema metadata, and manage database connections programmatically.
Authentication
All API requests must pass a Bearer token HTTP Authorization header containing your API secret key.
Authorization: Bearer int_sec_99a8b7c6d5e4f321...
POST/api/chat
Execute AI Query
Submit a natural language question against a connected database to generate SQL and return structured dataset records.
{
"databaseConnectionId": "conn_12345",
"message": "Show top 10 users by order count"
}GET/api/databases
List Connected Databases
Retrieve all database connections configured for your active organization workspace.
// Response
{
"connections": [
{ "id": "conn_12345", "name": "Production Postgres", "type": "POSTGRESQL", "status": "CONNECTED" }
]
}