Error Handling & Status Codes

This page lists all possible error responses from the Petameta Chat API.

Standard Error Format

All errors follow this structure:

{
  "success": false,
  "error": "Invalid API Key",
  "code": "AUTH_INVALID_KEY",
  "request_id": "req_17635951",
  "timestamp": "2025-11-19T23:32:38.70Z"
}

Error Codes

This page lists all possible error codes returned by the PetaAI Chatbot API.

Authentication Errors

Code	Message
AUTH_MISSING_KEY	API key missing in header
AUTH_INVALID_KEY	Invalid or expired API key
AUTH_INSUFFICIENT_SCOPE	API key does not have required permissions

Request Errors

Code	Message
BAD_REQUEST	Malformed JSON request
MISSING_FIELDS	Required fields missing
INVALID_FIELD	One or more fields have invalid values

Handover-Related Errors

Code	Message
HANDOVER_REQUIRED	User needs human assistance
HANDOVER_NOT_SUPPORTED	Handover system not configured

Rate Limiting

Code	Message
RATE_LIMIT_EXCEEDED	Too many requests

Server Errors

Code	Message
SERVER_ERROR	Unexpected internal error
MODEL_TIMEOUT	AI model did not respond in time