Skip to main content

missing-scope

HTTP status: 403 Forbidden Type URI: https://docs.evinor.ai/problems/missing-scope

The API key authenticated successfully but lacks a scope the endpoint requires. The response body includes a missing_scopes array naming exactly the scope(s) you need — it never lists your key's full scope set.

{
  "type": "https://docs.evinor.ai/problems/missing-scope",
  "title": "Missing required scope",
  "status": 403,
  "detail": "The API key is missing required scope(s): SENSORS_WRITE.",
  "request_id": "…",
  "missing_scopes": ["SENSORS_WRITE"]
}

Common causes​

  • Using a read-only key (SENSORS_READ) to create, update, or delete a sensor (which needs SENSORS_WRITE).

How to resolve​

Scopes are fixed when a key is created and cannot be edited. Create a new key with the required scope, migrate your integration to it, and revoke the old key. See Authentication.