Skip to main content

unauthorised

HTTP 401 · Not retryable without client action.

ERPly Pro could not authenticate the request. Typical causes:

  • The JWT sent in Authorization: Bearer <token> is expired.
  • The JWT belongs to a different tenant / Cognito pool.
  • The X-Tenant-Id header is missing or does not match the tenant_id claim in the token.

How to fix​

  1. Refresh the token via the OAuth flow of the tenant's Cognito User Pool.
  2. Verify that the X-Tenant-Id header is present and matches the token claim.
  3. Make sure the client clock is NTP-synchronised — JWTs include exp/nbf.

Example​

{
  "type": "https://errors.api.erply.pro/unauthorised",
  "title": "Unauthorised",
  "status": 401,
  "detail": "Token has expired"
}