HTTP 403

insufficient_scope — Shorty API error

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

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

{
  "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

  Unauthorized (HTTP 401)

• feature_not_enabled

  Feature not enabled (HTTP 403)