Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer omx_sk_...

Get a demo key

GET /v1/auth/demo

Returns a demo session key with read-only access to sample data.

curl https://api.onlymetrix.com/v1/auth/demo

{"session_key": "omx_sk_demo00000000000000000000000000000000", "demo": true}

Sign up

POST /v1/auth/signup

Parameter	Type	Required	Description
email	string	yes	Account email
password	string	yes	Min 8 characters
name	string	no	Display name

Log in

POST /v1/auth/login

Parameter	Type	Required	Description
email	string	yes
password	string	yes

Returns session_key for subsequent requests.

Current user

GET /v1/auth/me

Returns tenant, user info, and active scopes.

API key scopes

Scope	Permissions
read	Query metrics, list tables, compiler status
write	Create/delete metrics, resolve requests
query	Execute raw SQL
admin	All setup endpoints, key management
*	Full access

Empty scopes = full access (legacy).

Generate API keys

POST /v1/setup/generate-key

Parameter	Type	Required	Description
name	string	no	Key label
scopes	array	no	Permission scopes

{"key": "omx_sk_...", "key_prefix": "omx_sk_a1b2...", "scopes": ["read", "query"]}

WARNING

The full key is shown only once. Store it securely.