Troubleshooting

Common issues and how to resolve them.

• 401 on every request — your access token expired or was revoked (logout-all, or the blacklist check on the JWT middleware). Re-authenticate.
• 403 on an admin route — your account role is not admin. Admin routes check role, not just a valid token.
• GraphQL query returns null data with a populated errors array — check the token scope; public tokens are read-scoped and will reject mutations.
• OAuth token exchange fails — double check grant_type is exactly client_credentialsand the secret hasn't been rotated.

Still stuck? Email support@storentia.com with the failing request's request_id.