If you encounter issues while using Hexel Secret Manager, refer to this guide for solutions to common problems.

Authentication Errors

  • 401 Unauthorized:
    • Cause: Invalid or expired token.
    • Solution: Re-authenticate and use a valid Bearer token.
  • 403 Forbidden:
    • Cause: Insufficient permissions or role.
    • Solution: Contact your admin to request access or check your assigned roles.

Resource Not Found

  • 404 Not Found:
    • Cause: The secret or resource does not exist, or you lack access.
    • Solution: Verify the resource ID and your permissions.

API Request Issues

  • 400 Bad Request:
    • Cause: Malformed request or missing required fields.
    • Solution: Check the API documentation for the correct request format.
  • 422 Unprocessable Entity:
    • Cause: Validation error (e.g., missing or invalid data).
    • Solution: Review the error message and correct your input.

Dashboard Problems

  • Page not loading or 500 errors:
    • Solution: Refresh the page, clear your browser cache, or try a different browser. If the issue persists, contact support.

Other Issues

  • Secret not updating or deleting:
    • Solution: Ensure you have the correct permissions and the resource exists.
  • Audit logs missing:
    • Solution: Check your role and permissions, or contact your admin.

If your issue is not listed here, see the FAQ or contact support at support@hexelstudio.com.