insufficient_scope

Credential lacks the scope

Code: insufficient_scope · HTTP status: usually 403

The credential is valid but was not granted the scope this operation needs.

How to fix

Reconnect the client and grant the scope named in the error, then retry.

Example response

{
  "code": "insufficient_scope",
  "type": "https://docs.stoqapp.com/v2/docs/api-v2/errors/insufficient-scope/",
  "title": "Credential lacks the scope",
  "status": 403,
  "detail": "Missing scope: write_preorders. The credential is valid but not for this operation. Reconnect with the scope the operation needs.",
  "errors": [
    "Missing scope: write_preorders"
  ],
  "details": [
    {
      "code": "insufficient_scope",
      "message": "Missing scope: write_preorders",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}

Every API v2 and MCP failure carries code and a type link to its page here. See Errors & Responses for the full envelope.