Error Codes

LifyGo uses standard HTTP status codes for every API response. When an error occurs, the response body contains an error field describing the problem.

Error Response Format

{
  "error": "A human-readable description of what went wrong."
}

HTTP Status Codes

Status	Meaning
200	Request completed successfully
201	Resource created successfully (API key, scheduled job, etc.)
400	Missing or invalid request data
401	Missing or invalid API key
404	Requested resource was not found
422	Request is valid, but required configuration is missing (for example, SMTP is not configured)
429	Rate limit exceeded (default: 100 requests per hour per API key)
500	Internal server error

Common Error Examples

Missing API Key

{
  "error": "missing API key"
}

Invalid API Key

{
  "error": "invalid API key"
}

Missing Required Field

{
  "error": "subject is required"
}

SMTP Not Configured

{
  "error": "SMTP configuration not found"
}

Rate Limit Exceeded

{
  "error": "rate limit exceeded"
}

Troubleshooting

If you receive a 500 Internal Server Error, check:

API server logs
SMTP server connectivity
Database availability
Redis availability
Environment variable configuration

​Error Codes

​Error Response Format

​HTTP Status Codes

​Common Error Examples

​Missing API Key

​Invalid API Key

​Missing Required Field

​SMTP Not Configured

​Rate Limit Exceeded

​Troubleshooting