> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myustadia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Health Deep

> Readiness probe: proves the DB path end-to-end (pool -> proxy -> Cloud SQL).

Caddy keeps probing the DB-free /api/v1/health for liveness (a DB blip must
not pull the only upstream); uptime monitoring targets THIS endpoint. Split
exists because the Aug 5-17 outage (mahara_app locked by Cloud SQL's password
policy) sat invisible behind the DB-free check for 12 days.

Sync def on purpose: runs in Starlette's threadpool, so a hung pool cannot
freeze the event loop (same rule as the assistant routes).



## OpenAPI

````yaml /openapi.yaml get /api/v1/health/deep
openapi: 3.1.0
info:
  title: Mahara Platform
  description: >
    AI Sales Training Course Generator, a Coursera-style platform.


    ## Authentication


    Every request must carry your API key as a Bearer token:


    `Authorization: Bearer sk_live_your_key_here`


    ## Getting an API key


    API keys are provisioned by our team. They are not self-service, so there is
    no signup page to apply on. To request access, email **sales@myustadia.com**
    and we will issue a key for your account.
  version: 1.0.0
servers: []
security: []
paths:
  /api/v1/health/deep:
    get:
      summary: Health Deep
      description: >-
        Readiness probe: proves the DB path end-to-end (pool -> proxy -> Cloud
        SQL).


        Caddy keeps probing the DB-free /api/v1/health for liveness (a DB blip
        must

        not pull the only upstream); uptime monitoring targets THIS endpoint.
        Split

        exists because the Aug 5-17 outage (mahara_app locked by Cloud SQL's
        password

        policy) sat invisible behind the DB-free check for 12 days.


        Sync def on purpose: runs in Starlette's threadpool, so a hung pool
        cannot

        freeze the event loop (same rule as the assistant routes).
      operationId: health_deep_api_v1_health_deep_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}

````