Error
insufficient_scope
The key does not cover this
| HTTP status | 403 |
|---|---|
| Retry | No: fix the request first |
| details | required: the missing scope; or restrictedTo: the key's channel: / binding: tags. |
What happened
The key does not cover this.
Why
The API key lacks the scope this operation requires (each operation lists its scope in the reference, x-voicelayer-scopes), or the key is restricted with channel: / binding: tags that do not cover the sender. On the events routes, the key needs events:read.
How to fix it
Use a key with the scope named in details.required, or one whose restriction covers this channel or Binding.
Example response
{
"error": "insufficient_scope",
"message": "The key does not cover this.",
"requestId": "req-8f2c1d4b",
"retryable": false,
"docs": "https://docs.vlayers.ai/errors/insufficient_scope"
}See Errors, retries and idempotency for how to handle errors in general.