Create and Manage Nexenergie API Keys for Secure API Access

API keys are for server-to-server access. Only tenant admins can create or revoke them. The raw secret is shown once on create.

Create a key

curl -sS https://<host>/api/v1/auth/api-keys \
  -H "Authorization: Bearer <access_jwt>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "oms-integration",
    "scopes": ["role:viewer", "markets:read", "forecasts:read"],
    "expires_in_days": 90
  }'

Store api_key from the response. Later list and delete calls only show key_prefix.

name

1–100 characters.

scopes

Defaults to ["role:viewer"].

expires_in_days

Optional, 1–365. Omit for no expiry.

Call the API

curl -sS "https://<host>/api/v1/forecasts/latest?market_id=omie_es&product=da" \
  -H "Authorization: Bearer nex_..."

Scopes

role:viewer, role:trader, role:manager, role:admin

Maps the key to a tenant role.

markets:read

Required if the key lists any fine-grained scopes and you call /markets.

forecasts:read

Required if the key lists any fine-grained scopes and you call /forecasts.

If you set markets:read but omit forecasts:read, forecast endpoints return 403. Either use only a role:* scope, or include every fine-grained scope you need.

Revoke

curl -sS -X DELETE https://<host>/api/v1/auth/api-keys/<api_key_id> \
  -H "Authorization: Bearer <access_jwt>"

Get Started

Core Concepts

Guides

Account & Settings

Create and Manage Nexenergie API Keys for Secure API Access

Create a key

Call the API

Scopes

Revoke

​Create a key

​Call the API

​Scopes

​Revoke

Create a key

Call the API

Scopes

Revoke