Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Genify Backend Health API
version: 0.1.0
tags:
- name: Health
paths:
/health:
get:
summary: Health
description: 'Lightweight health check (the container''s HEALTHCHECK and the uptime monitor) — no blocking DB calls.
A synchronous DB query here blocks the async event loop for ~1s, stalling all concurrent requests.
Database connectivity is checked separately via /health/deep.'
operationId: health_health_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
tags:
- Health
/health/deep:
get:
summary: Health Deep
description: 'Deep health check with database connectivity test.
Runs the DB query in a thread pool so it doesn''t block the event loop.
Use this for debugging, not for ALB health checks.'
operationId: health_deep_health_deep_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
tags:
- Health
components:
securitySchemes:
HTTPBearer:
type: http
scheme: bearer