Authentication

How to authenticate API requests

All API requests require authentication using an API key.

API Key

Create API keys in the Control Plane under Settings → API Keys.

Include the key in the api-key header:

curl -X GET https://value.valmi.io/api/v1/agent_type/all \
  -H "api-key: token_abc123xyz"

Base URL

https://value.valmi.io/api/v1

Error Responses

401 Unauthorized

{
  "detail": "Unauthorized: Invalid api key"
}

403 Forbidden

{
  "detail": "Restricted: This endpoint is not allowed for your API key"
}