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

# Common Errors

> Error codes and messages you might encounter, and what they mean.

# Common Errors

This page lists the most common error messages in Neural Factory and how to resolve them.

## Authentication errors

### "Session expired" / "Please sign in again"

Your authentication session has timed out. Sign out and sign back in. If this happens frequently, clear your browser cookies for the Neural Factory domain.

### "Unauthorized" (401)

Your request was not authenticated. Possible causes:

* You're not signed in
* Your API key is invalid or expired
* Your session token has expired

**Fix**: Sign in again, or verify your API key is correct and active.

### "Forbidden" (403)

You don't have permission to perform this action. Possible causes:

* You're trying to access an admin feature as a Member
* The agent or knowledge base is restricted to groups you don't belong to
* Your API key doesn't have the required permissions

**Fix**: Contact your administrator to check your role and group memberships.

## Resource errors

### "Not found" (404)

The requested resource doesn't exist. Possible causes:

* The agent, knowledge base, or conversation was deleted
* The URL is incorrect
* You're trying to access a resource in a different organization

### "Rate limited" (429)

You've exceeded the request rate limit. Wait for the time specified in the `Retry-After` header before retrying. If you consistently hit rate limits, consider upgrading your plan (SaaS) or contact your administrator (Enterprise).

## Server errors

### "Internal server error" (500)

Something went wrong on the server. This is usually temporary. Steps:

1. Wait a moment and try again
2. If the error persists, check if the issue is specific to one agent or feature
3. Contact [support@neuralfactory.ai](mailto:support@neuralfactory.ai) if the error continues

### "Service unavailable" (503)

The platform is temporarily unavailable, usually due to maintenance or high load. Try again in a few minutes.

## Chat errors

### "Agent failed to respond"

The agent encountered an error while processing your message. Possible causes:

* The AI model service is temporarily unavailable
* The agent's configuration has an issue
* A connected tool or datasource is failing

**Fix**: Try sending the message again. If it persists, try a different agent or contact your administrator.

### "Message too long"

Your message exceeds the maximum allowed length. Shorten your message or break it into multiple messages.