# `key_scope_insufficient`

> For the complete documentation index, see [llms.txt](https://www.shortsintel.com/llms.txt). Every docs page is also available as markdown: add .md to its URL. To connect, read [agents.md](https://www.shortsintel.com/agents.md).

A read-only key tried a paid call or a write.

## Status

HTTP `403`, title `Key scope insufficient`. One of the [credentials](https://www.shortsintel.com/docs/reference/errors#credentials) errors. Branch on `code`, never on the status or the prose.

Retryable: no. Every body carries this as `retryable: false`, beside `action` and `remedy`: the same request will fail again until the request changes or a person acts.

## Common causes

- The key was created read-only in the console.

## What to do

Action: Use a full API key, or send estimate=true to quote it.

A read-only key makes free reads and estimates only. Use a full key; retrying will not help.

## Example

The body arrives as `application/problem+json`, with `retryable` and the `remedy` above. Most responses add `detail` about the occurrence, and some add fields of their own.

```json
{
  "type": "https://www.shortsintel.com/docs/reference/errors/key_scope_insufficient",
  "title": "Key scope insufficient",
  "status": 403,
  "code": "key_scope_insufficient",
  "retryable": false,
  "action": "Use a full API key, or send estimate=true to quote it.",
  "remedy": "A read-only key makes free reads and estimates only. Use a full key; retrying will not help."
}
```

## Related

- [Authentication and limits](https://www.shortsintel.com/docs/concepts/authentication-and-limits)
- [Every error code](https://www.shortsintel.com/docs/reference/errors)

[Previous forbidden](https://www.shortsintel.com/docs/reference/errors/forbidden)[Next invalid_request](https://www.shortsintel.com/docs/reference/errors/invalid_request)