API Reference
The Nexatron REST API is organized around resource groups. All endpoints are prefixed with /api/v1 and require authentication.
Base URL: https://api.nexatron.io/api/v1
Authentication: pass your API key in the Authorization header:
Authorization: Bearer nxa_your_api_key_here
API keys are issued from the in-product Settings → API keys page. Keys are scoped to a single tenant and can be revoked at any time.
This page is a conceptual overview. The complete, always-current endpoint reference — request and response schemas, parameters, and status codes — is generated from the live API specification. Browse it under API Reference.
Resource groups
The API surface is grouped by the core concepts of the platform:
| Group | What it covers |
|---|---|
| Query | Submit a natural-language question and receive an answer, with the generated SQL, the sources used, and a confidence score. Streaming is available via server-sent events. |
| Connections | Create, list, inspect, test, and remove data-source connections, and retrieve a connected source's schema. |
| Semantic layer | Define and manage certified metrics, dimensions, and relationships so every query resolves to approved business definitions. |
| Conversations | List, retrieve, and manage conversations and their messages for multi-turn querying. |
| Feedback | Record thumbs-up/down and chart feedback that feeds accuracy improvements. |
Refer to the generated reference for the exact paths, methods, and payloads in each group.
Data sources
Nexatron connects to warehouses and databases (PostgreSQL, MySQL, SQL Server, Snowflake, BigQuery, Databricks, Redshift, and Amazon S3) and to business applications such as Salesforce and QuickBooks through a generic AppConnector and the MCP framework.
The set of connector types available to your tenant is returned by the connector-types endpoint rather than hard-coded here, so it always reflects what the platform currently supports. See GET /connections/types in the generated reference.
Common Response Codes
| Code | Meaning |
|---|---|
200 | Success |
201 | Created |
400 | Bad request (check the detail field) |
401 | Invalid or missing API key |
403 | Insufficient permissions |
404 | Resource not found |
422 | Validation error (check detail for field-level errors) |
429 | Rate limited (check Retry-After header) |
Rate Limits
Rate limit headers are included in every response:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1712505600
Limits vary by plan. Contact your account team for plan-specific quotas.
Enterprise endpoints
SCIM provisioning, audit log access, billing, and analytics endpoints are documented separately and are available to enterprise customers. Contact your account team for the enterprise API guide.