Skip to content
Developers
Get an API token

Security

How to handle Novi credentials, keep access narrow, rotate, and what each product lets a token or agent see and change.

View MarkdownOpen in Claude(opens in a new tab)
  • Keep tokens and keys in an environment variable or a secret manager. Never in code, a URL, a shared notebook or a support email.
  • Copy a credential when it is shown. Novi API tokens and Snowflake programmatic access tokens are shown once. A Novi UDM Data private key comes as a link that works for 72 hours, and Novi keeps no copy.
  • Novi API tokens start with novi_pat_, so secret scanners can find one committed by mistake.
  • Call the APIs from a server, script or notebook. Browser code on your own web pages can’t call the Novi Forecasts API.
Link Lifetime Who can use it
Novi UDM Data bulk file link 2 hours. A download that has started continues Anyone with the link
Forecasts export file, signed copy 15 minutes It works without credentials, so anyone with it can download
Novi UDM Data private key link 72 hours Not published yet. Treat it as a secret
Product What a credential can do
Novi UDM Data (v4) A Snowflake role. Restrict a programmatic access token to one role with ROLE_RESTRICTION
Novi Forecasts API A Novi API token acts as one person with that person’s full access. No token can create or manage tokens
MCP sign-in One product at your company, through its MCP server only. It does not work on other hosts, products or the REST APIs
Novi EVA REST API The key acts for your EVA organization
  • Access MCP is its own permission. Your company’s Novi administrator grants it through a role, and removing it cuts off every assistant sign-in.
  • Read-only service tokens not tied to a person are Planned.
Credential How
Novi API token Pick a lifetime from 1 to 365 days. Create a new token, switch to it, then revoke the old one on the API tokens page. A revoked token stops working within two minutes
Snowflake programmatic access token ALTER USER REMOVE PROGRAMMATIC ACCESS TOKEN, then ADD a new one with DAYS_TO_EXPIRY
MCP sign-in Sign in again when the assistant asks
Key pair, EVA Developer API Token Not published yet. Ask support@novilabs.com

Details: Authentication.

MCP server Tools that change anything
Novi EVA None. Every tool is read-only
Novi Forecasts Tools read, or start a plan or an export. save_forecast_source saves only after asking you. No tool deletes
Novi M&A Intelligence Only your own comps basket

Your subscription applies on every channel

Section titled “Your subscription applies on every channel”

An API or an agent sees what your subscription covers, and no more.

  • Novi UDM Data: every delivery path shows only the basins in your subscription. Views keyed by a well or wellbore filter rows for you.
  • Novi EVA REST: a value outside your subscription comes back as "Subscription Required".
  • Novi EVA MCP: column search covers only columns you are licensed for. A request outside your subscription returns ACCESS_DENIED.
  • Novi Forecasts API: each company’s plans, exports and saved records are its own. Nothing you send can reach another company’s records.

Novi Labs lists SOC 2 Type 2 on novilabs.com.