Common Errors and Solutions

Here are solutions for the most frequently encountered issues in HireKit.

Authentication Errors

"Session expired" or "Unauthorized"

• Sign out and sign back in
• Clear your browser cookies for the HireKit domain
• Check if your Clerk session is still valid

"Invalid API key" (Browser Extension)

• Generate a new API key from Settings
• Ensure you copied the full key including the hk_ prefix
• Check that the key has not been revoked

AI Feature Errors

"Rate limit exceeded"

• You have reached your daily limit for that AI model
• Check your usage in Settings > AI Configuration
• Wait until midnight for limits to reset
• Ask an admin to increase your limits if needed

"AI request timed out"

• AI operations can take 5-15 seconds; wait for them to complete
• Check your internet connection (AI calls require external API access)
• Try again - temporary API issues can cause timeouts
• If persistent, check that the ANTHROPIC_API_KEY is valid

Upload Errors

"File too large"

• Resume uploads are limited to 10MB
• Document Vault uploads are limited to 50MB
• Compress your file or use a different format

"Unsupported file type"

• Resumes: PDF and DOCX only
• Vault documents: Common document formats accepted

Docker Issues

Services not starting

docker compose down
docker compose up --build

Database connection errors

• Ensure the postgres container is running: docker compose ps
• Check logs: docker compose logs postgres
• Verify DATABASE_URL in your environment configuration

Performance Issues

Slow page loads

• Check that Redis is running for caching
• Clear your browser cache
• Ensure Docker has adequate resource allocation (2GB+ RAM recommended)