auth_required

API key required

Code: auth_required · HTTP status: usually 401

The request reached a protected endpoint without any credential.

How to fix

Send the store’s API key in the X-Auth-Token header (or Authorization: Bearer ).

Example response

{
  "code": "auth_required",
  "type": "https://docs.stoqapp.com/v2/docs/api-v2/errors/auth-required/",
  "title": "API key required",
  "status": 401,
  "detail": "API key required. Send the store's API key as the X-Auth-Token header (the MCP server also takes Authorization: Bearer <key>). The merchant finds it in STOQ → Back in stock alerts → Integrations → API Key; see https://docs.stoqapp.com/docs/api-key/",
  "errors": [
    "API key required"
  ],
  "details": [
    {
      "code": "auth_required",
      "message": "API key required",
      "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.