Skip to main content

API Overview

Base configuration and response formats for the Zihin API.

Base URL​

Development: http://localhost:3001
Production:  https://llm.zihin.ai

Response Format​

Success​

{
  "success": true,
  "data": {},
  "count": 0,
  "meta": {
    "generatedAt": "2025-12-17T18:00:00.000Z"
  }
}

Error​

{
  "error": "error_code",
  "message": "Error description",
  "details": {},
  "status": "error"
}

Pagination​

{
  "data": [],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 100,
    "pages": 2
  }
}

Caching​

EndpointTTL
/api/llm/models5 min
/api/llm/recommendations10 min
/api/llm/provider15 min
/api/health30 sec
/api/health/status30 sec

Endpoint Categories​

CategoryBase PathAuth Required
Health/api/healthNo
LLM/api/v3/llmYes*
Agents/api/agentsYes
Database/api/database-configsYes
Telemetry/api/telemetryNo

*Public call endpoint available with API Key