Authentication

Every request to the Valori Cloud API carries a project-scoped API key. No project ID or node URL is required.

Valori uses project-scoped API keys, prefixed vlk_. Send yours as a bearer token on every request:

Authorization: Bearer vlk_your_project_api_key

Never commit an API key to source control or ship one in client-side code. Generate keys from the Valori dashboard and store them as a secret in your deployment environment.

How resolution works

The key alone is enough — you never pass a project ID or a node URL in a request. The Cloud API resolves both from the key on every call:

vlk_ API key
    ↓
https://app.valori.systems
    ↓
Cloud verifies the key, resolves the project
    ↓
Cloud resolves the project's node
    ↓
request reaches your project's data

This is also how both official SDKs are configured — construct the client with api_key/apiKey alone:

from valori import ValoriClient

client = ValoriClient(api_key="vlk_your_project_api_key")

Missing or invalid credentials

A request with no Authorization header, or one that fails verification, is rejected before it reaches your project's data. See Errors for the full status code reference.