> ## Documentation Index
> Fetch the complete documentation index at: https://hexelstudio.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting Guide

> How to resolve common issues with Hexel Secret Manager.

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](./faq) or contact support at [support@hexelstudio.com](mailto:support@hexelstudio.com).