Return custom errors from script extensions

Custom error responses are particularly valuable in pre-token minting scripts when you need to:

When a script returns a structured error, SecureAuth returns the clear message and appropriate status code to the client without issuing a token.

A retail company uses SecureAuth to manage partner API access. A pre-token script checks if the partner:

If any condition fails, the script blocks token issuance and returns a structured error:

{
  "error": {
    "message": "API quota exceeded",
    "code": 429
  }
}

This ensures unauthorized or invalid requests are stopped early, with a clear message for troubleshooting.

Return a custom error using this format, where:

module.exports = async function (context) {
  return {
    error: {
      message: "Your error message here",
      code: 403
    }
  };
};