Biron Analytics Biron Nexus API

Name: Biron Nexus API
Brand: Biron Nexus API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAnalyticsBusiness Intelligencebasic2 EndpointsREST

For Agents

Run NexusQL queries against a Biron semantic layer and read workspace metadata to discover available metrics. Two endpoints, HTTP Basic authentication.

Install Jentic One Beta

Connect the Biron Nexus API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Biron Nexus API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Biron Nexus API.

Execute a NexusQL query against the configured semantic layer via POST /sql and receive a tabular result set

Read workspace metadata including available metrics and dimensions via GET /workspaces/{code}

Pull modelled KPIs without writing SQL against raw warehouse tables

GET STARTED

Start building with Biron Nexus API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Biron Nexus API, keeping it validated and agent-ready. Biron is a data platform that ships an ETL stack and a semantic layer on top of the customer's warehouse. The Nexus API is the programmatic surface to that semantic layer: clients submit NexusQL queries, which Biron compiles against the modelled metrics and dimensions, and the API returns tabular result sets. A second endpoint reads workspace metadata so callers know which datasets and metrics are available before composing a query.

Use Cases

Patterns agents use Biron Nexus API for, with concrete tasks.

★ Programmatic KPI retrieval for status reports

Operations teams pull weekly KPIs from the modelled semantic layer rather than querying raw warehouse tables. POST /sql accepts a NexusQL query and returns a tabular result that maps cleanly into a status-report template. Because the semantic layer enforces consistent metric definitions, two reports built by different teams converge on the same numbers.

POST /sql with a NexusQL query for weekly_active_users grouped by week for the last 12 weeks and render the result table

Workspace discovery before query composition

Analysts who switch between several Biron workspaces need to confirm the available metrics before they write a NexusQL query. GET /workspaces/{code} returns the workspace definition including the list of metrics and dimensions Biron has modelled. The two-step pattern (discover then query) avoids failed /sql calls caused by referencing a metric that has not been published.

Call GET /workspaces/revenue-ops, list the metric names, and return them to the analyst as a picklist

Agent integration via Jentic for self-serve analytics

An AI agent answering 'what was our revenue last quarter' resolves the question through Jentic. Jentic returns the Biron Nexus /sql operation along with the workspace schema, so the agent can compose a valid NexusQL query, execute it, and surface the result in chat. The HTTP Basic credentials remain in the Jentic vault — the agent never holds them.

Search Jentic for 'run a nexusql query against biron', load the /sql schema, compose a query for revenue grouped by quarter, and return the result

Key Endpoints

2 endpoints — jentic publishes the only available openapi specification for biron nexus api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/sql

Execute a NexusQL query against the configured workspace

GET

/workspaces/{code}

Return workspace metadata including modelled metrics and dimensions

POST

/sql

Execute a NexusQL query against the configured workspace

GET

/workspaces/{code}

Return workspace metadata including modelled metrics and dimensions

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Biron HTTP Basic credentials are stored encrypted in the Jentic vault. Jentic builds the Authorization header at execution time, so agent prompts and logs never contain the password.

Intent-based discovery

Agents search by intent (e.g. 'run a nexusql query' or 'list metrics in a biron workspace') and Jentic returns the matching operation with its input and response schema.

Time to first call

Direct Biron integration: half a day to set up Basic auth, model the workspace lookup, and wire the /sql call. Through Jentic: under 30 minutes — search, load schema, execute.

FAQs

Specific to using Biron Nexus API through Jentic.

Why is there no official OpenAPI spec for Biron Nexus API?

Biron does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Biron Nexus API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Biron Nexus API use?

Biron Nexus uses HTTP Basic authentication. Clients send a username and password pair in the Authorization header on every request. Through Jentic the credential is held encrypted in the vault and injected at execution, so agents never see the password.

Can I list the metrics in a Biron workspace before querying?

Yes. GET /workspaces/{code} returns the workspace definition including the list of modelled metrics and dimensions. Call it once to populate a picklist, then issue POST /sql with a NexusQL query that references those names.

What are the rate limits for the Biron Nexus API?

Biron does not publish a numeric per-second rate limit in its specification. Treat /sql as a synchronous query against the underlying warehouse — long-running NexusQL queries occupy compute, so concurrency is bounded by the workspace's warehouse capacity rather than by an HTTP throttle.

How do I run a NexusQL query through Jentic?

Run pip install jentic, search Jentic for 'run a nexusql query against biron', load the /sql operation schema, and execute with a NexusQL string in the body. Jentic injects the Basic credentials and returns the tabular result.

Does the Biron Nexus API return raw warehouse data?

No. /sql executes NexusQL against the modelled semantic layer, not against raw warehouse tables. Use the workspace endpoint to discover the modelled metric and dimension names that NexusQL accepts.