# insufficient_scope — Shorty API error

> Insufficient scope (HTTP 403): when the Shorty API returns the insufficient_scope error, why, and how to fix it.

| Code | HTTP status | Type URI |
| --- | --- | --- |
| `insufficient_scope` | 403 | `https://aishorty.com/docs/api/errors/insufficient_scope` |

## When it happens

The credential is valid but lacks the scope this operation requires (e.g. calling a write endpoint with a read-only key).

## Example response

```json
{
  "type": "https://aishorty.com/docs/api/errors/insufficient_scope",
  "title": "Insufficient scope",
  "status": 403,
  "detail": "This operation requires the articles:write scope.",
  "instance": "urn:request:req_01J9Z8ABCDEFGH0123456789",
  "code": "insufficient_scope",
  "request_id": "req_01J9Z8ABCDEFGH0123456789"
}
```

## How to fix it

Grant the missing scope: re-create the API key with the needed scopes, or re-consent the connected app so its token carries them.

## Related errors

- [unauthorized](/docs/api/errors/unauthorized) — Unauthorized (HTTP 401)
- [feature_not_enabled](/docs/api/errors/feature_not_enabled) — Feature not enabled (HTTP 403)