Error Codes

Error Response Format#

All Anar products return errors in a consistent JSON format:

{
  "error": "Human-readable error message"
}

Validation errors include additional detail:

{
  "error": "Validation error",
  "details": [
    {
      "loc": ["body", "text"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

HTTP Status Codes#

Success Codes#

Client Error Codes#

Server Error Codes#

Product-Specific Errors#

Gateway#

Chat#

Guard#

Voice#

Docs#

Translate#

Flow#

Comply#

Eval#

Present#

Minutes#

Procure#

Agents#

Insights#

Handling Errors in Client Code#

Python#

import httpx

async def safe_request(url: str, token: str):
    async with httpx.AsyncClient() as client:
        response = await client.get(
            url,
            headers={"Authorization": f"Bearer {token}"},
        )
        if response.status_code == 401:
            # Token expired or invalid — re-authenticate
            raise AuthenticationError("Token invalid")
        if response.status_code == 429:
            # Rate limited — back off and retry
            retry_after = int(response.headers.get("Retry-After", 60))
            await asyncio.sleep(retry_after)
            return await safe_request(url, token)
        response.raise_for_status()
        return response.json()

TypeScript#

async function apiRequest(url: string, token: string): Promise<any> {
  const response = await fetch(url, {
    headers: { Authorization: `Bearer ${token}` },
  });

  if (!response.ok) {
    const body = await response.json();
    if (response.status === 401) {
      throw new Error("Authentication failed");
    }
    if (response.status === 429) {
      throw new Error("Rate limited, retry later");
    }
    throw new Error(body.error || `HTTP ${response.status}`);
  }

  return response.json();
}