forbidden

Code: forbidden · HTTP status: usually 403

The credential is valid, but the store’s plan or settings do not allow this operation.

How to fix

Check the plan or setting named in the error; the merchant can change it in the STOQ app.

Example response

{
  "code": "forbidden",
  "type": "https://docs.stoqapp.com/v2/docs/api-v2/errors/forbidden/",
  "title": "Forbidden",
  "status": 403,
  "detail": "Not available on this plan. This store's plan or settings do not allow the operation.",
  "errors": [
    "Not available on this plan"
  ],
  "details": [
    {
      "code": "forbidden",
      "message": "Not available on this plan",
      "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.