API Error Codes
When an API call results in an error, GrowPanel returns an HTTP status code along with an error message.
Error response format
{
"message": "Device parameter missing"
}HTTP status codes
| Status code | Description |
|---|---|
| 400 | Bad Request. Maybe you're missing some parameters |
| 401 | Unauthorized. Your API key may be invalid. |
| 403 | Forbidden. Your API key does not have access to the resource. |
| 404 | The resource was not found. |
| 405 | Method (GET, POST, PUT, DELETE) not allowed. |
| 429 | Too many requests. Your request has been rate limited |
| 500 | Internal server error. If this error persists, get in touch with us. |
| 501-599 | A problem occurred connecting to the GrowPanel platform. Try again later. |
Common errors and solutions
401 Unauthorized
Cause: Invalid or missing API key.
Solution:
- Verify your API key is correct
- Ensure the
Authorization: Bearer YOUR_API_KEYheader is included - Check if the key was regenerated or deleted
403 Forbidden
Cause: Your API key doesn't have permission for this resource.
Solution:
- Verify the key has the correct access level (Admin vs Viewer)
- Check if you're accessing resources from another account
429 Too Many Requests
Cause: Rate limit exceeded.
Solution:
- Wait for the rate limit window to reset (usually 1 minute)
- Implement exponential backoff in your integration
- Reduce request frequency
See Rate limiting for current limits.
Related pages
- Authentication - Setting up API access
- Rate limiting - Request limits
- API Reference - Endpoint documentation
