Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/yocxy2/2a/llms.txt

Use this file to discover all available pages before exploring further.

The health check endpoint provides a fast, lightweight signal that the AI Ticket Support System backend is up and accepting connections. It does not query the database, the AI service, or the Redis queue — it simply returns a static status string and the current server time. Use it to confirm the process is running before making ticket API calls.

Request

GET /api/health
This endpoint is mounted at /api/healthnot under the versioned /api/v1 prefix. It is intentionally kept outside the versioned namespace so that infrastructure tooling can reach it regardless of API version routing.
curl http://localhost:3001/api/health

Response (200 OK)

status
string
Always "ok" when the server process is running and able to handle requests.
timestamp
string
ISO 8601 UTC timestamp generated at the moment the request was handled (via new Date().toISOString()). Useful for confirming the server clock and verifying the response is fresh (not cached).

Example Response

{
  "status": "ok",
  "timestamp": "2024-01-15T10:30:00.000Z"
}
This endpoint is well-suited for:
  • Docker health checks — use HEALTHCHECK CMD curl -f http://localhost:3001/api/health || exit 1 in your Dockerfile or docker-compose.yml healthcheck block.
  • Load balancer target group health checks — configure your AWS ALB, GCP load balancer, or NGINX upstream health probe to GET /api/health and expect a 200 response.
  • Uptime monitoring — point tools like UptimeRobot, Betterstack, or Datadog Synthetics at this URL for continuous availability checks.

Build docs developers (and LLMs) love