code – A stable, unique identifier for the error. Useful for programmatic handling and support requests.
title – A short, human-readable summary of the issue.
message – Detailed guidance to help you resolve the error.
This structure ensures you always get actionable feedback when something doesn’t go as expected.
Auth Plugin Errors
The following errors can occur when interacting with the Auth Plugin endpoints. Each error follows our standard structure, making it easier to debug and respond to issues programmatically.
Refer to the table below for a list of possible error codes, what they mean, and how to resolve them.
400
Code
Title
Message
AUT-0002
Invalid Path Parameter
One or more path parameters are in an incorrect format. Please check the following parameters %v and ensure they meet the required format before trying again.
AUT-0004
Invalid Query Parameter
One or more query parameters are in an incorrect format. Please check the following parameters %v and ensure they meet the required format before trying again.
AUT-0010
Metadata Key Length Exceeded
The metadata key %v exceeds the maximum allowed length of %v characters. Please use a shorter key.
AUT-0011
Metadata Value Length Exceeded
The metadata value %v exceeds the maximum allowed length of %v characters. Please use a shorter value.
AUT-0012
Invalid Metadata Nesting
The metadata object cannot contain nested values. Please ensure that the value %v is not nested and try again.
AUT-0013
Invalid Grant Type
The provided 'grantType' %s is not valid. Accepted grant types are password, client_credentials, refresh_token, or others. Please provide a valid type.
AUT-0014
Grant Type Missing Fields
The provided 'grant_type' %s is missing required fields. Please refer to the documentation for guidance.
AUT-1001
Unsupported Grant Type
The provided 'grantType' is not supported by this application. Please refer to the application's supported grant types.
AUT-1005
Invalid Refresh Token
The provided 'refreshToken' is invalid, expired or revoked. Please verify the token and try again.
401
Code
Title
Message
AUT-0006
Token Missing
A valid token must be provided in the request header. Please include a token and try again.
AUT-0007
Invalid Token
The provided token is expired, invalid or malformed. Please provide a valid token and try again.
AUT-1003
Invalid Token
The provided token is expired, invalid or malformed. Please provide a valid token and try again.
AUT-1002
Invalid Username or Password
The provided 'username' or 'password' is incorrect. Please verify the credentials and try again.
AUT-1004
Invalid Client
The provided 'clientId' or 'clientSecret' is incorrect. Please verify the credentials and try again.
403
Code
Title
Message
AUT-0008
Permission Enforcement Error
The enforcer is not configured properly. Please contact your administrator if you believe this is an error.
404
Code
Title
Message
AUT-1015
Enforcement Sub Not Found
No subject was found for the provided 'sub'. Please refer to the enforcement documentation for guidance on the correct 'sub' value.
500
Code
Title
Message
AUT-0005
Internal Server Error
The server encountered an unexpected error. Please try again later or contact support.